O que é OpenCode
O OpenCode é um agente de programação com IA de código aberto, disponível como interface de terminal, aplicativo de desktop e extensão de IDE. 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
O OpenCode 2 e o OpenCode 1 usam o mesmo comandoopencode, então só um deles fica instalado por vez. Instale o OpenCode 2 com o script oficial de instalação:
opencode upgrade --major. O script https://opencode.ai/install e o pacote npm opencode-ai continuam instalando o OpenCode 1.
Verifique a instalação:
Configuração
Validação dos modelos
O OpenCode 2.2.5 passa nas verificações de leitura de arquivo e resposta final pela Capriole AI com todos os modelos da seção Modelos suportados, usando a configuração do OpenCode 2. O OpenCode 1.19.3 passa nas verificações de leitura de arquivo, escrita de arquivo e resposta final com a configuração do OpenCode 1.OpenCode 2
Crie ou atualize~/.config/opencode/opencode.json:
package: "@opencode/ai/providers/openai-compatible"é o pacote padrão do provedor, então Gemini, Grok, GLM e Kimi usam Chat Completions.- Cada modelo GPT substitui
packagepor@opencode/ai/providers/openai-compatible/responses, que usa a API Responses. Cada modelo Claude o substitui por@opencode/ai/providers/anthropic-compatible, que usa Anthropic Messages. envindica a variável que guarda sua key. O cabeçalhoAuthorizationenvia a key como Bearer token em todos os pacotes.reasoningEffortdá a cada modelo GPT um nível de raciocínio padrão. Sem ele, os modelos GPT respondem sem raciocinar.baseURLinclui/v1em todos os pacotes.limitinforma ao OpenCode a janela de contexto e o limite de saída de cada modelo.agents.titledefine o modelo que o OpenCode usa para títulos de sessão.
OpenCode 1
O OpenCode 1 não lê o formato do OpenCode 2, mas o OpenCode 2 lê este, então uma configuração do OpenCode 1 continua funcionando depois da atualização. Crie ou atualize~/.config/opencode/opencode.json:
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.npmpor@ai-sdk/openai, que usa a API Responses. Cada modelo Claude o substitui por@ai-sdk/anthropic, que usa Anthropic Messages. baseURLinclui/v1em todos os pacotes.{env:CAPRIOLE_AI_API_KEY}lê sua key do ambiente. O cabeçalhoAuthorizationa envia como Bearer token em todos os pacotes.limitinforma ao OpenCode a janela de contexto e o limite de saída de cada modelo, para que ele acompanhe o contexto e compacte a sessão a tempo.small_modelé o modelo que o OpenCode usa para tarefas leves, como títulos de sessão.
Executar OpenCode
Defina sua API key e inicie o OpenCode no diretório do projeto:opencode service restart faz com que ele pegue a key que você acabou de definir. No OpenCode 1, pule esta etapa.
Use /models para trocar de modelo. Para uma execução não interativa, use opencode run:
Modelos suportados
As referências de modelo usam o formatocapriole-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 OpenCode retorna um erro de autenticação?
Confirme queCAPRIOLE_AI_API_KEY está exportada no mesmo shell antes de iniciar o OpenCode e que o cabeçalho Authorization está presente em headers (OpenCode 2) ou options.headers (OpenCode 1). Se o OpenCode 2 retornar Missing Bearer token, o serviço em segundo plano dele iniciou sem a key: execute opencode service restart nesse shell.
Por que as solicitações Claude falham com Unsupported Claude Messages model?
Os modelos Claude que usam o pacote 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 as solicitações GPT falham?
Confirme que cada modelo GPT tem"package": "@opencode/ai/providers/openai-compatible/responses" (OpenCode 2) ou "provider": { "npm": "@ai-sdk/openai" } (OpenCode 1), para que as solicitações dele usem a API Responses.
Por que os modelos da Capriole AI não aparecem?
Confirme que a referência do modelo usacapriole-ai/<model-id>, como capriole-ai/moonshot/kimi-k3, e que disabled_providers não bloqueia capriole-ai. O OpenCode 1 ignora o formato providers do OpenCode 2.
Por que as mudanças de configuração não se aplicam?
Verifique se há umopencode.json no nível do projeto ou uma sobreposição de OPENCODE_CONFIG e reinicie o OpenCode.
Por que aparecem erros de pacote do provedor?
Limpe~/.cache/opencode e reinicie o OpenCode para que ele reinstale os pacotes do provedor.
Observações
- Mantenha sua key no ambiente. Não a cole em
opencode.json. - 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/modelslista 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 do OpenCode 2: instalação, migração do OpenCode 1, provedores, modelos, serviço em segundo plano e versões.
- Referências do OpenCode 1: instalação, configuração, provedores, modelos e solução de problemas.

