Guia de Configuracion de OpenCode: Alternativa Open Source a Claude Code en tu VPS
Instala y configura OpenCode en un VPS Linux. Conectalo a modelos open source baratos como MiniMax M2.7, Qwen 3.6 y DeepSeek V4. La alternativa open source a Claude Code que cuesta una fraccion del precio.
Claude Code es bueno. Yo lo uso. Pero cuesta $20/mes como minimo, consume tus limites de tasa rapido, y si estas en el plan anual, estas atado a los precios de Anthropic. Con GitHub Copilot cambiando a facturacion por uso el 1 de junio, muchos desarrolladores buscan algo que puedan controlar.
OpenCode es la alternativa open source que sigue mejorando. Mas de 120K estrellas en GitHub, mas de 75 proveedores de modelos, y puedes ejecutarlo en un VPS de $6/mes con modelos open source que cuestan centavos por solicitud. Lo he estado usando junto con Hermes Agent y OpenClaw durante las ultimas semanas y se ha convertido en mi agente de codificacion en terminal por defecto.
Esta guia cubre la instalacion en un VPS Linux, la conexion a modelos baratos, y el flujo de trabajo que realmente uso dia a dia.
Lo que cubre esta guia
- Instalar OpenCode en un VPS Linux en menos de un minuto
- Conectar a modelos open source baratos via OpenRouter y proveedores directos
- Configurar OpenCode Go por $10/mes con acceso a 12 modelos
- Modo plan vs modo construccion, el flujo /init, y consejos de uso real
- Como se compara OpenCode con Claude Code, Codex CLI y Aider
Que es OpenCode realmente
OpenCode es un agente de codificacion basado en terminal. Lee tu base de codigo, planifica cambios, edita archivos, ejecuta comandos e itera sobre errores — el mismo ciclo que ejecuta Claude Code, pero open source y compatible con cualquier proveedor. Funciona con Anthropic, OpenAI, Google, Alibaba, MiniMax, DeepSeek, Xiaomi, Moonshot y mas de 70 proveedores mas. Tambien puedes usar modelos locales a traves de Ollama.
La diferencia clave con Claude Code: tu eliges el modelo y el proveedor. Si Claude Sonnet es demasiado caro para una tarea, cambia a Qwen 3.6 Plus a $0.33/M de tokens de entrada. Si necesitas maximo razonamiento, cambia a GLM 5.1. Tu controlas el costo.
OpenCode GitHubInstalar OpenCode en un VPS
El script de instalacion se encarga de todo. En un VPS Linux:
curl -fsSL https://opencode.ai/install | bashEsto instala el binario opencode. Verifica que funciona:
opencode --versionOtros metodos de instalacion si el script no funciona en tu configuracion:
npm install -g opencode-aibun install -g opencode-aibrew install anomalyco/tap/opencodedocker run -it --rm ghcr.io/anomalyco/opencodeLo que necesitas
- Node.js 18+ (el script de instalacion se encarga de esto en la mayoria de sistemas)
- Una API key de al menos un proveedor
- Un emulador de terminal que soporte imagenes si quieres arrastrar y soltar capturas de pantalla (WezTerm, Ghostty, Kitty, o Alacritty)
En un VPS sin interfaz grafica, no necesitas soporte de imagenes. OpenCode funciona bien sobre SSH plano.
Configurar un proveedor de modelos
OpenCode soporta tres formas de conectar modelos, de la mas facil a la mas flexible.
Opcion 1: OpenCode Zen (la mas simple)
OpenCode Zen es el proveedor integrado. Te registras en opencode.ai/auth, obtienes una API key, y la pegas en OpenCode.
Ejecuta /connect en el TUI, selecciona opencode, y pega tu clave.
Opcion 2: OpenRouter (mas modelos)
OpenRouter te da acceso a mas de 200 modelos a traves de una sola API key. Esto es lo que uso para la mayoria de mi trabajo.
echo "OPENROUTER_API_KEY=your-key-here" >> ~/.config/opencode/.envLuego en OpenCode, ejecuta /connect y selecciona OpenRouter.
Opcion 3: Claves directas del proveedor
Para proveedores especificos puedes configurar variables de entorno directamente:
# MiniMax
echo "MINIMAX_API_KEY=your-key" >> ~/.config/opencode/.env
# Z.AI (GLM)
echo "ZAI_API_KEY=your-key" >> ~/.config/opencode/.env
# Xiaomi MiMo
echo "MIMO_API_KEY=your-key" >> ~/.config/opencode/.env
# DeepSeek
echo "DEEPSEEK_API_KEY=your-key" >> ~/.config/opencode/.env
# Moonshot (Kimi)
echo "MOONSHOT_API_KEY=your-key" >> ~/.config/opencode/.envOpenCode Go: $10/mes, todos los modelos incluidos
Si no quieres gestionar multiples API keys, OpenCode Go incluye 12 modelos open source populares en una sola suscripcion por $10/mes. Para un analisis detallado con limites y uso real, consulta la guia de OpenCode Go.
OpenCode GoQue incluye
- $10/mes
- MiniMax M2.7, M2.5, MiMo V2.5 Pro, GLM 5, GLM 5.1, Kimi K2.5, K2.6, DeepSeek V4 Pro, V4 Flash, Qwen 3.5 Plus, Qwen 3.6 Plus y mas
- Modelos alojados en EE.UU., UE y Singapur
- Politica de cero retencion
Limites de uso
| Limite | Tope |
|---|---|
| Por 5 horas | $12 |
| Por semana | $30 |
| Por mes | $60 |
Los modelos mas baratos rinden mas. MiniMax M2.7 te da un estimado de 3,400 solicitudes por 5 horas. GLM 5.1 te da 880.
Configuracion
Suscribete en opencode.ai/auth, copia tu API key, luego en OpenCode:
/connectSelecciona OpenCode Go y pega tu clave. Cambia modelos con /models.
El endpoint de Go tambien es accesible via API en https://opencode.ai/zen/go/v1/chat/completions, asi que puedes usarlo con Hermes Agent u OpenClaw tambien.
Trabajar con OpenCode dia a dia
Inicializar un proyecto
La primera vez que abres OpenCode en un proyecto:
cd /path/to/project
opencodeLuego ejecuta:
/initOpenCode analiza tu base de codigo y crea un archivo AGENTS.md en la raiz del proyecto. Este archivo le dice a OpenCode sobre la estructura de tu proyecto, patrones de codificacion y convenciones. Puedes editarlo manualmente para anadir instrucciones personalizadas.
Modo plan vs modo construccion
Este es el flujo de trabajo al que siempre vuelvo. Presiona Tab para cambiar entre modos:
Modo plan (solo lectura): OpenCode lee tu base de codigo y describe como implementaria una funcionalidad. No se hacen cambios.
Modo construccion (lectura-escritura): OpenCode hace los cambios reales en tus archivos.
El patron:
- Cambia a modo plan con Tab
- Describe lo que quieres
- Revisa el plan, anade restricciones
- Cambia a modo construccion con Tab
- Di que adelante
Deshacer y rehacer
Si OpenCode hace un cambio que no te gusta:
/undoRevierte los cambios y muestra tu prompt original para que puedas reformular.
Compartir conversaciones
/shareCrea un enlace a tu conversacion actual. Util para mostrarle a tu equipo lo que hizo el agente.
Elegir el modelo adecuado para cada tarea
| Tarea | Modelo | Razon |
|---|---|---|
| Ediciones rapidas, refactorizacion | MiniMax M2.7 | Barato y rapido |
| Trabajo frontend, generacion de UI | Qwen 3.6 Plus | Fuerte en “vibe coding” |
| Cambios complejos multi-archivo | GLM 5.1 | Mejor precision de codigo |
| Largo contexto, repos grandes | DeepSeek V4 Pro | 1M contexto, baja alucinacion |
| Uso diario por defecto | MiniMax M2.7 o Qwen 3.6 Plus | Balance de costo y calidad |
Cambia modelos en OpenCode con /models. Sin reinicio necesario.
OpenCode vs Claude Code vs Codex CLI
| Caracteristica | OpenCode | Claude Code | Codex CLI |
|---|---|---|---|
| Precio | Gratis (pagas API) | $20/mes + API | Incluido con ChatGPT |
| Eleccion de modelo | 75+ proveedores | Solo Anthropic | Solo OpenAI |
| Open source | Si | No | Si |
| Modo plan | Si (tecla Tab) | No | No |
| Soporte de imagenes | Arrastrar y soltar | Pegar imagenes | No |
| Servidores MCP | Si | Si | Si |
| VPS friendly | Si | Si | Si |
Riesgo de suscripcion
Usar los tokens OAuth de tu suscripcion de Claude Code o ChatGPT con agentes de codificacion automatizados puede hacer que te suspendan la cuenta. Estos proveedores monitorean el uso automatizado. Usa API keys de los modelos listados arriba en su lugar. Consulta nuestra guia de modelos para el desglose completo.
Ejecutar OpenCode en un VPS via SSH
OpenCode funciona sobre SSH. Lo ejecuto en un VPS de Hetzner de $6/mes y me conecto desde mi laptop. Algunos consejos:
Usa tmux para que tu sesion sobreviva si la conexion SSH se cae:
tmux new -s code
cd /path/to/project
opencodePara una mejor experiencia de terminal sobre SSH, usa mosh:
mosh user@your-vps-ipPreguntas frecuentes
OpenCode es realmente gratis?
El software es gratis y open source. Pagas por el uso de la API del LLM. Si usas OpenCode Go, son $10/mes. Si usas claves directas del proveedor, pagas por token. MiniMax M2.7 a traves de OpenRouter cuesta $0.30/M de tokens de entrada, que es aproximadamente $3-7/mes para uso tipico de codificacion.
Puedo usar OpenCode con modelos locales via Ollama?
Si. Configura OPENAI_BASE_URL=http://localhost:11434/v1 y OPENAI_API_KEY=ollama en tu configuracion de OpenCode. Consulta nuestra guia de Ollama con Docker para la configuracion.
Puedo usar OpenCode junto con Hermes Agent?
Si, se complementan. OpenCode es para tareas de codificacion. Hermes Agent es para tareas mas amplias — busquedas web, tareas programadas, mensajeria, gestion de servidor. Ejecuta ambos en el mismo VPS.
Que VPS necesito?
Cualquier VPS Linux con 1GB+ de RAM funciona. OpenCode en si es ligero — el trabajo pesado ocurre en el proveedor de API. Un Hetzner CX22 de $6/mes es mas que suficiente.
Si tambien ejecutas agentes de IA en tu servidor, consulta nuestra guia de configuracion de Hermes Agent y el resumen de alternativas a OpenClaw. Para los modelos mas baratos, la guia de los mejores modelos baratos para Hermes Agent cubre precios y benchmarks para todas las principales opciones open source. Si prefieres un agente de codificacion en terminal mas minimalista con un sistema de extensiones en TypeScript, nuestra guia de configuracion de Pi coding agent cubre instalacion, configuracion de modelos y las mejores extensiones. Para una comparacion detallada de estos dos agentes, consulta la comparacion de OpenCode vs Pi Agent.
