Roo Code Setup

Use QCode.cc from the Roo Code VS Code extension: pick the Anthropic provider, tick the custom base URL, and Claude works

Roo Code Setup¶

Roo Code is an open-source AI coding extension for VS Code, forked from Cline; Kilo Code in turn forked from it — the three share nearly identical settings screens, so this page transfers between them.

Which protocol¶

🔴 Do not use OpenAI Compatible to reach Claude — QCode's OpenAI endpoint rejects Claude models with model_not_available_on_endpoint. See Endpoints & API Paths.

Install¶

Search for Roo Code in the VS Code marketplace, or follow the instructions in the project repository.

Configure Claude (Anthropic provider)¶

1. Open Settings (gear icon) in the Roo Code sidebar
2. Set API Provider to Anthropic
3. Put your QCode key (starts with cr_) in API Key
4. Tick Use custom base URL and enter https://api.qcode.cc/api
5. Choose claude-sonnet-5 (or another live id) in the model dropdown
6. Save, then send a message in the chat box to confirm

From mainland China, swap the host for https://asia.qcode.cc/api (Hong Kong node); the key is unchanged. No trailing slash on the base URL — the extension appends /v1/messages itself, and an extra slash produces a 404.

Configure GPT and Chinese models (OpenAI Compatible)¶

1. Set API Provider to OpenAI Compatible
2. Base URL: https://api.qcode.cc/openai/v1
3. API Key: the same cr_ key
4. Model ID: gpt-5.5, gpt-5.6-terra, or a Chinese id such as glm-5.2

Verify connectivity¶

Check the endpoint and key with curl first, so you know whether to debug the extension's UI:

KEY="cr_your_qcode_key"
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'

JSON containing content means the endpoint side is fine; if the extension still fails, the problem is in its settings.

Troubleshooting¶

Related¶

• Endpoints & API Paths — protocol × model-family table
• Kilo Code Setup — downstream fork, nearly identical setup
• Cline Integration — upstream project
• Chinese Models