Claude Ajouté en 0.9.0

Le fournisseur Claude fait tourner l’agent Claude Code d’Anthropic sur la machine du relais, via le Claude Agent SDK. OAR démarre un processus worker par conversation. Il n’y a pas de clé d’API à saisir : Claude utilise la connexion Claude de la machine du relais, et vous pouvez changer cette connexion depuis le navigateur.

Claude Cloud fait tourner Claude Code dans un bac à sable chez Anthropic plutôt que sur votre machine. C’est un fournisseur distinct, avec sa propre mise en place. Ajouté en 0.9.18 Claude API fait tourner les mêmes chats Claude sur une clé d’API de la Claude Console plutôt que sur votre abonnement, et un chat Claude peut passer de l’un à l’autre.

Ce qu’il vous faut #

• Une connexion Claude sur la machine où tourne le relais. Le relais n’enregistre aucune clé Claude ; la CLI Claude garde la connexion, et OAR ne fait que la piloter. Vous pouvez vous connecter depuis le navigateur (voir Le compte Claude) ou en lançant claude une fois sur la machine.
• La CLI Claude Code (claude) sur cette machine, pour la connexion depuis le navigateur et la ligne du compte. Les turns Claude n’en ont pas besoin : ils tournent sur le build de Claude Code fourni avec l’Agent SDK. OAR peut installer la CLI pour vous, et dès lors les nouvelles sessions utilisent cette copie.

La ligne de la CLI Claude Code #

En haut de Settings → Providers → Claude (Réglages → Fournisseurs → Claude), une ligne Claude Code CLI indique si la CLI est installée, sa version, son emplacement et si elle est à jour. Ses boutons dépendent de l’état :

La sortie de l’installation s’affiche en continu dans le panneau sous Install log (Journal d’installation). Elle survit à la fermeture des réglages et peut être suivie depuis un autre appareil. Une seule installation tourne à la fois sur le relais. Rien de ce que vous tapez n’atteint un shell : les commandes sont figées dans le relais.

OAR cherche claude dans le PATH du relais, puis dans ~/.local/bin et /usr/local/bin. Après une installation ou une mise à jour, il utilise aussitôt le nouveau binaire et s’en souvient d’un redémarrage à l’autre : vous n’avez donc pas à redémarrer le relais. Les sessions déjà en cours gardent le binaire avec lequel elles ont démarré.

L’activer #

Claude est désactivé par défaut. Ouvrez Settings → Providers → Claude. Sous Claude SDK :

Une ligne sous les contrôles indique dans quel état se trouve Claude. Désactiver Claude renvoie au fournisseur par défaut les conversations qui n’ont pas encore envoyé de message. Les conversations déjà commencées gardent Claude.

Modèles #

Activer Claude découvre les modèles que propose l’Agent SDK et ajoute leurs ID claude-* aux sélecteurs. Utilisez Select Models → Claude SDK (Sélectionner des modèles → Claude SDK) pour choisir lesquels apparaissent dans la zone de saisie ; le modèle par défaut reste toujours activé.

Les variantes à long contexte comme claude-opus-5[1m] n’apparaissent pas comme des modèles distincts. Elles figurent comme une entrée 1M dans la liste déroulante Context window (Fenêtre de contexte) du modèle de base, dans New Chat et dans la zone de saisie.

Le compte Claude #

Sous la ligne de la CLI, la ligne du compte nomme le compte connecté et son forfait, par exemple Account: dev@example.com · Max plan, ou Not logged in.

Relogin (Se reconnecter) #

1. Appuyez sur Relogin. Le relais lance la connexion de la CLI Claude sur sa machine.
2. Un lien Open the Claude login page (Ouvrir la page de connexion Claude) apparaît, avec un bouton Copy link (Copier le lien). Ouvrez le lien sur n’importe quel appareil et donnez l’autorisation sur claude.ai.
3. Claude.ai affiche un code. Collez-le dans le champ Paste the code from claude.ai (Collez le code de claude.ai) et appuyez sur Submit code (Valider le code) (ou Enter).
4. Le panneau indique Logged in as …. Une nouvelle découverte des modèles est lancée : vous n’avez donc pas à redémarrer le relais.

Cancel abandonne la connexion. Une connexion que personne ne termine prend fin au bout de 10 minutes. Une seule connexion tourne à la fois sur un relais. Elle est poussée vers chaque navigateur ouvert : vous pouvez donc la commencer sur un appareil et la terminer sur un autre, et fermer les réglages ne la fait pas perdre.

