OpenCode: instalación, modelos y primer inicio

OpenCode es un agente de programación con IA de código abierto para el terminal: la herramienta en sí es gratuita (licencia MIT) y puedes conectar cualquier modelo, desde Claude y GPT hasta uno local mediante Ollama. El repositorio del proyecto ya ha superado las doscientas mil estrellas en GitHub. La frase «Claude Code gratis con cualquier modelo» suena atractiva, pero conviene aclararla: la herramienta es gratuita; las condiciones de uso dependen del modelo que elijas.

A continuación encontrarás todo según la documentación oficial: qué es la herramienta, cómo instalarla en macOS, Linux o Windows, cómo conectar un modelo y qué hacer en el primer inicio. Hay una sección aparte sobre los costes, porque aquí «gratis» se aplica solo a la herramienta: los modelos cuestan dinero, y eso es lo que suele causar confusión.

En la documentación encontrarás información práctica sobre cómo trabajar con Ailoot.

¿Qué es OpenCode en términos sencillos?#

En pocas palabras, OpenCode hace lo mismo que Claude Code: recibe una tarea en lenguaje natural y la lleva a cabo en tu proyecto. Se diferencian en dos aspectos. El código es completamente abierto, así que puedes leerlo e inspeccionarlo. Además, la herramienta no está vinculada a un único proveedor de modelos: funciona con más de 75 proveedores, desde Anthropic y OpenAI hasta un modelo local que se ejecuta en tu equipo.

El equipo Anomaly desarrolla el proyecto. El repositorio se creó el 30 de abril de 2025 y, a 4 de octubre de 2026, tiene más de 211 mil estrellas y 28 mil forks (verificado mediante una solicitud a la API de GitHub). Está escrito en TypeScript. La documentación se actualiza continuamente, así que las instrucciones siguientes se basan en la versión actual.

No confundas los nombres: el paquete npm de la línea actual se llama opencode-ai, el repositorio es anomalyco/opencode y el comando del terminal es simplemente opencode. Los artículos antiguos pueden usar la dirección sst/opencode: la organización cambió de nombre y el enlace antiguo ahora redirige al nuevo.

