OpenCode

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

Script de instalación
Homebrew
Go

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

brew install opencode-ai/tap/opencode

O usa el tap de la comunidad (actualizaciones más frecuentes):

brew install anomalyco/tap/opencode

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

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

Modelo	Mejor para
`gpt-5.4`	Tareas complejas, arquitectura de código
`gpt-5-mini`	Correcciones rápidas, consultas simples
`claude-sonnet-4-6`	Revisión de código, documentación
`claude-opus-4-6`	Razonamiento complejo
`gemini-3.5-flash`	Respuestas rápidas
`deepseek-r1`	Diseñ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

Command	Descripción
`/help`	Mostrar comandos disponibles
`/model <name>`	Cambiar a un modelo diferente
`/clear`	Borrar el historial de conversación
`/exit`	Salir de OpenCode

Solución de problemas

Error de conexión

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

Autenticación fallida

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

Modelo no encontrado

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

Usa el contexto del proyecto

Ejecuta OpenCode desde la raíz de tu proyecto para comprender mejor tu codebase.

Elige modelos apropiados

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 el código generado

Revisa siempre el código generado por AI antes de aplicar cambios a tu proyecto.

Matriz de compatibilidad

Herramientas de código

SDKs nativos

Frameworks y plataformas

Apps de chat

Descripción general

Instalación

Configuración

Paso 1: Establecer variables de entorno

Paso 2: Configurar OpenCode

Uso básico

Modelos disponibles

Comandos comunes

Comandos interactivos

Solución de problemas

Buenas prácticas

​Descripción general

​Instalación

​Configuración

​Paso 1: Establecer variables de entorno

​Paso 2: Configurar OpenCode

​Uso básico

​Modelos disponibles

​Comandos comunes

​Comandos interactivos

​Solución de problemas

​Buenas prácticas

Descripción general

Instalación

Configuración

Paso 1: Establecer variables de entorno

Paso 2: Configurar OpenCode

Uso básico

Modelos disponibles

Comandos comunes

Comandos interactivos

Solución de problemas

Buenas prácticas