Le relais ne détient aucun secret Claude. La CLI écrit la nouvelle connexion dans le dossier de configuration Claude de la machine du relais (~/.claude, ou le dossier indiqué dans CLAUDE_CONFIG_DIR).

Logout (Se déconnecter) #

Logout ouvre Log out of Claude (Se déconnecter de Claude), qui nomme le compte et indique combien de workers Claude tournent. Confirmez avec Log out. Les nouveaux turns Claude échouent alors jusqu’à ce que vous vous reconnectiez.

Sessions en cours #

Les sessions Claude en cours gardent l’ancien compte jusqu’à ce que leur processus worker se termine. Les nouvelles sessions utilisent le nouveau compte.

Attribution des commits #

Claude Code ajoute normalement sa propre ligne Co-Authored-By: Claude … aux commits que fait un agent, et une ligne au corps des pull requests. OAR vous laisse choisir :

OAR et Off gardent aussi le lien vers la session hors du texte des commits et des pull requests.

Réglez le choix pour tout le relais dans Settings → Providers → Claude → Commit attribution (Réglages → Fournisseurs → Claude → Attribution des commits). Sous la liste de choix, une ligne d’exemple montre ce que diront les commits.

Par dossier #

Le bouton de contexte 🧠 d’une conversation Claude affiche Commit attribution pour le dossier de la conversation, avec une liste de choix : Inherit (provider: …) (Hériter, fournisseur : …), OAR, Vanilla ou Off. Un choix fait ici vaut pour toutes les sessions Claude de ce dossier. Inherit revient au réglage de tout le relais.

Une modification atteint une session en cours avec son message suivant. Passer à vanilla redémarre la CLI de la session entre deux turns. Les conversations Claude Cloud suivent elles aussi le réglage de tout le relais. Ajouté en 0.9.18 Les chats Claude API sont des sessions Claude et suivent le choix du dossier comme les autres. Ajouté en 0.9.17 Les conversations DeepSeek du dossier suivent le choix du dossier, Vanilla y valant OAR ; leur réglage pour tout le relais se trouve dans le sous-onglet DeepSeek. Les autres fournisseurs ne sont pas concernés.

Limite des commandes de fond Ajouté en 0.9.12 #

Settings → Providers → Claude → Claude background command limit (Réglages → Fournisseurs → Claude → Limite des commandes de fond Claude) fixe combien de temps une commande que Claude lance en arrière-plan peut durer avant que Claude Code ne l’arrête, quand Claude ne donne pas à la commande son propre délai. Le curseur va de 30 minutes à 8 heures par pas de 30 minutes ; la valeur par défaut est de 2 heures. Save Claude settings l’enregistre. Claude peut toujours demander jusqu’à 8 heures pour une seule commande.

• Une commande que Claude lance au premier plan passe en arrière-plan au bout de 2 minutes : le turn continue pendant qu’elle tourne, et elle s’affiche dans le panneau des tâches avec sa console.
• Les commandes qui commencent par sleep, et les commandes des subagents, restent au premier plan et peuvent alors retenir le turn jusqu’à la limite.
• Claude est informé de la limite, et on lui demande d’écrire la sortie complète d’une longue commande dans un fichier journal plutôt que de la rediriger vers tail ou head, et de lancer détachée avec nohup une exécution qui doit survivre à un redémarrage de la session.
• La CLI lit la limite à son démarrage : une modification s’applique aux sessions Claude démarrées après l’enregistrement ; une session en cours garde sa limite jusqu’à son redémarrage. Les chats Claude Cloud ne sont pas concernés ; Ajouté en 0.9.17 les chats DeepSeek et Ajouté en 0.9.18 Claude API, qui font eux aussi tourner Claude Code, utilisent la même limite.

OAR transmet la limite à Claude Code sous la forme BASH_DEFAULT_TIMEOUT_MS, avec BASH_MAX_TIMEOUT_MS à 8 heures et CLAUDE_CODE_AUTO_BACKGROUND_TIMEOUT_MS à 2 minutes. Ces trois variables sont définies pour chaque session Claude que démarre OAR : les mêmes variables dans l’environnement du relais n’ont donc aucun effet.

Effort de raisonnement et thinking #

Effort de raisonnement #

Le sélecteur d’effort de raisonnement vaut par message : vous pouvez le changer entre deux turns. Il propose none et les niveaux que le modèle annonce (low, medium, high, xhigh, max). Ultracode apparaît sur les modèles qui prennent en charge xhigh. Il signifie un effort xhigh associé à une orchestration de workflows multi-agents, et consomme beaucoup plus de tokens.