Actualizado el 4 de octubre de 2026: el equipo lanzó OpenCode 2.0, la siguiente generación principal de la herramienta. Las instrucciones de instalación y conexión de modelos que aparecen a continuación siguen siendo para la línea actual 1.x (se instala con el comando curl -fsSL https://opencode.ai/install | bash; la versión actual al 30 de septiembre de 2026 es la 1.18.34): tiene soporte activo y es la versión que instala la documentación oficial en opencode.ai/docs. Más adelante hay una sección aparte sobre qué cambió exactamente en la segunda versión y cuándo conviene cambiarse.

¿En qué se diferencia OpenCode de Claude Code y Codex?#

Si ya tienes una suscripción de Claude, tiene sentido seguir usando Claude Code como herramienta principal; tenemos una guía detallada de instalación. OpenCode resulta útil en tres casos: si quieres trabajar con una suscripción de ChatGPT Plus o GitHub Copilot, ejecutar un modelo local sin pagar por API o usar una sola interfaz para varios modelos. También tenemos una reseña y guía de instalación de Codex.

Si aún estás eligiendo una herramienta, empieza por este resumen: con qué programa la gente en 2026. Y si ya tienes OpenCode instalado y necesitas conectarlo con otros agentes en Devin Desktop mediante ACP, consulta nuestra guía de configuración.

¿Qué ha cambiado en OpenCode 2.0?#

La segunda versión se instala con el comando curl -fsSL https://opencode.ai/v2/install | bash. Según la guía oficial de migración (opencode.ai/v2/docs/migrate-v1), ambas versiones utilizan el mismo comando opencode y ya no se instalan en paralelo de forma predeterminada: el instalador de v2 sustituye el binario de v1 y, antes de instalar v2 mediante un gestor de paquetes, la documentación pide expresamente desinstalar primero la versión v1. Sin embargo, la configuración se lee de los mismos archivos —~/.config/opencode/ y <project>/.opencode/—, así que los ajustes, agentes y servidores MCP se transfieren sin necesidad de reescribirlos. Sí hay que reescribir tres cosas: los plugins (tienen una API nueva), las integraciones con la API del servidor (el protocolo ha cambiado) y los ajustes del terminal (ahora hay un único archivo compartido cli.json en lugar de varios archivos tui.json).

Las dos novedades más destacadas de v2 son estas. Primero, se presentó Console, un servicio de pago para equipos con seguimiento del uso, presupuestos y políticas compartidas para todos los miembros. Segundo, el equipo por fin anunció el precio de la suscripción Go: $10 al mes para Go y $40 al mes para Go Plus, con límites más altos (página opencode.ai/go, verificada el 4 de octubre de 2026). Antes, la documentación solo decía «suscripción de bajo coste», sin indicar una cifra.

Si eres nuevo y solo quieres instalar el agente, sigue las instrucciones que aparecen a continuación: cubren la primera versión actual, que es la que recomienda la propia documentación. Plantéate usar v2 si necesitas las nuevas funciones de plugins o Console para equipos, pero prepárate para reescribir algunos plugins antiguos para adaptarlos a la nueva API. Si te interesa más una aplicación de escritorio de código abierto que no requiera un terminal, tenemos una reseña de ZCode, otro agente similar con interfaz propia.

¿Qué necesitas antes de instalarlo?#

Un poco más sobre el terminal, porque es el único lugar donde la instalación podría no salir según lo previsto. OpenCode muestra una interfaz completa con paneles y resaltado en el terminal, por eso la documentación recomienda un emulador moderno. Si la interfaz se ve mal al iniciarlo, instala primero una de las cuatro opciones mencionadas: WezTerm (funciona en todos los sistemas), Alacritty, Ghostty o Kitty. En Windows, la opción principal es WSL; tiene una sección propia más adelante.

Lo segundo es un modelo. OpenCode funciona mediante el modelo que conectes: por sí solo no procesa solicitudes. Hay cuatro opciones: una suscripción (ChatGPT Plus, GitHub Copilot, GitLab Duo), una clave API de cualquier proveedor, OpenCode Zen, el agregador del propio equipo, o un modelo local mediante Ollama. Las cuatro opciones se explican en la sección sobre cómo conectar un modelo.

Sin una descripción del proyecto, el agente tiene que adivinar los comandos de compilación, la estructura de archivos y las convenciones en uso; de ahí las «alucinaciones». OpenCode usa para esto un archivo AGENTS.md. El mismo enfoque se aplica a Claude Code y a cualquier otro agente; solo cambia el nombre del archivo de instrucciones.

¿Cómo instalar OpenCode en macOS y Linux?#

La opción recomendada es el instalador oficial:

1. Ejecuta el instalador

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

   El script detecta tu sistema y descarga OpenCode. Si después de instalarlo no encuentra el comando, cierra y vuelve a abrir el terminal; la nueva sesión detectará la ruta.

2. Comprueba que se instaló correctamente

   opencode --version
   

   El comando devuelve un número de versión, lo que significa que la instalación se ha completado correctamente. El mensaje «command not found» te lleva de vuelta al primer paso: inicia una nueva sesión del terminal o modifica PATH manualmente.

Si prefieres gestionar los paquetes por tu cuenta, estas son las opciones:

brew install anomalyco/tap/opencode

npm install -g opencode-ai

El comando de Homebrew empieza deliberadamente por anomalyco/tap/: la documentación recomienda su propio tap porque el equipo de Homebrew actualiza con menos frecuencia la fórmula de brew install opencode. El mismo nombre de paquete, opencode-ai, también funciona con bun, pnpm y yarn (bun install -g opencode-ai, yarn global add opencode-ai). En Arch Linux, usa sudo pacman -S opencode desde el repositorio estable o paru -S opencode-bin para obtener la versión más reciente del AUR.

Actualiza OpenCode con opencode upgrade; al iniciarse, también descarga actualizaciones automáticamente si la actualización automática está habilitada. Después de actualizarlo, comprueba la versión con el habitual opencode --version. También incluye una opción para desinstalarlo:

opencode uninstall

El comando muestra exactamente qué se eliminará y pide confirmación. Si quieres, puedes conservar la configuración y los datos de sesión: usa las opciones --keep-config y --keep-data.

¿Cómo instalar OpenCode en Windows?#

La primera opción que recomiendan los propios desarrolladores es WSL. Instálalo con un comando en PowerShell ejecutado como administrador:

wsl --install

Después de reiniciar, abre Ubuntu desde el menú Inicio y ejecuta dentro el comando habitual:

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

Tus archivos de las unidades de Windows están disponibles en WSL mediante /mnt/: la unidad C: está en /mnt/c/ y la D: en /mnt/d/. Así que puedes abrir un proyecto ubicado en C:\Users\Name\project de esta manera:

cd /mnt/c/Users/Name/project
opencode

La segunda opción es prescindir de WSL y usar gestores de paquetes de Windows. En PowerShell:

choco install opencode

scoop install opencode

La tercera opción es la aplicación de escritorio y la versión web. La aplicación se instala como un programa normal y muestra la interfaz en una ventana, sin terminal. La versión web se inicia con el comando opencode web: abre OpenCode en un navegador, y la documentación también recomienda iniciarla desde WSL para evitar problemas de acceso a los archivos. La documentación también enumera opciones menos habituales: mise, Docker y un binario listo para usar en la página de versiones de GitHub. La instalación mediante bun en Windows sigue en desarrollo; si bun es tu gestor de paquetes principal, usa la opción npm.

¿Cómo conectar un modelo a OpenCode?#

OpenCode admite más de 75 proveedores mediante AI SDK y Models.dev, además de modelos locales. La mayoría se conectan con el comando /connect dentro de la interfaz; para los modelos locales, también se especifica la dirección del servidor en la configuración. Las opciones varían según el método de pago y los requisitos del ordenador:

La documentación recomienda a quienes empiezan que usen OpenCode Zen. El equipo eligió modelos que funcionan bien específicamente como agentes y probó sus combinaciones con proveedores en tareas propias.

La conexión se hace así: escribe /connect, elige OpenCode Zen, inicia sesión y añade un método de pago en opencode.ai/auth, obtén una clave y pégala. Después, /models mostrará la lista de modelos recomendados. A 4 de octubre de 2026, la lista incluye, por ejemplo, GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 y Kimi K2.5. La documentación advierte con franqueza que la lista no es exhaustiva y queda desactualizada rápidamente porque cada semana aparecen modelos nuevos.

Las suscripciones se conectan con el mismo comando /connect: elige ChatGPT Plus o GitHub Copilot en la lista e inicia sesión en tu cuenta; no hace falta ninguna configuración adicional.

Si eliges Anthropic, /connect ofrece dos opciones: introducir manualmente una clave API o elegir Claude Pro/Max y autenticarte a través de un navegador. Sin embargo, Anthropic prohíbe los plugins de terceros para usar una suscripción Claude Pro/Max, y los plugins integrados de este tipo se eliminaron de OpenCode a partir de la versión 1.3.0. Si encuentras un artículo antiguo sobre «OpenCode mediante una suscripción de Claude», se refiere a esos plugins eliminados, no a una autorización oficial. Las suscripciones de ChatGPT Plus, GitHub Copilot, GitLab Duo (marcada como experimental) y Atomic Chat funcionan sin configuración adicional.

OpenCode guarda las claves que introduces mediante /connect en el archivo ~/.local/share/opencode/auth.json. Si no quieres elegir un modelo cada vez, establece el modelo predeterminado en el archivo de configuración opencode.json, en la raíz del proyecto:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5"
}

