Kilo Code

O que é Kilo Code

O Kilo Code é um assistente de programação com IA para IDEs e terminais. Ele pode usar a Capriole AI pelo provedor compatível com OpenAI do Kilo, que envia solicitações à API compatível com Chat Completions da Capriole AI.

Pré-requisitos

Antes de começar, confira se você tem:

Uma conta Capriole AI (Cadastre-se aqui)
Uma API key da Capriole AI (Obtenha sua key)
Kilo Code instalado no VS Code ou como Kilo CLI

Instalação

Extensão do VS Code

Instale o Kilo Code na visualização de extensões do VS Code. Pesquise Kilo Code e instale a versão pré-lançamento.

Kilo CLI

npm install -g @kilocode/cli

Configuração

Crie ou atualize o arquivo de configuração do Kilo:

Configuração global: ~/.config/kilo/kilo.jsonc
Configuração do projeto: kilo.jsonc ou .kilo/kilo.jsonc na raiz do projeto

Use esta configuração de provedor compatível com OpenAI:

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "openai-compatible/openai-latest",
  "enabled_providers": ["openai-compatible"],
  "provider": {
    "openai-compatible": {
      "options": {
        "apiKey": "{env:CAPRIOLE_AI_API_KEY}",
        "baseURL": "https://api.caprioletech.com/v1"
      },
      "models": {
        "openai-latest": {
          "name": "Capriole OpenAI Latest",
          "tool_call": true,
          "reasoning": true
        },
        "claude-latest": {
          "name": "Capriole Claude Latest",
          "tool_call": true,
          "reasoning": true
        },
        "anthropic/claude-fable-5": {
          "name": "Capriole Fable 5",
          "tool_call": true,
          "reasoning": true
        },
        "anthropic/claude-opus-5": {
          "name": "Capriole Opus 5",
          "tool_call": true,
          "reasoning": true
        },
        "google-latest": {
          "name": "Capriole Google Latest",
          "tool_call": true,
          "reasoning": true
        },
        "openai/gpt-5.6-terra": {
          "name": "Capriole GPT 5.6 Thinking",
          "tool_call": true,
          "reasoning": true
        },
        "openai/gpt-5.6-luna": {
          "name": "Capriole GPT 5.6",
          "tool_call": true,
          "reasoning": true
        },
        "openai/gpt-5.5": {
          "name": "Capriole GPT 5.5",
          "tool_call": true,
          "reasoning": true
        },
        "openai/gpt-5.4-mini": {
          "name": "Capriole GPT 5.4 Mini",
          "tool_call": true,
          "reasoning": true
        },
        "xai/grok-4.5": {
          "name": "Capriole Grok 4.5",
          "tool_call": true,
          "reasoning": true
        },
        "zai/glm-5.2": {
          "name": "Capriole GLM 5.2",
          "tool_call": true,
          "reasoning": true
        },
        "moonshot/kimi-k3": {
          "name": "Capriole Kimi K3",
          "tool_call": true,
          "reasoning": true
        },
        "anthropic/claude-opus-4-8": {
          "name": "Capriole Opus 4.8",
          "tool_call": true
        },
        "anthropic/claude-opus-4-7": {
          "name": "Capriole Opus 4.7",
          "tool_call": true
        },
        "anthropic/claude-opus-4-6": {
          "name": "Capriole Opus 4.6",
          "tool_call": true
        },
        "anthropic/claude-sonnet-4-6": {
          "name": "Capriole Sonnet 4.6",
          "tool_call": true
        },
        "google/gemini-3.1-pro-preview": {
          "name": "Capriole Gemini 3.1 Pro Preview",
          "tool_call": true,
          "reasoning": true
        },
        "google/gemini-3.5-flash": {
          "name": "Capriole Gemini 3.5 Flash",
          "tool_call": false,
          "reasoning": true
        }
      }
    }
  }
}

Executar Kilo Code

Defina sua API key e inicie o Kilo no diretório do projeto:

export CAPRIOLE_AI_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"
kilo

Inicie com um modelo específico:

kilo -m openai-compatible/openai-latest
kilo -m openai-compatible/claude-latest
kilo -m openai-compatible/google-latest
kilo -m openai-compatible/openai/gpt-5.5
kilo -m openai-compatible/openai/gpt-5.4-mini
kilo -m openai-compatible/anthropic/claude-fable-5
kilo -m openai-compatible/anthropic/claude-opus-5
kilo -m openai-compatible/anthropic/claude-opus-4-8
kilo -m openai-compatible/anthropic/claude-opus-4-7
kilo -m openai-compatible/google/gemini-3.1-pro-preview
kilo -m openai-compatible/google/gemini-3.5-flash
kilo -m openai-compatible/moonshot/kimi-k3

Execute uma solicitação pontual com Gemini 3.5 Flash:

kilo run --agent ask -m openai-compatible/google/gemini-3.5-flash "Summarize this project."

