OpenCode: probé esta tarde la alternativa open source a Claude Code y creé un Pomodoro funcional en 9 minutos
Llevas meses leyendo que para usar un agente de código necesitas pagar.
Que Claude Code, 100 euros al mes en su plan Max. Que Cursor, 20. Que sin suscripción no puedes hacer nada serio con IA y código.
Mentira. O verdad a medias, que es peor.
Existe una alternativa open source que se llama OpenCode, se instala en tu terminal en menos de un minuto, y le conectas la API que tú quieras. O ninguna, si usas un modelo local.
Y si la terminal te da pereza, también tiene aplicación de escritorio que se instala con doble clic. Sí, así de fácil.
La probé esta tarde. Te cuento todo: lo bueno, lo que casi me hace abandonar, y lo que conseguí hacer en menos de diez minutos sin escribir una línea de código.
¿Qué es OpenCode exactamente?
OpenCode es un agente de código open source que vive en tu terminal. También tiene aplicación de escritorio y extensiones para VS Code, Cursor y Zed, pero su corazón está en la línea de comandos.
Algunos datos que importan:
- Más de 150.000 estrellas en GitHub
- Lo usan más de 6,5 millones de desarrolladores al mes
- Licencia MIT, completamente gratis
- No almacena tu código ni tu contexto
La diferencia clave con Claude Code, Cursor o cualquier otra herramienta cerrada es esta: OpenCode no te ata a un proveedor. Tú decides qué modelo conectar. Puede ser Claude, GPT, Gemini, DeepSeek, Grok, o un modelo local con Ollama.
Eso cambia el juego. Pagas por uso, no por suscripción. Y si tiras de modelo local, no pagas nada.
Por qué he decidido probarlo
Soy técnico de IT en un hospital. Antes estuve 18 años en Recursos Humanos. No soy desarrollador profesional, pero sí toqueteo proyectos, hago automatizaciones y desde hace año y medio uso herramientas de IA todos los días.
Claude Code está muy bien. Lo he probado. Pero 100 euros al mes para alguien que no programa para vivir es difícil de justificar. Y con la API de Anthropic pasa lo mismo: cuando empiezas a usarla en serio, la factura sube rápido.
Cuando supe que existía OpenCode y que podías conectarle DeepSeek a 0,14 dólares por millón de tokens, hice cálculos. Para mi uso real, salía a menos de 5 euros al mes.
Tenía que probarlo.
Paso 1: Instalación
Abrí la terminal y pegué este comando, que es el oficial de la web:
curl -fsSL https://opencode.ai/install | bash
Si usas npm, también funciona:
npm i -g opencode-ai
Y para macOS o Linux con Homebrew:
brew install anomalyco/tap/opencode
La instalación tardó menos de un minuto. Termina con un mensaje de bienvenida muy bonito en ASCII y te dice que ya puedes usar el comando opencode desde cualquier carpeta.
Spoiler: no funcionó a la primera.
Problema 1: «opencode: command not found»
Aquí estuvo el momento de «esto no es lo que prometía la web».
Después de instalar, escribí opencode en la terminal y me devolvió:
opencode: command not found
Lo que pasa es que el instalador añade OpenCode a tu PATH editando el archivo .bashrc, pero ese cambio no se aplica en la terminal que ya tenías abierta. Necesitas refrescarlo o abrir una terminal nueva.
Solución
Si te pasa, tienes dos opciones:
Opción A — Recargar el .bashrc:
source ~/.bashrc
Opción B — Cerrar la terminal y abrir otra nueva.
Yo elegí la A. Funcionó al instante.
Esto le pasa a casi todo el mundo en la primera instalación. No es un fallo de OpenCode: es cómo funciona Linux y la mayoría de instaladores que tocan el PATH. Pero si nadie te lo cuenta, te bloqueas en el primer minuto.
Paso 2: Elegir un modelo
OpenCode arranca con varios modelos gratuitos incluidos. Esto está muy bien para probar la herramienta sin gastar un euro.
Pero la gracia de OpenCode es conectarle el modelo que tú quieras. Para verlo, una vez dentro de OpenCode escribes:
/models
Te aparece una lista con todos los proveedores compatibles. Estos son los más interesantes a fecha de hoy:
| Modelo | Input por millón de tokens | Output por millón de tokens |
|---|---|---|
| DeepSeek V4 Flash | $0,14 | $0,28 |
| DeepSeek V4 Pro (75% descuento hasta 31 mayo) | $1,74 | $3,48 |
| Claude Sonnet 4.6 | $3 | $15 |
| Claude Opus 4.6 | $5 | $25 |
| GPT-5.4 | $2,50 | $10 |
| Gemini 2.5 Flash-Lite | $0,10 | $0,40 |
| Ollama (local) | 0 | 0 |
Los precios son verificados en las páginas oficiales de cada proveedor a fecha de hoy.
Mi recomendación sincera:
- Si estás empezando y quieres pagar lo mínimo: DeepSeek V4 Flash. Calidad-precio imbatible.
- Si tienes un ordenador potente y quieres cero euros: Ollama con un modelo como Qwen 2.5 Coder.
- Si necesitas la máxima calidad para tareas críticas: Claude Opus 4.6 o Sonnet 4.6.
En el vídeo del canal os explico cómo elegir entre DeepSeek y Opus dependiendo de la tarea, porque no siempre lo más barato compensa.
Paso 3: Conectar la API
Una vez elegido el modelo, conectarlo es fácil. Dentro de OpenCode escribes:
/auth login
Te aparece un menú. Eliges el proveedor (DeepSeek, Anthropic, OpenAI, etc.) y pegas tu API key.
Dónde conseguir las API keys
- DeepSeek: platform.deepseek.com → API Keys
- Anthropic (Claude): console.anthropic.com → API Keys
- OpenAI: platform.openai.com → API Keys
- Ollama (local): no necesita key, solo tenerlo instalado
OpenCode guarda la clave de forma cifrada en ~/.local/share/opencode/auth.json. No la sube a ningún lado.
La demo: crear un Pomodoro funcional desde cero
Aquí es donde OpenCode se gana el sueldo.
Abrí una carpeta vacía llamada Pomodoro, lancé opencode desde dentro, y le di este prompt:
«Crea un Pomodoro funcional en HTML, CSS y JavaScript en un solo archivo index.html. Temporizador de 25 minutos para trabajo, descanso corto de 5 minutos. Botones Start, Pause y Reset. Que muestre el tiempo en grande en formato MM:SS. Que cambie de color según el modo: rojo para trabajo, verde para descanso. Sonido o alerta visual al terminar cada ciclo. Diseño minimalista, fondo oscuro, tipografía grande. Primero hazme un plan. Luego, si te confirmo, lo creas.»
Lo que pasó después:
- OpenCode generó un plan en unos 30 segundos. Me dijo qué estructura HTML tendría, qué clases CSS usaría, cómo organizaría la lógica JavaScript del temporizador y cómo manejaría las transiciones entre modos.
- Le dije «adelante» y empezó a crear el archivo. Tardó alrededor de 4 minutos en generar el
index.htmlcompleto. - Abrí el archivo en el navegador. Funcionaba a la primera. Botones operativos, contador descendiente, transición de colores entre trabajo y descanso, alerta visual al terminar cada ciclo.
Total desde que escribí el prompt hasta tener el Pomodoro funcionando: 4 minutos.
Si sumamos la instalación inicial (1 minuto), elegir modelo (30 segundos), conectar API (1 minuto) y resolver el problema del PATH (otro minuto perdido), el tiempo total fue menos de 9 minutos.
Sin escribir una sola línea de código.
Lo que no te cuentan en otros vídeos
Voy a ser honesto, que es lo que aquí me toca.
Problema 2: la calidad depende del modelo, no del programa
OpenCode es solo el contenedor. La inteligencia viene del modelo que conectes. Si conectas un modelo gratuito muy pequeño, los resultados serán más justos. El Pomodoro lo creó perfecto con el modelo gratuito incluido, pero para tareas más complejas (refactorizar un proyecto grande, debug avanzado), notarás la diferencia entre DeepSeek Flash y Claude Opus.
Solución: empieza con DeepSeek Flash para casi todo. Solo escala a Opus o Sonnet cuando una tarea concreta lo requiera.
Problema 3: hay forks con el mismo nombre
Si buscas «OpenCode» en Google, te van a salir varios proyectos diferentes con nombres parecidos. La web oficial actual es opencode.ai y el repositorio activo es github.com/anomalyco/opencode. Hay un repositorio antiguo llamado opencode-ai/opencode que parece otro proyecto distinto.
Solución: ve siempre desde opencode.ai. No instales OpenCode desde otros repos sin verificar.
Problema 4: terminal-first puede asustar a los no técnicos
OpenCode está pensado para gente que se mueve cómoda en línea de comandos. Si nunca has abierto una terminal, los primeros 10 minutos pueden ser frustrantes.
Solución: descárgate la aplicación de escritorio. Te lo cuento ahora.
OpenCode Desktop: la opción gráfica para los que odian la terminal
Si todo lo que has leído hasta aquí te suena a chino, respira. Hay una alternativa mucho más cómoda y la mayoría de tutoriales no la mencionan.
OpenCode tiene una aplicación de escritorio descargable directamente desde su web. Funciona igual que la versión de terminal, pero con una interfaz gráfica limpia, ventana propia y sin tener que pelearte con comandos.
Está actualmente en versión Beta, así que te aviso por adelantado: es estable para uso normal, pero pueden aparecer pequeños bugs o cambios entre versiones. Yo personalmente no he tenido problemas, pero soy honesto contigo: beta es beta.
Dónde descargarla
Vas a opencode.ai/download y eliges tu sistema operativo. Hay versiones para todos:
- macOS (Apple Silicon) — para Mac M1, M2, M3 o M4
- macOS (Intel) — para Mac antiguos con procesador Intel
- Windows (x64) — instalador estándar
- Linux (.deb) — para Ubuntu, Debian, Lubuntu y derivados
- Linux (.rpm) — para Fedora, openSUSE y derivados
Si tienes Homebrew instalado en macOS, también puedes hacerlo en una sola línea:
brew install --cask opencode-desktop
Por qué te puede interesar más que la terminal
Tres razones honestas:
- No hay que tocar el PATH ni el .bashrc. El problema del «command not found» que tuve yo desaparece. Instalas, abres y funciona.
- Interfaz visual para gestionar sesiones, modelos y configuración. En lugar de escribir
/modelso/auth login, todo está en menús con clics. - Misma potencia que la versión terminal. No es una versión recortada. Lo que hace una, lo hace la otra.
Cuándo tiene más sentido cada versión
| Situación | Recomendación |
|---|---|
| Eres desarrollador y vives en terminal | Versión terminal (más rápida y scripteable) |
| Eres profesional curioso de la IA pero no técnico | Versión escritorio |
| Quieres automatizar OpenCode dentro de scripts | Versión terminal (tiene CLI completa) |
| Te bloqueas en cuanto ves una pantalla negra con texto | Versión escritorio, sin dudas |
| Quieres usarlo desde VS Code, Cursor o Zed | Extensión IDE (la tercera opción) |
Para la mayoría de los lectores de este blog —profesionales que usan IA todos los días pero no son desarrolladores—, la versión de escritorio es probablemente la mejor opción para empezar.
Yo en el vídeo del canal grabo la versión terminal porque es la que mejor enseña qué hace OpenCode por dentro. Pero si tú no quieres saber lo que pasa por dentro y solo quieres usarlo, descárgate la app de escritorio y olvídate.
Problema 5: Plan mode no es opcional, es obligatorio
Si le dejas tocar código directamente sin pedirle un plan primero, puede tomar decisiones que rompen tu proyecto. OpenCode tiene dos modos: Plan (solo analiza y propone, no toca nada) y Build (modifica archivos). Por defecto arranca en Build.
Solución: pulsa Tab al empezar para cambiar a Plan mode. Pídele un plan, lo revisas, y solo entonces vuelves a Build con otro Tab.
¿Cuándo SÍ usar OpenCode?
- Si pagas Claude Code o Cursor de tu bolsillo y notas la suscripción cada mes
- Si quieres probar varios modelos sin atarte a uno solo
- Si tienes proyectos personales o secundarios que no justifican una suscripción cara
- Si te mueves bien en terminal y prefieres herramientas open source
- Si quieres aprender cómo funcionan los agentes de código por dentro
¿Cuándo NO usar OpenCode?
- Si tu empresa paga Claude Code o Cursor por ti
- Si necesitas la máxima fiabilidad en producción y no tienes tiempo para configurar
- Si tu trabajo depende de funcionalidades muy específicas de Claude Code (como su integración con GitHub Actions oficial)
(Antes en esta lista decía «si nunca has usado una terminal, no lo uses». He cambiado de opinión a mitad del artículo: con la app de escritorio en beta, esa barrera desaparece. Si te asusta la terminal, descárgate la versión gráfica y a tirar.)
Lo que llevo aprendido en estas horas
Lo barato no siempre sale caro. Y lo gratuito tampoco siempre sale gratis.
OpenCode es una herramienta seria, mantenida por una comunidad enorme, gratis, y con la flexibilidad que las suscripciones cerradas nunca te van a dar. Es la opción más interesante que he visto en meses para alguien que no quiere atarse a Anthropic, OpenAI o Google.
No reemplaza a Claude Code al cien por cien, pero para el 80% de los usos reales de un trabajador con curiosidad por la IA, está más que de sobra. Y en el otro 20%, conectas Claude Sonnet 4.6 o Opus 4.6 con tu API key y tienes lo mejor de los dos mundos.
Quien siga pagando 100 euros al mes sin haberlo probado, paga la pereza.
No es magia. Es saber dónde mirar.
Recurso descargable: comandos OpenCode copia-y-pega
He preparado un PDF con todos los comandos que aparecen en este artículo, organizados por bloques: instalación, configuración, prompts de ejemplo, atajos de teclado y solución de los 5 problemas más comunes.
👉 DESCARGAR GUÍA OPENCODE EN PDF
(Sustituir el # por la URL real del PDF cuando lo subas a WordPress.)
¿Quieres que te avise cuando publique tutoriales así?
Cada domingo envío una newsletter con una herramienta de IA que he probado en mi semana real, los problemas que encontré y cómo los resolví. Sin gurús, sin humo, sin promesas vacías.
Suscríbete gratis a Diario Vida →
Cuéntame en los comentarios: ¿qué API vas a conectar tú a OpenCode? ¿DeepSeek por barato, Opus por calidad, u Ollama para no pagar nada? Y si te has atascado en algún paso, dímelo aquí abajo y lo resolvemos.
Categorías sugeridas: Herramientas IA, Tutoriales Tags sugeridos: opencode, claude code, deepseek, agente código, ia open source, terminal, alternativas claude
- ✅ Tips de IA práctica cada semana
- ✅ Sistemas de constancia de 500+ días
- ✅ Herramientas probadas (no teoría)