El formato es provider/model; ambos identificadores aparecen en la salida de /models.

¿Cómo conectar un modelo local mediante Ollama?#

Esta opción no genera ningún coste de API: el modelo se ejecuta en tu ordenador. Si estás comparando modelos gratuitos en general, tenemos una reseña aparte sobre cuáles funcionan razonablemente bien como agentes y cuáles solo lo hacen sobre el papel. Para usar OpenCode, instala Ollama desde el sitio oficial y descarga un modelo:

ollama pull qwen3-coder

Un detalle útil de la documentación: Ollama puede configurarse automáticamente para OpenCode; cuenta con una guía de integración propia. Si quieres configurarlo todo manualmente, añade a opencode.json un proveedor con la dirección de tu servidor local de Ollama:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3-coder": {
          "name": "Qwen3 Coder"
        }
      }
    }
  }
}

Después, el modelo local aparecerá en la lista de la interfaz con /models. Selecciónalo y ponte a trabajar. La documentación aporta una advertencia práctica: si el agente deja de llamar a las herramientas (editar archivos o ejecutar comandos), aumenta num_ctx en la configuración de Ollama; empieza con valores de 16k–32k. Los modelos locales son más débiles que los modelos en la nube específicamente para tareas de agente, y un contexto pequeño empeora el problema. Si la versión local no es suficiente, puedes conectar Qwen desde la nube con una clave; en la guía Cómo obtener una clave API para Qwen Code se explica dónde conseguirla.

