Configuração do OpenCode para Claude: configuração do opencode.json, modelos e erros comuns

OpenCode lê suas configurações de opencode.json. Para executá-lo com Claude por este gateway, você altera um único valor, o campo do provedor Anthropic baseURL, e fornece uma chave. Abaixo estão duas configurações funcionais, os ajustes de modelo e contexto que importam e as correções para os erros que usuários do OpenCode encontram neste gateway, extraídos dos nossos próprios logs de solicitações.

Onde fica opencode.json

OpenCode mescla uma configuração global com uma configuração por projeto: ~/.config/opencode/opencode.json para as configurações que você deseja usar em todos os lugares, e opencode.json na raiz de um projeto para esse repositório. Adicionar a linha $schema oferece preenchimento automático e validação na maioria dos editores.

Mantenha a chave fora do arquivo. Coloque-a em uma variável de ambiente e faça referência a ela como {env:AIPRIME_API_KEY}. As chaves que você adiciona com /connect dentro do OpenCode são armazenadas em ~/.local/share/opencode/auth.json; opencode auth list mostra o que está armazenado ali.

export AIPRIME_API_KEY=your_gateway_key   # add to ~/.bashrc or ~/.zshrc
opencode auth list                         # credentials OpenCode already knows about

Opção 1: aponte o provedor Anthropic integrado para o gateway

A menor alteração: mantenha o próprio provedor Anthropic do OpenCode e sua lista de modelos e substitua o destino das solicitações.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://aiprimetech.io/v1",
        "apiKey": "{env:AIPRIME_API_KEY}"
      }
    }
  },
  "model": "anthropic/claude-sonnet-5",
  "small_model": "anthropic/claude-haiku-4-5"
}

Opção 2: um provedor personalizado com sua própria lista de modelos

Uma entrada de provedor separada mantém o gateway independente de qualquer login da Anthropic, permite listar exatamente os modelos que você quer no seletor e definir limites de contexto por modelo.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aiprime": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Prime Tech",
      "options": {
        "baseURL": "https://aiprimetech.io/v1",
        "apiKey": "{env:AIPRIME_API_KEY}"
      },
      "models": {
        "claude-sonnet-5":  { "name": "Claude Sonnet 5",  "limit": { "context": 200000, "output": 64000 } },
        "claude-opus-5-5":  { "name": "Claude Opus 5.5",  "limit": { "context": 200000, "output": 64000 } },
        "claude-haiku-4-5": { "name": "Claude Haiku 4.5", "limit": { "context": 200000, "output": 32000 } }
      }
    }
  },
  "model": "aiprime/claude-sonnet-5",
  "small_model": "aiprime/claude-haiku-4-5"
}

Prefira @ai-sdk/anthropic para Claude: usa a API Messages nativa, de modo que o cache de prompts e o raciocínio funcionam como a Anthropic os projetou. O gateway também oferece o formato da OpenAI, então @ai-sdk/openai-compatible com a mesma https://aiprimetech.io/v1 URL base também funciona, e esse é o caminho a usar para modelos GPT com a mesma chave.

Modelos e limites de contexto

model é o que o agente principal usa; small_model cuida de tarefas auxiliares de baixo custo, como títulos de sessões. O limit.context número informa ao OpenCode quando compactar a sessão. Se uma sessão longa falhar com prompt is too long, reduza esse valor (200000 é um valor seguro) para que o OpenCode resuma mais cedo, em vez de enviar mais do que o endpoint aceita.

Os IDs dos modelos são strings exatas. Nomes antigos como claude-3-5-sonnet-20241022 ou versões com data não são disponibilizados; use os IDs acima ou a lista no seu painel.

Verifique a chave e a URL antes de iniciar o OpenCode

Uma solicitação pelo terminal informa se a chave e a URL estão corretas, independentemente da configuração do OpenCode:

curl -s https://aiprimetech.io/v1/messages \
  -H "x-api-key: $AIPRIME_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":20,"messages":[{"role":"user","content":"ping"}]}'

Uma resposta JSON com um content array significa que está tudo certo do lado do gateway e que qualquer problema restante está em opencode.json. Invalid API key significa que a variável está vazia ou contém a chave errada.

Solução de problemas: erros encontrados por usuários do OpenCode

Estes são os erros mais frequentes ao usar o OpenCode neste gateway, com a solução para cada um.

Para erros que vêm do lado do modelo, e não do cliente, consulte guia de erros da API do Claude.

Perguntas frequentes

AI Prime Tech é um gateway de API independente. Não tem afiliação com a Anthropic, não é endossado por ela e não é seu revendedor. Claude e os nomes dos modelos relacionados são marcas comerciais de seus respectivos proprietários.