Instalar OpenCode (2026): configuración y primer agente con IA

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?
  • ¿Cuánto cuesta OpenCode Go?
• En resumen

Los posts que ya escribí de OpenCode son de precio y techos de uso: Go a 10 USD y Zen vs Go. Este no. Este es cómo dejar el programa instalado y contestando en tu repo.

OpenCode es un agente de código que vive en la terminal (TUI). No es un IDE. No sustituye a VS Code. Es la pieza que abre el proyecto, lee archivos y propone cambios con el modelo que tú le enchufas.

OpenCode Go, si lo usas, cuesta 10 USD al mes desde el primer mes. Go Plus son 40 USD al mes si necesitas más cupo. Ya no hay primer mes a 5 USD ni crédito de referido. La suscripción está en opencode.ai/go.

Actualizado el 30 de septiembre de 2026.

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 de 10 USD al mes (Go Plus, 40 USD) 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.

Si este comando falla (el postinstall no corre, command not found: opencode, EACCES), ve a los errores comunes de instalación y su solución.

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 (o Go Plus a 40) y los modelos abiertos. Crea la cuenta en opencode.ai/go, completa el billing y conecta Go desde /connect. El detalle de techos 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.
• Cualquier otro error de instalación: los nueve fallos que aparecen de verdad —el postinstall que no corre, el brew install que no existe, el PATH en Windows— están resueltos uno por uno en OpenCode no instala: errores y soluciones.
• 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.

¿Cuánto cuesta OpenCode Go?

10 USD al mes desde el primer cargo. Go Plus son 40 USD al mes. El detalle de límites está en el post de precios. No hay crédito de referido.

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: 10 USD al mes, o 40 USD en Go Plus.
• Precios y techos: los otros dos posts.

El plan, si lo quieres, está en OpenCode Go.

Si estás armando tu kit de herramientas de programación con IA y vas a pagar licencias o suscripciones, en Eneba consigues un 5% de descuento con mi enlace. Es un enlace de afiliado: a ti te sale más barato y a mí me ayuda a mantener el blog. Si es para tu equipo, aquí explico cómo comprar licencias de software baratas en Eneba. El 5% se aplica con el código CreaCosas al pagar, siempre que entres por el enlace.

---

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