OpenCode vs Claude Code: diferencias y cuál elegir

OpenCode es un agente de código abierto que conectas a casi cualquier modelo; Claude Code, el de Anthropic. Qué cambia en modelos, permisos y coste.

OpenCode vs Claude Code: diferencias y cuál elegir

OpenCode es un agente de programación de código abierto que puedes conectar a casi cualquier modelo, y Claude Code es el agente de Anthropic, construido alrededor de los modelos Claude. Los dos leen tu repositorio, editan ficheros, ejecutan comandos y trabajan desde la terminal. Lo que los separa es quién controla el arnés: el programa que rodea al modelo y decide qué te pregunta antes de actuar y qué hace sin preguntar.

La pregunta que decide es esta: ¿quieres elegir modelo y ser dueño del arnés, o prefieres el arnés que el propio fabricante ajusta para su modelo?

Comparativa rápida

OpenCodeClaude Code
LicenciaMIT [1]Propietaria, bajo los términos de Anthropic [5]
ModelosMás de 75 proveedores, y modelos locales con Ollama o LM Studio, entre otros [2]Solo Claude, vía Anthropic, Bedrock, Google Cloud o Foundry
AutenticaciónAPI key de cada proveedor con /connect; también suscripciones como ChatGPT Plus o GitHub CopilotCuenta de Claude con suscripción, Claude Console o proveedor cloud [6]
ExtensiónAgentes, subagentes, comandos, skills, MCP y plugins en JS/TSCLAUDE.md, skills, subagentes, hooks, MCP y plugins
Permisos si no tocas nadaCasi todo en allow [3]Auto mode con clasificador [7]
Coste de entradaSoftware gratis; pagas al proveedor, o nada con un modelo localSuscripción de Claude o consumo de API

En extensibilidad están muy cerca. Las diferencias que vas a notar están en qué modelos y suscripciones admite cada uno, y en lo que hacen cuando no has escrito ni una regla de permisos.

Qué es OpenCode

OpenCode, o OpenCode CLI, es un agente de programación con IA de código abierto. Lo instalas con npm o con Homebrew, y lo arrancas con el comando opencode dentro de tu proyecto [1]. Trae dos agentes principales que alternas con la tecla Tab: build, con acceso completo, y plan, que no edita ficheros y pide permiso antes de ejecutar comandos. Conectas un proveedor con /connect, ejecutas /init y crea un fichero AGENTS.md con las instrucciones del proyecto.

Si vienes de Claude Code, probarlo cuesta poco: OpenCode lee tu CLAUDE.md cuando no hay AGENTS.md, y busca skills también en .claude/skills/ [4]. Además puedes asignar un modelo distinto a cada agente, uno rápido para planificar y otro más capaz para implementar.

Ten en cuenta que OpenCode 1 y OpenCode 2 conviven en la documentación y usan el mismo comando. Lo que cuento aquí sale de la versión 1.

Qué hace distinto Claude Code

Claude Code ejecuta el mismo bucle de agente, pero el arnés y el modelo salen del mismo fabricante. Si no lo conoces, empieza por qué es Claude Code y cómo funciona.

Ese acoplamiento es literal. Puedes mandar las peticiones a Anthropic, a Bedrock, a Google Cloud, a Foundry o a un gateway propio, pero la documentación lo deja claro: cambiar ANTHROPIC_BASE_URL cambia adónde van las peticiones, no qué modelo responde [8].

A cambio, Anthropic ajusta el arnés para sus modelos. Lo más visible es el auto mode: en las versiones actuales, las sesiones de terminal y VS Code arrancan en un modo donde un segundo modelo, el clasificador, revisa las acciones en lugar de ti. Si auto mode no está disponible, la sesión empieza en Manual, que pregunta antes de casi todo [7].

Tu suscripción de Claude no está permitida en OpenCode

Si pagas Claude Pro o Max, puedes usar esa suscripción en Claude Code, pero no en OpenCode. No es un límite técnico, es una prohibición: los términos de Anthropic reservan el login con OAuth de los planes de suscripción para Claude Code y sus aplicaciones nativas, y no permiten que desarrolladores de terceros enruten peticiones a través de credenciales Free, Pro o Max en nombre de sus usuarios [5].

La propia documentación de OpenCode lo reconoce: hay plugins que permiten usar Pro/Max dentro de OpenCode, Anthropic lo prohíbe expresamente y OpenCode dejó de incluirlos a partir de la versión 1.3.0 [2]. Para usar Claude en OpenCode sin saltarte los términos, pagas por consumo: con una API key de Claude Console o a través de un proveedor cloud como Amazon Bedrock. Con ChatGPT Plus o GitHub Copilot pasa lo contrario: OpenCode los acepta sin configuración extra, así que muchas veces lo que ya pagas decide por ti.

Permisos: lo que pasa cuando no configuras nada

En OpenCode, si no escribes reglas, la mayoría de permisos están en allow: el agente edita ficheros y ejecuta comandos sin preguntarte. Solo pide confirmación cuando toca rutas fuera del proyecto o cuando repite la misma llamada a una herramienta tres veces seguidas, y bloquea la lectura de ficheros .env [3]. Lo primero que haría al instalarlo es cerrar eso:

// opencode.jsonc: pregunta antes de editar o ejecutar
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "ask",
    "bash": {
      "*": "ask",                // comodín primero
      "git status *": "allow",   // excepciones después
      "git push *": "deny"
    }
  }
}

