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 comandoopencode, así que solo puedes tener uno instalado a la vez. Instala OpenCode 2 con el script de instalación oficial:
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:
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
packagepor@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. envindica la variable que guarda tu clave. La cabeceraAuthorizationenvía la clave como token Bearer con todos los paquetes.reasoningEffortda a cada modelo GPT un nivel de razonamiento por defecto. Sin él, los modelos GPT responden sin razonar.baseURLincluye/v1para todos los paquetes.limitindica a OpenCode la ventana de contexto y el límite de salida de cada modelo.agents.titledefine 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:
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.npmpor@ai-sdk/openai, que usa la API Responses. Cada modelo Claude lo sustituye por@ai-sdk/anthropic, que usa Anthropic Messages. baseURLincluye/v1para todos los paquetes.{env:CAPRIOLE_AI_API_KEY}lee tu clave del entorno. La cabeceraAuthorizationla envía como token Bearer con todos los paquetes.limitindica 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_modeles 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 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 formatocapriole-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 queCAPRIOLE_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 usacapriole-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 unopencode.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
- Mantén tu clave en el entorno. No la pegues en
opencode.json. - Para añadir otro modelo de Capriole AI, copia la entrada de un modelo de la misma familia y cambia el ID.
GET https://api.caprioletech.com/v1/modelsdevuelve la lista de todos los IDs de modelo. - Gemini 4 Carbon razona más tiempo que Gemini 4 Argon, así que cada turno puede tardar más y usar más tokens. Para turnos más rápidos, usa
google/gemini-4-argon. - Para usar la misma clave en tus otros agentes de programación, consulta Usa una sola clave API con agentes de programación.
- Referencias de OpenCode 2: instalación, migración desde OpenCode 1, proveedores, modelos, servicio en segundo plano y versiones.
- Referencias de OpenCode 1: instalación, configuración, proveedores, modelos y solución de problemas.

