claude-cluster docs1.10.1
Security and auditSécurité et audit

Security overviewVue d'ensemble de la sécurité

Threat model for local use, the LAN, the web access and the phone app; permissions, secrets and privacy.Modèle de menaces pour l'usage local, le réseau local, l'accès web et l'application téléphone ; permissions, secrets et vie privée.

claude-cluster drives agents that run commands with your rights, so its security is about who can talk to the core and what a manipulated model can do. The detailed findings of the code audit are in the security audit.

claude-cluster pilote des agents qui exécutent des commandes avec vos droits, donc sa sécurité tient à qui peut parler au cœur et à ce qu'un modèle manipulé peut faire. Les constats détaillés de l'audit du code sont dans l'audit de sécurité.

1. Who can reach whatQui peut atteindre quoi

ActorReachesTrust
you, at the keyboardeverythingfull
any program running as youthe control socket and your config / data foldersthe same as your account
a device on your LANthe https page; nothing else until the code and your approvalnone, then approved
a device from outside (Tailscale, router)the same, https only, approval always askedsame
the global session (a model)the MCP tools, bounded by protected settingslow: it obeys text it reads
a sub-sessionits own small MCPdepends on its permission mode

The design assumes that the models can be manipulated by text they read (a web page, a file, a reply): the guards are meant to bound what that text can make them do.

ActeurAtteintConfiance
vous, au claviertouttotale
tout programme exécuté par vousle socket de contrôle et vos dossiers de config / donnéescelle de votre compte
un appareil de votre réseau localla page https ; rien d'autre avant le code et votre accordaucune, puis approuvé
un appareil de l'extérieur (Tailscale, routeur)pareil, https seulement, accord toujours demandépareil
la session globale (un modèle)les outils MCP, bornés par les réglages protégésfaible : elle obéit au texte qu'elle lit
une sous-sessionson propre petit MCPselon son mode de permission

La conception suppose que les modèles peuvent être manipulés par le texte qu'ils lisent (une page web, un fichier, une réponse) : les garde-fous servent à borner ce que ce texte peut leur faire faire.

2. Local useUsage local

Everything goes through a unix socket in your runtime folder (0700, the socket 0600): only your user (and root) reaches it. Any program running as you, a script or an agent in bypassPermissions, may drive claude-cluster through it: the same trust as your account. API keys live in the keyring (secret-tool) or in credentials.json (0600), never in config.toml, logs or transcripts; the agents of the sessions receive them on a pipe, not on their command line. The config and data folders are 0700. Programs run with your rights (commands.*, editor, viewer, voice commands) are confirmed before they change.

Tout passe par un socket unix de votre dossier d'exécution (0700, le socket en 0600) : seul votre utilisateur (et root) l'atteint. Tout programme exécuté par vous, un script ou un agent en bypassPermissions, peut piloter claude-cluster par lui : la même confiance que votre compte. Les clés d'API vivent dans le trousseau (secret-tool) ou dans credentials.json (0600), jamais dans config.toml, les journaux ou les transcriptions ; les agents des sessions les reçoivent sur un tube, pas sur leur ligne de commande. Les dossiers de config et de données sont en 0700. Les programmes lancés avec vos droits (commands.*, éditeur, visionneuse, commandes de voix) sont confirmés avant de changer.

