OpenCode

Deixar meu agente fazer a configuraçãoCopy Anchor Link

Copie esta tarefa para um agente que já esteja funcionando no seu computador:

Leia este guia e me ajude a conectar OpenCode ao TokenLab:
https://tokenlab.sh/docs/pt/integrations/opencode
Verifique primeiro minha versão instalada e a configuração ativa.
Preserve as contas, os provedores, as permissões e os demais ajustes existentes.
Faça backup dos arquivos locais e mostre as alterações propostas.
Deixe que eu insira localmente as chaves de API necessárias; nunca as solicite, exiba ou cole no chat.
Verifique primeiro se a configuração é carregada corretamente.
Explique separadamente o custo de qualquer teste com requisições pagas antes de executá-lo.

Visão geralCopy Anchor Link

OpenCode é um assistente de programação com AI de código aberto que roda no seu terminal. Ele oferece suporte a vários provedores de LLM e pode ser configurado para usar a API do TokenLab para acessar centenas de modelos.

InstalaçãoCopy Anchor Link

OpenCode

npm install -g opencode-ai@1.18.31

Verifique a instalação:

opencode --version

ConfiguraçãoCopy Anchor Link

Etapa 1: Definir variáveis de ambienteCopy Anchor Link

Siga as etapas de terminal do início rápido para macOS, Linux, WSL ou Windows PowerShell e defina TOKENLAB_API_KEY sem gravar a chave no histórico. Inicie o OpenCode nesse terminal. Para uso persistente, utilize um gerenciador local de segredos, sem acrescentar a chave em texto simples ao perfil do shell.

Etapa 2: Configurar o OpenCodeCopy Anchor Link

A configuração abaixo foi verificada com OpenCode 1.18.31. Outras versões precisam de verificação própria conforme a documentação oficial.

Salve a configuração em um arquivo separado ~/.config/opencode/tokenlab.jsonc. Se XDG_CONFIG_HOME estiver definido, use opencode/tokenlab.jsonc nesse diretório. Preserve os arquivos habituais opencode.json / opencode.jsonc, as contas, o modelo padrão e as permissões. O arquivo separado só é carregado em uma execução que o selecione com OPENCODE_CONFIG. Se o arquivo ou nome do provedor já estiver em uso, escolha outro nome e ajuste os comandos.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenlab": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenLab",
      "options": {
        "baseURL": "https://api.tokenlab.sh/v1",
        "apiKey": "{env:TOKENLAB_API_KEY}"
      },
      "models": {
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        }
      }
    }
  }
}

Opcional: o assistente reversível de configuração do OpenCode permite visualizar, aplicar e restaurar o arquivo original com Python 3.11+. O plugin TokenLab Skills 0.1.2 inclui esses scripts; um Skill independente também pode ser usado após a atualização para uma versão que os contenha. Para plugins ou Skills independentes já instalados, siga as instruções de atualização do README e confirme que o script está presente. A configuração manual desta página também funciona sem o assistente.

Uso básicoCopy Anchor Link

Defina a chave conforme o início rápido, carregue o arquivo apenas nesta execução e selecione o modelo explicitamente. Substitua caminhos e nomes personalizados. Preserve configurações existentes de OPENCODE_CONFIG ou OPENCODE_CONFIG_CONTENT em um ambiente de inicialização separado; ajustes do projeto ou gerenciados ainda podem ter prioridade.

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode models tokenlab
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode --model tokenlab/gpt-5.6-terra

A lista de modelos verifica o carregamento local, não a validade da chave ou o sucesso de uma solicitação real. Um prompt utiliza saldo TokenLab e o OpenCode pode enviar solicitações auxiliares cobradas separadamente, como a geração de um título. Confira a resposta e os registros correspondentes.

Inicie sem esse arquivo para usar sua configuração habitual. Não salve OPENCODE_CONFIG no perfil do shell para seguir este guia. Para desfazer a configuração manual, remova apenas o arquivo separado que criou ou restaure sua cópia se ele já existia.

Modelos disponíveisCopy Anchor Link

Comandos comunsCopy Anchor Link

Analisar código:

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "What does this function do?" < src/utils.ts

Gerar código:

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Create a REST API with Express"

Revisar alterações:

git diff | OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Review these changes"

Corrigir erros:

OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Fix the TypeScript errors in this project"

Comandos interativosCopy Anchor Link

Solução de problemasCopy Anchor Link

Boas práticasCopy Anchor Link