Saltar al contenido principal
Con una sola clave API de Capriole AI, usas GPT-6.2 Astra, Claude Fable 5.1, Opus 5.5 y Gemini 4 Carbon en OpenCode pagando hasta un 92% menos que los precios oficiales de la API.

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. Esta configuración añade Capriole AI como un único proveedor personalizado. Cada uno de sus modelos usa el protocolo de API que Capriole AI sirve para esa familia de modelos.

Requisitos previos

Antes de empezar, asegúrate de tener:
  • Una cuenta de Capriole AI (Regístrate aquí)
  • Un plan Premium (USD 9 al mes, también incluye chat web ilimitado) o un plan Team, necesario para la clave API (Suscríbete)
  • Una clave API de Capriole AI (Obtén tu clave)

Instalación

OpenCode 2 y OpenCode 1 usan el mismo comando opencode, así que solo puedes tener uno instalado a la vez. Instala OpenCode 2 con el script de instalación oficial:
O instálalo con npm:
Para pasar de OpenCode 1, ejecuta opencode upgrade --major. El script https://opencode.ai/install y el paquete npm opencode-ai siguen instalando OpenCode 1. Verifica la instalación:

Configuración

Validación de modelos

OpenCode 2.2.5 supera una prueba de lectura de archivos y respuesta final a través de Capriole AI con todos los modelos de la sección Modelos compatibles, usando la configuración de OpenCode 2. OpenCode 1.19.3 supera una prueba de lectura de archivos, escritura de archivos y respuesta final con la configuración de OpenCode 1.

OpenCode 2

Crea o actualiza ~/.config/opencode/opencode.json:
Qué hace cada ajuste:
  • package: "@opencode/ai/providers/openai-compatible" es el paquete por defecto del proveedor, así que Gemini, Grok, GLM y Kimi usan Chat Completions.
  • Cada modelo GPT sustituye package por @opencode/ai/providers/openai-compatible/responses, que usa la API Responses. Cada modelo Claude lo sustituye por @opencode/ai/providers/anthropic-compatible, que usa Anthropic Messages.
  • env indica la variable que guarda tu clave. La cabecera Authorization envía la clave como token Bearer con todos los paquetes.
  • reasoningEffort da a cada modelo GPT un nivel de razonamiento por defecto. Sin él, los modelos GPT responden sin razonar.
  • baseURL incluye /v1 para todos los paquetes. limit indica a OpenCode la ventana de contexto y el límite de salida de cada modelo.
  • agents.title define el modelo que OpenCode usa para los títulos de sesión.

OpenCode 1

OpenCode 1 no lee el formato de OpenCode 2, pero OpenCode 2 sí lee este, así que una configuración de OpenCode 1 sigue funcionando después de actualizar. Crea o actualiza ~/.config/opencode/opencode.json:
Qué hace cada ajuste:
  • npm: "@ai-sdk/openai-compatible" es el paquete por defecto del proveedor, así que Gemini, Grok, GLM y Kimi usan Chat Completions.
  • Cada modelo GPT sustituye provider.npm por @ai-sdk/openai, que usa la API Responses. Cada modelo Claude lo sustituye por @ai-sdk/anthropic, que usa Anthropic Messages.
  • baseURL incluye /v1 para todos los paquetes.
  • {env:CAPRIOLE_AI_API_KEY} lee tu clave del entorno. La cabecera Authorization la envía como token Bearer con todos los paquetes.
  • limit indica a OpenCode la ventana de contexto y el límite de salida de cada modelo, para que pueda controlar el contexto y compactar la sesión a tiempo.
  • small_model es el modelo que OpenCode usa para tareas ligeras, como los títulos de sesión.

Ejecutar OpenCode

Define tu clave API y luego inicia OpenCode desde el directorio de tu proyecto:
OpenCode 2 envía las solicitudes a los modelos desde un servicio en segundo plano que lee la clave al iniciarse, así que opencode service restart hace que tome la clave que acabas de definir. En OpenCode 1, omite este paso. Usa /models para cambiar de modelo. Para una ejecución no interactiva, usa opencode run:

Modelos compatibles

Las referencias de modelo usan el formato capriole-ai/<model-id>. openai-latest, claude-latest y google-latest siempre apuntan a nuestro modelo insignia más reciente de cada familia, actualmente GPT-6.2 Astra, Claude Fable 5.1 y Gemini 4 Carbon.

Solución de problemas

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

Confirma que CAPRIOLE_AI_API_KEY está exportada en el mismo shell antes de iniciar OpenCode y que la cabecera Authorization está presente en headers (OpenCode 2) u options.headers (OpenCode 1). Si OpenCode 2 devuelve Missing Bearer token, su servicio en segundo plano se inició sin la clave: ejecuta opencode service restart en ese shell.

¿Por qué las solicitudes de Claude fallan con Unsupported Claude Messages model?

Los modelos Claude que usan el paquete de Anthropic necesitan los IDs de Claude sin prefijo, como claude-opus-5-5. Los IDs con el prefijo anthropic/ son para Chat Completions.

¿Por qué fallan las solicitudes de GPT?

Confirma que cada modelo GPT tiene "package": "@opencode/ai/providers/openai-compatible/responses" (OpenCode 2) o "provider": { "npm": "@ai-sdk/openai" } (OpenCode 1), para que sus solicitudes usen la API Responses.

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

Confirma que la referencia de modelo usa capriole-ai/<model-id>, como capriole-ai/moonshot/kimi-k3, y que disabled_providers no bloquea capriole-ai. OpenCode 1 ignora el formato providers de OpenCode 2.

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

Comprueba si hay un opencode.json a nivel de proyecto o una anulación con OPENCODE_CONFIG y luego reinicia OpenCode.

¿Por qué aparecen errores de paquetes de proveedor?

Borra ~/.cache/opencode y reinicia OpenCode para que reinstale los paquetes de proveedor.

Notas

Última modificación el 18 de noviembre de 2026