Faire tourner Claude Code comme worker osFoundry avec votre propre abonnement Claude

Une fois cette configuration terminée, le rôle Worker de osFoundry est tenu par Claude Code. Quand une étape du plan lui revient, l'application de bureau lance claude dans le dossier de votre projet, connecté avec votre propre abonnement Claude. Claude Code modifie les fichiers avec ses propres outils et accède aux outils d'osFoundry, comme la recherche dans vos notes, sous le nom mcp__osfoundry__memory_search. Chacun de ces appels apparaît dans le chat osFoundry sous forme d'une ligne "Using …".

Qui fait quoi

	Claude Code	Application de bureau osFoundry
Connexion	Votre abonnement Claude, enregistré par la CLI après /login	Ne le voit jamais. Retire ANTHROPIC_API_KEY et les variables similaires de l'environnement du processus enfant, pour que l'exécution ne puisse pas basculer sur la facturation API
Coût	Imputé à votre abonnement	Enregistre l'exécution avec un coût de 0
Fichiers	Ses propres Read, Edit et Bash, dans un seul dossier (--add-dir)	Choisit ce dossier : le plus récent dans Local Folders
Outils osFoundry	Les appelle sous la forme mcp__osfoundry__<tool>	Les sert sur un port loopback pour cette exécution uniquement, et vérifie chaque appel contre une allowlist
Approbation	Tourne avec --permission-mode bypassPermissions dans son dossier	Chaque appel passé par le bridge franchit la même barrière d'approbation et de politique que l'appel d'outil de n'importe quel autre modèle
Sortie	Texte final	Devient la sortie du rôle. L'activité des outils s'affiche en lignes de progression

Configuration

1. Installer Claude Code et se connecter une fois

Installez la CLI comme l'indique la documentation d'Anthropic. Connectez-vous ensuite depuis un terminal :

$ claude
> /login

osFoundry cherche le binaire dans le PATH, dans ~/.claude/local et dans le bundle de l'extension VS Code (~/.vscode/extensions/anthropic.claude-code-*/resources/native-binary/claude). Un Claude Code installé uniquement via l'extension VS Code est donc trouvé lui aussi.

2. L'activer dans External AI

Dans l'application de bureau, cliquez sur l'icône de clé dans l'en-tête (API Keys (BYOK)), puis ouvrez l'onglet External AI (IA externe). La ligne Claude Code doit ressembler à ceci :

Claude Code   Installed                                  [Enabled]
/Users/you/.claude/local/claude
Model id: cli:claude (chat) · cli:claude:agent (autonomous)
[Verify sign-in]  [Sign in]

Exemple : Claude Code et Codex dans l'onglet External AI

Cliquez sur Verify sign-in (vérifier la connexion). L'application lance une toute petite completion via la CLI et affiche ✓ Signed in ou Needs sign-in. Sign in ouvre Claude Code dans une fenêtre de terminal avec l'indication "Type /login to sign in, then close this window."

Il se peut qu'un badge API key in env apparaisse. Cela signifie qu'une variable comme ANTHROPIC_API_KEY est définie dans l'environnement depuis lequel osFoundry a été lancé. L'application la retire avant de lancer claude, donc l'exécution utilise toujours votre abonnement. Le badge n'est qu'un avertissement.

3. Lui donner un dossier

Le mode agent travaille dans un vrai répertoire. Ajoutez votre projet dans Settings → Local Folders. Si vous en avez plusieurs, c'est le dernier ajouté qui est utilisé. Les exécutions lancées depuis la surface Code utilisent plutôt le dépôt enregistré pour cette exécution.

4. Attribuer le rôle

Ouvrez l'onglet Pipeline → Pipeline Roles. Sous Agents, choisissez Worker et sélectionnez cli:claude:agent dans le groupe External AI (subscription).

Les deux identifiants correspondent à deux modes différents :

• cli:claude:agent est autonome. Claude Code dispose de ses propres outils dans votre dossier, plus les outils d'osFoundry via le bridge. Utilisez-le pour Worker, Researcher, Document Agent et les rôles similaires.
• cli:claude est le mode chat. La CLI tourne avec --disallowedTools '*' et ne peut rien appeler. Il convient aux rôles purement textuels comme Titling ou Compaction. Si un rôle qui a besoin d'outils y est lié, l'exécution échoue avec un message qui vous invite à utiliser cli:claude:agent.

