Documentação

Kilo Code

O provedor personalizado do Kilo Code tem quatro campos. Preencha-os e a extensão se comunicará com Claude e GPT usando uma única chave — ela nunca saberá qual fornecedor está por trás do endpoint.

Providers → Custom provider → OpenAI Compatible, URL base com /v1 e ID do modelo Claude digitado — o Kilo Code nunca descobre qual fornecedor está por trás dele.

Settings → Providers → Custom provider

Provider ID    kunavo
Display name   Kunavo
Provider API   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API key        sk-kn-...
Models         claude-sonnet-5
               claude-opus-5
               claude-haiku-4-5

A URL base mantém o sufixo /v1 aqui — o Kilo Code acrescenta apenas a rota, e o exemplo documentado pelo próprio produto termina em /v1. O oposto ocorre com os clientes no estilo Anthropic, que precisam da origem sem o sufixo.

Provider API é um seletor de protocolo, não de fornecedor. Escolher OpenAI Compatible e depois inserir um ID de modelo Claude é a combinação prevista: o ID é resolvido no endpoint, não na extensão.

Ainda não tem uma chave? Crie uma conta na Kunavo, gere uma chave (ela começa com sk-kn-) e adicione crédito a partir de $10 — as chamadas são pagas com esse saldo, e chamadas malsucedidas não são cobradas. O painel então abre na configuração de Kilo Code.

Passo a passo

Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
Abra as configurações do Kilo Code (ícone de engrenagem), acesse a guia Providers, role até o fim e clique em Custom provider.
Preencha Provider ID, Display name, Provider API = OpenAI Compatible, Base URL e API key, conforme indicado acima.
Em Models, adicione os IDs manualmente ou use os da lista preenchida automaticamente — o Kunavo responde em GET /v1/models, então a lista é preenchida automaticamente.
Selecione o provedor no seletor de modo de chat e envie uma mensagem. Fixe um modelo econômico nos modos usados constantemente e um modelo caro nos modos de planejamento.

Verificado em Página do provedor OpenAI Compatible do Kilo Code em 6 de setembro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Esta é a versão resumida. O guia completo — escolha do modelo, custo de uma sessão real e modos de falha — está em o passo a passo do Kilo Code + Claude.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em Kilo Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

ID do modelo	Entrada / saída da Kunavo	Onde se encaixa em Kilo Code
`claude-sonnet-5`	$1.40 / $7.00	Modos Code e Architect — o modelo de trabalho padrão
`claude-opus-5`	$3.50 / $17.50	Modo Architect em refatorações grandes, nas quais um plano incorreto custa caro
`claude-haiku-4-5`	$0.70 / $3.50	Ask mode e triagem rápida de arquivos, em que o volume predomina
`gpt-5-6-sol`	$2.00 / $12.00	uma segunda opinião de outra família, com a mesma chave

A cobrança é por token, usando um saldo pré-pago e sem tarifa mensal — consulte billing. Em contextos repetidos — que representam a maior parte do que um editor ou cliente de chat envia — o cache de prompt altera a conta mais do que a escolha do modelo.

Perguntas frequentes

Como adiciono um provedor personalizado ao Kilo Code?

Abra as configurações do Kilo Code pelo ícone de engrenagem, acesse a guia Providers, role até o fim da lista e clique em "Custom provider". Preencha Provider ID e Display name, defina Provider API como "OpenAI Compatible", cole a URL base e a chave de API do endpoint e, em seguida, adicione os IDs dos modelos manualmente ou pela lista preenchida automaticamente. O provedor aparecerá então no seletor de modo, como qualquer provedor integrado.

O Kilo Code pode usar modelos Claude sem uma conta Anthropic?

Sim. A opção Provider API "OpenAI Compatible" do Kilo Code indica o protocolo de comunicação, não o fornecedor, e encaminha o ID do modelo diretamente à URL base configurada. Portanto, um ID Claude é resolvido nesse endpoint, não na extensão, e as credenciais usadas são as do endpoint, não as da Anthropic.

A URL base do Kilo Code precisa terminar em /v1?

Sim, para um endpoint compatível com OpenAI. O Kilo Code acrescenta apenas a rota — /chat/completions, /models —, então a URL base precisa ser a raiz /v1, por exemplo, https://api.kunavo.com/v1. O exemplo documentado pelo próprio produto usa o mesmo sufixo. Se faltar /v1, o resultado será um erro 404, não um erro de autenticação.

Por que o Kilo Code não mostra modelos depois que adiciono um provedor?

A lista de modelos é obtida na rota /v1/models do endpoint usando a chave informada; por isso, uma lista vazia geralmente significa que a chave ou a URL base está incorreta, não que o provedor não tenha modelos. Teste o mesmo par com um comando curl simples para /v1/models: se receber JSON, o problema está na configuração da extensão; 401 indica um problema com a chave; 404, com a URL. Também é possível inserir os modelos manualmente a qualquer momento.