Ferramentas de código
OpenCode
Configure o OpenCode para usar a API do TokenLab
Deixe meu agente configurar isso
Copie esta tarefa para um agente que já esteja rodando no seu computador:
Read this guide and help me connect OpenCode to TokenLab:
https://tokenlab.sh/docs/pt/integrations/opencode
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.Visão geral
O OpenCode pode usar o TokenLab através de um provedor personalizado compatível com OpenAI. Adicione a chave de API do TokenLab, a Base URL e um ID de modelo atual.
Instalação
npm install -g opencode-ai@1.18.31Verifique a instalação:
opencode --versionConfiguração
Passo 1: Definir variáveis de ambiente
Use as instruções do terminal do Início Rápido para macOS, Linux, WSL ou Windows PowerShell para definir a TOKENLAB_API_KEY sem colocar a chave no histórico de comandos. Inicie o OpenCode a partir desse terminal. Para uso persistente, utilize seu gerenciador de segredos local; não adicione uma chave em texto simples ao seu perfil de shell.
Passo 2: Configurar o OpenCode
A configuração abaixo foi verificada com o OpenCode 1.18.31. Outras versões precisam de sua própria verificação em relação à documentação oficial.
Crie um arquivo separado ~/.config/opencode/tokenlab.jsonc com a configuração abaixo. Se XDG_CONFIG_HOME estiver definido, use opencode/tokenlab.jsonc dentro desse diretório. Mantenha o opencode.json / opencode.jsonc normal, contas, modelo padrão e permissões inalterados: este arquivo separado é carregado apenas para uma invocação que o seleciona com OPENCODE_CONFIG. Se o nome do arquivo ou do provedor já pertencer a outra configuração, escolha um arquivo/nome diferente 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"
}
}
}
}
}Esta configuração usa @ai-sdk/openai-compatible para Chat Completions. Escolha um modelo atual cujos detalhes suportem Chat Completions e as ferramentas que você precisa; não infira suporte para outro protocolo ou versão a partir deste exemplo.
Opcional: o auxiliar de configuração reversível do OpenCode oferece visualização, aplicação e restauração de arquivo original com Python 3.11+. O plugin TokenLab Skills 0.1.2 inclui esses scripts; uma instalação de Skill independente também pode ser usada após a atualização para uma versão que os contenha. Para um plugin existente ou instalação de Skill independente, siga as instruções de atualização do README e confirme se o script está presente. A configuração manual aqui permanece utilizável sem o auxiliar.
Uso básico
Defina a chave usando o Quickstart, carregue este arquivo e selecione o modelo explicitamente para esta invocação. Substitua pelo seu caminho real e nome do provedor, caso tenha personalizado. Mantenha qualquer configuração existente de OPENCODE_CONFIG ou OPENCODE_CONFIG_CONTENT em linha em um ambiente de inicialização separado; as configurações do projeto e gerenciadas ainda podem ter precedência.
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-terraA descoberta de modelos verifica o carregamento local, não a validade da chave ou uma solicitação ativa bem-sucedida. Um prompt utiliza o saldo do TokenLab e o OpenCode pode enviar solicitações auxiliares cobradas separadamente, como a geração de títulos. Verifique a resposta e os registros de solicitação correspondentes.
Para usar sua configuração comum, inicie sem esta camada. Não torne OPENCODE_CONFIG persistente em seu perfil de shell para este guia. Para desfazer a configuração manual, remova apenas o arquivo separado que você criou ou restaure seu backup, caso ele existisse anteriormente.
Gere imagens e vídeos no mesmo agente
O OpenCode também pode criar imagens e vídeos curtos com o servidor MCP do TokenLab. Cada geração é paga com o mesmo saldo do TokenLab. Mescle esta entrada mcp no mesmo tokenlab.jsonc, ao lado de provider. O OpenCode substitui {env:TOKENLAB_API_KEY} pela variável do seu terminal, portanto, a chave não é gravada no arquivo:
{
"mcp": {
"tokenlab": {
"type": "local",
"command": ["npx", "-y", "@tokenlabai/mcp-server@0.6.48"],
"environment": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "{env:TOKENLAB_API_KEY}"
},
"timeout": 30000
}
}
}O timeout mais longo dá tempo ao npx para baixar o pacote na primeira inicialização. Execute opencode mcp list com o mesmo OPENCODE_CONFIG e verifique se o tokenlab está conectado. Em seguida, tente:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video retorna um ID de tarefa. O agente chama get_task_status até que o vídeo esteja pronto. Veja servidores MCP do OpenCode para outras configurações.
Escolha um modelo
Copie um ID de modelo de codificação atual da página de modelos. Compare os modelos em seu próprio repositório antes de definir um padrão.
Comandos comuns
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.tsGerar 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 interativos
| Comando | Descrição |
|---|---|
/help | Mostrar comandos disponíveis |
/models | Alternar para um modelo diferente |
/clear | Limpar histórico de conversas |
/exit | Sair do OpenCode |