Skip to main content

Qué es OpenCode

OpenCode es un agente de programación de IA de código abierto disponible como interfaz de terminal, app de escritorio y extensión de IDE. Con la configuración de proveedor, puede enviar solicitudes de modelo compatibles a través de los endpoints compatibles con OpenAI y Anthropic de Capriole AI.

Requisitos previos

Antes de empezar, asegúrate de tener:

Instalación

Instala OpenCode con el script oficial de instalación:
O instálalo con npm:
Verifica la instalación:

Configuración

Validación de modelos

OpenCode 1.14.48 supera las pruebas de lectura de archivos y respuesta final con Fable 5.1 mediante Anthropic Messages (claude-latest) y con zai/glm-5.3-flash mediante Chat Completions. Usa estas rutas en la configuración siguiente. Con anthropic/claude-fable-5-1 y google/gemini-3.8-flash mediante Chat Completions, la sesión guardada de OpenCode contiene la lectura completada y la respuesta correcta, pero run --format json omite el evento de texto final. Estas rutas no superan la prueba completa de salida de CLI y no se añaden a la configuración siguiente. xai/grok-4.6 acepta solicitudes de Chat Completions, pero no superó las pruebas de tareas de agentes, por lo que no se incluye en la configuración siguiente. Las pruebas directas al proveedor también detectaron un uso de herramientas inconsistente con Grok 4.5; completar una solicitud API no demuestra que la respuesta del agente sea correcta. Crea o actualiza ~/.config/opencode/opencode.json: Usa apiKey para los proveedores OpenAI y compatibles con OpenAI, y authToken para el proveedor Anthropic.

Ejecutar OpenCode

Después de reemplazar YOUR_CAPRIOLE_AI_API_KEY en la configuración, inicia OpenCode:
Usa /models para seleccionar OpenAI latest, GPT-6 Astra, GPT 5.6 Thinking, GPT 5.6, GPT 5.5, Fable 5.1, Fable 5, Opus 5, Grok 4.5, GLM 5.3 Flash, GLM 5.2, Kimi K3, Claude latest, Opus 4.8, Opus 4.7, Opus 4.6 o Sonnet 4.6. Usa Ctrl+T para recorrer las variantes de modelo.

Modelos compatibles

OpenCode admite OpenAI latest, GPT-6 Astra, GPT 5.6 Thinking, GPT 5.6, GPT 5.5, Fable 5.1, Fable 5, Opus 5, Grok 4.5, GLM 5.3 Flash, GLM 5.2, Kimi K3, Claude latest, Opus 4.8, Opus 4.7, Opus 4.6 y Sonnet 4.6 a través de Capriole AI. Fable 5 y Opus 5 pueden usar el proveedor compatible con Chat Completions o el proveedor de Anthropic Messages.
  • openai-latest
  • openai/gpt-6-astra
  • openai/gpt-5.6-terra
  • openai/gpt-5.6-luna
  • openai/gpt-5.5
  • anthropic/claude-fable-5
  • anthropic/claude-opus-5
  • xai/grok-4.5
  • zai/glm-5.3-flash
  • zai/glm-5.2
  • moonshot/kimi-k3
  • claude-latest
  • claude-fable-5-1
  • claude-fable-5
  • claude-opus-5
  • claude-opus-4-8
  • claude-opus-4-7
  • claude-opus-4-6
  • claude-sonnet-4-6

Solución de problemas

¿Por qué OpenCode devuelve un error de autenticación?

Confirma que tanto apiKey como authToken en ~/.config/opencode/opencode.json usan tu clave API de Capriole AI en lugar de YOUR_CAPRIOLE_AI_API_KEY.

¿Por qué fallan las solicitudes de GPT?

Confirma que el proveedor GPT usa npm: "@ai-sdk/openai" y baseURL: "https://api.caprioletech.com/v1" para que las solicitudes usen la API Responses.

¿Por qué fallan las solicitudes de Grok, GLM o Kimi?

Confirma que capriole-ai-compatible usa npm: "@ai-sdk/openai-compatible" y baseURL: "https://api.caprioletech.com/v1" para que ambos modelos usen Chat Completions.

¿Por qué fallan las solicitudes de Anthropic?

Confirma que el proveedor Anthropic usa npm: "@ai-sdk/anthropic", authToken y baseURL: "https://api.caprioletech.com/v1".

¿Por qué no aparecen los modelos de Capriole AI?

Confirma que la referencia del modelo usa <providerId>/<modelId>, como capriole-ai-openai/openai-latest, capriole-ai-compatible/moonshot/kimi-k3 o capriole-ai-anthropic/claude-latest, y que enabled_providers incluye los proveedores de Capriole AI mientras que disabled_providers no los bloquea.

¿Por qué no aparecen las variantes de modelo?

Confirma que reiniciaste OpenCode después de actualizar ~/.config/opencode/opencode.json, luego abre /models y pulsa Ctrl+T para recorrer las variantes.

¿Por qué no se aplican los cambios de configuración?

Revisa si hay anulaciones de opencode.json a nivel de proyecto o de OPENCODE_CONFIG y luego reinicia OpenCode.

¿Por qué aparecen errores de inicialización de proveedor o de paquetes de proveedor?

Para ProviderInitError, verifica primero la configuración del proveedor. Para errores de paquetes de proveedor, limpia ~/.cache/opencode y reinicia OpenCode para que se reinstalen los paquetes de proveedor.

Notas

Última modificación el 14 de septiembre de 2026