How to use Kilo Code with a custom OpenAI-compatible or Anthropic endpoint

Kilo Code is an open-source coding agent for VS Code. The 2026 extension was rebuilt on top of OpenCode, and its configuration works differently from the legacy extension and from Roo Code: instead of one API Provider dropdown, you add a "Custom provider" on the Providers tab, and the result is stored in kilo.json. This guide follows the extension as of October 2026.

Add a Custom provider in the UI

Open Kilo Code settings (gear icon) → Providers tab, scroll to the bottom and click Custom provider:

Click Submit. The models then appear under ccsub in the model picker. The model field takes IDs such as claude-sonnet-5; every available ID is on the models page.

Which Provider API to choose

• OpenAI Compatible calls /chat/completions and supports Fetch models, which reads https://www.ccsub.net/api/v1/models. This is the least typing.
• Anthropic Messages calls /messages. Fetch models is disabled, so add each model ID with Add model.
• OpenAI Responses is also available, and CCSub serves /responses, but the first two cover most needs.

Managing it in kilo.json

The dialog cannot set token limits, and models without them default to 0, which gets in the way of context management. Edit the config file to add them:

Example using Anthropic Messages (adjust the limit values to your needs):

{
  "provider": {
    "ccsub": {
      "npm": "@ai-sdk/anthropic",
      "name": "CCSub",
      "options": {
        "baseURL": "https://www.ccsub.net/api/v1",
        "apiKey": "{env:CCSUB_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "claude-sonnet-5",
          "limit": { "context": 200000, "output": 32000 }
        }
      }
    }
  },
  "model": "ccsub/claude-sonnet-5"
}

{env:CCSUB_API_KEY} reads the key from an environment variable, but only in the global config — in a project kilo.json it is left as literal text. Models are referenced as providerID/modelID.

Verify

Pick a model under ccsub, give Kilo Code a small task, and look for the request on the Usage page of your CCSub dashboard. Kilo's config format is essentially OpenCode's, so the OpenCode guide explains the remaining fields. If you prefer a classic dropdown-style setup, see the Cline guide.