¿Qué es OpenCode?
OpenCode es un agent de programación con IA de código abierto que se ejecuta en la terminal y que también puede usarse mediante flujos de trabajo de escritorio, IDE y basados en servidor. Ayuda a los desarrolladores a trabajar con una base de código leyendo archivos, explicando su estructura, editando código, revisando cambios y ejecutando tareas a través de proveedores de LLM conectados. Lo conectas a un proveedor de modelos, como la API de Kimi, y OpenCode usa ese proveedor para planificar, razonar y actuar dentro de tu entorno de desarrollo.
¿Qué puedes hacer con OpenCode?
Puedes elegir OpenCode cuando quieras un flujo de trabajo de programación con IA que pueda trabajar directamente con tu proyecto. Por ejemplo:
Escribir, editar y refactorizar código: puedes pedirle a OpenCode que agregue una función, modifique un archivo existente, refactorice una función o explique cómo debería cambiarse un módulo. Para obtener mejores resultados, indícale los archivos o directorios exactos involucrados.
Depurar errores y generar pruebas: OpenCode puede inspeccionar la salida de errores, leer los archivos relacionados, sugerir correcciones y agregar pruebas. Esto es especialmente útil cuando la falla depende del contexto del proyecto.
Revisar cambios de código: puedes usar OpenCode para revisar cambios locales antes de confirmarlos (commit). Puede buscar posibles errores, pruebas faltantes, patrones inconsistentes y cambios riesgosos.
Automatizar flujos de trabajo de desarrollo: OpenCode también admite flujos de trabajo no interactivos y basados en servidor. Por ejemplo, puedes ejecutar un prompt puntual desde la línea de comandos o iniciar un servidor OpenCode sin interfaz (headless) y conectarle otro cliente o integración.
Requisitos previos para configurar OpenCode con una API de LLM
Antes de configurar OpenCode con una API de LLM, prepara lo siguiente:
Una terminal funcional en macOS, Linux o Windows (se recomienda WSL).
Node.js, Homebrew u otro método de instalación compatible.
Una carpeta de proyecto en la que puedas hacer pruebas sin riesgo.
Una cuenta de proveedor de modelos.
En el caso de OpenCode, ten en cuenta que las credenciales del proveedor son sensibles. No pegues tu clave en incidencias públicas, capturas de pantalla compartidas, archivos fuente ni configuraciones que subas a un repositorio.
Paso 1: Instala OpenCode
El método de instalación más rápido según la documentación oficial de OpenCode es el script de instalación. Ejecuta esto en tu terminal:
OpenCode también admite la instalación mediante npm, Homebrew y otros comandos. Si prefieres la versión de escritorio, puedes descargar la que corresponda a tu dispositivo.
Paso 2: Inicia OpenCode
Ve al proyecto en el que quieres que OpenCode trabaje:
Inicia OpenCode:
Si es la primera vez que usas OpenCode en el proyecto, inicialízalo desde dentro del TUI:
Cómo configurar OpenCode con una API de LLM
En la mayoría de los casos, usar “OpenCode API” significa conectar OpenCode a un proveedor externo de LLM mediante una clave de API. El proveedor suministra el modelo, mientras que OpenCode gestiona el flujo de trabajo del agente de codificación dentro de tu proyecto. Los siguientes pasos usan Kimi API como proveedor de ejemplo.
Paso 1: Crea tu clave de Kimi API
Abre la plataforma de Kimi API. Crea una clave de API desde la consola y guárdala en un gestor de contraseñas o de secretos. Si tu consola solo muestra la clave completa una vez, cópiala antes de salir de la página.
Paso 2: Conecta un proveedor de modelos
Inicia OpenCode en tu proyecto:
Dentro de la interfaz de OpenCode, ejecuta:
Busca Moonshot AI o la entrada del proveedor compatible con Kimi que muestre tu versión de OpenCode. La documentación oficial de proveedores de OpenCode incluye un flujo para el proveedor Moonshot AI: crea una clave en la consola de Moonshot AI, ejecuta /connect, busca Moonshot AI e ingresa la clave de API.
Si tu versión no incluye Moonshot AI en la lista, actualiza OpenCode y actualiza la lista de modelos:
Paso 3: Ingresa tu clave de Kimi API
Cuando OpenCode te pida la clave de API, pega tu clave de Kimi API.
OpenCode almacena las credenciales del proveedor en su archivo local de autenticación. La documentación oficial del proveedor indica esta ruta:
Normalmente no necesitas editar ese archivo manualmente. Usa en su lugar el flujo /connect de proveedores de OpenCode.
Paso 4: Selecciona un modelo de Kimi
Después de conectar el proveedor, elige un modelo desde dentro de OpenCode:
Selecciona el modelo de Kimi que quieras usar. Para nuevos flujos de trabajo de agentes de codificación, empieza con:
Si necesitas ejecutar OpenCode de forma no interactiva con un modelo específico, usa el formato proveedor/modelo que muestra la lista de modelos de tu OpenCode. Por ejemplo:
Luego usa el identificador exacto del modelo que muestra OpenCode.
Paso 5: Ejecuta tu primera tarea de codificación
Empieza con una tarea de bajo riesgo para poder verificar que el proveedor, el modelo, el acceso al proyecto y los permisos funcionan correctamente:
Resultado esperado:
Luego prueba con una pequeña tarea de codificación:
Esto confirma que OpenCode puede leer el proyecto y razonar sobre el código antes de que le permitas hacer cambios.
¿Por qué usar Kimi API con OpenCode?
Kimi API es una buena opción para OpenCode cuando quieres un proveedor de modelos compatible con OpenAI para flujos de trabajo de codificación y agentes.
Gran capacidad de codificación y razonamiento
{{KIMI_MODEL_LATEST_FULL}} está posicionado oficialmente para codificación de largo alcance, seguimiento de instrucciones, autocorrección y ejecución de agentes. Esto lo hace relevante para tareas de OpenCode como ediciones de varios archivos, depuración, refactorización y revisión.
Soporte de contexto largo para proyectos más grandes
La documentación oficial de {{KIMI_MODEL_LATEST_FULL}} indica soporte de contexto largo para {{KIMI_MODEL_LATEST_FULL}} y varios modelos de la serie K2. En un flujo de trabajo con agentes, el contexto largo puede ser útil cuando la tarea requiere leer varios archivos, comparar patrones de implementación o conservar un gran historial de la tarea.
API compatible con OpenAI para una configuración más sencilla
La Kimi API es compatible con el formato de la API de OpenAI. Para herramientas que ya admiten chat completions al estilo OpenAI, esto suele significar que solo necesitas configurar la API key, la Base URL y el nombre del modelo.
Uso flexible más allá de OpenCode
Puedes usar la misma API key de Kimi en otras herramientas de desarrollo compatibles con OpenAI, en scripts directos o en flujos de trabajo internos. Si más adelante usas el servidor de OpenCode o el SDK de OpenCode, configura primero Kimi como proveedor de modelos.
Configuraciones clave de la API de OpenCode que debes conocer
Estas configuraciones controlan la mayoría de los problemas de configuración de la API y del proveedor en OpenCode.
API key
La API key autentica tu solicitud ante el proveedor del modelo. En OpenCode, normalmente la agregas con:
Proveedor
El proveedor indica a OpenCode de dónde proviene el modelo. En esta guía, el proveedor es Moonshot AI / Kimi API. Se pueden configurar otros proveedores por separado, pero cada uno necesita sus propias credenciales y su propia lista de modelos.
Base URL
La Base URL es el endpoint que se usa para las solicitudes directas a la API compatible con OpenAI. Para los ejemplos de la Kimi API, usa el endpoint que se muestra en la documentación actual de la Kimi API o en la consola de tu cuenta.
Nombre del modelo
El nombre del modelo debe coincidir exactamente con el del proveedor. Un pequeño error de tipeo puede provocar un error de modelo no encontrado.
Ejemplo común:
En OpenCode, confirma el identificador de proveedor/modelo con:
Solución de errores comunes de la API de OpenCode
La mayoría de los problemas de configuración provienen de uno de estos cinco puntos: credenciales, endpoint, proveedor, nombre del modelo o tamaño de contexto.
Error de autenticación
La autenticación puede fallar si la API key se pegó incorrectamente, se eliminó o se rotó. También puede ocurrir si se seleccionó el proveedor equivocado, o si la key pertenece a una cuenta o región distinta de la que está configurada actualmente en OpenCode.
Solución:
Vuelve a conectar el proveedor y pega una API key nueva. Si usas variables de entorno para pruebas directas, restablece la key:
Error de endpoint no válido
Un error de endpoint no válido normalmente significa que OpenCode no puede alcanzar el endpoint correcto del proveedor. Las causas comunes incluyen una Base URL mal escrita, el uso mezclado de los endpoints .ai y .cn entre distintas herramientas, o un proxy o firewall que reescribe las solicitudes antes de que lleguen al proveedor.
Solución:
Revisa el endpoint que se muestra en la documentación actual de la Kimi API o en la consola. Para pruebas directas de la API, usa un mismo endpoint de forma consistente:
Modelo no compatible
Este error puede ocurrir cuando el nombre del modelo está mal escrito, cuando el modelo seleccionado no está disponible para tu cuenta, o cuando la caché de la lista de modelos de OpenCode está desactualizada. También puede ocurrir cuando el identificador de proveedor/modelo que usa OpenCode es distinto del nombre de modelo bruto que muestra la documentación del proveedor.
Solución:
Luego, selecciona el modelo de nuevo con:
Límite de tasa excedido
Un error de límite de tasa suele significar que el proveedor recibió demasiadas solicitudes en muy poco tiempo. Esto puede pasar si se ejecutan varias tareas de agentes al mismo tiempo, o si un script o una integración reintenta solicitudes fallidas de forma demasiado agresiva.
Solución:
Pausa la tarea, reduce las ejecuciones en paralelo y revisa el estado de cuota o facturación en la consola de tu proveedor. Evita escribir bucles de reintento infinitos alrededor de OpenCode o de las llamadas directas a la Kimi API.
Desborde de la ventana de contexto
Un desborde de la ventana de contexto suele significar que la tarea es demasiado grande para que el modelo la procese de una sola vez. Esto puede pasar si se incluyen demasiados archivos, si se le pide a OpenCode que inspeccione todo el repositorio, o si una sesión larga ha acumulado demasiado historial de conversación.
Solución:
Pídele a OpenCode que trabaje en un alcance más reducido:
También puedes iniciar una sesión nueva para una tarea más específica.
Conclusión
OpenCode puede conectar tu base de código a proveedores de modelos y ejecutar tareas de programación desde la terminal. Kimi API puede proporcionar el backend del modelo para esos flujos de trabajo mediante una configuración compatible con OpenAI. Si quieres un flujo de trabajo práctico con un agente de programación, crea tu clave de Kimi API, conecta Moonshot AI en OpenCode, elige un modelo de Kimi y ejecuta una tarea pequeña de un proyecto para verificar la configuración.
Preguntas frecuentes
/connect. OpenCode almacena las credenciales de los proveedores de forma local, y la documentación oficial indica ~/.local/share/opencode/auth.json como la ruta del archivo de credenciales.opencode models. Para la API de Kimi, elige el identificador exacto del modelo Kimi que aparece en tu lista de modelos de OpenCode, como kimi-k2.6 cuando esté disponible para tu cuenta./connect.