Todas las páginas
En esta página

Claude Nuevo en 0.9.0

El proveedor Claude ejecuta el agente Claude Code de Anthropic en la máquina del relay, a través del Claude Agent SDK. OAR inicia un proceso worker por conversación. No hay ninguna clave de API que introducir: Claude usa el inicio de sesión de Claude de la máquina del relay, y puedes cambiar ese inicio de sesión desde el navegador.

Claude Cloud ejecuta Claude Code en un sandbox de Anthropic en lugar de en tu máquina. Es un proveedor aparte con su propia configuración. Nuevo en 0.9.18 Claude API ejecuta los mismos chats de Claude con una clave de API de Claude Console en lugar de tu suscripción, y un chat de Claude puede pasar de una a otra.

Lo que necesitas #

  • Un inicio de sesión de Claude en la máquina en la que se ejecuta el relay. El relay no guarda ninguna clave de Claude; la CLI de Claude guarda el inicio de sesión y OAR solo la maneja. Puedes iniciar sesión desde el navegador (consulta La cuenta de Claude) o ejecutando claude una vez en la máquina.
  • La CLI de Claude Code (claude) en esa máquina, para el inicio de sesión desde el navegador y la fila de la cuenta. Los turns de Claude no la necesitan: se ejecutan con la build de Claude Code que viene con el Agent SDK. OAR puede instalarte la CLI, y a partir de entonces las sesiones nuevas usan esa copia.

La fila de la CLI de Claude Code #

En la parte superior de Settings → Providers → Claude (Ajustes → Proveedores → Claude) una fila Claude Code CLI muestra si la CLI está instalada, su versión, dónde está y si está al día. Sus botones dependen del estado:

Botón Cuándo Qué hace
Install (Instalar) No se encontró ninguna CLI Te pide confirmación, indicando el comando y la carpeta en la que escribe, y luego ejecuta el instalador propio de Anthropic como el usuario del relay. En Linux y macOS es curl -fsSL https://claude.ai/install.sh | bash; en Windows, irm https://claude.ai/install.ps1 | iex.
Update (Actualizar) Se encontró la CLI Ejecuta claude update.
Switch to native installer (Cambiar al instalador nativo) La CLI se instaló con npm en una carpeta en la que el usuario del relay no puede escribir Ejecuta claude install. La copia de npm se queda donde está; la build nativa tiene prioridad en el PATH.
Cancel / Dismiss (Cancelar / Descartar) Mientras se ejecuta una instalación / después de que termine Detiene la ejecución / borra el resultado.

La salida de la instalación llega en streaming al panel como Install log (Registro de instalación). Sobrevive al cierre de los ajustes y se puede seguir desde otro dispositivo. Solo se ejecuta una instalación a la vez en el relay. Nada de lo que escribes llega a una shell: los comandos están fijados en el relay.

OAR busca claude en el PATH del relay, y después en ~/.local/bin y /usr/local/bin. Tras una instalación o actualización usa el binario nuevo de inmediato, y lo recuerda entre reinicios, así que no tienes que reiniciar el relay. Las sesiones que ya están en ejecución conservan el binario con el que empezaron.

Activarlo #

Claude está desactivado por defecto. Abre Settings → Providers → Claude. En Claude SDK:

Control Predeterminado Qué hace
Enable Claude for New Chat model selection (Activar Claude en la selección de modelo de los chats nuevos) Desactivado Hace de Claude una opción en New Chat (Nuevo chat) y ejecuta la detección de modelos. Se aplica en cuanto lo cambias, sin Save Claude settings (Guardar los ajustes de Claude).
Claude model ID (ID de modelo de Claude) claude-sonnet-5 El modelo con el que empieza una conversación de Claude. Pulsa Save Claude settings para aplicarlo.
Commit attribution (Atribución de commits) OAR Lo que dicen los commits y los pull requests. Consulta Atribución de commits. También necesita Save Claude settings.

