Comprueba el entorno
Prepara Node.js LTS, Git, una carpeta limpia y una terminal con acceso al proveedor.
Guía práctica 2026
Guía de despliegue de OpenCodeInstala, configuray verifica tu modelo
Esta guía ayuda a poner OpenCode en marcha sin perderse entre comandos. Cubre entorno, CLI, proveedor, configuración del proyecto, pruebas de validación y errores frecuentes.
- Entrada recomendada
- CLI primero
- Configuración clave
- Proveedor + modelo
- Ideal para
- Programación con IA
Quick Start
Flujo de despliegue en 7 pasos
Sigue esta secuencia para una primera instalación o una migración a otra máquina.
Instala la CLI
Usa el método oficial y confirma que el comando opencode está disponible.
Conecta un proveedor
Empieza con un solo proveedor y guarda las claves fuera del repositorio.
Elige un modelo
Usa un modelo estable y copia el ID real desde el panel del proveedor.
Crea la configuración
Usa opencode.json para preferencias no secretas del proyecto.
Valida con una tarea pequeña
Pide leer un archivo, editar algo simple y ejecutar una prueba.
Guarda notas de errores
Registra versión de Node, proveedor, proxy, modelo y errores comunes.
Provider
Proveedor: primero haz funcionar una ruta
La mayoría de fallos vienen de claves, URL base, nombres de modelo, proxy o permisos.
| Revisión | Acción recomendada | Error común |
|---|---|---|
| API key | Guárdala fuera del repositorio. | Subir secretos a Git. |
| Base URL | Usa el endpoint correcto. | Usar una ruta equivocada. |
| Modelo | Copia el ID real. | Usar un nombre comercial. |
| Permisos | Empieza con cautela. | Permitir todo sin probar. |
Project config example
Use this as a non-secret configuration shape. Confirm exact fields with your OpenCode version.
{
"model": "provider/model-id",
"permission": { "edit": "ask", "bash": "ask" },
"ignore": ["node_modules", ".env", "dist"]
}Platform Notes
Notas por plataforma
Windows
Usa PowerShell o WSL si dependes de herramientas Linux.
macOS
Verifica qué instalación de Node usa tu terminal.
Linux
Evita root para tareas de desarrollo y protege las claves.
Troubleshooting
Orden de diagnóstico
- Si falta el comando, revisa PATH.
- Si no hay modelos, revisa proveedor, clave y URL.
- Si hay timeout, separa red, proxy y límites.
- Si fallan permisos, revisa carpeta y política.
- Si baja la calidad, valida con un modelo estable.
FAQ
Preguntas frecuentes
¿Qué necesito antes de desplegar OpenCode?
Node.js LTS, Git, terminal y una clave de proveedor.
¿Dónde va opencode.json?
Normalmente en la raíz del repositorio, sin secretos.
¿Cómo valido el despliegue?
Lee un archivo, edita uno pequeño y ejecuta una prueba.