Herramientas de código

OpenCode

Configura OpenCode para usar la API de TokenLab

Dejar que mi agente lo configure

Copia esta tarea en un agente que ya funcione en tu ordenador:

Lee esta guía y ayúdame a conectar OpenCode con TokenLab:
https://tokenlab.sh/docs/es/integrations/opencode
Comprueba primero mi versión instalada y la configuración activa.
Conserva las cuentas, los proveedores, los permisos y los demás ajustes existentes.
Haz una copia de seguridad de los archivos locales y muestra los cambios propuestos.
Las claves API necesarias las introduciré localmente; nunca las pidas, muestres ni pegues en el chat.
Comprueba primero que la configuración se carga correctamente.
Explica por separado el coste de cualquier prueba con peticiones de pago antes de ejecutarla.

Descripción general

OpenCode es un asistente de programación con AI de código abierto que se ejecuta en tu terminal. Es compatible con múltiples proveedores de LLM y se puede configurar para usar la API de TokenLab para acceder a cientos de modelos.

Instalación

OpenCode

npm install -g opencode-ai@1.18.31

Verifica la instalación:

opencode --version

Configuración

Paso 1: Establecer variables de entorno

Sigue los pasos de terminal de inicio rápido para macOS, Linux, WSL o Windows PowerShell y define TOKENLAB_API_KEY sin dejar la clave en el historial. Inicia OpenCode desde esa terminal. Para uso persistente, utiliza un gestor local de secretos; no añadas la clave en texto plano al perfil del shell.

Paso 2: Configurar OpenCode

La configuración siguiente se comprobó con OpenCode 1.18.31. Otras versiones requieren una verificación propia con su documentación oficial.

Guarda la configuración en un archivo independiente ~/.config/opencode/tokenlab.jsonc. Si defines XDG_CONFIG_HOME, usa opencode/tokenlab.jsonc dentro de ese directorio. Conserva los archivos habituales opencode.json / opencode.jsonc, las cuentas, el modelo predeterminado y los permisos. Este archivo solo se carga en una ejecución que lo seleccione con OPENCODE_CONFIG. Si el archivo o el nombre del proveedor ya se usa, elige otro nombre 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 envía Chat Completions mediante @ai-sdk/openai-compatible. Consulta los detalles actuales del modelo para comprobar Chat Completions y las herramientas necesarias. El ejemplo no demuestra compatibilidad con otros protocolos o versiones.

Opcionalmente, el asistente reversible de configuración de OpenCode permite previsualizar, aplicar y restaurar el archivo original con Python 3.11+. El plugin TokenLab Skills 0.1.2 incluye estos scripts; un Skill independiente también sirve si se actualiza a una versión que los contenga. Para plugins o Skills independientes ya instalados, sigue las instrucciones de actualización del README y comprueba que el script esté presente. La configuración manual de esta página también funciona sin el asistente.

Uso básico

Configura la clave siguiendo el inicio rápido, carga el archivo solo para esta ejecución y selecciona el modelo explícitamente. Sustituye las rutas y nombres personalizados. Conserva cualquier configuración previa de OPENCODE_CONFIG o OPENCODE_CONFIG_CONTENT en un entorno de inicio separado; los ajustes de proyecto o administrados 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-terra

La lista de modelos comprueba la carga local, no la validez de la clave ni una solicitud real correcta. Un prompt utiliza saldo TokenLab y OpenCode puede enviar solicitudes auxiliares facturadas por separado, como generar un título. Comprueba la respuesta y los registros correspondientes.

Inicia sin este archivo para usar tu configuración habitual. No guardes OPENCODE_CONFIG en el perfil del shell para seguir esta guía. Para deshacer los pasos manuales, elimina solo el archivo independiente que creaste o restaura su copia si ya existía.

Modelos disponibles

ModeloMejor para
gpt-5.6-terraTareas complejas, arquitectura de código
gpt-5.6-lunaCorrecciones rápidas, consultas simples
claude-sonnet-4-6Revisión de código, documentación
claude-opus-4-6Razonamiento complejo
gemini-3.5-flashRespuestas rápidas

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.ts

Generar 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

CommandDescripción
/helpMostrar comandos disponibles
/modelsCambiar a un modelo diferente
/clearBorrar el historial de conversación
/exitSalir de OpenCode

Solución de problemas

Buenas prácticas

En esta página