Todas las páginas
En esta página

Claude Cloud Nuevo en 0.9.7

Un chat de Claude Cloud ejecuta Claude Code en un sandbox de Anthropic en lugar de en el host de tu relay. El sandbox trabaja sobre su propio clon de un repositorio de GitHub. Ve lo que está subido a GitHub y nada de tu máquina, y sus resultados vuelven como ramas a las que el agente hace push. El chat se factura a la cuenta de Claude con la que ha iniciado sesión la CLI de Claude del host del relay.

En OAR es una conversación como las demás: la respuesta llega en streaming, las preguntas llegan como tarjetas y funciona desde tu teléfono.

Experimental y desactivado por defecto

Claude Cloud usa el inicio de sesión que la CLI de Claude guarda en el host del relay para llamar a endpoints de API que usa la propia CLI de Claude. Estos endpoints no son una API pública documentada. Anthropic puede cambiarlos sin previo aviso; los chats en la nube y las cifras de consumo en vivo fallan entonces con una nota hasta que se actualice OAR. Si no te parece bien que un programa distinto de la CLI use su inicio de sesión de esta forma, deja el proveedor desactivado.

Lo que necesita #

  • La CLI de Claude en el host del relay, con la sesión iniciada con una cuenta de claude.ai, mediante Settings → Providers → Claude → Relogin (Ajustes → Proveedores → Claude → Volver a iniciar sesión) o ejecutando claude en el host. El mismo inicio de sesión sirve para los chats de Claude.
  • GitHub conectado a esa cuenta de Claude: claude.ai/connect-github.
  • La app de GitHub de Claude permitida en cada repositorio en el que deba trabajar un chat en la nube (GitHub → Settings → Applications → Claude → Configure).
  • Un entorno en la cuenta de Claude. Una cuenta que no tiene ninguno recibe su entorno predeterminado cuando abres claude.ai/code una vez.

Activarlo #

Abre Settings → Providers → Claude Cloud (Ajustes → Proveedores → Claude Cloud).

Control Predeterminado Qué hace
Enable Claude Cloud for New Chat (Activar Claude Cloud en Nuevo chat) desactivado Ofrece Claude Cloud en New Chat (Nuevo chat) y activa las cifras de la cuenta en vivo en Check Usage (Ver consumo). Se rechaza mientras el host no tenga un inicio de sesión de Claude.
Claude login (Inicio de sesión de Claude) Salta a la pestaña Claude, donde se cambia el inicio de sesión.
Cloud environment (Entorno en la nube) el primer entorno activo de la cuenta El entorno en el que se ejecutan las sesiones nuevas en la nube. Si no hay ninguno guardado, el relay toma el primero activo y lo guarda.
Default model (Modelo predeterminado) claude-sonnet-5-5 El modelo con el que empieza un chat nuevo en la nube. La lista son los modelos del proveedor Claude sin sus variantes [1m], más el predeterminado.
Save Claude Cloud settings (Guardar los ajustes de Claude Cloud) Guarda el entorno y el modelo predeterminado. El interruptor surte efecto de inmediato.

La pestaña también muestra la cuenta a la que se facturan los chats, y de dónde lee el relay el inicio de sesión y hasta cuándo es válido.

Activar el proveedor es tu consentimiento para el uso del inicio de sesión de Claude descrito arriba:

  • El relay y sus workers en la nube solo leen el token de acceso. Se envía a https://api.anthropic.com y a ningún otro host.
  • Solo se guarda en memoria. No se escribe en la base de datos ni en un registro, no se envía al navegador y no se pone en un mensaje de error.
  • OAR nunca lo renueva y nunca usa el token de renovación. La CLI mantiene vigente su propio inicio de sesión. Cuando el token ha caducado, el relay vuelve a leer el archivo y, como mucho una vez cada cinco minutos, hace que la CLI compruebe su propio inicio de sesión. Un inicio de sesión que sigue caducado termina el turn con una nota para que vuelvas a iniciar sesión.
  • Mientras el interruptor está desactivado, el relay no pide nada a Anthropic con este inicio de sesión: no lista entornos y no lee el consumo de la cuenta.