Una línea bajo los controles dice en qué estado está Claude. Desactivar Claude devuelve al proveedor predeterminado las conversaciones que aún no han enviado ningún mensaje. Las conversaciones que ya han empezado conservan Claude.

Modelos #

Activar Claude detecta los modelos que ofrece el Agent SDK y añade sus IDs claude-* a los selectores. Usa Select Models → Claude SDK (Seleccionar modelos → Claude SDK) para elegir cuáles de ellos se muestran en el área de redacción; el modelo predeterminado siempre permanece activado.

Las variantes de contexto largo como claude-opus-5[1m] no aparecen como modelos separados. Se muestran como una entrada de 1M en el desplegable Context window (Ventana de contexto) del modelo base, en New Chat y en el área de redacción.

Un modelo nuevo llega con una actualización de OAR

La detección consulta la build de Claude Code que viene incluida en el Agent SDK, así que claude update por sí solo no hace aparecer un modelo nuevo de Claude. Llega con una actualización de OAR.

La cuenta de Claude #

Bajo la fila de la CLI, la fila de la cuenta indica la cuenta con la sesión iniciada y su plan, por ejemplo Account: dev@example.com · Max plan, o Not logged in.

Relogin (Volver a iniciar sesión) #

  1. Pulsa Relogin. El relay ejecuta el inicio de sesión de la CLI de Claude en su máquina.
  2. Aparece un enlace Open the Claude login page (Abrir la página de inicio de sesión de Claude), con un botón Copy link (Copiar enlace). Abre el enlace en cualquier dispositivo y autoriza en claude.ai.
  3. Claude.ai muestra un código. Pégalo en el campo Paste the code from claude.ai (Pega el código de claude.ai) y pulsa Submit code (Enviar el código) (o Enter).
  4. El panel dice Logged in as …. Se ejecuta una nueva detección de modelos, así que no tienes que reiniciar el relay.

Cancel abandona el inicio de sesión. Un inicio de sesión que nadie termina acaba a los 10 minutos. Solo se ejecuta un inicio de sesión a la vez en un relay. Se envía a todos los navegadores abiertos, así que puedes empezarlo en un dispositivo y terminarlo en otro, y cerrar los ajustes no hace que se pierda.

El relay no guarda ningún secreto de Claude. La CLI escribe el nuevo inicio de sesión en la carpeta de configuración de Claude de la máquina del relay (~/.claude, o la carpeta de CLAUDE_CONFIG_DIR).

Logout (Cerrar sesión) #

Logout abre Log out of Claude (Cerrar sesión en Claude), que indica la cuenta y cuántos workers de Claude están en ejecución. Confirma con Log out. Los turns nuevos de Claude fallan entonces hasta que vuelvas a iniciar sesión.

Sesiones en ejecución #

Las sesiones de Claude en ejecución conservan la cuenta anterior hasta que su proceso worker termina. Las sesiones nuevas usan la cuenta nueva.

Atribución de commits #

Claude Code normalmente añade su propia línea Co-Authored-By: Claude … a los commits que hace un agente, y una línea al cuerpo de los pull requests. OAR te deja elegir:

Opción Commits Pull requests
OAR (predeterminado) Terminan con Co-authored-by: Open Agent Relay (<model>) <no-reply@oar.sh>, con el nombre del modelo entre paréntesis, por ejemplo Claude Fable 5.1. Terminan con 🤖 Generated with [Open Agent Relay](https://oar.sh).
Vanilla (Original) Las líneas propias de Claude Code. La línea propia de Claude Code.
Off (Desactivado) Ninguna línea de atribución. Ninguna línea de atribución.

OAR y Off también mantienen un enlace a la sesión fuera del texto de los commits y los pull requests.

Fija la opción para todo el relay en Settings → Providers → Claude → Commit attribution (Ajustes → Proveedores → Claude → Atribución de commits). Bajo el selector, una línea de ejemplo muestra lo que dirán los commits.

Por carpeta #

El botón de contexto 🧠 de una conversación de Claude muestra Commit attribution para la carpeta de la conversación, con un selector: Inherit (provider: …) (Heredar, proveedor: …), OAR, Vanilla u Off. Una opción elegida aquí vale para todas las sesiones de Claude de esa carpeta. Inherit vuelve al ajuste de todo el relay.

Un cambio llega a una sesión en ejecución con su siguiente mensaje. Pasar a vanilla reinicia la CLI de la sesión entre turns. Las conversaciones de Claude Cloud también siguen el ajuste de todo el relay. Nuevo en 0.9.18 Los chats de Claude API son sesiones de Claude y siguen la opción de la carpeta como cualquier otra. Nuevo en 0.9.17 Las conversaciones de DeepSeek en la carpeta siguen la opción de la carpeta, con Vanilla interpretado como OAR; su ajuste para todo el relay está en la subpestaña DeepSeek. Los demás proveedores no se ven afectados.

Límite de comandos en segundo plano Nuevo en 0.9.12 #

Settings → Providers → Claude → Claude background command limit (Ajustes → Proveedores → Claude → Límite de comandos en segundo plano de Claude) fija cuánto puede tardar un comando que Claude ejecuta en segundo plano antes de que Claude Code lo detenga, cuando Claude no le da al comando un tiempo límite propio. El control deslizante va de 30 minutos a 8 horas en pasos de 30 minutos; el valor predeterminado es 2 horas. Save Claude settings lo guarda. Claude puede seguir pidiendo hasta 8 horas para un solo comando.

  • Un comando que Claude ejecuta en primer plano pasa a segundo plano tras 2 minutos, así que el turn continúa mientras se ejecuta, y se muestra en el panel de tareas con su consola.
  • Los comandos que empiezan por sleep, y los comandos de los subagents, se quedan en primer plano y pueden entonces retener el turn hasta el límite.
  • A Claude se le comunica el límite, que escriba la salida completa de un comando largo en un archivo de registro en lugar de pasarla por tail o head, y que inicie desacoplada con nohup una ejecución que deba sobrevivir a un reinicio de la sesión.
  • La CLI lee el límite al arrancar: un cambio se aplica a las sesiones de Claude iniciadas después de guardar; una sesión en ejecución conserva su límite hasta que se reinicia. Los chats de Claude Cloud no se ven afectados; los chats de Nuevo en 0.9.17 DeepSeek y Nuevo en 0.9.18 Claude API, que también ejecutan Claude Code, usan el mismo límite.

OAR pasa el límite a Claude Code como BASH_DEFAULT_TIMEOUT_MS, con BASH_MAX_TIMEOUT_MS a 8 horas y CLAUDE_CODE_AUTO_BACKGROUND_TIMEOUT_MS a 2 minutos. Estas tres se fijan para cada sesión de Claude que inicia OAR, así que las mismas variables en el entorno del relay no tienen efecto.

Effort y razonamiento #

Reasoning effort #

El selector de reasoning effort es por mensaje: puedes cambiarlo entre turns. Ofrece none y los niveles que informa el modelo (low, medium, high, xhigh, max). Ultracode aparece en los modelos que admiten xhigh. Significa effort xhigh junto con orquestación de flujos de trabajo con varios agentes, y usa muchos más tokens.

Ventana de contexto #

Para los modelos que tienen una variante de 1M, el desplegable Context window ofrece la ventana predeterminada del modelo (mostrada como —, ya que el catálogo del SDK no incluye la cifra) y 1M. Un modelo que solo existe como variante de 1M ofrece solo esa.

Razonamiento #

El botón de contexto 🧠 también contiene dos controles exclusivos de Claude, que se fijan por conversación:

Control Opciones Predeterminado
Thinking (Razonamiento) On (Activado), Off On
Thinking text (Texto del razonamiento) Summarized (Resumido), Hidden (Oculto) Summarized

Activar el razonamiento, y cambiar el texto, se aplican en el siguiente mensaje. Desactivar el razonamiento se aplica a la siguiente sesión de la CLI. Hidden solo oculta el texto; el modelo sigue razonando y los tokens siguen contando. Off es el control que ahorra tokens.

Lo que funciona especialmente bien en Claude #

  • Corrección del rumbo. Un mensaje que envías durante un turn en curso entra en ese turn; el botón de enviar dice Steer (Corregir el rumbo). Consulta Los turns y la queue y Mientras corre un turn.
  • Modos. plan usa el propio modo plan del SDK y termina con un tablero Plan ready (Plan listo) de la herramienta de planes de Claude. Consulta Modos del relay.
  • Tarjetas de pregunta. El AskUserQuestion de Claude se convierte en una tarjeta, incluida la selección múltiple. Consulta ask_user.
  • Tareas en segundo plano y subagents. Los comandos pasados a segundo plano, los subagents, los monitores y los flujos de trabajo sobreviven a la respuesta que los inició y se muestran en el panel de tareas del área de redacción. El título de un subagent abre su registro completo. Solo un subagent en segundo plano se puede detener por separado; uno que se ejecuta dentro del turn actual se detiene con el turn. Settings → General → Background task timeout (Ajustes → General → Tiempo límite de las tareas en segundo plano) (4 h por defecto) limita cuánto tiempo mantienen en ejecución una sesión las tareas en segundo plano por sí solas.
  • Desglose exacto del contexto. El botón 🧠 muestra las categorías que informa el SDK.
  • Compactación automática. Claude compacta por sí mismo una sesión larga. El modal 🧠 tiene un control deslizante Auto-compact window (Ventana de compactación automática): Auto, 100k, 150k, 200k, 300k, 500k o 1M. Consulta Compactar una conversación.
  • Pausa por límite de uso. Un turn que alcanza el límite de uso de la suscripción se pone en pausa y continúa después del reinicio. Consulta Cuando se alcanza un límite de uso.
  • Continuidad de la sesión. Se guarda el id de sesión del SDK, así que una conversación se reanuda después de que su worker se reinicie.
  • Adjuntos. Las imágenes de hasta 5 MB se envían en línea. Las imágenes más grandes y otros archivos se pasan como rutas para que Claude los lea.

Los turns de Claude no tienen línea de consumo bajo la respuesta. Los límites del plan de Claude están en Check Usage (Ver consumo).

Dónde vive la sesión #

En el explorador de archivos, el botón Session root (Raíz de la sesión) (🕵️) abre la carpeta propia de la sesión en el área de proyectos del Agent SDK, dentro de ~/.claude/projects (o dentro de CLAUDE_CONFIG_DIR). La transcripción es el archivo .jsonl junto a esa carpeta. La carpeta solo se crea cuando la sesión tiene archivos de subagents o de resultados de herramientas, así que puede estar vacía en una conversación reciente. Eliminar una conversación elimina su transcripción.

Variables de entorno #

Fíjalas en el entorno en el que arranca el relay.

Variable Qué hace
CLAUDE_CONFIG_DIR La carpeta de configuración de Claude en lugar de ~/.claude: el inicio de sesión, y dónde se buscan las carpetas de sesión.
CLAUDE_CODE_EXECUTABLE El binario de Claude Code que usan los workers en lugar de la build incluida en el Agent SDK. Una instalación o actualización desde el panel la fija por ti.
CLAUDE_CODE_AUTO_COMPACT_WINDOW Sustituye la ventana de compactación automática. La línea bajo el control deslizante la indica entonces como origen. La lee el propio Claude Code; cuando las sesiones se ejecutan bajo tmux, fijarla para el relay no llega hasta él (consulta qué variables llegan a los agentes).
BASH_DEFAULT_TIMEOUT_MS, BASH_MAX_TIMEOUT_MS, CLAUDE_CODE_AUTO_BACKGROUND_TIMEOUT_MS Nuevo en 0.9.12 No se leen del entorno del relay: OAR las fija para cada sesión de Claude a partir del límite de comandos en segundo plano.
CLAUDE_CODE_OAUTH_TOKEN Un token de inicio de sesión en lugar del archivo de inicio de sesión de la CLI, para Claude Cloud y para los chats locales de Claude, cuya CLI lo prefiere al archivo de inicio de sesión. Nuevo en 0.9.17 Solo lo reciben los workers de Claude y de Claude Cloud, bajo tmux a través de un archivo que solo puede leer el usuario del relay; los workers de otros proveedores, incluidos los de DeepSeek, nunca lo reciben.
ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN Nuevo en 0.9.17 No se pasan a los workers. Un chat de Claude se ejecuta con el inicio de sesión de Claude, nunca con una clave del entorno del relay; antes de 0.9.17, Claude Code prefería una clave así al inicio de sesión. Un chat de Claude API se ejecuta con la clave guardada en Settings → Providers → Claude API (Ajustes → Proveedores → Claude API), nunca con estas.

Nuevo en 0.9.18 Un chat con suscripción nunca se ejecuta con una clave de API. Claude Code toma una clave de API antes que tu inicio de sesión de Claude cuando uno de sus propios ajustes se la da: env.ANTHROPIC_API_KEY en ~/.claude/settings.json o en la .claude/settings*.json de la carpeta del chat, un apiKeyHelper o un inicio de sesión de Console. Antes, un chat así se ejecutaba con esa clave y se facturaba a su propietario. Ahora el turn se detiene cuando Claude Code arranca, con una nota que indica el origen y el ajuste que hay que quitar, y el código relay.subscription-key-source. Claude Code envía su primera solicitud de modelo un momento después de ese arranque, así que como mucho una solicitud de modelo puede salir antes con la clave. Para ejecutar un chat con una clave de API, usa Claude API y su selector de facturación.

Solución de problemas #

Problema Qué hacer
Claude no aparece en New Chat Activa Enable Claude for New Chat model selection en Settings → Providers → Claude.
La fila de la CLI dice Not installed (No instalado), o la fila de la cuenta no puede leer la cuenta El inicio de sesión desde el navegador y la fila de la cuenta necesitan claude en la máquina del relay. Pulsa Install, o instálalo tú y vuelve a abrir los ajustes.
Not logged in, o una respuesta dice que Claude no puede autenticarse Pulsa Claude settings (Ajustes de Claude) en la respuesta fallida y luego Relogin (o ejecuta claude en la máquina). Después vuelve a enviar el mensaje.
El inicio de sesión ha caducado Igual que arriba. Una sesión en ejecución conserva su token antiguo hasta que su worker termina; vuelve a enviar el mensaje después de iniciar sesión.
La respuesta apunta a la facturación, la suscripción o la organización Comprueba la cuenta que indica el panel: su suscripción, su método de pago y si la organización permite Claude Code. Relogin inicia sesión con otra cuenta.
Un turn en pausa por un límite de uso Espera al reinicio, o usa Resume now (Reanudar ahora) o Cancel en el banner. Consulta Cuando se alcanza un límite de uso.
Un modelo nuevo no está en el selector Los modelos vienen de la build de Claude Code incluida en el SDK; llegan con una actualización de OAR, no con claude update.
Nuevo en 0.9.18 Claude Code took an API key for this subscription turn (source "…"), so the turn was stopped (relay.subscription-key-source) Quita ANTHROPIC_API_KEY del env de los ajustes de Claude Code (~/.claude/settings.json, o la .claude/settings*.json de la carpeta), quita un apiKeyHelper o cierra la sesión de Console, y vuelve a enviar el mensaje. Para ejecutar el chat con la clave guardada en Settings, pásalo a la clave de API.
Relogin falla en Windows El flujo de inicio de sesión está hecho para Linux y macOS; en Windows funciona en la medida de lo posible. Ejecuta claude en una terminal en su lugar.