Nota del autor: OpenCode 2.2.3 incorpora el proveedor Claude Agent. En este artículo explicamos en qué se diferencia del plugin OAuth retirado en marzo, cómo conectarlo en 3 pasos y cuáles son sus 5 limitaciones para que decidas si te conviene.
El 30 de octubre, OpenCode lanzó la versión 2.2.3, que incorpora el proveedor Claude Agent. Para conectarlo, instala Claude Code en tu equipo, ejecuta claude auth login una vez y selecciona Claude Agent en /connect de OpenCode. Así podrás usar tu propia suscripción de Claude para ejecutar sus modelos. Hasta el 31 de octubre, el anuncio oficial de @opencode había acumulado unas 510.000 visualizaciones.
Esto no es el sistema OAuth que se retiró en marzo. La nueva solución utiliza el binario oficial de Claude Code y el SDK de Claude Agent. OpenCode no lee ni almacena tus credenciales: las solicitudes al modelo salen del proceso claude que se ejecuta en tu equipo. OpenCode afirma que cuenta con autorización de Anthropic, aunque Anthropic no ha publicado un anuncio independiente.
El desarrollador Chen Cheng (@chenchengpro) analizó la implementación: al iniciar se configuran tools: [] y settingSources: [], y solo se permiten las herramientas mcp__opencode__*. Como el manejador MCP no tiene acceso a tool_use_id, debe registrar cada llamada de una en una mediante un hook PreToolUse. Por eso, la lectura de archivos en paralelo pasa a ser secuencial. El prompt de sistema sigue siendo el que incluye Claude Code y, en su opinión, «sin duda funciona peor que usar Claude Code directamente». En este artículo encontrarás cómo conectarlo en 3 pasos, sus 5 limitaciones y recomendaciones para 3 perfiles de usuario.
Nota: este artículo se basa en las notas de la versión de OpenCode, el documento de diseño del PR #58782, la documentación oficial de Claude Code y los comentarios de la comunidad. No hemos realizado pruebas de extremo a extremo.
Usar una suscripción de Claude con OpenCode: la conclusión
La respuesta tiene tres partes: sí se puede, pero no con el método antiguo y con algunas limitaciones.
- Requisitos: OpenCode V2 versión 2.2.3 o superior; Claude Code instalado en la misma máquina y con la sesión iniciada mediante
claude auth login. - Cómo funciona: OpenCode usa Claude Agent SDK para invocar el proceso
claudede tu equipo. No implementa su propio OAuth, ni lee ni almacena tokens. - Limitaciones: las llamadas a herramientas se ejecutan en serie; muchas funciones de Claude Code no están disponibles; solo funciona en local, no en entornos alojados o remotos.
Sobre si es «gratis», conviene aclarar algo: el plan gratuito de Claude no incluye Claude Code, así que no sirve para este método. Necesitas uno de los planes Pro, Max, Ultra, Team o Enterprise, o una cuenta de Console. Tampoco es uso ilimitado: el consumo se descuenta de los límites de 5 horas y semanales de tu suscripción. La interfaz de OpenCode mostrará $0 porque la suscripción ya cubre el coste.
Si no tienes una suscripción o tu equipo necesita compartir un punto de acceso, puedes usar una API con pago por consumo. Por ejemplo, con APIYI apiyi.com puedes invocar modelos Claude mediante una interfaz compatible con OpenAI. Esta opción no está vinculada a una máquina local ni sujeta a los límites de una suscripción.
Por qué la suscripción de Claude desapareció de OpenCode en marzo y volvió en octubre
En 2026 hubo cuatro momentos clave:
- 9 de enero: Anthropic endureció las restricciones para los harnesses de terceros. Ese día se abrió en OpenCode el issue #7410, «Broken Claude Max», en el que algunos usuarios informaron de errores repentinos con Claude Max.
- 20 de febrero: medios internacionales informaron de que Anthropic había modificado sus términos para prohibir expresamente el uso de tokens OAuth en otros productos, incluidos los creados con Agent SDK.
- 19 de marzo: OpenCode integró el PR #18186, «anthropic legal requests», que eliminó el plugin integrado
opencode-anthropic-authy retiró a anthropic de la lista de proveedores. - 30 de octubre: Claude Agent regresó con OpenCode 2.2.3. Ese mismo día, la versión 2.2.4 añadió una configuración guiada.
La clave está en el texto de los términos. La versión de la página de cumplimiento legal de Anthropic archivada en Wayback el 21 de febrero todavía decía que usar tokens OAuth de Free, Pro o Max en cualquier otro producto, herramienta o servicio —incluido Agent SDK— infringía los términos de servicio para consumidores. Para la versión archivada el 30 de septiembre, esa frase ya había desaparecido y se había añadido una excepción: los usuarios finales podían iniciar sesión con su propia suscripción en el binario de Claude Code sin modificar, incluso cuando una plataforma alojara Claude Code. La página de octubre conservaba esa excepción.
Claude Agent de OpenCode está diseñado precisamente para ajustarse a ella. En los comentarios del PR #58782, alguien preguntó si podían bloquearle la cuenta; el autor, Tarquinen, respondió que había obtenido permiso de Anthropic y que cumplía plenamente los términos de servicio. Daniel Smolsky, miembro de OpenCode, también publicó en X: «We got permission». Sin embargo, hasta el 31 de octubre no se encontró ningún anuncio independiente de Anthropic al respecto, así que, por ahora, la afirmación de que existe un permiso procede únicamente de OpenCode.
| Aspecto | Plugin OAuth anterior a marzo | Claude Agent de octubre |
|---|---|---|
| Inicio de sesión | OpenCode usaba el flujo OAuth de claude.ai para obtener un token | El usuario ejecuta claude auth login en Claude Code, en su propia máquina |
| Quién envía las solicitudes | OpenCode invocaba directamente la API de Anthropic | El proceso local claude las envía mediante Agent SDK |
| Lectura o almacenamiento del token | El plugin mantenía el token OAuth | No lo lee ni lo almacena; /connect solo registra el método elegido |
| Postura de Anthropic | Los términos de febrero lo prohibieron expresamente y el plugin se retiró en marzo | OpenCode afirma tener permiso; los términos de septiembre añadieron una excepción, pero no hubo un anuncio independiente |
| Riesgo | Riesgo de bloqueo de la cuenta y retirada del plugin | Menor que en marzo, aunque la política podría volver a cambiar |
Conviene dejar claros los riesgos. Los términos actuales se reservan el derecho de aplicar sus normas sin previo aviso y siguen prohibiendo que terceros recopilen, almacenen o retransmitan credenciales de Claude. Por eso, al configurar la integración, ten en cuenta dos cosas: no instales plugins OAuth antiguos que circulan por internet y no dejes tu cuenta en una plataforma ajena para que ejecute tareas por ti.
Cómo funciona OpenCode Claude Agent y por qué ejecuta las herramientas en serie
La cadena completa es: OpenCode → Claude Agent SDK → claude local → Anthropic. OpenCode no se interpone entre Claude Code y Anthropic ni modifica las solicitudes. Por defecto, el ejecutable claude se busca en PATH, aunque también puedes indicar su ruta con la variable de entorno OPENCODE_CLAUDE_PATH.
Al iniciar, muchas funciones de Claude Code se desactivan o se reemplazan. Podemos resumirlo como «tres desactivaciones, un reemplazo y una ejecución en serie»:
- Desactiva las herramientas integradas: con
tools: [], no se usa ninguna de las herramientas de lectura, escritura o Bash que trae Claude Code. - Desactiva la configuración del usuario: con
settingSources: [], no se leen~/.claudeni el directorio.claudedel proyecto. Tampoco se cargan CLAUDE.md, hooks, skills ni servidores MCP. - Solo permite herramientas de OpenCode: únicamente se autorizan las herramientas con el prefijo
mcp__opencode__*. Si Claude invoca una herramienta con otro nombre, recibeNo such tool availabley OpenCode no ejecuta la llamada. - Reemplaza la implementación de las herramientas: OpenCode convierte sus propias herramientas en un servidor MCP dentro del proceso y, al ejecutarlas, utiliza sus propias ventanas de permisos. La indicación de sistema sigue siendo la que trae Claude Code, con el añadido de que «se está ejecutando en opencode», más la indicación del agente que hayas elegido y AGENTS.md.
- Ejecuta las herramientas en serie: el manejador de herramientas de OpenCode no tiene acceso al
tool_use_idde Claude, así que el hookPreToolUsedebe registrarlo primero para poder recuperarlo después. El hook solo puede registrar un ID a la vez, por lo que las herramientas no se pueden marcar como aptas para ejecución en paralelo. Claude normalmente leería varios archivos a la vez, pero aquí pasa a leerlos uno por uno.
OpenCode tiene sus razones para este diseño. El formato del historial de conversación es el mismo sin importar qué modelo haya generado el contenido, así que cambiar de modelo no causa problemas. Además, hay un único sistema de permisos para todo. El costo es que se pierden bastantes capacidades originales de Claude Code. Chen Cheng lo resume así: «Con todo esto, da la impresión de que el resultado seguro será peor que usar Claude Code directamente». Conviene tenerlo claro antes de decidir si integrarlo o no.
Hay otros detalles de funcionamiento: cada sesión inicia un proceso claude de larga duración, que se detiene tras 5 minutos de inactividad y se reanuda cuando llega el siguiente mensaje. Claude Code se encarga de reintentar las solicitudes fallidas; OpenCode no añade más reintentos.
Conecta OpenCode a tu suscripción de Claude en 3 pasos
Antes de empezar, comprueba estos 5 requisitos:
- OpenCode es V2, versión 2.2.3 o superior, no V1.
- Claude Code está instalado en tu equipo.
- Tu cuenta de Claude tiene un plan de pago o es una cuenta de Console.
- OpenCode y Claude Code están en el mismo equipo.
- No estás usando hosted opencode ni un espacio de trabajo remoto.
El comando para instalar V2 es curl -fsSL https://opencode.ai/v2/install | bash. También puedes descargar la versión de escritorio.
Paso 1: Instala Claude Code
Qué verás: ejecuta claude --version en la terminal. Si aparece un mensaje que indica que no se encuentra el comando, significa que aún no está instalado.
Qué hacer: en macOS y Linux, usa el script oficial install.sh. En Windows, ejecuta el script oficial install.ps1 en PowerShell. Si ya lo tenías instalado, pero la versión es antigua, ejecuta claude update para actualizarlo.
Cómo comprobar que funciona: claude --version muestra el número de versión.
Paso 2: Inicia sesión en tu cuenta de Claude
Qué verás: después de ejecutar claude auth login, el navegador abrirá la página de inicio de sesión de Anthropic.
Qué hacer: inicia sesión con tu cuenta de Claude de pago y luego ejecuta claude auth status para consultar el estado.
Cómo comprobar que funciona: el estado muestra que el método de autenticación es el inicio de sesión mediante suscripción, no api_key ni none.
Hay un detalle importante: si tienes configurada la variable ANTHROPIC_API_KEY en tu shell, Claude Code podría priorizar la clave API y facturar según el uso. Antes de iniciar sesión, ejecuta unset ANTHROPIC_API_KEY; si Claude Code te pregunta si quieres usar esa clave, recházala.
Paso 3: Conecta Claude Agent en OpenCode
Qué verás: al introducir /connect en OpenCode, aparecerá una lista de proveedores.
Qué hacer: selecciona Claude Agent, no «Anthropic». Después, usa /models para elegir un modelo de Claude. En la versión 2.2.4 y superiores hay un proceso guiado que te ayuda a copiar el comando de inicio de sesión, comprobar la instalación y verificar la conexión. Una vez completadas todas las comprobaciones, podrás elegir el modelo. Si prefieres la línea de comandos, también puedes usar opencode auth login para hacer lo mismo.
Cómo comprobar que funciona: puedes elegir un modelo de Claude en la lista, recibes una respuesta al enviar una indicación de prueba y la ventana de permisos de OpenCode aparece con normalidad al usar herramientas.
Lista de solución de problemas
- Claude Agent no aparece en la lista: ejecuta
opencode --versionpara comprobar la versión y actualiza si es anterior a la 2.2.3. Asegúrate también de tener instalada la V2. - Aparece un mensaje que indica que no se encuentra claude: comprueba
PATHo usaOPENCODE_CLAUDE_PATHpara especificar la ruta absoluta declaude. - Vuelve repetidamente a la página de inicio de sesión: algunos usuarios de las primeras versiones han informado de desconexiones tras una o dos conexiones y de que, al intentar reconectar, vuelven a la página de inicio de sesión. La comunidad sigue trabajando en una solución. Mientras tanto, puedes ejecutar de nuevo
claude auth loginen la terminal y después volver a/connect. - Aparece un mensaje de que alcanzaste el límite del plan: significa que agotaste la cuota de 5 horas o la cuota semanal de tu suscripción. Tendrás que esperar a que se restablezca.
- No puedes conectarte desde un entorno remoto: no es compatible por diseño; solo puedes usarlo en tu equipo local.
Una última aclaración: la documentación de proveedores de OpenCode V1 todavía conserva la antigua advertencia de que «Anthropic prohíbe Pro/Max». Esa información corresponde al período anterior a marzo. No busques Claude Agent en el /connect de V1: solo está disponible en V2.
5 limitaciones de usar una suscripción de Claude en OpenCode
| Limitación | Cómo se manifiesta | A quién afecta más |
|---|---|---|
| Herramientas en serie | El hook solo registra un tool_use_id a la vez, así que los archivos se leen uno por uno en lugar de en paralelo |
Repositorios grandes y refactorizaciones que abarcan varios archivos |
| La indicación no es la de OpenCode | Se usa la indicación de sistema de Claude Code; la integrada en OpenCode no se aplica | Quienes dependen del comportamiento predeterminado del agente de OpenCode |
| Faltan funciones de Claude Code | No están disponibles /usage, auto mode, memory, cloud sessions, agent teams y otras funciones |
Usuarios intensivos de Claude Code |
| Solo funciona en local | No es compatible con entornos alojados o remotos; claude debe estar en la misma máquina |
Desarrollo en la nube, equipos remotos y CI |
| Parámetros y plugins limitados | No se admiten parámetros como temperature, top-p, seed o stop; el hook http.request no se ejecuta |
Quienes necesitan ajustar parámetros con precisión o usar una pasarela |
Herramientas en serie: en proyectos pequeños apenas se nota. Pero si una tarea requiere revisar decenas de archivos, el tiempo de espera aumenta considerablemente. Si sueles hacer refactorizaciones amplias, conviene tener en cuenta ese coste de tiempo.
La indicación no es la de OpenCode: las indicaciones personalizadas de los agentes siguen funcionando, pero la indicación base es la de Claude Code. Si ya estás acostumbrado al comportamiento del agente integrado de OpenCode, puede que notes cambios en el estilo del modelo al hacer el cambio.
Funciones ausentes: esta es la limitación más importante. El documento de diseño enumera las funciones que Claude Code tiene y que no están disponibles en OpenCode, como auto mode, ultracode, auto memory, away summaries, cloud sessions, /teleport, agent teams, /loop, computer use, Bash en un entorno aislado, edición de notebooks y skills integradas como /simplify y /verify.
Solo funciona en local: el proceso de Claude se detiene tras 5 minutos de inactividad y se reanuda con el siguiente mensaje. No se puede usar de esta forma en CI ni en máquinas de desarrollo remotas.
Parámetros y plugins limitados: no se admite ningún parámetro de muestreo. La URL base y los encabezados solo se pueden leer del archivo de configuración; los plugins no pueden modificarlos para cada solicitud. Los hooks http.request y http.response tampoco se ejecutan, porque las solicitudes las envía Claude Code.
También hay varios detalles sobre el uso que conviene tener en cuenta: en OpenCode no puedes consultar /usage de Claude; al alcanzar el límite, no se continúa automáticamente; y tampoco puedes comprar uso adicional desde ahí. El /usage de OpenCode muestra el consumo de OpenCode Console y no tiene relación con la cuota de tu suscripción de Claude. Además, se dice que los usuarios de claude -p y del SDK reciben menos cuota de suscripción que quienes usan Claude Code normalmente, pero el documento de diseño indica expresamente que esto «no está verificado», así que por ahora no debe darse por hecho.
En resumen: si necesitas auto mode, memory, cloud sessions, agent teams, computer use o edición de notebooks, usa Claude Code directamente. Esta opción solo vale la pena si buscas los modelos de Claude junto con las herramientas y el sistema de permisos de OpenCode, y puedes aceptar que las herramientas se ejecuten en serie.
Usar OpenCode con una suscripción a Claude: para quién sí y para quién no
Hay tres casos principales:
- Ya usas OpenCode 2.x, tienes una suscripción a Claude y solo programas en tu equipo: vale la pena probarlo. Puedes cambiar entre Claude y otros modelos dentro del mismo harness, sin pagar la API por separado.
- Solo usas Claude Code: no te compliques. Usa Claude Code directamente: ofrece más funciones, permite ejecutar herramientas en paralelo y utiliza las indicaciones originales.
- Trabajas en equipo, usas CI o desarrollo remoto, o dependes del modo automático, la memoria o el panel de cuotas: mejor no lo uses. Esta solución solo funciona en local, le faltan funciones y la facturación no es transparente. En estos casos, es más adecuado usar una clave API o el pago por uso de APIYI apiyi.com.
| Opción | Precio (al 27 de octubre) | Para quién |
|---|---|---|
| Claude Pro | $20/mes | Uso individual ligero, con límites de 5 horas y semanales |
| Claude Max / Ultra | $100 / $200 al mes | Usuarios individuales intensivos |
| Cliente OpenCode | Gratis y de código abierto | Todo el mundo |
| OpenCode Go (opcional) | $10/mes | Quienes necesitan modelos alojados por OpenCode; no es un requisito para usar Claude Agent |
| APIYI Claude Opus 5.5 | Entrada $4 / salida $20 | Equipos, CI y quienes necesitan una facturación clara |
| APIYI Claude Sonnet 5.5 / Haiku 5.5 | $2/$10 y $0.1/$0.5 | Programación diaria y tareas por lotes |
Los precios de APIYI en la tabla son por millón de tokens. La lectura de caché se cobra por separado.
💰 Recomendación de pago por uso: si no tienes suscripción, necesitas compartir el servicio con tu equipo o quieres controlar cada gasto, puedes usar APIYI apiyi.com. Ofrece tanto el endpoint
messages(formato nativo de Anthropic) como el endpointchat(formato compatible con OpenAI). Configura base_url comohttps://api.apiyi.com/v1. Consulta la lista de modelos de la plataforma para conocer los modelos y precios vigentes.
Preguntas frecuentes
P1: ¿Pueden suspender mi cuenta por usar una suscripción de Claude con OpenCode?
El riesgo es menor que en marzo: el nuevo método usa el binario oficial, OpenCode no lee el token y también cumple la excepción añadida a los términos en septiembre. Sin embargo, la afirmación de que está autorizado proviene de OpenCode; Anthropic no ha hecho un anuncio específico y se reserva el derecho de hacer cumplir sus términos sin previo aviso. No uses los antiguos complementos de OAuth.
P2: ¿Por qué no encuentro Claude Agent en /connect?
En la mayoría de los casos es un problema de versión: tienes una versión anterior a la 2.2.3 o todavía usas V1. Actualiza a la última versión de V2 y busca «Claude Agent» en `/connect`, no «Anthropic».
P3: OpenCode muestra un coste de $0. ¿Es realmente gratis?
No. Muestra $0 porque el coste ya está cubierto por la suscripción, pero el uso real sigue descontándose de tus límites de 5 horas y semanales. Si usas una clave API, OpenCode mostrará el coste según los precios de models.dev.
P4: ¿Se puede usar en una máquina de desarrollo remota o en la nube?
No. `claude` y OpenCode deben estar instalados en la misma máquina; no se admiten espacios de trabajo alojados ni remotos. Para la nube o entornos de CI, se recomienda usar una clave API o hacer invocaciones de pago por uso a través de APIYI, apiyi.com.
P5: ¿Cómo elijo entre conectar una suscripción y usar una clave API?
La conexión mediante suscripción es adecuada para uso personal en tu propia máquina, siempre que ya pagues la suscripción. Una clave API no está vinculada a una máquina, puede compartirse entre varias personas, ofrece una facturación clara y no está sujeta a los límites de la suscripción. Si quieres comparar Claude con otros modelos, APIYI, apiyi.com, te permite cambiar entre ellos y hacer pruebas con una sola clave.
P6: ¿Se puede usar la versión gratuita de Claude?
No. La versión gratuita no incluye Claude Code. Necesitas al menos un plan Pro o una cuenta Team, Enterprise o Console.
Resumen: OpenCode con una suscripción de Claude en 3 frases
Se puede conectar: OpenCode 2.2.3 y versiones posteriores utilizan el Agent SDK oficial para invocar claude en el equipo local; OpenCode afirma que cuenta con autorización de Anthropic, aunque la política podría cambiar. Cómo conectarlo: instala Claude Code, ejecuta claude auth login y selecciona Claude Agent en /connect. Cuándo no conviene: si necesitas herramientas en paralelo, todas las funciones de Claude Code o acceso remoto o en equipo, usa Claude Code directamente o invoca Claude con pago por uso a través de APIYI apiyi.com.
Autor: Equipo técnico de APIYI
Consultas técnicas: para dudas sobre la integración de modelos Claude, puedes contactarnos en la página de inicio de APIYI apiyi.com; encontrarás más documentación en docs.apiyi.com.