3. Web accessAccès web

  • https by default with an authority of your own computer (key 0600), TLS 1.2 or newer; a plain request is redirected.
  • Two factors per device: the 6-digit code (new at each opening; a wrong code is answered 1 s later, 5 wrong ones block the address 15 minutes and rotate the code) and your approval on the computer. A trusted device (its own 32-byte secret) comes back by itself.
  • Cookies are HttpOnly, SameSite=Strict and Secure, and the session is bound to the address of the device.
  • Scope: only private addresses of a subnet of your computer, the tailnet range, or (with remote = router) any address over https; the Host is checked (no DNS rebinding) and a POST needs the right Origin.
  • Found by the app ([web] discovery, on by default): while the access is open, the core answers a broadcast on UDP 8789 from a private address of a subnet of the computer only, once per address every 0.5 s, with its name, its port, https, the fingerprint of its authority and its version - never the code; the app connects only to the authority it pinned. Turn it off to stay silent on the network.
  • The page: a per-response CSP nonce, X-Frame-Options: DENY, nosniff, HSTS; everything shown is escaped; attachments are sandboxed; a file an agent wrote opens as text when it is HTML, SVG or XML, never as a page of your origin; the routes taking JSON refuse any other type, which is all a plain form can send. 8 connections per address and 64 at once at most.
  • What a device can do: everything the keyboard can, except a shell (!command, :r, a task or a schedule that runs a command, whatever the shape of the prompt or of its fields) and the settings you did not open to it ([web] settings, :set too); a file it writes is a .md / .txt out of the hidden folders. On the terminal page too, with the shell off: no editor by Ctrl+E (an editor is a shell), no viewer, no file manager, no clipboard of the computer (its own), and the code, the approvals and the bans stay on the computer. A trusted phone lost or unlocked is your claude-cluster: Web devices > trust no more / ban, and keep the shell off unless you need it.
  • From outside: tailscale opens nothing to the Internet; router makes the login page reachable by anyone, so the code, your approval and the bans are what stand. The code, the conversation and the cookies are encrypted end to end and the key never leaves your computer.

The shell switch ([web] shell) does not by itself stop an approved device from asking an agent to run a command: treat every approved device as a person with your keyboard. See the audit, findings F7 and F8.

  • https par défaut avec une autorité propre à votre ordinateur (clé 0600), TLS 1.2 ou plus ; une requête en clair est redirigée.
  • Deux facteurs par appareil : le code à 6 chiffres (nouveau à chaque ouverture ; un mauvais code est répondu 1 s plus tard, 5 mauvais bloquent l'adresse 15 minutes et changent le code) et votre accord sur l'ordinateur. Un appareil de confiance (son propre secret de 32 octets) revient seul.
  • Les cookies sont HttpOnly, SameSite=Strict et Secure, et la session est liée à l'adresse de l'appareil.
  • Portée : seulement les adresses privées d'un sous-réseau de votre ordinateur, la plage du tailnet, ou (avec remote = router) toute adresse en https ; le Host est vérifié (pas de DNS rebinding) et un POST exige le bon Origin.
  • Trouvé par l'app ([web] discovery, activé par défaut) : tant que l'accès est ouvert, le cœur répond à une diffusion sur l'UDP 8789 venant d'une adresse privée d'un sous-réseau de l'ordinateur uniquement, une fois par adresse toutes les 0,5 s, avec son nom, son port, https, l'empreinte de son autorité et sa version - jamais le code ; l'app ne se connecte qu'à l'autorité qu'elle a épinglée. Désactivez-le pour rester muet sur le réseau.
  • La page : un nonce CSP par réponse, X-Frame-Options: DENY, nosniff, HSTS ; tout ce qui est affiché est échappé ; les pièces jointes sont isolées ; un fichier écrit par un agent s'ouvre comme du texte quand il est HTML, SVG ou XML, jamais comme une page de votre origine ; les routes qui prennent du JSON refusent tout autre type, le seul qu'un simple formulaire puisse envoyer. 8 connexions par adresse et 64 en même temps au plus.
  • Ce qu'un appareil peut faire : tout ce que fait le clavier, sauf un shell (sur la page terminal aussi, shell coupé : aucun éditeur par Ctrl+E, un éditeur étant un shell, aucune visionneuse ni gestionnaire de fichiers, le presse-papiers de l'appareil et non celui de l'ordinateur ; le code, les approbations et les bannissements restent sur l'ordinateur) (!commande, :r, une tâche ou une planification qui lance une commande, quelle que soit la forme du prompt) et les réglages que vous ne lui avez pas ouverts ([web] settings, :set aussi) ; un fichier qu'il écrit est un .md / .txt hors des dossiers cachés. Un téléphone de confiance perdu ou déverrouillé, c'est votre claude-cluster : Web devices > trust no more / ban, et gardez le shell coupé sauf besoin.
  • De l'extérieur : tailscale n'ouvre rien à Internet ; router rend la page de connexion joignable par n'importe qui, donc le code, votre accord et les bannissements sont ce qui tient. Le code, la conversation et les cookies sont chiffrés de bout en bout et la clé ne quitte jamais votre ordinateur.

