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
| Actor | Reaches | Trust |
|---|---|---|
| you, at the keyboard | everything | full |
| any program running as you | the control socket and your config / data folders | the same as your account |
| a device on your LAN | the https page; nothing else until the code and your approval | none, then approved |
| a device from outside (Tailscale, router) | the same, https only, approval always asked | same |
| the global session (a model) | the MCP tools, bounded by protected settings | low: it obeys text it reads |
| a sub-session | its own small MCP | depends 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.
| Acteur | Atteint | Confiance |
|---|---|---|
| vous, au clavier | tout | totale |
| tout programme exécuté par vous | le socket de contrôle et vos dossiers de config / données | celle de votre compte |
| un appareil de votre réseau local | la page https ; rien d'autre avant le code et votre accord | aucune, 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és | faible : elle obéit au texte qu'elle lit |
| une sous-session | son propre petit MCP | selon 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=StrictandSecure, 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; theHostis checked (no DNS rebinding) and aPOSTneeds the rightOrigin. - 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,:settoo); a file it writes is a.md/.txtout of the hidden folders. On the terminal page too, with the shell off: no editor byCtrl+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:
tailscaleopens nothing to the Internet;routermakes 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=StrictetSecure, 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 ; leHostest vérifié (pas de DNS rebinding) et unPOSTexige le bonOrigin. - 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,:setaussi) ; un fichier qu'il écrit est un.md/.txthors 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 :
tailscalen'ouvre rien à Internet ;routerrend 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_setandconfig_writerefuse 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 switchesrewrite_*; - it writes only
.md/.txtfiles 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/updateare 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_setetconfig_writeles 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 interrupteursrewrite_*; - elle n'écrit que des fichiers
.md/.txthors 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/updatesont 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.