Como adiciono um fornecedor personalizado ao OpenCode?

Execute /connect, escolha Other e guarde a sua chave sob um ID de fornecedor, depois adicione ao opencode.json um provider com esse ID, com npm definido como @ai-sdk/openai-compatible e options.baseURL definido como https://aigrow.gg/v1.

Onde é que o OpenCode guarda a chave?

Em ~/.local/share/opencode/auth.json depois de /connect. opencode auth list mostra quais os fornecedores que têm uma.

Que pacote npm usa o fornecedor?

@ai-sdk/openai-compatible, que chama /v1/chat/completions. @ai-sdk/openai chama /v1/responses, que o endpoint não serve.

OpenCode com um fornecedor personalizado

Adicione este fornecedor ao opencode.json e indique a sua chave com /connect, e o OpenCode passa a funcionar com modelos Claude, GPT e Grok através da sua chave AIGROW.

Comprar crédito de API

Já tem um código? Resgate-o em Acesso à API e depois crie uma chave.

opencode.json no seu projeto

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aigrow": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AIGROW",
      "options": { "baseURL": "https://aigrow.gg/v1" },
      "models": { "claude-opus-5.5": { "name": "Claude Opus 5.5" } }
    }
  }
}

Substitua ag_your_key_here por uma chave de Acesso à API.

Onde fica a definição

Um projeto: opencode.json
Todos os projetos: ~/.config/opencode/opencode.json
A chave, depois de /connect: ~/.local/share/opencode/auth.json

Guarde a chaveNo OpenCode, execute /connect, desça até Other e introduza aigrow como ID do fornecedor.

Cole a sua chaveCole a sua chave AIGROW quando o OpenCode a pedir.

Adicione o fornecedorColoque o bloco no opencode.json. O ID do fornecedor no ficheiro tem de coincidir com o que escreveu em /connect.

Mais modelos e um predefinido

Liste todos os modelos que quer no seletor e defina model para que o OpenCode arranque com um deles.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aigrow": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AIGROW",
      "options": { "baseURL": "https://aigrow.gg/v1" },
      "models": {
        "claude-opus-5.5": { "name": "Claude Opus 5.5" },
        "grok-4.7": { "name": "Grok 4.7" },
        "gpt-6-astra": { "name": "GPT-6 Astra" }
      }
    }
  },
  "model": "aigrow/claude-opus-5.5"
}

Que modelo usar

Introduza o id exatamente como está escrito aqui.

Claude Opus 5.5claude-opus-5.5: A opção predefinida em todos os blocos desta página e o modelo Claude mais barato aqui por token enviado e recebido. Contexto: 1 000 000 tokens.
Grok 4.7grok-4.7: O preço de saída mais baixo aqui. O seu contexto tem metade do tamanho dos modelos Claude. Contexto: 500 000 tokens.
GPT-6 Astragpt-6-astra: Para um modelo GPT. Custa o mesmo por token que o Fable e mais do que o Opus. Contexto: 1 050 000 tokens.
Claude Fable 5.1claude-fable-5.1: Custa mais por token do que o Opus. Compare os dois no ranking de programação antes de mudar. Contexto: 1 000 000 tokens.

A lista de preços tem todos os ids e a respetiva taxa de crédito, os preços da API do Claude indicam os preços de tabela e o ranking de programação compara os modelos em prompts de programação.

Verifique se funciona

Primeiro a chave isolada, depois o OpenCode com ela.

A chave

Peça a lista de modelos. Requer uma chave válida e não custa nada.

curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"

Uma chave válida devolve a lista:

{
  "object": "list",
  "data": [
    { "id": "claude-opus-5.5", "object": "model", ... },
    { "id": "claude-fable-5.1", "object": "model", ... },
    { "id": "gpt-6-astra", "object": "model", ... },
    { "id": "claude-sonnet-5.5", "object": "model", ... },
    { "id": "gpt-6.1-sol", "object": "model", ... },
    { "id": "grok-4.7", "object": "model", ... },
    ...
  ],
  "has_more": false
}

OpenCode

Execute /models, escolha um modelo em AIGROW e envie este prompt.

Reply with the word ready

Uma configuração a funcionar responde na sessão:

ready

Quando falha

Primeiro os erros do OpenCode, depois as respostas que o endpoint dá a qualquer ferramenta.