¿Cuánto cuesta OpenCode y usarlo?#

Todos los costes aquí corresponden al modelo, y hay cuatro posibilidades. Con una clave API o Zen, pagas por el uso real y el importe depende de cuánto trabajo haga el agente. Go es un plan de suscripción para modelos abiertos del equipo de OpenCode: $10 al mes para Go y $40 al mes para Go Plus con límites más altos (verificado en la página opencode.ai/go el 4 de octubre de 2026). El límite depende del modelo: por ejemplo, Go permite unas 110 solicitudes cada 5 horas (440 al mes) para Kimi K3 y unas 26 000 solicitudes cada 5 horas para el modelo más ligero DeepSeek V4.1 Flash. Para acceder a un modelo específico una vez superado el límite, la documentación indica un precio aparte ($15 al mes para Kimi K3, $60 para Go Plus). Consulta la página de suscripciones al conectarte para ver la lista completa de modelos y límites. Con ChatGPT Plus o Copilot, las solicitudes están cubiertas por la suscripción que ya pagas; recuerda que estas suscripciones tienen sus propios límites de intensidad de uso. Por último, las solicitudes a un modelo local mediante Ollama no cuestan nada, pero necesitas un ordenador con suficiente potencia para ejecutarlo rápidamente.

¿Qué debes hacer en el primer inicio?#

Primer inicio, dentro de la carpeta de tu proyecto:

cd path/to/project
opencode

La interfaz se abre con un campo de entrada. Primero, usa el comando /init: el agente analiza los archivos importantes del repositorio, hace un par de preguntas si es necesario y escribe un archivo AGENTS.md, una guía sobre la estructura del proyecto, los comandos para compilar y probar, y las convenciones que se utilizan. La documentación recomienda guardar este archivo en git; OpenCode lo utilizará como instrucción permanente del proyecto. En cuanto a su función, AGENTS.md equivale directamente a CLAUDE.md en el ecosistema OpenCode.

En segundo lugar, usa el modo Plan. La tecla Tab alterna entre los dos agentes principales: Build tiene acceso completo a los archivos y comandos, mientras que Plan se dedica al análisis y la planificación; de forma predeterminada, los cambios en archivos y los comandos bash en modo Plan requieren tu aprobación. Para las tareas nuevas, la documentación recomienda empezar con un plan: lee lo que el agente pretende hacer, ajusta la redacción y solo entonces vuelve a Build con Tab.

