OpenCode + Claude: inicio de sesión con suscripción vía Claude Agent o API Key, cuál elegir (2.2.3+)

OpenCode 2.2.3 añade un provider Claude Agent integrado. Instala Claude Code 2.1.248+, ejecuta claude auth login y elige Claude Agent en /connect para usar tu sesión de Claude Code y sus modelos. La otra vía es el provider Anthropic con un baseURL y una API Key. Esta guía compara ambas, explica cada configuración, cómo pasar las reglas de CLAUDE.md a AGENTS.md, los errores habituales y la salida real de la vía API Key.

9 分钟阅读
OpenCode + Claude: inicio de sesión con suscripción vía Claude Agent o API Key, cuál elegir (2.2.3+)

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 un baseURL y una Key para el provider anthropic en opencode.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)
VersionesOpenCode 2.2.3+, Claude Code 2.1.248+ instalado en localCualquier versión de OpenCode
Inicio de sesiónclaude auth login en la terminalPegar una API Key (o leerla de una variable de entorno)
Quién envía las peticionesTu programa claude local, a través del Claude Agent SDK oficialEl propio OpenCode
Herramientas, permisos, historialTodo del lado de OpenCodeTodo del lado de OpenCode
CLAUDE.mdLa carga de CLAUDE.md por Claude Code está desactivada; las reglas llegan por AGENTS.mdCarga de reglas propia de OpenCode (AGENTS.md primero)
Espacios de trabajo remotos / alojadosNo compatible; claude debe correr en la misma máquinaCompatible
Temperature y otras opciones de muestreoNo compatibleCompatible

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

bash
opencode --version   # 2.2.3+
claude --version     # 2.1.248+

Actualiza si hace falta:

bash
# 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

bash
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

text
/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:

bash
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 ~/.claude y de la carpeta .claude del 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: /usage del plan de Claude, sesiones en la nube y /teleport, /loop, auto mode, computer use, entre otros. /usage en OpenCode muestra el uso de OpenCode Console.
  • Cada sesión mantiene un proceso claude persistente. 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

bash
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:

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 baseURL de OpenCode lleva /v1: https://api.aicodewith.ai/v1. En Claude Code es distinto: su ANTHROPIC_BASE_URL es https://api.aicodewith.ai, sin /v1.
  • apiKey lee {env:AICODEWITH_API_KEY} del entorno, así la Key no acaba en archivos del proyecto ni en git.
  • También puedes omitir apiKey y pegar la Key en /connect → Anthropic.
  • Con /models ves los modelos de Claude disponibles; escribe model como anthropic/<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:

python
# 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:

bash
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:

text
> 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:

python
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.md tiene 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:

bash
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ó:

text
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:

text
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

相关文章

Qué es el UI SDK y cómo se usa? La biblioteca de comportamientos de Vercel y shadcn para agentes, instalada y probada en Claude Code / Codex / Cursor (0.1.0-beta.1)

Qué es el UI SDK y cómo se usa? La biblioteca de comportamientos de Vercel y shadcn para agentes, instalada y probada en Claude Code / Codex / Cursor (0.1.0-beta.1)

El UI SDK es la biblioteca de comportamientos de Vercel para agentes, publicada el 12 de noviembre de 2026 como 0.1.0-beta.1. Los comportamientos viven en el paquete independiente del framework @ui-sdk/core y los renderizan adaptadores para React, Vue, Svelte, Solid y Web Components. Esta guía sigue la documentación oficial sobre qué es, cómo instalarlo y cómo añadir el skill para Claude Code, Codex y Cursor, y registra los comandos, tiempos y salidas de nuestra máquina de prueba.

¿Qué es AWS Emulator y cómo se instala? Prueba apps de AWS en local con Claude Code y Codex (probado en 1.0.322)

¿Qué es AWS Emulator y cómo se instala? Prueba apps de AWS en local con Claude Code y Codex (probado en 1.0.322)

AWS Emulator es el emulador local oficial de las API de AWS, con disponibilidad general desde el 11 de noviembre de 2026 (hora de EE. UU.). No tiene cargo adicional por el servicio, su código es abierto, no necesita cuenta de AWS y cubre más de 200 servicios. Probamos la versión 1.0.322 en Debian 13: comandos de instalación, AWS CLI apuntando al endpoint local para crear un bucket de S3 y una tabla de DynamoDB, los errores que encontramos y cómo hacer que Claude Code, Codex y Cursor escriban y prueben código contra el emulador.

¿Qué es T3 Code y cómo se instala? Conectar Claude Code y Codex, usar una API Key de terceros y resolver errores comunes (probado en 0.1.9)

¿Qué es T3 Code y cómo se instala? Conectar Claude Code y Codex, usar una API Key de terceros y resolver errores comunes (probado en 0.1.9)

T3 Code es la consola de código abierto de pingdotgg para manejar agentes de programación. No trae modelo propio: controla los CLI de Claude Code, Codex, Cursor y otros que ya tienes instalados. Probamos T3 Code 0.1.9 en Linux. Esta guía cubre los comandos de instalación, cómo conectar Claude Code y Codex a una API Key de AICodeWith para que T3 Code los controle, una ejecución completa de ambos agentes con el comando t3 thread y los errores que encontramos, con su solución.