Skip to main content
Kilo Code is a VS Code extension for AI-assisted coding. Configure it with a Custom Provider pointing to the AI Gateway to access every model in the catalog, including Anthropic Claude models.

Prerequisites

  • Kilo Code extension installed in VS Code (kilocode.kilo-code)
  • Active Orq.ai account
  • Orq.ai API key

Setup

Open the Kilo Code panel → SettingsProvidersCustom Provider. Fill the fields: Click Submit. In the model selector at the bottom of the Kilo Code panel, pick a model (e.g. orqai / openai/gpt-5.6-sol).
Always use the provider/model_id format for model IDs (e.g. anthropic/claude-sonnet-5, not claude-sonnet-5). Bare IDs return a 400 invalid model format error.

Max output tokens

Kilo Code defaults to 32,000 max output tokens. The Custom Provider GUI does not expose per-model token limits. For models with a smaller native cap (e.g. openai/gpt-5.6-sol at 16k), open ~/.config/kilo/kilo.jsonc via Kilo Settings → Global Config and add a limit object for the model under the root models key:
Without this, Kilo Code sends a 32k token request. If the upstream model’s native cap is lower, the request will fail with a token limit error.

Skills

Orq Skills add pre-built agentic workflows to Kilo Code for the full Build, Evaluate, Optimize lifecycle.

Installation

Set an API key and connect the Orq MCP server first. Skills are then triggered by describing what is needed.

Orq Skills

The full catalogue of skills and slash commands.
Slash commands (/orq:quickstart, /orq:traces, and others) are only available in Claude Code.

Troubleshooting

The model ID is missing the provider prefix. Change claude-sonnet-5 to anthropic/claude-sonnet-5, gpt-5.6-sol to openai/gpt-5.6-sol, and so on.
Add a limit object for the model in ~/.config/kilo/kilo.jsonc as shown in the Max output tokens section above. The GUI does not expose this field.
Verify the Base URL is set to https://my.orq.ai/v3/router. Requests sent to a provider’s own endpoint bypass the AI Gateway and produce no Traces.

Verification

Pick a model in the Kilo Code selector and send a message. The response appears in the panel and the request appears in Orq.ai Traces with the selected model identifier.