Skip to main content
Use esta guía para ejecutar OpenCode con CometAPI. La configuración expone cuatro formatos de API mediante proveedores personalizados independientes. Esta configuración se probó con OpenCode 1.18.16. Referencias oficiales:
Sustituya cada valor your-model-id por un ID de modelo de la página de modelos de CometAPI. Elija un modelo que admita el formato de API de la entrada del proveedor correspondiente.

​
Requisitos previos

​
Comprender los formatos de API

Cada ID de proveedor selecciona un adaptador de SDK y un formato de API. Esta guía verifica la operación de Streaming de Gemini utilizada durante un turno normal del agente de OpenCode. El adaptador de Google agrega :streamGenerateContent?alt=sse a la ruta del modelo. No agregue /chat/completions, /responses, /messages ni una ruta de modelo de Gemini a baseURL. Cada adaptador agrega la ruta de operación requerida.

​
Comprender los permisos de tiempo de ejecución

OpenCode se ejecuta con los permisos del proceso que lo inicia. Inicie OpenCode en el directorio de proyecto previsto y mantenga una vía de reversión, como git. Use un contenedor o sandbox cuando necesite límites más estrictos para el sistema de archivos, los procesos, la red o las claves de API.

​
Configurar OpenCode

1

Instalar OpenCode

Instala OpenCode con el paquete oficial de npm:
Confirma que la CLI esté disponible:
Consulta la guía de instalación de OpenCode para conocer Homebrew, Windows, Docker y otros métodos de instalación.
2

Configura tu clave de API de CometAPI

Almacena tu clave de API de CometAPI en la variable de entorno COMETAPI_KEY.
Lee la clave de API sin mostrarla en la terminal:
Configura la variable en cada sesión de shell que inicie OpenCode. No confirmes claves de API en el control de versiones.
3

Elige una ubicación de configuración

Usa una de estas ubicaciones compatibles:
  • Configuración global: ~/.config/opencode/opencode.json
  • Configuración del proyecto: opencode.json en la raíz del proyecto
OpenCode combina los archivos de configuración. Una configuración de proyecto anula los valores en conflicto de la configuración global.Usa el archivo global cuando quieras los proveedores en todos los proyectos. Usa el archivo del proyecto cuando un repositorio necesite sus propias entradas de modelos.
4

Agrega los proveedores de CometAPI

Crea el archivo de configuración seleccionado. Si el archivo ya contiene un provider objeto, combina estas cuatro entradas en ese objeto:
Reemplaza cada clave your-model-id de forma independiente. Las cuatro entradas pueden usar diferentes ID de modelo.La configuración no establece un model de nivel superior. Esto te permite elegir el formato de API y el modelo necesarios mediante /models.
No uses /connect para esta configuración. Los campos apiKey se leen COMETAPI_KEY desde el entorno. Una variable no configurada se resuelve como un valor vacío en lugar de una clave de API /connect almacenada.
5

Selecciona y verifica cada proveedor

Inicia OpenCode en el proyecto al que quieres que acceda:
Ejecuta /models y luego selecciona una entrada provider/model. En las cuatro ejecuciones de verificación de esta guía, cada turno del modelo usó el formato de API correspondiente a la entrada seleccionada. No se observó ninguna distribución de solicitudes entre formatos ni negociación automática del formato de API .Para verificar Chat Completions desde la línea de comandos, ejecuta:
Para verificar Responses desde la línea de comandos, ejecuta:
Para verificar Anthropic Messages desde la línea de comandos, ejecuta:
Para verificar Gemini generateContent desde la línea de comandos, ejecuta:

​
Solución de problemas

Confirme que la configuración sea JSON válido. Cada entrada personalizada debe estar dentro del objeto provider de nivel superior, y cada ID de modelo debe estar dentro del objeto models correspondiente. Reinicie OpenCode y luego abra /models de nuevo.
Confirme que COMETAPI_KEY esté configurado en la shell que inicia OpenCode. Una referencia {env:COMETAPI_KEY} no configurada se convierte en un valor vacío. Abra una nueva shell después de cambiar un perfil de shell.
Consulte la página de modelos de CometAPI, luego sustituya el modelo ID dentro de la entrada del proveedor seleccionada. Confirme que el modelo acepte el formato de API de ese proveedor.
Mantenga baseURL en /v1 para Chat Completions, Responses y Messages. Use /v1beta para Gemini. No incluya una ruta de operación en baseURL.
Use un ID de modelo que acepte el formato de API del proveedor seleccionado. No suponga que un ID de modelo acepta los cuatro formatos.
OpenCode combina la configuración global y la del proyecto. Cambie el nombre del ID del proveedor del proyecto o elimine sus valores en conflicto cuando desee que la entrada del proveedor global permanezca sin cambios.
OpenCode usa los permisos del proceso que lo inició. Ejecute OpenCode en un contenedor o sandbox cuando necesite límites de acceso más estrictos.

​
Recursos relacionados

Última modificación el 13 de agosto de 2026