Guía de configuración de proveedores de IA

Configuración de OpenCode

OpenCode es un asistente de programación con IA de código abierto para la terminal. Es adecuado para preguntas y respuestas sobre código, modificaciones de archivos y cambio de modelos dentro del directorio de un proyecto. Los principiantes deben usar primero su asistente de conexión integrado y evitar escribir manualmente el JSON completo al principio.

Información oficial Las descargas y la documentación están sujetas al sitio oficial.

Sitio web oficial de OpenCode Asistentes de programación con IA de código abierto para la terminal Documentación Instrucciones de instalación, autenticación y comandos Referencia de configuración del proveedor de IA Consulta la lógica de configuración en opencode.json

Qué es esta herramienta y para qué sirve

Ubicación del archivo de configuración

Sistema	Ubicación del archivo de configuración	Descripción
Windows	`C: \Users\YourUsername\. config\opencode\opencode.json`	Si el archivo no existe, crea uno nuevo
macOS / Linux	`~/. config/opencode/opencode.json`	Si el archivo no existe, crea uno nuevo

Comienza con el asistente de conexión

Asistente de conexión de OpenCode

cd YOUR_TEST_PROJECT opencode /connect

Comprobar modelo de OpenCode

cd YOUR_TEST_PROJECT opencode /models

Aspectos a tener en cuenta al configurar manualmente

Edita el archivo de configuración solo si la documentación de tu proveedor especifica claramente el campo Provider de OpenCode, dónde colocar la Base URL y la Key. Los campos pueden variar entre versiones; no copies directamente ejemplos de JSON de otras herramientas en OpenCode.

Elementos a verificar	Descripción
Tipo de proveedor	No mezcles protocolos de OpenAI, Claude, Gemini u otros
Base URL	Usa la dirección completa proporcionada por el proveedor para OpenCode o el protocolo correspondiente
Key	Usa la Key correspondiente al proveedor actual
Nombre del modelo	Copia la lista de modelos desde el panel del proveedor

Cómo probar después de guardar

Accede al directorio de un proyecto de prueba y ejecuta opencode.
Usa primero /models para confirmar que el modelo que acabas de configurar sea visible.
Tras seleccionar el modelo, envía 'Por favor, responde únicamente: Configuración de OpenCode exitosa'.
La primera vez, no permitas que modifique archivos; pídele únicamente que explique el directorio actual o el archivo actual.
Si falla, regresa primero a /connect o verifica el proveedor, la Base URL, la clave y el nombre del modelo según la documentación del proveedor.

Síntoma	Verificación prioritaria	Solución
No aparece ningún modelo en `/models`	Si el proveedor se guardó correctamente y si se puede obtener la lista de modelos	Añade manualmente el ID del modelo / nombre del modelo desde el panel del proveedor
Fallo de conexión	Si la Base URL corresponde al protocolo del proveedor actual	No mezcles direcciones de Claude, Gemini y OpenAI
El archivo de configuración no es válido	Formato JSON, comas, comillas	Da prioridad a generar la configuración usando el asistente de conexión y luego realiza ajustes manuales menores.

Sitio web oficial de OpenCode Consulta las instrucciones de instalación, autenticación y comandos.

Referencia de configuración de proveedores de IA para OpenCode Consulta el enfoque de configuración de opencode.json.