Para uma solicitação pontual na CLI, passe um prompt para kilo run:

export CAPRIOLE_AI_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"
kilo run -m openai-compatible/openai-latest "Explain this repository structure."

Modelos suportados

Comece com openai-latest em configurações novas do Kilo Code. Use claude-latest ou google-latest quando quiser que a Capriole AI roteie para o modelo principal Claude ou Gemini que recomendamos, e use um ID de modelo concreto quando precisar de uma versão exata. A documentação do Kilo usa a mesma ordem de famílias do seletor de modelos da Capriole AI: OpenAI, Anthropic e depois Google. As integrações da API pública excluem predefinições exclusivas do chat na web, como Fable 5 Thinking e Opus 5 Thinking.

openai-latest
openai/gpt-5.6-terra
openai/gpt-5.6-luna
openai/gpt-5.5
openai/gpt-5.4-mini
claude-latest
anthropic/claude-fable-5
anthropic/claude-opus-5
anthropic/claude-opus-4-8
anthropic/claude-opus-4-7
anthropic/claude-opus-4-6
anthropic/claude-sonnet-4-6
google-latest
google/gemini-3.1-pro-preview
google/gemini-3.5-flash
xai/grok-4.5
zai/glm-5.2
moonshot/kimi-k3

Mantenha "tool_call": false para Gemini 3.5 Flash no Kilo Code. A Capriole AI suporta chamadas de ferramenta simples de Chat Completions para este modelo, e o Kilo Code pode executar fluxos de ferramenta locais com esta configuração, mas ativar declarações nativas de função do Gemini ainda pode expor o subconjunto mais estreito de schema OpenAPI do Gemini. Outros IDs públicos de modelo compatíveis com Chat Completions retornados por GET /v1/models também podem ser configurados quando você quiser testá-los. Valide o uso de ferramentas antes de usar um modelo em fluxos de edição de código.

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.

Qual arquivo de configuração devo editar?

Use ~/.config/kilo/kilo.jsonc para a Kilo CLI e a extensão do VS Code atuais. Execute kilo config check depois de editá-lo.

Por que as solicitações falham com erros de endpoint?

Confirme que baseURL é https://api.caprioletech.com/v1. O Kilo envia solicitações de Chat Completions para /v1/chat/completions.

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

Confirme que o modelo selecionado usa o formato openai-compatible/<model-id> e que provider.openai-compatible.models contém a entrada correspondente. Por exemplo, openai-compatible/openai-latest mapeia para a chave de configuração openai-latest.

Por que o uso de ferramentas falha?

Para entradas de GPT, Claude, Gemini 3.1 Pro e aliases latest, confirme que a entrada do modelo inclui "tool_call": true. O Kilo Code executa ferramentas localmente e envia solicitações de acompanhamento de Chat Completions para a Capriole AI. Para Gemini 3.5 Flash, mantenha "tool_call": false. O Gemini suporta chamada de função, mas as declarações de função usam um subconjunto suportado do schema OpenAPI. Alguns schemas nativos de ferramenta são mais amplos do que esse subconjunto.

Observações

A Capriole AI expõe o Kilo Code por POST /v1/chat/completions.
O Kilo Code executa ferramentas de programação localmente. A Capriole AI só trata a solicitação de modelo.
O Kilo Code 7.3.16 conclui uma chamada de ferramenta bash com streaming e o turno seguinte do assistente com Kimi K3.
Comece com a configuração mínima do provedor. Adicione limites de modelo do Kilo ou outras opções de modelo só quando quiser gerenciar o contexto no lado do cliente.
Referências oficiais: Provedor OpenAI Compatible do Kilo, Configurações do Kilo, Modelos personalizados do Kilo, Kilo CLI e Chamada de função do Gemini.

Primeiros passos

Endpoints

Integração com agentes

O que é Kilo Code

Pré-requisitos

Instalação

Extensão do VS Code

Kilo CLI

Configuração

Executar Kilo Code

Modelos suportados

Solução de problemas

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

Qual arquivo de configuração devo editar?

Por que as solicitações falham com erros de endpoint?

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

Por que o uso de ferramentas falha?

Observações

​O que é Kilo Code

​Pré-requisitos

​Instalação

​Extensão do VS Code

​Kilo CLI

​Configuração

​Executar Kilo Code

​Modelos suportados

​Solução de problemas

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

​Qual arquivo de configuração devo editar?

​Por que as solicitações falham com erros de endpoint?

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

​Por que o uso de ferramentas falha?

​Observações

O que é Kilo Code

Pré-requisitos

Instalação

Extensão do VS Code

Kilo CLI

Configuração

Executar Kilo Code

Modelos suportados

Solução de problemas

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

Qual arquivo de configuração devo editar?

Por que as solicitações falham com erros de endpoint?

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

Por que o uso de ferramentas falha?

Observações