Les agents que vous définissez dans l'écran Agents peuvent aussi l'utiliser. Leur sélecteur de modèle le propose sous CLI agents, avec le libellé "autonomous — runs in your local folder".

5. Ce que l'application lance réellement

Pour chaque exécution, osFoundry démarre un nouveau bridge MCP, puis lance la CLI à peu près ainsi. Les flags viennent de build_claude_command dans src-tauri/src/providers/agent_cli.rs :

claude -p "<conversation>" \
  --output-format stream-json --verbose --include-partial-messages \
  --permission-mode bypassPermissions \
  --add-dir /Users/you/work/site \
  --mcp-config '{"mcpServers":{"osfoundry":{"type":"http",
      "url":"http://127.0.0.1:<port>/mcp",
      "headers":{"Authorization":"Bearer <per-run token>"},
      "timeout":120000}}}' \
  --strict-mcp-config \
  --append-system-prompt "<role prompt>"

--strict-mcp-config tient vos propres serveurs MCP globaux ou de projet à l'écart de cette exécution. Seul le serveur osfoundry est branché. Le port et le token sont nouveaux à chaque exécution, et le listener se ferme quand le processus se termine.

Une vraie exécution

Exemple. La note et le dépôt sont du contenu de démonstration.

Vous (chat Maestro, Worker = cli:claude:agent)
  Trouve dans mes notes la date de la revue budgétaire du T4 et ajoute-la à TODO.md.

Appels d'outils de Claude Code
  mcp__osfoundry__memory_search  {"query": "revue budgétaire T4"}
    → "Revue budgétaire T4 : jeu. 14:00."
  Read   TODO.md
  Edit   TODO.md   (+ "- [ ] Préparer les chiffres pour la revue budgétaire T4 (jeu. 14:00)")

Lignes de progression d'osFoundry
  Using memory_search — {"query":"revue budgétaire T4"}
  Using Read — {"file_path":"TODO.md"}
  Using Edit — {"file_path":"TODO.md", …}

Réponse
  Ajouté "Préparer les chiffres pour la revue budgétaire T4 (jeu. 14:00)" à TODO.md.
  L'heure vient de votre note "Revue budgétaire T4 : jeu. 14:00."

Le préfixe mcp__osfoundry__ est la façon dont Claude Code nomme les outils d'un serveur appelé osfoundry. osFoundry le retire dans la ligne de progression, si bien que memory_search se lit comme avec un modèle via API.

Où passe la limite

Le bridge propose une liste courte et fixe. Elle comprend des outils en lecture seule comme memory_search, web_search, extract_content, code_search, todo_list, transcribe et les outils de lecture cloud_*, plus l'orchestration (spawn_fleet, graph_run, loop_run), l'écran en direct et les outils Canvas. Elle laisse volontairement de côté read_file, write_file et execute_command. Claude Code en possède déjà des versions limitées à son dossier, et un second exécuteur sans cette limite, via MCP, irait au-delà de --add-dir.

L'allowlist est appliquée par le bridge, pas par un flag de la CLI. Une exécution en mode bypassPermissions ne respecte pas --allowedTools, donc osFoundry ne le passe pas. Un appel à un outil hors de la liste de l'exécution reçoit une erreur JSON-RPC : "tool '…' is not available to this agent".

Le workspace et le canal sont fixés au démarrage du bridge. Un appel d'outil ne peut pas se rediriger vers un autre workspace via ses arguments.

Les écritures sur l'écran ou dans un éditeur Canvas (ui_agent_act, les outils d'écriture Canvas) vous demandent toujours d'abord votre accord, comme pour un modèle via API. Les exécutions que personne ne surveille, par exemple un agent qui répond à une mention dans un canal, refusent un outil soumis à approbation au lieu d'attendre un clic qui ne viendra pas.

Vos fichiers ne passent jamais par osFoundry. Claude Code les lit et les modifie directement, et son trafic part vers Anthropic sous votre propre connexion, comme dans un terminal.

L'étape suivante consiste à lier aussi cli:claude:agent au rôle Researcher, à côté de Worker, puis à lancer une tâche orchestrée. La page des rôles du Pipeline liste tous les rôles que vous pouvez lui confier, et Local Folders explique comment le dossier de travail est choisi.