Cómo instalar OpenCode y programar con IA paso a paso

Tabla de Contenidos

• Dos nombres que no hay que mezclar
• Paso a paso

  • 1. Instala el CLI de OpenCode
  • 2. Comprueba que corre
  • 3. Conecta un proveedor
  • 4. Entra a un repo real
  • 5. Manda la primera tarea
• Si algo falla
• Preguntas frecuentes

  • ¿OpenCode y OpenCode Go son lo mismo?
  • ¿Puedo instalarlo con Homebrew o Scoop?
  • ¿Necesito una GPU potente?
  • ¿Cómo consigo los 5 USD de crédito?
• En resumen

Dos nombres que no hay que mezclar

• OpenCode: el CLI. Lo instalas una vez. Es software libre, corre como opencode.
• OpenCode Go: la suscripción (~5 USD el primer mes, 10 después) con modelos abiertos y techos de uso. Es un proveedor que puedes conectar. No es obligatorio para instalar el CLI.

Puedes instalar OpenCode hoy y conectar la API de Anthropic, Z.ai u otra. Go es el atajo si no quieres administrar diez API keys.

Paso a paso

1. Instala el CLI de OpenCode

La doc oficial v2 da estas vías. Elige una:

npm install -g @opencode/cli

bun install -g --trust @opencode/cli

pnpm add -g --allow-build=@opencode/cli @opencode/cli

yarn global add @opencode/cli

curl -fsSL https://opencode.ai/v2/install | bash

El paquete de npm usa un script de postinstall de confianza para bajar el binario nativo de tu plataforma. Por eso bun y pnpm piden el flag de --trust / --allow-build.

Lo que no uses, según esa misma doc: Homebrew, AUR, Scoop, Chocolatey ni un .exe suelto de un espejo. Tutoriales de 2025 que dicen brew install opencode están desactualizados respecto a v2.

Docker existe (ghcr.io/anomalyco/opencode con tags de versión) si tu flujo es contenedor. Para el primer día, npm o el script bastan.

2. Comprueba que corre

Cierra y abre la terminal (el PATH a veces no se refresca). Luego:

opencode

Tiene que abrir la TUI, no command not found. Si el script de curl instaló en un directorio que tu shell no carga, abre una sesión nueva o haz source de tu .bashrc / .zshrc.

No hace falta GPU. No hace falta opencode tui como subcomando mágico: el binario sin argumentos lanza la interfaz.

3. Conecta un proveedor

Dentro de la TUI, el comando es:

/connect

Ahí eliges el proveedor. Caminos razonables:

• OpenCode Go: si quieres el plan de 10 USD y los modelos abiertos. Crea la cuenta con el enlace de 5 USD, completa el billing, y conecta Go desde /connect. El detalle de techos (5 horas / semana / mes) está en el post de precios; aquí solo importa que la sesión autentique.
• Z.ai / GLM: si ya tienes el Coding Plan, conéctalo como proveedor custom con el endpoint de coding. No mezcles la key de chat genérico.
• Anthropic, OpenAI u otro: /connect y pegas la key. OpenCode trae varios de fábrica.

Sin proveedor, la TUI es un caparazón vacío. El error típico del día uno no es “no instala”: es abrir opencode y no haber conectado nada.

4. Entra a un repo real

cd /ruta/a/tu/proyecto
opencode

El agente ve los archivos de ese directorio. Si lo lanzas en $HOME, va a querer opinar sobre todo tu disco. No lo hagas.

Si el proyecto ya tiene un AGENTS.md o un opencode.json, los respeta. Si no, puedes inicializar después; no es bloqueante para el primer prompt.

5. Manda la primera tarea

Pide algo que puedas verificar sin fe:

• “¿Qué hace src/auth.ts?”
• “Escribe un test para esta función y no toques el resto.”

Si edita el archivo correcto y el diff tiene sentido, la instalación está lista. Recién ahí vale la pena hablar de MCP, plugins y temas — la doc de customize existe para el día 2.

Si algo falla

• command not found: PATH. Reabre la terminal. En npm global, a veces falta el prefijo de npm en el PATH de Windows.
• El postinstall de npm se bloqueó: es el script que baja el binario. En bun/pnpm tienes que haber pasado --trust / --allow-build.
• La TUI abre pero el modelo no responde: no es la instalación, es /connect. Revisa la key y el proveedor.
• Go se agota a media tarde: es el techo de uso, no un bug del CLI. Eso está explicado en el post de límites.

Preguntas frecuentes

¿OpenCode y OpenCode Go son lo mismo?

No. CLI vs suscripción de modelos. Puedes usar el CLI sin Go.

¿Puedo instalarlo con Homebrew o Scoop?

No según la doc v2. npm/bun/pnpm/yarn o el script opencode.ai/v2/install.

¿Necesito una GPU potente?

No para Go ni para APIs en la nube.

¿Cómo consigo los 5 USD de crédito?

Con el enlace de Go. Se aplican a límites de uso.

En resumen

• Instala el CLI por la vía oficial v2, no por un brew de un blog.
• /connect es el paso que la gente se salta.
• Lanza opencode dentro del repo.
• Go es opcional y barato de probar con el crédito de referido.
• Precios y techos: los otros dos posts.

👉 Probar OpenCode Go con 5 USD de crédito

---

Si ya tienes el agente en la cabeza y te falta “que corra en esta máquina”, no necesitas otra comparativa. Necesitas un install que la doc oficial todavía respalde.

— Leandro Valencia