Desactivar Claude Cloud lo quita de New Chat. Las conversaciones en la nube que ya existen siguen funcionando.

Iniciar un chat en la nube #

Elige + New Chat → Provider → Claude Cloud (Nuevo chat → Proveedor → Claude Cloud). El campo Working directory (Carpeta de trabajo) se mantiene, pero aquí solo rellena dos campos, que también puedes elegir de una lista o escribir tú. No hay reasoning effort que elegir. La sesión en la nube en sí la crea tu primer mensaje. El cuadro de diálogo se describe en Iniciar una conversación.

Repositorio #

Se lee del remoto origin de la carpeta, o del remoto de su rama upstream. Con el campo enfocado, OAR lista los repositorios a los que la app de GitHub de Claude puede acceder para la cuenta. La lista se lee de Anthropic y se guarda durante un minuto; ↻ junto a la etiqueta la vuelve a leer. Si no se puede leer, el motivo se muestra bajo los repositorios usados antes. Los repositorios usados en chats en la nube anteriores en este relay aparecen primero y están marcados con «used here»; otras marcas son «private», «public», «archived» y «no access». Al escribir se filtra la lista por owner/name; las teclas de flecha y Enter eligen, Escape la cierra.

También puedes escribir o pegar owner/repo o una URL de GitHub, https o ssh. Solo se aceptan repositorios de GitHub.

Rama #

La rama actual de la carpeta; un repositorio elegido de la lista trae su rama predeterminada. Con el campo enfocado, OAR ofrece las ramas del repositorio tal como las ve el git del host del relay (git ls-remote, con el propio inicio de sesión de GitHub del host). Cuando el host no puede leerlas, el campo es un campo de texto simple. Déjalo vacío para la rama predeterminada del repositorio.

Avisos #

Bajo los campos, OAR avisa de lo que no tendrá el clon en la nube:

Aviso Significado
1 commit not pushed — the cloud clone will not have it. La rama de la carpeta va por delante de su upstream. Se muestra con un número cuando son varios commits.
Branch main has no upstream — push it first, the cloud clone only sees GitHub. La rama nunca se subió.
Uncommitted changes stay local. La carpeta tiene cambios sin commit.
This folder is not a git repository — enter the repository by hand. La carpeta no dio nada con lo que rellenar.
No GitHub remote in this folder — enter the repository by hand. Se muestra como The remote of this folder is not on GitHub — cloud sessions need a GitHub repository. cuando hay un remoto, pero no de GitHub.
Could not read git details for this folder — enter the repository by hand. El relay no pudo leer la carpeta.
The Claude GitHub app has no access to example-org/sample-repo — add it under GitHub → Settings → Applications → Claude, or pick another repository. La nube rechazaría el primer mensaje.
No cloud environment is set — choose one in Settings → Providers → Claude Cloud. Elige un entorno en los ajustes.

Los dos primeros avisos solo aparecen mientras los campos siguen indicando el repositorio y la rama de la propia carpeta.

Si se rechaza Start chat (Iniciar chat), una línea de error bajo los campos dice por qué: por ejemplo Enter a GitHub repository., Not a GitHub repository. Use owner/repo or a github.com URL., Not a valid branch name., Claude Cloud is not enabled on this relay o No cloud environment is set. con la recomendación de elegir uno en los ajustes.

Trabajar en un chat en la nube #

