---
title: "Guia de Configuracion de OpenCode: Alternativa Open Source a Claude Code en tu VPS"
description: "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."
date: 2026-04-30
categories: ["AI"]
tags: ["ai-tools","self-hosted","vps"]
---
import Button from "@components/widgets/Button.astro";
import Notice from "@components/widgets/Notice.astro";
import ListCheck from "@components/widgets/ListCheck.astro";
import Accordion from "@components/widgets/Accordion.astro";
import Tabs from "@components/widgets/Tabs.astro";
import Tab from "@components/widgets/Tab.astro";
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](/es/alternativas-github-copilot-2026/), muchos desarrolladores buscan algo que puedan controlar.
[OpenCode](https://opencode.ai/) 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](/es/guia-configuracion-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.
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.
## Instalar OpenCode en un VPS
El script de instalacion se encarga de todo. En un VPS Linux:
```bash
curl -fsSL https://opencode.ai/install | bash
```
Esto instala el binario `opencode`. Verifica que funciona:
```bash
opencode --version
```
Otros metodos de instalacion si el script no funciona en tu configuracion:
```bash
npm install -g opencode-ai
```
```bash
bun install -g opencode-ai
```
```bash
brew install anomalyco/tap/opencode
```
```bash
docker run -it --rm ghcr.io/anomalyco/opencode
```
### Lo 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](https://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.
```bash
echo "OPENROUTER_API_KEY=your-key-here" >> ~/.config/opencode/.env
```
Luego en OpenCode, ejecuta `/connect` y selecciona OpenRouter.
### Opcion 3: Claves directas del proveedor
Para proveedores especificos puedes configurar variables de entorno directamente:
```bash
# 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/.env
```
## OpenCode Go: $10/mes, todos los modelos incluidos
Si no quieres gestionar multiples API keys, [OpenCode Go](https://go.bitdoze.com/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-go-plan/).
### Que 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](https://opencode.ai/auth), copia tu API key, luego en OpenCode:
```
/connect
```
Selecciona `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](/es/guia-configuracion-hermes-agent/) u OpenClaw tambien.
## Trabajar con OpenCode dia a dia
### Inicializar un proyecto
La primera vez que abres OpenCode en un proyecto:
```bash
cd /path/to/project
opencode
```
Luego ejecuta:
```
/init
```
OpenCode 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:
1. Cambia a modo plan con Tab
2. Describe lo que quieres
3. Revisa el plan, anade restricciones
4. Cambia a modo construccion con Tab
5. Di que adelante
### Deshacer y rehacer
Si OpenCode hace un cambio que no te gusta:
```
/undo
```
Revierte los cambios y muestra tu prompt original para que puedas reformular.
### Compartir conversaciones
```
/share
```
Crea 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 |
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](/es/mejores-modelos-opensource-openclaw/) 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:
```bash
tmux new -s code
cd /path/to/project
opencode
```
Para una mejor experiencia de terminal sobre SSH, usa **mosh**:
```bash
mosh user@your-vps-ip
```
## Preguntas frecuentes
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.
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](/ollama-docker-install/) para la configuracion.
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.
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](/es/guia-configuracion-hermes-agent/) y el resumen de [alternativas a OpenClaw](/es/alternativas-openclaw/). Para los modelos mas baratos, la guia de los [mejores modelos baratos para Hermes Agent](/es/mejores-modelos-baratos-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](/es/guia-configuracion-pi-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](/es/opencode-vs-pi-agent/).