Fenêtre de contexte #

Pour les modèles qui ont une variante 1M, la liste déroulante Context window propose la fenêtre par défaut du modèle (affichée —, car le catalogue du SDK ne donne aucun chiffre) et 1M. Un modèle qui n’existe qu’en variante 1M ne propose que celle-ci.

Thinking #

Le bouton de contexte 🧠 contient aussi deux contrôles propres à Claude, réglés par conversation :

Activer le thinking, et changer le texte, s’appliquent au message suivant. Désactiver le thinking s’applique à la session CLI suivante. Hidden ne fait que masquer le texte ; le modèle raisonne toujours et les tokens comptent toujours. Off est le contrôle qui économise des tokens.

Ce qui marche particulièrement bien sur Claude #

• Pilotage. Un message que vous envoyez pendant un turn en cours entre dans ce turn ; le bouton d’envoi affiche Steer (Piloter). Voir Les turns et la queue et Pendant qu’un turn tourne.
• Modes. plan utilise le mode plan propre au SDK et se termine par un tableau Plan ready (Plan prêt) issu de l’outil de plan de Claude. Voir Modes du relais.
• Cartes de question. Le AskUserQuestion de Claude devient une carte, choix multiple compris. Voir ask_user.
• Tâches de fond et subagents. Les commandes passées en arrière-plan, les subagents, les moniteurs et les workflows survivent à la réponse qui les a lancés et s’affichent dans le panneau des tâches de la zone de saisie. Le titre d’un subagent ouvre son enregistrement complet. Seul un subagent passé en arrière-plan peut être arrêté à lui seul ; celui qui tourne dans le turn en cours s’arrête avec le turn. Settings → General → Background task timeout (Réglages → Général → Délai des tâches de fond) (4 h par défaut) limite combien de temps les seules tâches de fond gardent une session active.
• Ventilation exacte du contexte. Le bouton 🧠 affiche les catégories que le SDK communique.
• Compactage automatique. Claude compacte de lui-même une longue session. La modale 🧠 a un curseur Auto-compact window (Fenêtre de compactage auto) : Auto, 100k, 150k, 200k, 300k, 500k ou 1M. Voir Compacter une conversation.
• Pause à la limite d’utilisation. Un turn qui atteint la limite d’utilisation de l’abonnement est mis en pause et reprend après la réinitialisation. Voir Quand une limite d’utilisation est atteinte.
• Continuité de session. L’id de session du SDK est enregistré : une conversation reprend donc après le redémarrage de son worker.
• Pièces jointes. Les images jusqu’à 5 Mo sont envoyées directement dans le message. Les images plus grandes et les autres fichiers sont transmis sous forme de chemins, que Claude lit.

Les turns Claude n’ont pas de ligne de consommation sous la réponse. Les limites du forfait Claude se trouvent dans Check Usage (Vérifier la consommation).

Où vit la session #

Dans l’explorateur de fichiers, le bouton Session root (Racine de la session) (🕵️) ouvre le dossier propre à la session dans la zone de projets de l’Agent SDK, dans ~/.claude/projects (ou dans CLAUDE_CONFIG_DIR). Le fil de la conversation est le fichier .jsonl à côté de ce dossier. Le dossier n’est créé que lorsque la session a des fichiers de subagents ou de résultats d’outils : il peut donc être vide pour une conversation récente. Supprimer une conversation supprime son fil.

Variables d’environnement #

Définissez-les dans l’environnement dans lequel démarre le relais.

Ajouté en 0.9.18 Un chat sur abonnement ne tourne jamais sur une clé d’API. Claude Code préfère une clé d’API à votre connexion Claude quand l’un de ses propres réglages lui en fournit une : env.ANTHROPIC_API_KEY dans ~/.claude/settings.json ou dans le .claude/settings*.json du dossier du chat, un apiKeyHelper, ou une connexion Console. Un tel chat tournait auparavant sur cette clé et la facturait à son propriétaire. Désormais, le turn s’arrête au démarrage de Claude Code, avec une note qui nomme la source et le réglage à retirer, et le code relay.subscription-key-source. Claude Code envoie sa première requête au modèle un instant après ce démarrage : au plus une requête au modèle peut donc partir sur la clé avant l’arrêt. Pour faire tourner un chat sur une clé d’API, utilisez Claude API et son sélecteur de facturation.

Dépannage #