Claude Cloud Ajouté en 0.9.7
Un chat Claude Cloud fait tourner Claude Code dans un bac à sable chez Anthropic plutôt que sur l’hôte de votre relais. Le bac à sable travaille sur son propre clone d’un dépôt GitHub. Il voit ce qui est poussé sur GitHub et rien de votre machine, et ses résultats reviennent sous forme de branches que l’agent pousse. Le chat est facturé au compte Claude sur lequel la CLI Claude de l’hôte du relais est connectée.
Dans OAR, c’est une conversation comme les autres : la réponse arrive en continu, les questions arrivent sous forme de cartes, et cela fonctionne depuis votre téléphone.
Expérimental, et désactivé par défaut
Claude Cloud utilise la connexion que la CLI Claude conserve sur l’hôte du relais pour appeler des points de terminaison d’API que la CLI Claude utilise elle-même. Ces points de terminaison ne sont pas une API publique documentée. Anthropic peut les changer sans préavis ; les chats cloud et les chiffres de consommation en direct échouent alors avec une note jusqu’à ce qu’OAR soit mis à jour. Si cela vous gêne qu’un programme autre que la CLI utilise sa connexion de cette façon, laissez le fournisseur désactivé.
Ce qu’il lui faut #
- La CLI Claude sur l’hôte du relais, connectée avec un compte claude.ai
via Settings → Providers → Claude → Relogin (Réglages → Fournisseurs → Claude → Se reconnecter) ou en lançant
claudesur l’hôte. La même connexion sert aux chats Claude. - GitHub connecté à ce compte Claude : claude.ai/connect-github.
- L’app GitHub Claude autorisée sur chaque dépôt sur lequel un chat cloud doit travailler (GitHub → Settings → Applications → Claude → Configure).
- Un environnement sur le compte Claude. Un compte qui n’en a pas reçoit son environnement par défaut quand vous ouvrez claude.ai/code une fois.
L’activer #
Ouvrez Settings → Providers → Claude Cloud (Réglages → Fournisseurs → Claude Cloud).
| Contrôle | Par défaut | Ce qu’il fait |
|---|---|---|
| Enable Claude Cloud for New Chat (Activer Claude Cloud dans Nouveau chat) | désactivé | Propose Claude Cloud dans New Chat (Nouveau chat) et active les chiffres du compte en direct dans Check Usage (Vérifier la consommation). Il est refusé tant que l’hôte n’a pas de connexion Claude. |
| Claude login (Connexion Claude) | Mène à l’onglet Claude, où l’on change la connexion. | |
| Cloud environment (Environnement cloud) | le premier environnement actif du compte | L’environnement dans lequel tournent les nouvelles sessions cloud. Si aucun n’est enregistré, le relais prend le premier actif et l’enregistre. |
| Default model (Modèle par défaut) | claude- |
Le modèle avec lequel démarre un nouveau chat cloud. La liste contient les modèles du fournisseur Claude sans leurs variantes [1m], plus le modèle par défaut. |
| Save Claude Cloud settings (Enregistrer les réglages Claude Cloud) | Enregistre l’environnement et le modèle par défaut. L’interrupteur prend effet immédiatement. |
L’onglet indique aussi le compte auquel les chats sont facturés, ainsi que l’endroit où le relais lit la connexion et jusqu’à quand elle est valide.
Activer le fournisseur vaut consentement à l’usage de la connexion Claude décrit ci-dessus :
- Le relais et ses workers cloud ne font que lire le token d’accès. Il est
envoyé à
https://et à aucun autre hôte.api. anthropic. com - Il n’est gardé qu’en mémoire. Il n’est écrit ni dans la base de données ni dans un journal, n’est pas envoyé au navigateur et n’est pas placé dans un message d’erreur.
- OAR ne le renouvelle jamais et n’utilise jamais le token de renouvellement. La CLI garde elle-même sa connexion à jour. Quand le token a expiré, le relais relit le fichier et, au plus une fois toutes les cinq minutes, fait vérifier sa propre connexion par la CLI. Une connexion toujours expirée met fin au turn avec une note invitant à se reconnecter.
- Tant que l’interrupteur est désactivé, le relais ne demande rien à Anthropic avec cette connexion : il ne liste aucun environnement et ne lit aucune consommation du compte.
Désactiver Claude Cloud le retire de New Chat. Les conversations cloud qui existent déjà continuent de fonctionner.
Démarrer un chat cloud #
Choisissez + New Chat → Provider → Claude Cloud (Nouveau chat → Fournisseur → Claude Cloud). Le Working directory (Dossier de travail) reste, mais ici il ne fait que remplir deux champs, que vous pouvez aussi choisir dans une liste ou saisir vous-même. Il n’y a pas d’effort de raisonnement à choisir. La session cloud elle-même est créée par votre premier message. La boîte de dialogue est décrite dans Démarrer une conversation.
Dépôt #
Lu depuis le remote origin du dossier, ou depuis le remote de sa branche
amont. Quand le champ a le focus, OAR liste les dépôts que l’app GitHub Claude
peut atteindre pour le compte. La liste est lue chez Anthropic et gardée une
minute ; ↻ à côté du libellé la relit. Si elle ne peut pas être lue, la
raison s’affiche sous les dépôts utilisés auparavant. Les dépôts utilisés dans
des chats cloud précédents sur ce relais viennent en premier et sont marqués
« used here » ; les autres marques sont « private », « public », « archived » et
« no access ». La saisie filtre la liste par owner/ ; les flèches et
Enter choisissent, Escape la ferme.
Vous pouvez aussi saisir ou coller owner/ ou une URL GitHub, https ou ssh.
Seuls les dépôts GitHub sont acceptés.
Branche #
La branche actuelle du dossier ; un dépôt choisi dans la liste apporte sa
branche par défaut. Quand le champ a le focus, OAR propose les branches du dépôt
telles que les voit le git de l’hôte du relais (git ls-, avec la propre
connexion GitHub de l’hôte). Quand l’hôte ne peut pas les lire, le champ est un
simple champ texte. Laissez-le vide pour la branche par défaut du dépôt.
Avertissements #
Sous les champs, OAR avertit de ce que le clone cloud n’aura pas :
| Avertissement | Signification |
|---|---|
1 commit not pushed — the cloud clone will not have it. |
La branche du dossier est en avance sur sa branche amont. Affiché avec un nombre pour plusieurs commits. |
Branch main has no upstream — push it first, the cloud clone only sees Git |
La branche n’a jamais été poussée. |
Uncommitted changes stay local. |
Le dossier a des modifications qui ne sont pas commitées. |
This folder is not a git repository — enter the repository by hand. |
Le dossier n’a rien fourni pour remplir les champs. |
No Git |
Affiché sous la forme The remote of this folder is not on Git quand il y a un remote, mais pas sur GitHub. |
Could not read git details for this folder — enter the repository by hand. |
Le relais n’a pas pu lire le dossier. |
The Claude Git |
Le cloud refuserait le premier message. |
No cloud environment is set — choose one in Settings → Providers → Claude Cloud. |
Choisissez un environnement dans les réglages. |
Les deux premiers avertissements n’apparaissent que tant que les champs désignent encore le dépôt et la branche du dossier lui-même.
Si Start chat (Démarrer le chat) est refusé, une ligne d’erreur sous les champs dit pourquoi : par
exemple Enter a Git, Not a Git, Not a valid branch name., Claude Cloud is not enabled on this relay, ou No cloud environment is set. avec le conseil d’en choisir
un dans les réglages.
Travailler dans un chat cloud #
La réponse arrive en continu à mesure que l’agent l’écrit, avec les réflexions,
l’activité des outils et les bulles des subagents. Pendant que le bac à sable
démarre, l’activité des outils montre ses étapes sous forme de lignes qui
commencent par Cloud:, puis Claude Code running in the cloud avec le modèle.
- La ligne cloud. Au-dessus de la zone de saisie : le dépôt, la branche, un lien claude.ai ↗ vers la session, un lien ⇡ branch (⇡ branche) par branche que l’agent a poussée (les 20 plus récentes), et ce que la session a coûté jusqu’ici selon Anthropic. Une branche poussée ouvre la comparaison GitHub avec la branche de départ du chat (la branche elle-même, quand l’agent a poussé dessus).
- Ouvrir sur claude.ai. ☁️ Open on claude.ai (Ouvrir sur claude.ai) dans le menu
⋯du chat ouvre la session sur claude.ai, une fois la session créée. - Questions. Les questions de l’agent (
Ask) arrivent sous forme de cartes de question, choix multiple compris. Un outil qui demande une permission reçoit une carte Allow / Deny (Autoriser / Refuser). Une carte à laquelle vous répondez sur claude.ai se ferme dans OAR.User Question - Arrêt. Stop (Arrêter) interrompt le turn cloud. Si le cloud ne confirme pas dans les 30 secondes, le turn se termine dans OAR avec une note indiquant que l’agent travaille peut-être encore là-bas, avec le lien vers la session.
- Images. JPEG, PNG, GIF ou WebP, jusqu’à 5 Mo chacune, envoyées dans le message. Les autres pièces jointes sont refusées : le bac à sable ne peut pas lire les fichiers de l’hôte du relais.
- Messages de suivi. Un message va dans la même session cloud, même après une longue période d’inactivité. Un message envoyé pendant un turn attend la fin du turn.
- Changer de modèle. Le modèle peut être changé entre deux turns dans la zone de saisie, comme dans un chat Claude local. Le bac à sable bascule avant le message suivant.
- Attribution des commits. Les commits et pull requests que l’agent fait
dans le bac à sable se terminent par les lignes que prévoit le réglage
d’attribution de l’onglet Claude ; voir
Attribution des commits. L’auteur du
commit reste l’identité git du bac à sable (
Claude). - Travail de fond. Un turn reste ouvert tant que le travail de fond de l’agent (un subagent, une longue commande) tourne, si bien que la réponse finale arrive dans le même turn.
- Les turns que la session démarre d’elle-même. Quand le travail de fond de l’agent survit au turn, ou quand vous envoyez un message sur claude.ai, la réponse apparaît dans le chat comme une réponse de suite, avec une ligne indiquant d’où elle vient.
- Archiver et supprimer. Archiver ou supprimer la conversation archive la session cloud chez Anthropic ; la désarchiver la ramène. Rien n’est supprimé là-bas.
Quand le navigateur ou le relais est absent #
L’agent continue de travailler dans le cloud. Un redémarrage du relais ou du worker de la conversation au milieu d’un turn n’envoie pas votre message deux fois : le nouveau worker retrouve le turn dans le journal d’événements de la session et le suit, et un turn qui s’est terminé entre-temps reçoit sa réponse depuis le journal. Une connexion à la session qui a été coupée est rouverte là où elle s’est interrompue. Voir Redémarrages et reprise pour la même chose en général.
À la limite d’utilisation #
Un turn que le cloud refuse à la limite d’utilisation Claude est mis en pause
comme un turn Claude local : une note avec l’heure de réinitialisation, la
bannière, et le travail reprend de lui-même après la réinitialisation. Voir
Quand une limite d’utilisation est atteinte. L’avertissement
avant la limite est une ligne dans l’activité des outils, Claude usage limit warning (..., pas une bannière.
Ce qu’un chat cloud n’a pas #
Rien de l’hôte du relais n’atteint le bac à sable.
- Outils du relais. Pas de
preview, pas derelay_, et pas de médias intégrés par chemin sur l’hôte. Voir Par fournisseur.tool - Dossiers. Pas de dossier de travail à changer : Change CWD (Changer le dossier de travail) manque dans
le menu
⋯. Pas de dossier Session à parcourir non plus. - Modes du relais. Pas de modes du relais, pas d’effort de raisonnement et pas de taille de contexte : les trois sélecteurs sont masqués.
- Pilotage et tâches. Pas de pilotage en cours de turn et pas de panneau des tâches de fond.
- Pièces jointes. Seulement des images.
Consommation #
Avec Claude Cloud activé, Check Usage a une carte Claude Cloud :
- une jauge par crédit en dollars que détient le compte, avec ce qui est utilisé, ce qui reste et la date d’expiration ;
- Cloud spend (OAR sessions) (Dépenses cloud, sessions OAR) : le coût qu’Anthropic indique pour les sessions cloud que ce relais a encore, avec le coût propre de cette conversation quand vous ouvrez la modale depuis un chat cloud ;
- le dernier rapport de session cloud : son coût, et le coût et les tokens par modèle.
Ces chiffres sont le coût indiqué par Anthropic, pas un relevé de facturation, et les sessions démarrées ailleurs ne sont pas comptées. Un crédit offert mais pas encore réclamé est mentionné avec un lien vers claude.ai. Les turns cloud consomment d’abord le crédit cloud ; sans crédit, ils comptent dans les limites Claude.
La carte Claude de Check Usage lit aussi ses limites en direct depuis le compte tant que Claude Cloud est activé. Le bouton 🧠 montre quelle part de la fenêtre de contexte de la session est utilisée, sans catégories. Aucune ligne de consommation n’est jointe aux réponses.
Démarrer une session cloud depuis un agent #
Un agent peut démarrer un chat cloud avec create_, en utilisant
provider: "claude-, un repo et, en option, une branch ; voir
create_session. Cela
fonctionne pour un agent sur un relais associé (selon les règles qui valent pour
le démarrage de toute session depuis celui-ci) et pour un agent sur ce relais
une fois les sessions d’agent
activées. Les mêmes vérifications s’appliquent que dans New Chat : le
fournisseur est activé, un environnement est défini, le dépôt est sur GitHub.
Un chat sans modèle demandé démarre avec le modèle par défaut de l’onglet. Un
agent peut aussi lire un chat cloud que vous avez créé, lui envoyer un prompt,
l’attendre et l’arrêter.
Variables d’environnement #
| Nom | Ce qu’elle fait |
|---|---|
CLAUDE_ |
Un token de connexion Claude utilisé à la place du fichier d’identifiants de la CLI, par le relais et par ses workers cloud. Ajouté en 0.9.17 Seuls les workers Claude Cloud et Claude le reçoivent, avec ou sans tmux ; sous tmux, il passe par un fichier que seul l’utilisateur du relais peut lire, que le shell du worker lit une fois puis supprime. |
CLAUDE_ |
Le dossier de configuration Claude, à la place de ~/.. La connexion de la CLI (.) y est lue. |
OAR_ |
Mettez-la à off sur l’hôte du relais pour que la liste des branches dans New Chat n’interroge plus git. Le champ de branche est alors un simple champ texte. |
Si ça ne marche pas #
Si Claude Cloud manque dans New Chat, activez-le dans Settings → Providers → Claude Cloud.
Quand un échec a une cause connue, la réponse est une note système qui dit ce qui s’est passé et quoi faire. Renvoyez ensuite le message.
| Ce que vous voyez | Pourquoi, et que faire |
|---|---|
L’interrupteur est refusé : Claude Cloud needs the Claude CLI login on this host. Log in on Settings → Providers → Claude, then switch it on. |
Connectez-vous d’abord sur l’onglet Claude. |
Claude Cloud needs the Claude login of this relay host, and there is none. |
Connectez-vous dans Settings → Providers → Claude. |
The Claude login of this relay host has expired. |
Reconnectez-vous dans Settings → Providers → Claude. Le refus de la connexion par l’API donne la même note. |
Git |
Connectez-le sur claude.ai/connect-github. |
The Claude Git |
Ajoutez le dépôt à l’accès aux dépôts de l’app (GitHub → Settings → Applications → Claude → Configure). |
The cloud environment of this conversation is missing. |
Choisissez un environnement dans Settings → Providers → Claude Cloud. Si la liste est vide, ouvrez claude.ai/code une fois avec ce compte. |
Claude Cloud refused the request because of a rate limit. |
Attendez un peu. Si le cloud indique un délai, la note dit Wait about N s. |
The cloud session of this conversation was not found. |
Elle a peut-être été supprimée sur claude.ai, ou l’hôte du relais est connecté à un autre compte Claude. Démarrez un nouveau chat Claude Cloud. |
Claude Cloud takes images only, sent inline (JPEG, PNG, GIF or Web |
Retirez la pièce jointe, ou mettez ce dont l’agent a besoin dans le dépôt ou dans le message. Le message n’a pas été envoyé. |
the Claude Cloud turn failed (... |
Un échec que le relais ne sait pas nommer, par exemple après un changement d’interface chez Anthropic. Réessayez ou envoyez un nouveau message ; si l’échec persiste, mettez OAR à jour. |
La liste des environnements indique Could not list the cloud environments: ... |
Le relais n’a pas pu lire la liste chez Anthropic. L’environnement enregistré reste sélectionnable. |
Un problème de connexion passager ne fait pas échouer le turn : le message retourne dans la queue et est remis de nouveau.