La documentación ofrece este consejo:

Cuanto más específica sea la tarea y más contexto proporciones, menos trabajo tendrás que repetir. Añade archivos a una solicitud con @: empieza a escribir un nombre y la interfaz los encontrará mediante una búsqueda aproximada. Puedes arrastrar imágenes directamente al terminal, y un mensaje que empiece por ! se ejecuta como comando shell; su salida se añade al contexto del agente. Si te equivocaste al formular la tarea o el agente hizo algo incorrecto, /undo revierte los cambios, y puedes ejecutarlo varias veces seguidas. ¿Has vuelto a cambiar de opinión? /redo restaura lo que deshiciste. Y /share crea un enlace a una conversación para tu equipo; sin este comando, la conversación no se publica en ninguna parte.

¿Qué más puede hacer OpenCode?#

Comandos personalizados. Cualquier solicitud recurrente puede convertirse en un comando: coloca un archivo Markdown en .opencode/commands/, define description, agent y model en su frontmatter y escribe debajo una plantilla de prompt. Después, llama al comando con /. Comprobaciones del proyecto antes de publicar, revisión de errores recientes, generación de una migración: cualquier cosa que pidas con regularidad.

Subagentes. Además de Build y Plan, hay otros tres: General para tareas de varios pasos (acceso a todas las herramientas excepto a la lista de tareas), Explore para leer código rápidamente sin permiso para editarlo y Scout para investigar bibliotecas externas. Llámalos mencionándolos con @ en un mensaje.

Servidores MCP. Conecta herramientas externas mediante la sección mcp de la configuración opencode.json; se admiten servidores locales y remotos. Cada servidor MCP añade sus herramientas al contexto, y un servidor que consume mucho contexto, como GitHub, puede agotarlo rápidamente: conéctate solo a lo que necesites. Tenemos una guía con configuraciones listas para usar sobre el concepto MCP; está escrita para Claude Code, pero el protocolo es compartido.

Versión web y servidor. opencode web abre la interfaz en un navegador. Para acceder desde otro equipo, usa opencode serve --hostname 0.0.0.0 --port 4096; siempre que haya acceso a la red, establece una contraseña con la variable OPENCODE_SERVER_PASSWORD. Sin contraseña, el servidor no está protegido.

¿Qué hacer si la instalación falla?#

«opencode: command not found» después de la instalación. El terminal aún no reconoce la nueva ruta. Para empezar, cierra y vuelve a abrir el terminal. Si no funciona, busca dónde colocó el binario el instalador y añade esa carpeta al PATH del terminal.

El modelo no responde o muestra un error de autorización. Comprueba que el proveedor esté conectado: escribe /connect y vuelve a autenticarte. Las claves se guardan en ~/.local/share/opencode/auth.json; si trasladastes la instalación desde otro equipo o borraste carpetas, puede que falte el archivo. La documentación trata por separado los errores ProviderInitError y AI_APICallError: para el primero, vuelve a autorizar el proveedor; para el segundo, vacía la carpeta ~/.cache/opencode y reinicia.

La interfaz está rota: los paneles aparecen desordenados o se muestran caracteres ilegibles en lugar de símbolos. Empieza por comprobar tu terminal. Instala una de las opciones recomendadas —WezTerm funciona en los tres sistemas— y ejecuta OpenCode desde ella.

Si nada funciona, consulta los registros: en macOS y Linux están en ~/.local/share/opencode/log/; en Windows, pulsa Win+R y escribe %USERPROFILE%\.local\share\opencode\log. Se conservan los diez archivos más recientes; activa el registro detallado con la opción opencode --log-level DEBUG. Con esos registros, puedes presentar un informe de errores en el repositorio del proyecto en GitHub.

¿Qué más pregunta la gente sobre OpenCode?#

Abrir Ailoot.