Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
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

curl -fsSL https://opencode.ai/install | bash
Verifica la instalación: 
opencode --version

​
Configuración

​
Paso 1: Establecer variables de entorno

export OPENAI_API_KEY="sk-your-tokenlab-key"
Para una configuración permanente, añade esto a ~/.bashrc o ~/.zshrc: 
echo 'export OPENAI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
source ~/.zshrc

​
Paso 2: Configurar OpenCode

La documentación actual de OpenCode recomienda configurar proveedores mediante opencode.json o opencode.jsonc. Para TokenLab, usa un proveedor personalizado en lugar de sobrecargar el proveedor integrado openai: 
{
  "$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"
}
Usa @ai-sdk/openai-compatible para compatibilidad con el estilo de chat-completions. Si específicamente necesitas una ruta de proveedor basada en /v1/responses, la documentación de proveedores de OpenCode recomienda cambiar el paquete a @ai-sdk/openai.

​
Uso básico

Iniciar modo interactivo: 
opencode
Ejecutar con un prompt: 
opencode "Explain this codebase"
Especificar modelo: 
opencode --model tokenlab/gpt-5.4 "Fix the bugs in main.py"

​
Modelos disponibles

ModeloMejor para
gpt-5.4Tareas complejas, arquitectura de código
gpt-5-miniCorrecciones rápidas, consultas simples
claude-sonnet-4-6Revisión de código, documentación
claude-opus-4-6Razonamiento complejo
gemini-2.5-flashRespuestas rápidas
deepseek-r1Diseño de algoritmos

​
Comandos comunes

Analizar código: 
opencode "What does this function do?" < src/utils.ts
Generar código: 
opencode "Create a REST API with Express"
Revisar cambios: 
git diff | opencode "Review these changes"
Corregir errores: 
opencode "Fix the TypeScript errors in this project"

​
Comandos interactivos

CommandDescripción
/helpMostrar comandos disponibles
/model <name>Cambiar a un modelo diferente
/clearBorrar el historial de conversación
/exitSalir de OpenCode

​
Solución de problemas

  • Verifica que options.baseURL esté establecido en https://api.tokenlab.sh/v1
  • Comprueba la conectividad de red
  • Prueba curl https://api.tokenlab.sh/v1/models para verificar
  • Verifica que la variable de entorno OPENAI_API_KEY esté establecida
  • Verifica que options.apiKey haga referencia a {env:OPENAI_API_KEY} u otra fuente de secreto válida
  • Comprueba que la clave comience con sk-
  • Asegúrate de que la clave esté activa en el dashboard de TokenLab
  • Comprueba que el nombre del modelo en la configuración coincida exactamente
  • Verifica la disponibilidad del modelo en tokenlab.sh/en/models

​
Buenas prácticas

Ejecuta OpenCode desde la raíz de tu proyecto para comprender mejor tu codebase.
Usa modelos más rápidos (gpt-5-mini) para tareas simples y modelos más potentes (gpt-5.4, claude-sonnet-4-6) para las complejas.
Revisa siempre el código generado por AI antes de aplicar cambios a tu proyecto.