OpenCode es una herramienta de programación con IA que vive dentro de la terminal y es de código abierto. No es un editor ni un plugin del editor: se lanza en la carpeta del proyecto y trabaja sobre esos ficheros.

• Linux

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

• Windows

npm install -g @opencode/cli
opencode --version

Para trabajar, siempre desde la raíz del proyecto:

cd mi-proyecto
opencode

Se abre la TUI: la caja de entrada abajo, y encima la conversación.

opencode upgrade

OpenCode no es un modelo: habla con modelos de otros. Conviene no confundir las dos cosas:

Recién instalado ya funciona, sin registro ni tarjeta: de serie usa los modelos de OpenCode Zen, y varios son gratuitos. En /models se reconocen por la etiqueta free —la lista concreta cambia con el tiempo—.

Abre la misma pantalla que sale en el primer arranque, con la lista de servicios a los que enlazarse. Lo importante es que no te obliga a contratar nada nuevo: si ya pagas ChatGPT, GitHub Copilot, Anthropic o Google, esa suscripción se reaprovecha desde OpenCode. Puedes tener varios proveedores conectados a la vez.

Lista todos los modelos de los proveedores que tengas conectados y elige con cuál se manda la siguiente petición. El cambio es instantáneo y la conversación no se pierde, y de ahí sale el flujo más rentable del día a día:

• Plan con el modelo más capaz, que es donde se decide si el cambio está bien planteado.
• Tab a Build con uno más barato, que es donde solo hay que ejecutar lo ya decidido.

Qué es un subagente y para qué sirve está en el tema de Agentes. Plan y Build (sección 5) también son agentes: son los principales, los que hablan contigo. De serie, OpenCode trae dos subagentes:

• general: para tareas de varios pasos que investigan y cambian código.
• explore: busca y entiende el código sin modificar nada.

Hay tres formas de lanzarlo:

• Invocándolo directamente con @ y su nombre. Al escribir @ sale en la lista junto a los ficheros y las skills.

@explore ¿dónde se valida el token JWT y qué endpoints no pasan por esa validación?

• Con lenguaje natural, diciéndole que lo use:

Usa el subagente general para migrar los tests del módulo pedidos de JUnit 4 a JUnit 5

• Automáticamente: lo decide OpenCode, que lo lanza cuando la tarea encaja con su description.

Cada subagente es un fichero .md:

• .opencode/agents/ en el proyecto: está en el repositorio para que sea solo de ese proyecto.
• ~/.config/opencode/agents/ en tu ordenador: para compartirlo entre proyectos.

Qué es una skill y cómo se escribe está en el tema de Skills.

Hay tres formas de lanzarla:

• Invocándola directamente con @ y su nombre: al escribir @ sale en la lista junto a los ficheros y los subagentes.

@revisar-pr revisa el PR 128

• Con lenguaje natural, diciéndole que la use:

Usa la skill revisar-pr con el PR 128

• Automáticamente: lo decide OpenCode, que la carga cuando su description encaja con lo que pides («revisa el PR 128»).

Cada skill es una carpeta con su SKILL.md:

• .opencode/skills/ en el proyecto: está en el repositorio para que sea solo de ese proyecto.
• ~/.config/opencode/skills/ en tu ordenador: para compartirla entre proyectos.

OpenCode tiene dos modos: Plan y Build, y se cambia entre ellos con Tab.

Lee, analiza y te propone un plan, sin editar ningún fichero. El plan te lo cuenta en la conversación; solo si se lo pides lo guarda en ~/.opencode/plan, que es el único sitio donde puede escribir. Los comandos los ejecuta sin preguntarte.

Puedes además pedirle que te pregunte lo que no tenga claro («antes de proponer nada, hazme las preguntas que necesites») en lugar de que se invente los huecos. Leer el plan cuesta un minuto; deshacer un cambio mal enfocado, bastante más.

Cuando el plan está bien, Tab a Build y que lo ejecute.

Ejecuta: edita ficheros y lanza comandos sin preguntarte casi nada. Solo pide permiso para leer un .env o para salir de la carpeta del proyecto.

Genera AGENTS.md, las instrucciones fijas del proyecto: analiza el código y escribe en la raíz qué es el proyecto, su arquitectura y los comandos habituales (arrancar, probar, construir). Se lee solo en cada sesión. Es un punto de partida: revísalo y edítalo a mano.

Empieza de cero: sesión nueva y contexto vacío. Se hace cada vez que cambias de tarea.

Deshace: quita el último mensaje de la conversación y deshace los cambios que hizo en los ficheros. /redo lo vuelve a aplicar.

Resume la conversación para liberar contexto y seguir en la misma sesión.

Copia al portapapeles la última respuesta de OpenCode

Exporta toda la conversación (no solo la última respuesta)

No es un comando, son dos pulsaciones de tecla: paran al agente en seco, esté pensando o a media tarea. La primera solo avisa: hasta la segunda no se para. Lo que ya ha hecho se queda hecho: le dices qué cambiar y sigue.

Los plugins añaden a OpenCode funciones que no trae de serie. Son paquetes de npm (o de Git) y se gestionan desde la terminal con opencode plugin. Se guardan en la configuración global, así que valen para todos los proyectos.

• Ver los plugins instalados:

opencode plugin list

• Instalar un plugin. Por ejemplo, Quota:

opencode plugin add @slkiser/opencode-quota

• Ver si hay versiones nuevas de los plugins instalados:

opencode plugin check

• Actualizar todos los que estén desactualizados. Para actualizar solo uno, se añade su nombre:

opencode plugin update

• Desinstalar un plugin:

opencode plugin remove @slkiser/opencode-quota

• opencode.ai
• Documentación
• Repositorio