Kilo Code Setup

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

Kilo Code Setup¶

Kilo Code is an open-source AI coding extension for VS Code. It is a fork of Roo Code, which in turn forked from Cline — 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 Kilo Code in the VS Code marketplace, or follow the instructions on kilo.ai.

Configure Claude (Anthropic provider)¶

1. Open Settings (gear icon) in the Kilo 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
• Roo Code Setup — upstream project, nearly identical setup
• Cline Integration — further upstream
• Chinese Models