El orden importa porque en OpenCode gana la última regla que coincide [3]. Claude Code funciona al revés: evalúa deny, luego ask y luego allow, y la primera coincidencia en ese orden decide, sea cual sea la regla más específica [9]. En Claude Code, unas reglas parecidas van en .claude/settings.json:

{
  "permissions": {
    "allow": ["Bash(git diff *)"],
    "deny": ["Bash(git push *)", "Read(*.env)"]
  }
}

Si copias tus reglas de una herramienta a otra pensando que se leen igual, puedes dejar abierto lo que querías cerrar. Las reglas que merece la pena escribir desde el primer día las tienes en permisos de Claude Code: las reglas que deberías escribir ya.

Cuándo elegir cada uno

Quieres probar varios modelos, o el código no puede salir de tu máquina. OpenCode, conectado a un modelo local con Ollama o LM Studio.

Ya pagas Claude Pro o Max. Claude Code, porque es el único sitio donde esa suscripción vale.

No quieres mantener la configuración del arnés. Claude Code: arranca en auto mode y, en un equipo, los ajustes gestionados se aplican a todos sin que cada persona escriba los suyos.

Ya pagas ChatGPT Plus o GitHub Copilot. OpenCode te da un agente de terminal sin abrir otra cuenta.

Estás aprendiendo cómo funcionan estos agentes. Prueba los dos con la misma tarea sobre el mismo repositorio. Lo que llevan debajo los dos, el bucle que llama a herramientas y comprueba su propio trabajo, lo desmontamos paso a paso en el curso de patrones agénticos.

El arnés importa tanto como el modelo

Solemos comparar agentes mirando qué modelo llevan, y nos olvidamos de que el mismo modelo dentro de dos arneses se comporta distinto, porque cambia qué contexto recibe y, sobre todo, qué puede hacer sin pedir permiso. OpenCode te da el arnés para que lo ajustes tú, lo que reduce la dependencia de un proveedor de IA; Claude Code te lo entrega ajustado, lo que te ahorra configuración que mucha gente nunca llega a hacer.

Antes de darle permisos amplios a cualquiera de los dos, yo revisaría esto:

  • Qué hace cuando no has escrito ninguna regla.
  • En qué orden evalúa tus reglas, y si un deny tuyo puede quedar anulado.
  • Adónde van tus datos. En OpenCode Zen, la pasarela de modelos del proyecto, varios modelos gratuitos avisan de que durante ese periodo los datos pueden usarse para mejorar el modelo [10].
  • Qué servidores MCP y plugins tienes cargados, porque un plugin de OpenCode o un hook de Claude Code es código que se ejecuta con tus permisos.

Ninguna de estas preguntas depende de qué modelo sea más listo esta semana, y son las que deciden si un error del agente se queda en un diff que revisas o acaba en un git push que no pediste.

Fuentes

  1. Repositorio anomalyco/opencode: licencia MIT, instalación y agentes build y plan.
  2. Providers, documentación de OpenCode: más de 75 proveedores, modelos locales, nota sobre Claude Pro/Max y la versión 1.3.0.
  3. Permissions, documentación de OpenCode: valores por defecto y regla de la última coincidencia.
  4. Rules, documentación de OpenCode: compatibilidad con CLAUDE.md y .claude/skills/.
  5. Legal and compliance, documentación de Claude Code: términos aplicables y uso de credenciales de suscripción.
  6. Authentication, documentación de Claude Code: métodos de login.
  7. Choose a permission mode, documentación de Claude Code: auto mode como modo inicial desde la v2.1.283.
  8. Model configuration, documentación de Claude Code: ANTHROPIC_BASE_URL cambia el destino, no el modelo.
  9. Configure permissions, documentación de Claude Code: orden de evaluación deny, ask, allow.
  10. Zen, documentación de OpenCode: modelos gratuitos y uso de datos.
  11. Transitioning Gemini CLI to Antigravity CLI, Google Developers Blog: sustitución de Gemini CLI.

Preguntas Frecuentes

¿Qué es OpenCode?

Es un agente de programación de código abierto, con licencia MIT, que se usa sobre todo desde la terminal, aunque también tiene app de escritorio y extensión de IDE. Trabaja sobre tu repositorio con el proveedor de modelos que elijas, incluidos modelos locales.

¿OpenCode es gratis?

El software sí; pagas los modelos que conectes, o nada si ejecutas uno local.

¿Puedo usar mi suscripción de Claude Pro o Max en OpenCode?

No, porque Anthropic lo prohíbe: sus términos reservan el login con suscripción para Claude Code y sus aplicaciones nativas, y OpenCode retiró los plugins que lo permitían en la versión 1.3.0. Para usar modelos Claude en OpenCode pagas por consumo, con una API key de Claude Console o con un proveedor cloud como Amazon Bedrock.

OpenCode vs Claude Code: ¿cuál es mejor para empezar?

Depende de lo que ya pagas y de cuánto quieras configurar. Claude Code arranca con una red de seguridad puesta, porque un clasificador revisa las acciones antes de ejecutarlas, y eso perdona más si todavía no sabes qué reglas escribir, aunque no te ahorra escribirlas. Con OpenCode, escribe las reglas de permisos antes de la primera sesión de trabajo de verdad.

¿Y OpenCode vs Gemini CLI?

Google sustituyó Gemini CLI por Antigravity CLI y dejó de servirlo a los usuarios de sus planes de consumo el 18 de junio de 2026 [11]. Si vienes de ahí, te interesa la comparativa de Claude Code vs Antigravity CLI; OpenCode sigue siendo la alternativa si no quieres atarte a ningún fabricante.