> ## Documentation Index
> Fetch the complete documentation index at: https://docs.capriole.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kilo Code

> Configure o Kilo Code para usar a Capriole AI.

## 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](https://capriole.ai))
* Uma API key da Capriole AI ([Obtenha sua key](https://capriole.ai?view=api))
* 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

```bash theme={null}
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:

```jsonc theme={null}
{
  "$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:

```bash theme={null}
export CAPRIOLE_AI_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"
kilo
```

Inicie com um modelo específico:

```bash theme={null}
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:

```bash theme={null}
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`:

```bash theme={null}
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](https://kilo.ai/docs/ai-providers/openai-compatible), [Configurações do Kilo](https://kilo.ai/docs/getting-started/settings), [Modelos personalizados do Kilo](https://kilo.ai/docs/code-with-ai/agents/custom-models), [Kilo CLI](https://kilo.ai/docs/cli) e [Chamada de função do Gemini](https://ai.google.dev/gemini-api/docs/function-calling).