OpenCode

Visão geral

Tipo: Ferramenta de códigoCaminho principal: compatível com OpenAINível de suporte: Caminho compatível

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ção

Script de instalação
Homebrew
Go

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

brew install opencode-ai/tap/opencode

Ou use o tap da comunidade (atualizações mais frequentes):

brew install anomalyco/tap/opencode

go install github.com/opencode-ai/opencode@latest

Verifique a instalação:

opencode --version

Configuração

Etapa 1: Definir variáveis de ambiente

export OPENAI_API_KEY="sk-your-tokenlab-key"

Para configuração permanente, adicione a ~/.bashrc ou ~/.zshrc:

echo 'export OPENAI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
source ~/.zshrc

Etapa 2: Configurar o OpenCode

A documentação atual do OpenCode recomenda configurar provedores por meio de opencode.json ou opencode.jsonc. Para o TokenLab, use um provedor personalizado em vez de sobrescrever o provedor openai integrado:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenlab": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenLab",
      "options": {
        "baseURL": "https://api.tokenlab.sh/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5-mini": {
          "name": "GPT-5 Mini"
        }
      }
    }
  },
  "model": "tokenlab/gpt-5.4"
}

Use @ai-sdk/openai-compatible para compatibilidade no estilo chat-completions. Se você precisar especificamente de um caminho de provedor baseado em /v1/responses, a documentação de provedores do OpenCode recomenda trocar o pacote para @ai-sdk/openai.

Uso básico

Iniciar o modo interativo:

opencode

Executar com um prompt:

opencode "Explain this codebase"

Especificar modelo:

opencode --model tokenlab/gpt-5.4 "Fix the bugs in main.py"

Modelos disponíveis

Modelo	Melhor para
`gpt-5.4`	Tarefas complexas, arquitetura de código
`gpt-5-mini`	Correções rápidas, consultas simples
`claude-sonnet-4-6`	Revisão de código, documentação
`claude-opus-4-6`	Raciocínio complexo
`gemini-3.5-flash`	Respostas rápidas
`deepseek-r1`	Design de algoritmos

Comandos comuns

Analisar código:

opencode "What does this function do?" < src/utils.ts

Gerar código:

opencode "Create a REST API with Express"

Revisar alterações:

git diff | opencode "Review these changes"

Corrigir erros:

opencode "Fix the TypeScript errors in this project"

Comandos interativos

Command	Descrição
`/help`	Mostrar comandos disponíveis
`/model <name>`	Alternar para um modelo diferente
`/clear`	Limpar o histórico da conversa
`/exit`	Sair do OpenCode

Solução de problemas

Erro de conexão

Verifique se options.baseURL está definido como https://api.tokenlab.sh/v1
Verifique a conectividade de rede
Tente curl https://api.tokenlab.sh/v1/models para testar

Falha na autenticação

Verifique se a variável de ambiente OPENAI_API_KEY está definida
Verifique se options.apiKey referencia {env:OPENAI_API_KEY} ou outra fonte de segredo válida
Verifique se a chave começa com sk-
Certifique-se de que a chave está ativa no dashboard do TokenLab

Modelo não encontrado

Verifique se o nome do modelo na configuração corresponde exatamente
Verifique a disponibilidade do modelo em tokenlab.sh/en/models

Boas práticas

Use o contexto do projeto

Execute o OpenCode a partir da raiz do seu projeto para uma melhor compreensão da sua base de código.

Escolha modelos apropriados

Use modelos mais rápidos (gpt-5-mini) para tarefas simples e modelos mais robustos (gpt-5.4, claude-sonnet-4-6) para tarefas complexas.

Revise o código gerado

Sempre revise o código gerado por AI antes de aplicar alterações ao seu projeto.

Matriz de compatibilidade

Ferramentas de código

SDKs nativos

Frameworks e plataformas

Apps de chat

Visão geral

Instalação

Configuração

Etapa 1: Definir variáveis de ambiente

Etapa 2: Configurar o OpenCode

Uso básico

Modelos disponíveis

Comandos comuns

Comandos interativos

Solução de problemas

Boas práticas

​Visão geral

​Instalação

​Configuração

​Etapa 1: Definir variáveis de ambiente

​Etapa 2: Configurar o OpenCode

​Uso básico

​Modelos disponíveis

​Comandos comuns

​Comandos interativos

​Solução de problemas

​Boas práticas

Visão geral

Instalação

Configuração

Etapa 1: Definir variáveis de ambiente

Etapa 2: Configurar o OpenCode

Uso básico

Modelos disponíveis

Comandos comuns

Comandos interativos

Solução de problemas

Boas práticas