Configuração de Coding Agents

OpenCode: modelos próprios, API Key e Base URL

Conecte o OpenCode ao Chat Completions compatível com OpenAI do BetterToken usando /connect, opencode.json, uma API Key, a Base URL e um Model ID. Na prática.

O OpenCode se conecta ao BetterToken com @ai-sdk/openai-compatible. Nomeie o provedor do OpenCode como BetterToken ou OpenAI Compatible. Use esta página para a configuração geral de API Key, Base URL ou opencode.json. Consulte o guia do GLM ou o guia do Kimi K3 ao selecionar e verificar um desses modelos. Copie o Model ID exato da model plaza.

Configurações principais

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Modelo	`YOUR_MODEL_ID`

Pré-requisitos

Instale o OpenCode 1 com os comandos abaixo
Crie uma BetterToken API Key
Copie um Model ID do model plaza ou da janela Setup da chave

Cadastre-se e obtenha uma BetterToken API Key

Já tem uma conta? Entre, recarregue o saldo e crie uma chave no console.

Instalar

Estes comandos instalam o OpenCode 1. Para OpenCode 2, use o guia de instalação. O OpenCode 2 lê as configurações existentes nos mesmos locais e converte as configurações de provedor V1 compatíveis; consulte o guia de migração antes de alterar a sintaxe de configuração.

curl

curl -fsSL https://opencode.ai/install | bash

npm

npm install -g opencode-ai

Configuração pela linha de comando

O script de configuração automática do BetterToken cria ou atualiza o provedor BetterToken no OpenCode. Ele requer Node.js. Se você não informar uma API Key ou um Model ID como argumento, o script solicitará esses dados.

macOS / Linux

curl -fsSL "https://bettertoken.ai/install-opencode-provider.sh" | bash

Windows

iwr "https://bettertoken.ai/install-opencode-provider.ps1" -OutFile "$env:TEMP\install-opencode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-opencode-provider.ps1"

Selecione bettertoken/YOUR_MODEL_ID quando o script terminar. Se o OpenCode já estiver em execução, reinicie-o antes de testar.

Configuração manual

Opção 1: salvar as credenciais com /connect

Inicie o OpenCode e execute:

/connect

Escolha Other, informe bettertoken como identificador do provedor e depois insira YOUR_API_KEY. O OpenCode armazena a credencial localmente.

Opção 2: configurar o JSON

O arquivo global é ~/.config/opencode/opencode.json. Um projeto pode usar opencode.json no diretório raiz.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "bettertoken/YOUR_MODEL_ID",
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://bettertoken.ai/v1"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID"
        }
      }
    }
  }
}

Se você não usar /connect, adicione "apiKey": "YOUR_API_KEY" em options. Nunca faça commit de uma configuração que contenha uma chave real.

Este exemplo usa @ai-sdk/openai-compatible para Chat Completions. O pacote SDK deve corresponder ao protocolo do endpoint; consulte as orientações oficiais para provedores antes de usar outro protocolo. Nos testes em macOS com um modelo GPT, o OpenCode 1.19.4 e o 2.1.4 concluíram chamadas de ferramentas para leitura de arquivos com cada SDK: @ai-sdk/openai-compatible usou /v1/chat/completions, e @ai-sdk/openai usou /v1/responses. Os quatro casos de leitura de arquivos passaram com read permitido e edit e bash negados.

Verificar a conexão

Execute opencode em um projeto, selecione bettertoken/YOUR_MODEL_ID e envie uma mensagem curta. Uma resposta normal confirma a configuração. Reinicie o OpenCode depois de alterar o JSON.

Para uma verificação de texto não interativa com o OpenCode 1:

opencode run --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

O OpenCode 2 exige --standalone para essa execução não interativa:

opencode run --standalone --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

Trocar de modelo

Adicione um novo YOUR_MODEL_ID em provider.bettertoken.models, atualize o model de nível superior, salve e reinicie o OpenCode.

Erros comuns

Erro	Solução
`401`	Execute `/connect` novamente ou verifique `apiKey`.
`404`	Use somente `https://bettertoken.ai/v1` como `baseURL`; não acrescente `/chat/completions`.
Modelo não encontrado	Faça o `model` de nível superior corresponder exatamente a um ID em `models`.
Configuração não aplicada	Verifique se o `opencode.json` do projeto substitui o arquivo global e reinicie o OpenCode.