Resposta curta
Para usar o OpenCode com a APIVAI, execute /connect, escolha Other, informe o ID de provedor apivai e cole sua chave da APIVAI; depois adicione um provedor apivai ao opencode.json com "npm": "@ai-sdk/openai-compatible" e "baseURL": "https://api.apivai.com/v1", liste IDs de modelo como claude-sonnet-4-6 e gpt-5.5 e escolha apivai/claude-sonnet-4-6 com /models. Para usar o Claude no formato nativo, você pode, em vez disso, apontar o provedor embutido anthropic para https://api.apivai.com/v1; no OpenCode essa URL mantém o /v1, porque o SDK da Anthropic que ele usa só acrescenta /messages. Em 2026-10-10, o Claude Sonnet 4.6 custa $1.15 / $5.74 por milhão de tokens de entrada / saída pela APIVAI, contra $3.00 / $15.00 no preço oficial. Você paga por token a partir de um saldo pré-pago, sem assinatura.
O que é o OpenCode e por que conectá-lo à sua própria API?
O OpenCode é um agente de programação com IA, de código aberto, que roda no terminal. Ele lê o projeto, edita arquivos, executa comandos e resolve uma tarefa passo a passo. O OpenCode é construído sobre o AI SDK e conversa com muitos provedores, incluindo qualquer API compatível com OpenAI, então você decide para onde vão as requisições ao modelo e quem as cobra.
A APIVAI oferece uma única chave para modelos Claude e GPT, cobrada por token (abaixo dos preços oficiais na maioria dos modelos), a partir de um saldo que você recarrega quando precisar. A mesma chave funciona no formato da OpenAI e no da Anthropic, então serve para as duas configurações abaixo.
Qual configuração de provedor usar no OpenCode?
| Provedor personalizado (compatível com OpenAI) | Provedor embutido anthropic | |
|---|---|---|
Pacote npm | @ai-sdk/openai-compatible | embutido (SDK da Anthropic) |
baseURL | https://api.apivai.com/v1 | https://api.apivai.com/v1 |
| Modelos | Claude e GPT | Só Claude |
| O que o OpenCode chama | /v1/chat/completions | /v1/messages |
| Melhor para | Um provedor para todos os modelos | Claude no formato nativo Messages |
Comece pelo provedor personalizado: ele cobre Claude e GPT, e você controla exatamente quais IDs de modelo aparecem no seletor. Use o provedor embutido anthropic se você usa só o Claude e quer a integração nativa do OpenCode com ele. Lembre que, ao sobrescrever anthropic, todas as requisições desse provedor vão para a APIVAI.
Como configurar o OpenCode com a APIVAI passo a passo?
Passo 1: Crie uma chave da APIVAI
- Cadastre-se em apivai.com com seu e-mail.
- Recarregue o saldo a partir de $10 com cartão, cripto, Alipay ou WeChat Pay. Não há teste grátis: você paga só pelo que usar.
- Abra o Dashboard, crie uma chave e copie. Você pode definir um limite de orçamento próprio para a chave, para que o agente nunca gaste mais do que o planejado.
Passo 2: Salve a chave com /connect
- Inicie o OpenCode no seu projeto e digite
/connect. - Role até Other e selecione.
- Informe o ID de provedor
apivai. Você vai usar exatamente esse ID no arquivo de configuração. - Cole sua chave da APIVAI quando ele pedir a chave de API.
O OpenCode guarda a chave em ~/.local/share/opencode/auth.json. O mesmo fluxo existe fora da TUI com opencode auth login. Se preferir uma variável de ambiente, pule este passo e adicione "apiKey": "{env:APIVAI_API_KEY}" às options do provedor abaixo.
Passo 3: Adicione o provedor ao opencode.json
Coloque isto no opencode.json na raiz do projeto, ou em ~/.config/opencode/opencode.json para usar em todos os projetos:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"apivai": {
"npm": "@ai-sdk/openai-compatible",
"name": "APIVAI",
"options": {
"baseURL": "https://api.apivai.com/v1"
},
"models": {
"claude-sonnet-4-6": {
"name": "Claude Sonnet 4.6",
"limit": { "context": 200000, "output": 16384 }
},
"claude-haiku-4-5": {
"name": "Claude Haiku 4.5",
"limit": { "context": 200000, "output": 16384 }
},
"gpt-5.5": {
"name": "GPT-5.5",
"limit": { "context": 128000, "output": 16384 }
}
}
}
},
"model": "apivai/claude-sonnet-4-6",
"small_model": "apivai/claude-haiku-4-5"
}| Chave | Valor |
|---|---|
ID em provider | apivai (o mesmo ID informado no /connect) |
npm | @ai-sdk/openai-compatible |
options.baseURL | https://api.apivai.com/v1 |
Chaves de models | IDs de modelo exatos, ex.: claude-sonnet-4-6 |
limit.output | 8192 ou mais (no mínimo 4096) |
model | apivai/claude-sonnet-4-6 |
A baseURL deve terminar em /v1 uma única vez: o pacote acrescenta /chat/completions. As chaves dentro de models são os IDs enviados à APIVAI, e name é só o rótulo no seletor. limit informa ao OpenCode quanto contexto resta e qual pode ser o tamanho de uma resposta. small_model é usado em trabalhos leves, como gerar títulos de sessão, então um modelo barato serve bem ali.
Para ver quais IDs de modelo a sua chave pode usar, execute:
curl https://api.apivai.com/v1/models \ -H "Authorization: Bearer YOUR_APIVAI_KEY"
A lista de modelos muda com o tempo, então copie os IDs dessa resposta ou da página de preços, e não de tutoriais antigos. Reinicie o OpenCode, execute /models e escolha um modelo em APIVAI.
Passo 4 (opcional): Use o provedor Anthropic embutido para o Claude
- Execute
/connect, selecione Anthropic, escolha Manually enter API Key e cole sua chave da APIVAI. - Adicione a URL base ao
opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"anthropic": {
"options": {
"baseURL": "https://api.apivai.com/v1"
}
}
}
}Aqui o /v1 fica. É o contrário de ferramentas como o Claude Code: o SDK da Anthropic no OpenCode trata baseURL como um prefixo que já inclui /v1 (o padrão é https://api.anthropic.com/v1) e só acrescenta /messages. Informar https://api.apivai.com sem /v1 chamaria /messages e daria 404. Escolha os modelos Claude na lista da Anthropic em /models; se faltar o ID que você quer, adicione-o em provider.anthropic.models. Há mais detalhes sobre esse formato na página do proxy da API do Claude.
Qual modelo escolher no OpenCode?
Um agente de programação envia muitas requisições por tarefa, então o preço por token importa. Preços por 1M de tokens de entrada / saída em 2026-10-10:
| ID do modelo | Preço (entrada / saída) | Para quê |
|---|---|---|
claude-sonnet-4-6 | $1.15 / $5.74 | Padrão para o dia a dia |
claude-sonnet-5-5 | $0.77 / $3.82 | Dia a dia, Sonnet mais novo |
claude-opus-5-5 | $1.54 / $7.65 | Bugs difíceis, grandes refatorações |
claude-haiku-4-5 | $0.38 / $1.92 | small_model, edições rápidas |
gpt-5.5 | $0.77 / $4.56 | Alternativa GPT, segunda opinião |
gpt-6-luna | $0.0144 / $0.0768 | Tarefas simples muito baratas |
Um esquema prático: Claude Sonnet 4.6 ou Claude Sonnet 5.5 como model, Claude Haiku 4.5 como small_model e Claude Opus 5.5 quando uma tarefa falha repetidamente. Os modelos GPT só funcionam pelo provedor personalizado compatível com OpenAI.
Quanto custa o OpenCode com a APIVAI?
Cada passo de uma tarefa reenvia a sessão e os arquivos que o agente já leu, então os tokens de entrada se acumulam rápido. Dois exemplos realistas com o Claude Sonnet 4.6:
- Uma tarefa média, como adicionar um recurso que mexe em alguns arquivos: cerca de 25 requisições de 30.000 tokens de entrada e 2.000 de saída cada. Custo: $1.15 com a APIVAI, $3.00 no preço oficial.
- Um mês de trabalho com três tarefas dessas por dia durante 22 dias (1.650 requisições): $75.87 com a APIVAI, $198 no preço oficial.
O mesmo mês com o Claude Haiku 4.5 custaria $25.15. Essas estimativas não consideram o cache de prompts e incluem os tokens de raciocínio no número de saída, já que são cobrados como saída. O Dashboard lista cada requisição com tokens e custo, então em um dia você pode trocar essas suposições pelos seus próprios números. Para uma comparação mais ampla, veja os preços da API do Claude em 2026.
Como resolver os erros mais comuns do OpenCode?
- 401 Unauthorized: execute
opencode auth liste confira se existe uma credencial paraapivai. O ID usado no/connectdeve ser exatamente igual ao ID do provedor noopencode.json. Verifique também se a chave não foi excluída nem esgotou o orçamento. - 404 Not Found: confira
options.baseURL. As duas configurações usamhttps://api.apivai.com/v1, sem/chat/completionsou/messagesno final e sem/v1duplicado. - Modelo não encontrado: a chave dentro de
modelsdeve ser um ID exato, comoclaude-sonnet-4-6. Confira comGET /v1/models. - Provedor ou modelos não aparecem em /models: o valor de
npmdeve ser@ai-sdk/openai-compatiblee o JSON precisa ser válido. Reinicie o OpenCode depois de editar o arquivo. - Respostas vazias ou cortadas: o raciocínio vem ativado por padrão e consome tokens de saída. Aumente
limit.outputpara 8192 ou mais (no mínimo 4096). - 429 Too Many Requests: o limite padrão é de 60 requisições por minuto por chave. Tarefas longas do agente podem atingi-lo; espere um pouco ou peça ao suporte para aumentar o limite.
As regras gerais de cada formato estão na página de API compatível com OpenAI e na documentação.
Perguntas frequentes
Posso usar Claude e GPT no OpenCode com uma única chave?
Sim. Liste os dois IDs de modelo no provedor apivai e alterne entre eles com /models.
Qual baseURL informar no OpenCode?
https://api.apivai.com/v1 nas duas configurações. O pacote compatível com OpenAI acrescenta /chat/completions e o SDK da Anthropic acrescenta /messages.
Onde deve ficar o opencode.json?
Na raiz do projeto, para um único projeto, ou em ~/.config/opencode/opencode.json, para todos. A configuração do projeto tem prioridade sobre a global.
A APIVAI armazena meu código?
Não. O conteúdo das requisições e respostas não é registrado. Só ficam guardados dados de uso como modelo, tokens e custo, para a cobrança.
Posso usar a mesma chave em outras ferramentas?
Sim. A mesma chave funciona no Aider, no Claude Code e em editores como o Zed. Criar uma chave por ferramenta deixa o Dashboard mais fácil de ler.
Crie uma conta, recarregue a partir de $10 e cole sua chave no OpenCode.