La respuesta llega en streaming a medida que el agente la escribe, con pensamientos, actividad de herramientas y burbujas de subagents. Mientras el sandbox arranca, la actividad de herramientas muestra sus pasos como líneas que empiezan por Cloud:, y después Claude Code running in the cloud con el modelo.

  • La línea de la nube. Encima del área de redacción: el repositorio, la rama, un enlace claude.ai ↗ a la sesión, un enlace ⇡ branch (rama) por cada rama a la que el agente hizo push (las 20 más recientes) y lo que la sesión ha costado hasta ahora según informa Anthropic. Una rama subida abre la comparación de GitHub con la rama desde la que empezó el chat (la propia rama, cuando el agente hizo push a ella).
  • Abrir en claude.ai. ☁️ Open on claude.ai (Abrir en claude.ai) en el menú ⋯ del chat abre la sesión en claude.ai, una vez que la sesión existe.
  • Preguntas. Las preguntas del agente (AskUserQuestion) llegan como tarjetas de pregunta, incluida la selección múltiple. Una herramienta que pide permiso recibe una tarjeta Allow / Deny (Permitir / Denegar). Una tarjeta que respondes en claude.ai se cierra en OAR.
  • Detener. Stop (Detener) interrumpe el turn en la nube. Si la nube no lo confirma en 30 segundos, el turn termina en OAR con una nota de que el agente puede seguir trabajando allí, con el enlace a la sesión.
  • Imágenes. JPEG, PNG, GIF o WebP, de hasta 5 MB cada una, enviadas en línea. Los demás adjuntos se rechazan: el sandbox no puede leer los archivos del host del relay.
  • Mensajes de seguimiento. Un mensaje va a la misma sesión en la nube, también después de llevar mucho tiempo inactiva. Un mensaje enviado durante un turn espera a que termine el turn.
  • Cambiar el modelo. El modelo se puede cambiar entre turns en el área de redacción, como en un chat local de Claude. El sandbox cambia antes del siguiente mensaje.
  • Atribución de commits. Los commits y pull requests que hace el agente en el sandbox terminan con las líneas que indica el ajuste de atribución de la pestaña Claude; consulta Atribución de commits. El autor del commit sigue siendo la identidad de git del sandbox (Claude).
  • Trabajo en segundo plano. Un turn sigue abierto mientras se ejecuta el trabajo en segundo plano del agente (un subagent, un comando largo), así que la respuesta final llega en el mismo turn.
  • Turns que la sesión inicia por sí misma. Cuando el trabajo en segundo plano del agente dura más que el turn, o cuando envías un mensaje en claude.ai, la respuesta aparece en el chat como una respuesta de continuación, con una línea que dice de dónde viene.
  • Archivar y eliminar. Archivar o eliminar la conversación archiva la sesión en la nube en Anthropic; desarchivarla la recupera. Allí no se elimina nada.

Cuando el navegador o el relay no están #

El agente sigue trabajando en la nube. Un reinicio del relay o del worker de la conversación a mitad de un turn no envía tu mensaje dos veces: el worker nuevo encuentra el turn en el registro de eventos de la sesión y lo sigue, y un turn que terminó mientras tanto se responde desde el registro. Una conexión perdida con la sesión se vuelve a abrir donde se cortó. Consulta Reinicios y reanudación para lo mismo en general.

En el límite de uso #

Un turn que la nube rechaza en el límite de uso de Claude se pone en pausa como un turn local de Claude: una nota con la hora de reinicio, el banner, y el trabajo continúa por sí solo después del reinicio. Consulta Cuando se alcanza un límite de uso. El aviso antes del límite es una línea en la actividad de herramientas, Claude usage limit warning (...), no un banner.

Lo que no tiene un chat en la nube #

Nada del host del relay llega al sandbox.

Consumo #

Con Claude Cloud activado, Check Usage tiene una tarjeta Claude Cloud:

  • un medidor por cada crédito en dólares que tiene la cuenta, con lo usado, lo que queda y cuándo caduca;
  • Cloud spend (OAR sessions) (Gasto en la nube, sesiones de OAR): el coste que informa Anthropic de las sesiones en la nube que este relay aún tiene, con el coste de esta conversación cuando abres el modal desde un chat en la nube;
  • el último informe de sesión en la nube: su coste, y coste y tokens por modelo.

Estas cifras son el coste que informa Anthropic, no un extracto de facturación, y no se cuentan las sesiones iniciadas en otro sitio. Un crédito que se ofrece pero aún no se ha reclamado se menciona con un enlace a claude.ai. Los turns en la nube gastan primero el crédito de la nube; sin crédito, cuentan contra los límites de Claude.

