Herramientas de código
OpenCode
Configura OpenCode para usar la API de TokenLab
Deja que mi agente realice esta configuración
Copia esta tarea a un agente que ya esté ejecutándose en tu computadora:
Read this guide and help me connect OpenCode to TokenLab:
https://tokenlab.sh/docs/es/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.Descripción general
OpenCode puede usar TokenLab a través de un proveedor personalizado compatible con OpenAI. Agrega la clave de API de TokenLab, la URL base (Base URL) y un ID de modelo actual.
Instalación
npm install -g opencode-ai@1.18.31Verifica la instalación:
opencode --versionConfiguración
Paso 1: Establecer variables de entorno
Usa las instrucciones de terminal de Inicio rápido para macOS, Linux, WSL o Windows PowerShell para establecer TOKENLAB_API_KEY sin incluir la clave en el historial de comandos. Inicia OpenCode desde esa terminal. Para un uso persistente, utiliza tu gestor de secretos local; no añadas una clave en texto plano a tu perfil de shell.
Paso 2: Configurar OpenCode
La configuración a continuación fue verificada con OpenCode 1.18.31. Otras versiones requieren su propia verificación frente a la documentación oficial.
Crea un archivo separado ~/.config/opencode/tokenlab.jsonc con la configuración que aparece abajo. Si XDG_CONFIG_HOME está configurado, usa opencode/tokenlab.jsonc dentro de ese directorio. Mantén los archivos opencode.json / opencode.jsonc, las cuentas, el modelo predeterminado y los permisos normales sin cambios: este archivo separado solo se carga para una invocación que lo seleccione con OPENCODE_CONFIG. Si el nombre del archivo o del proveedor ya pertenece a otra configuración, elige un archivo/nombre diferente y ajusta los 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 configuración utiliza @ai-sdk/openai-compatible para Chat Completions. Elige un modelo actual cuyos detalles admitan Chat Completions y las herramientas que necesitas; no infieras compatibilidad con otro protocolo o versión a partir de este ejemplo.
Opcional: el asistente de configuración reversible de OpenCode proporciona vista previa, aplicación y restauración de archivos originales con Python 3.11+. El plugin de TokenLab Skills 0.1.2 incluye estos scripts; también se puede usar una instalación de Skill independiente después de actualizar a una versión que los contenga. Para un plugin existente o una instalación de Skill independiente, sigue las instrucciones de actualización del README y confirma que el script esté presente. La configuración manual aquí sigue siendo utilizable sin el asistente.
Uso básico
Establece la clave usando Quickstart, luego carga este archivo y selecciona el modelo explícitamente para esta invocación. Sustituye tu ruta y nombre de proveedor reales si los has personalizado. Mantén cualquier configuración existente de OPENCODE_CONFIG o OPENCODE_CONFIG_CONTENT en línea en un entorno de lanzamiento separado; la configuración del proyecto y la gestionada aún pueden tener prioridad.
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-terraLa detección de modelos verifica la carga local, no la validez de la clave ni una solicitud en vivo exitosa. Un prompt utiliza el saldo de TokenLab y OpenCode puede enviar solicitudes auxiliares facturadas por separado, como la generación de títulos. Revisa la respuesta y los registros de solicitudes correspondientes.
Para usar tu configuración habitual, inicia sin esta capa. No persistas OPENCODE_CONFIG en tu perfil de shell para esta guía. Para deshacer la configuración manual, elimina solo el archivo separado que creaste, o restaura su copia de seguridad si existía antes.
Genera imágenes y video en el mismo agente
OpenCode también puede crear imágenes y videos cortos con el servidor MCP de TokenLab. Cada generación se paga con el mismo saldo de TokenLab. Fusiona esta entrada mcp en el mismo tokenlab.jsonc, junto a provider. OpenCode reemplaza {env:TOKENLAB_API_KEY} con la variable de tu terminal, por lo que la clave no se escribe en el archivo:
{
"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
}
}
}El timeout más largo le da tiempo a npx para descargar el paquete en el primer inicio. Ejecuta opencode mcp list con el mismo OPENCODE_CONFIG y verifica que tokenlab esté conectado. Luego intenta:
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 devuelve un ID de tarea. El agente llama a get_task_status hasta que el video esté listo. Consulta servidores MCP de OpenCode para otras configuraciones.
Elige un modelo
Copia un ID de modelo de codificación actual desde la página de modelos. Compara modelos en tu propio repositorio antes de establecer uno predeterminado.
Comandos comunes
Analizar 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.tsGenerar 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 cambios:
git diff | OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Review these changes"Corregir errores:
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 interactivos
| Comando | Descripción |
|---|---|
/help | Mostrar comandos disponibles |
/models | Cambiar a un modelo diferente |
/clear | Borrar historial de conversación |
/exit | Salir de OpenCode |