En resumen: desde OpenCode 2.2.3, OpenCode trae un provider integrado llamado Claude Agent. Instala Claude Code (2.1.248 o posterior), ejecuta claude auth login en la terminal y elige Claude Agent en /connect de OpenCode: tendrás tu sesión de Claude Code y sus modelos dentro de OpenCode. El post de @opencode que lo anunció («you can now use your claude subscription in OpenCode») superó las 620.000 visualizaciones en un día.
No es la única vía. Siempre ha habido dos formas de usar Claude en OpenCode:
- Inicio de sesión con suscripción:
/connect→ Claude Agent. El uso se descuenta de tu cuenta de Claude. - API Key:
/connect→ Anthropic, o unbaseURLy una Key para el provideranthropicenopencode.json. El uso se mide por Key.
A continuación: en qué se diferencian, cómo configurar cada una y por qué tu CLAUDE.md parece dejar de funcionar tras el cambio.
Crear API Key y compartirla entre OpenCode, Claude Code, Codex y Cursor →
Las dos vías, lado a lado
| Claude Agent (suscripción) | Anthropic (API Key) | |
|---|---|---|
| Versiones | OpenCode 2.2.3+, Claude Code 2.1.248+ instalado en local | Cualquier versión de OpenCode |
| Inicio de sesión | claude auth login en la terminal | Pegar una API Key (o leerla de una variable de entorno) |
| Quién envía las peticiones | Tu programa claude local, a través del Claude Agent SDK oficial | El propio OpenCode |
| Herramientas, permisos, historial | Todo del lado de OpenCode | Todo del lado de OpenCode |
| CLAUDE.md | La carga de CLAUDE.md por Claude Code está desactivada; las reglas llegan por AGENTS.md | Carga de reglas propia de OpenCode (AGENTS.md primero) |
| Espacios de trabajo remotos / alojados | No compatible; claude debe correr en la misma máquina | Compatible |
| Temperature y otras opciones de muestreo | No compatible | Compatible |
Todo lo de esta tabla sale del documento de diseño claude-agent-provider.md y de la PR #58782 del repositorio de OpenCode.
Cuál elegir:
- Ya tienes un plan de Claude y solo usas OpenCode en tu ordenador: Claude Agent.
- Ejecutas OpenCode en servidores, espacios remotos o CI, o quieres que OpenCode, Claude Code, Codex y Cursor compartan una Key y ver el registro de llamadas en un solo sitio: API Key.
- Puedes configurar ambas y cambiar en
/models. Según el documento de diseño, el historial de OpenCode es la fuente de verdad: al volver a Claude Agent, todo lo que no vio se le envía en un solo mensaje.
Vía 1: inicio de sesión con suscripción vía Claude Agent (OpenCode 2.2.3+)
Paso 1: comprobar versiones
opencode --version # 2.2.3+
claude --version # 2.1.248+
Actualiza si hace falta:
# OpenCode
opencode upgrade
# or: curl -fsSL https://opencode.ai/v2/install | bash
# or: npm i -g @opencode/cli@latest
# Claude Code
claude update
# or: curl -fsSL https://claude.ai/install.sh | bash
Claude Code debe ser 2.1.248 o posterior. Según el documento de diseño, OpenCode le pide a Claude Code que omita el contexto que añade en cada turno (CLAUDE.md anidados, listas de skills, recordatorios), y esa opción solo existe desde la 2.1.248.
Paso 2: iniciar sesión en Claude Code desde la terminal
claude auth login
claude --version
opencode
Ejecuta claude auth login en la terminal, no /login dentro de Claude Code. Las notas de la versión 2.2.4 sustituyeron precisamente una indicación /login engañosa por claude auth login.
Según el documento de diseño, OpenCode nunca lee la sesión guardada de Claude Code. /connect solo registra que elegiste este método, y es tu claude local quien envía las peticiones. Sirve cualquier inicio de sesión que admita claude: suscripción, API key o cuenta en la nube.
Paso 3: /connect en OpenCode y elegir Claude Agent
/connect
→ Claude Agent (Claude Code login)
→ Anthropic (API Key)
/models
Elige Claude Agent, no Anthropic. Anthropic es la entrada de API Key y solo muestra un campo para la Key. Desde la 2.2.4, al elegir Claude Agent empieza una configuración guiada: copiar el comando claude auth login, instalar Claude Code, verificar la conexión y luego elegir modelo. En la app de escritorio también se sale desde ahí del estado Needs sign-in.
Si claude no está en tu PATH, o tienes varias versiones, indica la correcta:
export OPENCODE_CLAUDE_PATH="$HOME/.local/bin/claude"
opencode
Qué cambia tras el cambio
Según el documento de diseño:
- Las herramientas integradas de Claude Code se desactivan. Claude usa las herramientas de OpenCode, y cada llamada pasa por las solicitudes de permiso de OpenCode. Solo hay un sistema de permisos.
- No se lee la configuración de Claude Code: los ajustes de
~/.claudey de la carpeta.claudedel proyecto, los CLAUDE.md, hooks, servidores MCP y skills se desactivan; OpenCode usa los suyos. La compactación y la memoria automáticas también; la compactación la hace OpenCode. - El prompt de sistema es el de Claude Code, más las instrucciones de OpenCode: AGENTS.md, skills, instrucciones MCP, el prompt del agente elegido, etc.
- No compatible:
/usagedel plan de Claude, sesiones en la nube y/teleport,/loop, auto mode, computer use, entre otros./usageen OpenCode muestra el uso de OpenCode Console. - Cada sesión mantiene un proceso
claudepersistente. Se cierra tras 5 minutos inactivo, y el siguiente mensaje retoma la sesión de Claude guardada.
La cuestión de los términos
En las respuestas al anuncio, muchos preguntan si esto incumple los términos de Anthropic:
- La página de introducción oficial del Claude Agent SDK dice que, salvo aprobación previa, Anthropic no permite a desarrolladores externos ofrecer el inicio de sesión de claude.ai ni los límites del plan en sus productos, incluidos los agentes creados con el Claude Agent SDK, y remite a la autenticación con API key.
- El propio documento de diseño de OpenCode plantea en «Open Questions» si hace falta hablarlo con Anthropic u obtener aprobación.
- Según @grok, Anthropic no ha confirmado ni aprobado públicamente este uso; según @schulzfel, está hecho con el Agent SDK oficial; según @jimmyyangrz, como depende del inicio de sesión de Claude, está bien para probar pero es arriesgado para montar un flujo de trabajo.
A fecha de publicación, Anthropic no se ha pronunciado públicamente sobre este provider de OpenCode. Sobre los riesgos de cuenta con suscripción, consulta Por qué se suspenden cuentas de Claude y cómo pasar Claude Code a una API Key.
Vía 2: provider Anthropic + API Key
Esta vía no necesita Claude Code; OpenCode envía las peticiones directamente. Así queda con una Key de AICodeWith.
Paso 1: poner la Key en una variable de entorno
export AICODEWITH_API_KEY="TU_API_KEY"
Paso 2: configurar baseURL en opencode.json
opencode.json en la raíz del proyecto, o el global ~/.config/opencode/opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"anthropic": {
"options": {
"baseURL": "https://api.aicodewith.ai/v1",
"apiKey": "{env:AICODEWITH_API_KEY}"
}
}
},
"model": "anthropic/claude-sonnet-5-5"
}
Claves:
- El
baseURLde OpenCode lleva/v1:https://api.aicodewith.ai/v1. En Claude Code es distinto: suANTHROPIC_BASE_URLeshttps://api.aicodewith.ai, sin/v1. apiKeylee{env:AICODEWITH_API_KEY}del entorno, así la Key no acaba en archivos del proyecto ni en git.- También puedes omitir
apiKeyy pegar la Key en/connect→ Anthropic. - Con
/modelsves los modelos de Claude disponibles; escribemodelcomoanthropic/<id del modelo>.
Para separar Keys y direcciones cuando varios clientes comparten una cuenta, consulta Configuración multiherramienta de Codex, OpenCode y WorkBuddy. Para Claude Code, consulta Conectar Claude Code a una API de terceros.
Prueba: OpenCode 2.2.5 corrige un pequeño bug con una Key de AICodeWith
Instalamos OpenCode 2.2.5 en una máquina Linux, con la configuración de arriba, y le pedimos corregir una función slugify. El proyecto tenía un AGENTS.md que pide ejecutar los tests tras modificar cualquier archivo .py:
# slug.py
def slugify(title):
return title.lower().replace(" ", "-")
# test_slug.py
def test_basic(self): self.assertEqual(slugify("Hello World"), "hello-world")
def test_punct(self): self.assertEqual(slugify("OpenCode + Claude: Setup!"), "opencode-claude-setup")
def test_spaces(self): self.assertEqual(slugify(" a b "), "a-b")
Comando:
opencode run -m anthropic/claude-sonnet-5-5 \
"Fix slugify in slug.py so all tests in test_slug.py pass. Follow AGENTS.md. Reply with one short summary line."
Tardó unos 11 segundos desde Enter hasta terminar. OpenCode leyó los dos archivos, reescribió slug.py, ejecutó los tests como pedía AGENTS.md y los 3 pasaron. Salida real:
> build · claude-sonnet-5-5
→ Read slug.py
→ Read test_slug.py
← Write slug.py
Wrote file successfully: slug.py
$ python3 -m unittest 2>&1 | tail -5
...
Ran 3 tests in 0.000s
OK
I rewrote `slugify` in `slug.py` to turn each run of non-alphanumeric characters into one hyphen and strip hyphens from both ends, and `python3 -m unittest` now passes all 3 tests.
El código corregido:
import re
def slugify(title):
# Collapse every run of non-alphanumeric characters into a single hyphen
return re.sub(r"[^a-z0-9]+", "-", title.lower()).strip("-")
No tenemos una cuenta de Claude con suscripción para probar, así que los pasos de la vía 1 siguen las notas de versión y el documento de diseño de OpenCode.
Crear API Key y probar tú mismo el opencode.json de arriba →
Pasar de CLAUDE.md a AGENTS.md
Con Claude Agent, la carga de CLAUDE.md por parte de Claude Code está desactivada, así que las reglas del proyecto deben llegar por OpenCode. Orden de reglas de OpenCode (ver la documentación Rules de OpenCode):
- Si un proyecto tiene AGENTS.md y CLAUDE.md, solo se usa AGENTS.md.
- CLAUDE.md solo sirve de respaldo cuando no hay AGENTS.md.
- El global
~/.config/opencode/AGENTS.mdtiene prioridad sobre~/.claude/CLAUDE.md.
Lo más sencillo: mover las reglas a AGENTS.md y dejar en CLAUDE.md una sola línea de importación, para que OpenCode, Claude Code y Codex lean el mismo archivo:
git mv CLAUDE.md AGENTS.md
printf '@AGENTS.md\n' > CLAUDE.md
git add AGENTS.md CLAUDE.md
Claude Code incorpora el contenido con @AGENTS.md. Para una configuración compartida más completa, consulta Compartir AGENTS.md entre Claude Code y Codex.
Errores habituales
/connect solo muestra un campo para la API Key
Elegiste Anthropic, que es la entrada de API Key. Para la suscripción, vuelve atrás y elige Claude Agent. Si no aparece, OpenCode es anterior a la 2.2.3: ejecuta opencode upgrade.
Claude Agent no conecta o pide iniciar sesión
Comprueba en orden: claude --version es 2.1.248+; ejecutaste claude auth login en la terminal; claude está en el PATH (si no, define OPENCODE_CLAUDE_PATH). El provider no está disponible en espacios remotos ni en OpenCode alojado.
«不支持的请求路径» (ruta de petición no admitida)
En la vía API Key, al baseURL le falta /v1. Cuando lo pusimos a propósito en https://api.aicodewith.ai, esto fue lo que devolvió:
Error: 不支持的请求路径,请检查 API 地址是否正确
Cámbialo a https://api.aicodewith.ai/v1.
«请在请求中提供有效的 API Key» (falta una API Key válida)
{env:AICODEWITH_API_KEY} quedó vacío, normalmente porque exportaste la variable en otra terminal o escribiste mal el nombre. El error tras vaciar la variable:
Error: 请在请求中提供有效的 API Key。
Editar CLAUDE.md no tiene efecto
Si el proyecto ya tiene AGENTS.md, OpenCode solo usa ese, y con Claude Agent la carga de CLAUDE.md por Claude Code también está desactivada. Mueve las reglas a AGENTS.md como se indica arriba.
Llegaste al límite del plan
Según el documento de diseño, Claude Code reintenta por su cuenta y OpenCode no reintenta con este provider, así que el error de límite aparece una vez. Espera a que se restablezca o cambia a la vía API Key en /models.
Fuentes
- Notas de versión de OpenCode v2.2.3
- Notas de versión de OpenCode v2.2.4
- PR #58782: feat(core): add Claude Agent provider
- Documento de diseño specs/v2/claude-agent-provider.md
- Introducción al Claude Agent SDK (documentación de Anthropic)
- Documentación Rules de OpenCode
- Documentación Providers de OpenCode
- @opencode en X