La tarjeta de Claude en Check Usage también lee sus límites en vivo de la cuenta mientras Claude Cloud está activado. El botón 🧠 muestra cuánto de la ventana de contexto de la sesión está en uso, sin categorías. No se adjunta ninguna línea de consumo a las respuestas.

Iniciar una sesión en la nube desde un agente #

Un agente puede iniciar un chat en la nube con create_session, usando provider: "claude-cloud", un repo y, opcionalmente, una branch; consulta create_session. Funciona para un agente en un relay emparejado (con las reglas para iniciar cualquier sesión desde allí) y para un agente en este relay una vez activadas las sesiones de agente. Se aplican las mismas comprobaciones que en New Chat: el proveedor está activado, hay un entorno fijado y el repositorio está en GitHub. Un chat sin un modelo solicitado empieza con el modelo predeterminado de la pestaña. Un agente también puede leer, enviar prompts, esperar y detener un chat en la nube que hayas creado tú.

Variables de entorno #

Nombre Qué hace
CLAUDE_CODE_OAUTH_TOKEN Un token de inicio de sesión de Claude que se usa en lugar del archivo de credenciales de la CLI, tanto en el relay como en sus workers en la nube. Nuevo en 0.9.17 Solo lo reciben los workers de Claude Cloud y de Claude, con o sin tmux; con tmux pasa por un archivo que solo puede leer el usuario del relay, que la shell del worker lee una vez y elimina.
CLAUDE_CONFIG_DIR La carpeta de configuración de Claude, en lugar de ~/.claude. De ella se lee el inicio de sesión de la CLI (.credentials.json).
OAR_CLAUDE_CLOUD_BRANCH_LOOKUP Ponla a off en el host del relay para que la lista de ramas de New Chat no consulte a git. El campo de la rama es entonces un campo de texto simple.

Si no funciona #

Si Claude Cloud no aparece en New Chat, actívalo en Settings → Providers → Claude Cloud.

Cuando un fallo tiene una causa conocida, la respuesta es una nota del sistema que dice qué pasó y qué hacer. Después vuelve a enviar el mensaje.

Lo que ves Por qué, y qué hacer
Se rechaza el interruptor: Claude Cloud needs the Claude CLI login on this host. Log in on Settings → Providers → Claude, then switch it on. Inicia sesión primero en la pestaña Claude.
Claude Cloud needs the Claude login of this relay host, and there is none. Inicia sesión en Settings → Providers → Claude.
The Claude login of this relay host has expired. Vuelve a iniciar sesión en Settings → Providers → Claude. Si la API rechaza el inicio de sesión, aparece la misma nota.
GitHub is not connected to the Claude account of this relay host. Conéctalo en claude.ai/connect-github.
The Claude GitHub app has no access to this repository. Añade el repositorio al acceso a repositorios de la app (GitHub → Settings → Applications → Claude → Configure).
The cloud environment of this conversation is missing. Elige un entorno en Settings → Providers → Claude Cloud. Si la lista está vacía, abre claude.ai/code una vez con esta cuenta.
Claude Cloud refused the request because of a rate limit. Espera un poco. Si la nube indica una espera, la nota dice Wait about N s.
The cloud session of this conversation was not found. Puede que se haya eliminado en claude.ai, o que el host del relay haya iniciado sesión con otra cuenta de Claude. Inicia un chat nuevo de Claude Cloud.
Claude Cloud takes images only, sent inline (JPEG, PNG, GIF or WebP, up to 5 MB each). Not sent: ... Quita el adjunto, o pon lo que el agente necesita en el repositorio o en el mensaje. El mensaje no se envió.
the Claude Cloud turn failed (...) Un fallo al que el relay no puede poner nombre, por ejemplo después de que Anthropic cambiara su interfaz. Reintenta o envía un mensaje nuevo; si sigue fallando, actualiza OAR.
La lista de entornos dice Could not list the cloud environments: ... El relay no pudo leer la lista de Anthropic. El entorno guardado sigue pudiéndose elegir.

Un problema de conexión que puede ser pasajero no hace fallar el turn: el mensaje vuelve a la queue y se entrega de nuevo.