L'interrupteur du shell ([web] shell) n'empêche pas à lui seul un appareil approuvé de demander à un agent d'exécuter une commande : traitez chaque appareil approuvé comme une personne devant votre clavier. Voir l'audit, constats F7 et F8.

4. The global session and its toolsLa session globale et ses outils

The global session runs in bypassPermissions by default, so it obeys what reaches it with your rights: that is the point of an orchestrator and its risk, because a prompt injected in a sub-session returns to it as a reply. Its MCP tools run without a prompt, so what they may do is bounded:

  • the protected settings are never changed by it (settings_set and config_write refuse them: it asks you): the web opened wider, the permissions of the agents, the programs run as you, the MCP servers and tools, the limits and the model policy, the plugin sources, the files of the voice (their path is a file it could then read and write), and the switches rewrite_*;
  • it writes only .md / .txt files outside hidden folders (export, /export), never gives a hidden file (~/.ssh, ~/.config, claude-cluster's folders, /proc, /dev) to a session as a context, a display or a preview (a link to one is one), and rewrites the system prompts only when you allowed it; the ! and : commands of a prompt and /update are yours;
  • the voice keys and the palette actions (log in / out, quit everything, start over) are the user's: never run by its tools nor by the web page.

These limits bound the tools of the global session, not the session process itself, which has its own shell and file tools in bypassPermissions.

Fixed since the first audit: the switches global_answers, global_fork, global_edit, the attachments and the rights of the sub-sessions are protected (F2), the hidden-file rule covers every path of a display (F3), heavy_run of a sub-session needs [orchestrator] sub_add (F1).

Input that cannot take the core down. JSON from outside (a request, a line of an agent, a file) is nested at most 512 levels: its copies and dumps recurse, a line of 200 000 [ used to end the core. A regex from outside (:s, a command trigger of a task) has 512 characters and 64 levels at most, and its search a budget. A question or a display of an agent is drawn bounded whatever its shape and its size, the settings are published as a new version instead of being rewritten under the threads reading them, and a state written by anything else loses that item, never the core. The numbers of a display can be anything (1e308, [1e300, -1e300, 1]): an index never leaves its table, a bar never grows without end. An exception in a thread, a frame of the terminal or a handler of the window is told in the log and ends that thread or that frame only. A paste is never keys: a letter of a text no longer allows a device or quits. A big body is read for a device really connected only (its cookies checked before the body).

La session globale tourne en bypassPermissions par défaut, donc elle obéit à ce qui lui parvient avec vos droits : c'est le but d'un orchestrateur et son risque, car un prompt injecté dans une sous-session lui revient comme réponse. Ses outils MCP s'exécutent sans demande, donc ce qu'ils peuvent faire est borné :

  • les réglages protégés ne sont jamais changés par elle (settings_set et config_write les refusent : elle vous demande) : le web ouvert plus largement, les permissions des agents, les programmes lancés comme vous, les serveurs et outils MCP, les limites et la politique de modèles, les sources de plugins, les fichiers de la voix (leur chemin est un fichier qu'elle pourrait alors lire et écrire), et les interrupteurs rewrite_* ;
  • elle n'écrit que des fichiers .md / .txt hors des dossiers cachés (export, /export), ne donne jamais un fichier caché (~/.ssh, ~/.config, les dossiers de claude-cluster, /proc, /dev) à une session comme contexte, affichage ou aperçu (un lien vers lui compte pareil), et ne réécrit les prompts système que si vous l'avez permis ; les commandes ! et : d'un prompt et /update sont les vôtres ;
  • les touches de voix et les actions de palette (connexion / déconnexion, tout quitter, recommencer) sont à l'utilisateur : jamais lancées par ses outils ni par la page web.

Ces limites bornent les outils de la session globale, pas le processus de la session lui-même, qui a son propre shell et ses outils de fichiers en bypassPermissions.

Corrigé depuis le premier audit : les interrupteurs global_answers, global_fork, global_edit, les pièces jointes et les droits des sous-sessions sont protégés (F2), la règle des fichiers cachés couvre tous les chemins d'un affichage (F3), heavy_run d'une sous-session demande [orchestrator] sub_add (F1).

Des entrées qui ne peuvent pas faire tomber le cœur. Une regex venue de dehors (:s, une condition de commande d'une tâche) fait 512 caractères et 64 niveaux au plus, et sa recherche a un budget. Une question ou un affichage d'un agent est dessiné borné quels que soient sa forme et sa taille, les réglages sont publiés comme une nouvelle version au lieu d'être réécrits sous les threads qui les lisent, et un état écrit par autre chose perd cet élément, jamais le cœur. Le JSON venu de dehors (une requête, une ligne d'un agent, un fichier) est imbriqué sur 512 niveaux au plus : ses copies et ses sérialisations sont récursives, une ligne de 200 000 [ terminait le cœur. Les nombres d'un affichage peuvent être n'importe quoi (1e308, [1e300, -1e300, 1]) : un indice ne sort jamais de sa table, une barre ne grandit jamais sans fin. Une exception dans un thread, une image du terminal ou un gestionnaire de la fenêtre est signalée au journal et ne termine que ce thread ou cette image. Un collage n'est jamais des touches : une lettre d'un texte n'autorise plus un appareil et ne quitte plus. Un gros corps de requête n'est lu que pour un appareil vraiment connecté (ses cookies vérifiés avant le corps).

5. SecretsSecrets

API keys: keyring or 0600 file, given to agents on a pipe. The token of Claude Code is read only to ask the usage endpoint of claude.ai, passed by a header file readable by you alone, removed at once, never logged. The Android app pins the authority of your computer the first time (its fingerprint shown), its updates come from the computer and keep its signing key. /ca.crt, /app.apk, /api/version and /docs are served to anyone who reaches the page: nothing secret is in them.

Clés d'API : trousseau ou fichier 0600, données aux agents sur un tube. Le jeton de Claude Code n'est lu que pour interroger le point d'accès d'usage de claude.ai, passé par un fichier d'en-têtes lisible par vous seul, supprimé aussitôt, jamais journalisé. L'application Android épingle l'autorité de votre ordinateur la première fois (son empreinte affichée), ses mises à jour viennent de l'ordinateur et gardent sa clé de signature. /ca.crt, /app.apk, /api/version et /docs sont servis à quiconque atteint la page : rien de secret dedans.

6. Privacy and the GDPRVie privée et RGPD

Everything stays on your computer: conversations, the prompt history (in clear, in your data folder), attachments, keys, the map of your computer. There is no server run by the project, no telemetry and no account. The GDPR does not apply to claude-cluster itself since no personal data is collected or processed by the project: data stays local. It still applies to what you choose to send to a provider: the map of your computer (machine.md), the prompts and the files a session sends are read by the API provider you connected.

Tout reste sur votre ordinateur : conversations, historique des prompts (en clair, dans votre dossier de données), pièces jointes, clés, carte de votre ordinateur. Il n'y a aucun serveur du projet, aucune télémétrie et aucun compte. Le RGPD ne s'applique pas à claude-cluster lui-même puisque le projet ne collecte ni ne traite de données personnelles : les données restent locales. Il s'applique toujours à ce que vous choisissez d'envoyer à un fournisseur : la carte de votre ordinateur (machine.md), les prompts et les fichiers qu'une session envoie sont lus par le fournisseur d'API que vous avez connecté.

7. Reporting a problemSignaler un problème

Open an issue on the repository with the version and commit shown at the bottom of this page. For a vulnerability, do not publish the details before the author had time to fix it.

Ouvrez un ticket sur le dépôt avec la version et le commit affichés en bas de cette page. Pour une vulnérabilité, ne publiez pas les détails avant que l'auteur ait eu le temps de corriger.