Saltar para o conteúdo principal
Kilo Code é um agente de codificação de IA de código aberto disponível no VS Code, JetBrains, CLI, Slack e Cloud. Ele se conecta ao OrcaRouter através do seu Custom provider (provedor personalizado — um endpoint compatível com OpenAI). Este guia cobre tanto a extensão do VS Code (a forma mais comum de usar o Kilo Code) quanto a CLI (@kilocode/cli, para uso headless).
Protocolo: compatível com OpenAI
  • Base URL: https://api.orcarouter.ai/v1 (inclui /v1)
  • Os IDs de modelo usam o formato vendor/model — o mais simples é orcarouter/auto

​
Extensão do VS Code

  1. Instale o Kilo Code a partir do VS Code Marketplace (abra o painel de Extensões e pesquise “Kilo Code”), depois abra-o pelo ícone do Kilo Code na Activity Bar (barra de atividades, a faixa de ícones à esquerda). No painel, clique na ⚙ engrenagem no canto superior direito para abrir as configurações.
O painel do Kilo Code com a engrenagem de configurações destacada
  1. Vá para Providers (provedores). Em Popular providers, encontre o Custom provider (“Add an OpenAI-compatible provider by base URL”) e clique em + Connect.
A entrada do Custom provider nas configurações de Providers do Kilo Code
  1. Preencha os campos do provedor:
    • Provider ID: orcarouter (apenas letras minúsculas, números, hifens ou sublinhados — sem barras; orcarouter/auto é rejeitado aqui).
    • Display name: OrcaRouter (o que você preferir).
    • Base URL: https://api.orcarouter.ai/v1
    • API key: sua chave do OrcaRouter (sk-orca-...).
Provider ID, base URL e API key do OrcaRouter no Kilo Code
  1. Escolha seus modelos. Assim que a chave e a base URL forem válidas, o Kilo Code busca a lista de modelos ao vivo do OrcaRouter — marque os que você quiser (ou Select all), depois clique em Submit. Para usar o roteamento automático, use também + Add model com o ID de modelo orcarouter/auto (é um alias de roteamento, portanto não aparecerá na lista buscada).
Seletor de modelos do Kilo Code mostrando modelos buscados do OrcaRouter
  1. O provedor agora aparece em Connected providers como OrcaRouter (CUSTOM).
OrcaRouter listado em Connected providers no Kilo Code
  1. Selecione o modelo OrcaRouter no seletor de modelos do painel de chat e envie uma mensagem de teste — uma resposta confirma a conexão.
Kilo Code respondendo através do OrcaRouter
Em um repositório grande, o Kilo Code pode primeiro perguntar se deve aguardar a inicialização do seu sistema de snapshots — escolha Disable for this project para pulá-la (o git ainda rastreia tudo) para que a requisição prossiga.
O plugin do JetBrains usa o mesmo Custom provider com os valores idênticos de base URL / chave / modelo.

​
CLI

Para uso headless / com scripts, instale a CLI.

​
Instalar

npm install -g @kilocode/cli
O comando é kilo.

​
Configurar

Arquivo de configuração: ~/.config/kilo/kilo.jsonc (também aceita kilo.json; o ./kilo.jsonc em nível de projeto tem prioridade). 
{
  "$schema": "https://app.kilo.ai/config.json",
  "provider": {
    "orcarouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OrcaRouter",
      "options": { "baseURL": "https://api.orcarouter.ai/v1", "apiKey": "sk-orca-..." },
      "models": { "orcarouter/auto": { "name": "OrcaRouter Auto" } }
    }
  },
  "model": "orcarouter/orcarouter/auto"
}
Troque por um modelo específico se preferir, por exemplo anthropic/claude-opus-4.8 ou google/gemini-2.5-flash. Os IDs de modelo usam o formato vendor/model.

​
Executar

echo "Reply with exactly: OK" | kilo run --auto --format json
Esperado: um evento JSON com "type":"text" e "text":"OK".

​
Notas

  • A base_url inclui /v1.
  • As referências de modelo usam provider/model. Como o provedor é nomeado orcarouter e o ID do modelo também carrega um prefixo vendor, a referência tem três segmentos: orcarouter/orcarouter/auto (ou orcarouter/anthropic/claude-opus-4.8).
  • O modo headless é kilo run "<prompt>" --auto (ou canalize o prompt via stdin). --format json fornece um fluxo de eventos legível por máquina.
  • Raciocínio/thinking: use a flag --variant <name> para o esforço de raciocínio específico do provedor (por exemplo, high, max, minimal), e --thinking para exibir os blocos de thinking.
Problema conhecido: --auto tem casos relatados de travamento após a conclusão / quando a chave está ausente (kilocode issues). Envolva com um timeout em CI e certifique-se de que a chave está carregada.