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
claudeuna 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 -fs; en Windows, irm https://. |
| 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 ~/. y
/. 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- |
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- 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., o Not logged in.
Relogin (Volver a iniciar sesión) #
- Pulsa Relogin. El relay ejecuta el inicio de sesión de la CLI de Claude en su máquina.
- 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.
- 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).
- 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
(~/., o la carpeta de CLAUDE_).
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- 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-, con el nombre del modelo entre paréntesis, por ejemplo Claude Fable 5.. |
Terminan con 🤖 Generated with [Open Agent Relay](https://. |
| 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
tailohead, y que inicie desacoplada connohupuna 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_, con
BASH_ a 8 horas y CLAUDE_ 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 1. 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
Askde Claude se convierte en una tarjeta, incluida la selección múltiple. Consulta ask_user.User Question - 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
~/. (o dentro de CLAUDE_). La transcripción es el
archivo . 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_ |
La carpeta de configuración de Claude en lugar de ~/.: el inicio de sesión, y dónde se buscan las carpetas de sesión. |
CLAUDE_ |
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_ |
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_, BASH_, CLAUDE_ |
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_ |
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_, ANTHROPIC_ |
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. en
~/. o en la . de la carpeta del
chat, un api 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.. 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.) |
Quita ANTHROPIC_ del env de los ajustes de Claude Code (~/., o la . de la carpeta), quita un api 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. |