O fornecedor não tem chave: Execute opencode auth list. Se aigrow não aparecer, execute /connect novamente e verifique se o ID coincide com o do opencode.json.
404 com @ai-sdk/openai: Esse pacote chama a Responses API, que o endpoint não disponibiliza. Use @ai-sdk/openai-compatible, como no bloco.
A minha ferramenta indica 401 ou erro de autenticação: A chave está em falta ou foi escrita incorretamente. Copie-a de novo em Acesso à API no painel e certifique-se de que é enviada como chave, e não como nome de modelo. Uma chave revogada falha da mesma forma: crie uma nova e substitua-a.
Recebo 402 ou uma mensagem sobre crédito: O seu saldo está vazio. Abra Acesso à API no painel, resgate um código ou compre outro pacote e o pedido seguinte será processado. Não é preciso mudar mais nada.
Aparece 404 ou Unknown model: O modelo tem de ser um dos que o endpoint disponibiliza, por exemplo claude-opus-5.5. A grafia própria do fornecedor também funciona (claude-opus-5-5, anthropic/claude-opus-5.5), mas um id com data ou qualquer modelo fora do catálogo é rejeitado antes de o pedido ser encaminhado e nada é cobrado. Peça GET /v1/models com a sua chave para obter a lista atual, ou consulte os ids na lista de preços.
Os pedidos são rejeitados com 429: A capacidade do endpoint é partilhada por todos os clientes: cerca de 20 pedidos por minuto e 4 em simultâneo. Cada resposta 429 inclui um cabeçalho retry-after, e os SDKs da OpenAI e da Anthropic esperam esse tempo e voltam a tentar por conta própria. Num ciclo seu, aguarde os segundos indicados ou reduza a concorrência.
O modelo está indisponível neste momento: Um 404 que indica que o modelo não está disponível neste momento significa que ele está brevemente em baixo no fornecedor de origem, e não um problema com a sua chave ou saldo. Tente novamente daqui a pouco ou envie o pedido para outro modelo.
Recebo um 502 ou 503: Uma falha transitória na origem ou na configuração, sem qualquer cobrança no seu saldo. Repita o pedido; se continuar a falhar, contacte-nos através da loja e vamos analisar.

O que não funciona através da AIGROW

O pacote @ai-sdk/openai, que chama /v1/responses. Todos os modelos aqui funcionam com @ai-sdk/openai-compatible.
Pesquisa web em tempo real dentro do modelo. Uma ferramenta de pesquisa web enviada num pedido é respondida com o que o modelo já sabe, sem resultados em tempo real. Uma ferramenta que obtém páginas na sua própria máquina continua a funcionar.
Qualquer endpoint além destes três: /v1/messages, /v1/chat/completions e /v1/models. A Responses API, os embeddings e a contagem de tokens respondem 404.
Campos de router como models, route, provider e plugins. São descartados, por isso um pedido vai sempre para o único modelo que indica.

Quanto custa um mês de OpenCode

O OpenCode é faturado por token às taxas de crédito da lista de preços. Um agente volta a enviar a conversa inteira a cada passo, por isso uma tarefa longa custa mais do que a última mensagem sugere; o registo de atividade em Acesso à API mostra quanto custou cada pedido.

Perguntas sobre o OpenCode e uma API personalizada

Como adiciono um fornecedor personalizado ao OpenCode?: Execute /connect, escolha Other e guarde a sua chave sob um ID de fornecedor, depois adicione ao opencode.json um provider com esse ID, com npm definido como @ai-sdk/openai-compatible e options.baseURL definido como https://aigrow.gg/v1.
Onde é que o OpenCode guarda a chave?: Em ~/.local/share/opencode/auth.json depois de /connect. opencode auth list mostra quais os fornecedores que têm uma.
Que pacote npm usa o fornecedor?: @ai-sdk/openai-compatible, que chama /v1/chat/completions. @ai-sdk/openai chama /v1/responses, que o endpoint não serve.

Fontes: OpenCode Providers · OpenCode Config. Consultado em 21 de outubro de 2026.

Configurar outra ferramenta

Claude CodeProtocolo Anthropic
Quatro variáveis de ambiente, na shell ou no settings.json.
ClineProtocolo OpenAI
O fornecedor OpenAI Compatible, quatro campos no ecrã de definições.
Roo CodeProtocolo OpenAI
O fornecedor OpenAI Compatible, os mesmos campos do Cline.
Kilo CodeProtocolo OpenAI
Um fornecedor personalizado no separador Providers; a lista de modelos preenche-se sozinha.
ContinueProtocolo OpenAI
Uma entrada models no config.yaml, com provider openai e um apiBase.
AiderProtocolo OpenAI
OPENAI_API_BASE e OPENAI_API_KEY, depois openai/ antes do ID do modelo.
ZedProtocolos Anthropic e OpenAI
Um fornecedor compatível com Anthropic para Claude, um compatível com OpenAI para GPT e Grok.
GooseProtocolo OpenAI
O fornecedor OpenAI com OPENAI_HOST, ou um ficheiro de fornecedor personalizado.
Vercel AI SDKProtocolos Anthropic e OpenAI
O fornecedor OpenAI Compatible para todos os modelos, ou o fornecedor Anthropic para o Claude.
OpenAI Agents SDKProtocolo OpenAI
O seu próprio cliente AsyncOpenAI, mudado para chat completions, com o tracing desativado.
LangChainProtocolos Anthropic e OpenAI
ChatOpenAI com base_url para todos os modelos, ou ChatAnthropic para o Claude.

O guia da API inclui os SDKs, o curl, os endpoints e os limites de utilização.

Cole o bloco e o OpenCode passa a funcionar com o seu crédito.

Compre um pacote de crédito, resgate o código do seu email em Acesso à API, crie uma chave e coloque-a no lugar de ag_your_key_here.

Comprar crédito de API Ver preços e modelos