Pular para o conteúdo principal
Com uma única API key da Capriole AI, você usa GPT-6.2 Astra, Claude Fable 5.1, Opus 5.5 e Gemini 4 Carbon no Kilo Code pagando até 92% menos que os preços oficiais da API.

O que é Kilo Code

O Kilo Code é um agente de programação com IA para o VS Code e o terminal. Esta configuração adiciona a Capriole AI como um único provedor personalizado. Cada modelo dele usa o protocolo de API que a Capriole AI oferece para a família desse modelo.

Pré-requisitos

Antes de começar, confira se você tem:
  • Uma conta Capriole AI (Cadastre-se aqui)
  • Um plano Premium (USD 9 por mês, também inclui chat na web ilimitado) ou um plano Team, necessário para a API key (Assine)
  • Uma API key da Capriole AI (Obtenha sua key)

Instalação

Kilo CLI

Verifique a instalação:

Extensão do VS Code

Instale o Kilo Code pela visualização de extensões do VS Code. A extensão lê o mesmo arquivo de configuração global que a CLI.

Configuração

Validação dos modelos

A Kilo CLI 7.8.15 passa nas verificações de leitura de arquivo, escrita de arquivo e resposta final pela Capriole AI com todos os modelos da seção Modelos suportados, usando a configuração abaixo. Crie ou atualize ~/.config/kilo/kilo.jsonc:
O que cada configuração faz:
  • npm: "@ai-sdk/openai-compatible" é o pacote padrão do provedor, então Gemini, Grok, GLM e Kimi usam Chat Completions.
  • Cada modelo GPT substitui provider.npm por @ai-sdk/openai, que usa a API Responses. Cada modelo Claude o substitui por @ai-sdk/anthropic, que usa Anthropic Messages.
  • {env:CAPRIOLE_AI_API_KEY} lê sua key do ambiente. O cabeçalho Authorization a envia como Bearer token em todos os pacotes.
  • tool_call: true permite que o modelo chame as ferramentas do Kilo.
  • limit define a janela de contexto e o limite de saída de cada modelo. Sem ele, o Kilo trata os dois como 0 e não compacta sessões longas.
Mantenha este provedor na sua configuração global. O Kilo não resolve referências {env:...} em uma configuração no nível do projeto. Execute kilo config check depois de editar o arquivo.

Executar Kilo Code

Defina sua API key e inicie o Kilo no diretório do projeto:
Inicie com um modelo específico:
Para uma solicitação pontual, passe um prompt para kilo run:

Modelos suportados

As referências de modelo usam o formato capriole-ai/<model-id>. openai-latest, claude-latest e google-latest sempre apontam para o nosso modelo principal mais recente de cada família, atualmente GPT-6.2 Astra, Claude Fable 5.1 e Gemini 4 Carbon.

Solução de problemas

Por que o Kilo Code retorna um erro de autenticação?

Confirme que CAPRIOLE_AI_API_KEY está exportada no mesmo shell antes de executar kilo e que o provedor está em ~/.config/kilo/kilo.jsonc, e não em uma configuração de projeto.

Por que as solicitações Claude falham com Unsupported Claude Messages model?

Os modelos Claude que usam @ai-sdk/anthropic precisam dos IDs Claude sem prefixo, como claude-opus-5-5. Os IDs com o prefixo anthropic/ são para Chat Completions.

Por que o Kilo Code diz que o modelo está ausente?

Confirme que o modelo selecionado usa o formato capriole-ai/<model-id> e que provider.capriole-ai.models tem uma entrada correspondente. Execute kilo models capriole-ai para listar os modelos que o Kilo carregou.

Por que o uso de ferramentas falha?

Confirme que a entrada do modelo inclui "tool_call": true.

Observações

  • Kilo Code executa as ferramentas de programação no seu computador. A Capriole AI processa as solicitações ao modelo.
  • Para adicionar outro modelo da Capriole AI, copie a entrada de um modelo da mesma família e altere o ID. GET https://api.caprioletech.com/v1/models lista todos os IDs de modelo.
  • O Gemini 4 Carbon raciocina por mais tempo que o Gemini 4 Argon, então cada turno pode demorar mais e usar mais tokens. Para turnos mais rápidos, use google/gemini-4-argon.
  • Para usar a mesma key nos seus outros agentes de programação, veja Usar uma API key com agentes de programação.
  • Referências oficiais: Kilo CLI, Modelos personalizados do Kilo, Configurações do Kilo e Provedores do OpenCode.
Última modificação em 18 de novembro de 2026