FAQFAQ
Short answers: data and privacy, agents and models, access from outside, platforms, and common questions.Réponses courtes : données et vie privée, agents et modèles, accès de l'extérieur, plateformes, questions courantes.
1. Data and privacyDonnées et vie privée
Does claude-cluster send my data anywhere? No telemetry. The only network traffic is what you start: your agents talk to their provider (Anthropic, OpenAI, Ollama on your machine...), the optional voice APIs (groq, deepgram, elevenlabs, cartesia) you configured, the usage endpoint of claude.ai read with your Claude Code token, and the web access you opened. This documentation is served by your own computer and uses no external resource.
Where are my conversations? On your computer, in the agent's own store and in ~/.local/share/claude-cluster/logs/. See Data formats.
What does the global session read? The map of your computer (machine.md) is read by it and therefore sent to its API provider; the prompt history keeps what you typed in clear in your data folder. See Security.
Is it GDPR compliant? The GDPR governs the processing of personal data by a controller. claude-cluster is software you run yourself: its data stays on your computer, there is no service of ours that receives it, so it does not apply to claude-cluster itself. It still applies to what you do with the providers you connect.
claude-cluster envoie-t-il mes données quelque part ? Aucune télémétrie. Le seul trafic réseau est ce que vous lancez : vos agents parlent à leur fournisseur (Anthropic, OpenAI, Ollama sur votre machine...), les API de voix optionnelles (groq, deepgram, elevenlabs, cartesia) que vous avez configurées, le point d'accès d'usage de claude.ai lu avec votre jeton Claude Code, et l'accès web que vous avez ouvert. Cette documentation est servie par votre propre ordinateur et n'utilise aucune ressource externe.
Où sont mes conversations ? Sur votre ordinateur, dans le stockage propre de l'agent et dans ~/.local/share/claude-cluster/logs/. Voir Formats de données.
Que lit la session globale ? La carte de votre ordinateur (machine.md) est lue par elle et donc envoyée à son fournisseur d'API ; l'historique des prompts garde en clair ce que vous avez tapé dans votre dossier de données. Voir Sécurité.
Est-ce conforme au RGPD ? Le RGPD encadre le traitement de données personnelles par un responsable de traitement. claude-cluster est un logiciel que vous exécutez vous-même : ses données restent sur votre ordinateur, aucun service de notre part ne les reçoit, donc il ne s'applique pas à claude-cluster lui-même. Il s'applique toujours à ce que vous faites avec les fournisseurs que vous connectez.
2. Agents and modelsAgents et modèles
Do I need Claude? No: Claude Code is the default and the complete driver, but Ollama (local), Anthropic-compatible endpoints, OpenAI-compatible ones (Qwen Code), opencode and the OpenAI Codex CLI work too. The global session needs a claude-driver provider.
Why does the global session run in bypassPermissions? It orchestrates: asking before each tool would defeat the purpose. The tools it holds are bounded and the protected settings are out of its reach; you can set [global] permission_mode = "auto" to have it ask. See Permissions.
How much does it cost? claude-cluster is free (MIT licence); the models cost what their provider charges. The Tokens, Cost and Usage panels and /usage show it, and [limits] caps it per day, week and month.
Ai-je besoin de Claude ? Non : Claude Code est le pilote par défaut et le complet, mais Ollama (local), les points d'accès compatibles Anthropic, ceux compatibles OpenAI (Qwen Code), opencode et le CLI OpenAI Codex fonctionnent aussi. La session globale a besoin d'un fournisseur du pilote claude.
Pourquoi la session globale tourne-t-elle en bypassPermissions ? Elle orchestre : demander avant chaque outil irait contre le but. Les outils qu'elle détient sont bornés et les réglages protégés sont hors de sa portée ; vous pouvez mettre [global] permission_mode = "auto" pour qu'elle demande. Voir Permissions.
Combien ça coûte ? claude-cluster est gratuit (licence MIT) ; les modèles coûtent ce que facture leur fournisseur. Les panneaux Tokens, Cost et Usage et /usage l'affichent, et [limits] le plafonne par jour, semaine et mois.
3. Using itUtilisation
Category or tag? One category per session (its primary label), several tags. Both live in the taxonomy.
How do I start over? Palette Start over: every sub-session goes to the trash, queued tasks stop and the global session gets a new conversation.
A session is stuck. Ctrl+C stops the turn, F4 or /retry asks again after an API error, /continue goes on after a stop. A session that exited is started again on its conversation.
Can two sessions share a folder? Yes; they are independent processes, so they can step on each other's files like two terminals would. Use a fork, a worktree or one session per folder.
Catégorie ou tag ? Une catégorie par session (son étiquette principale), plusieurs tags. Les deux vivent dans la taxonomie.
Comment repartir de zéro ? Palette Start over : toutes les sous-sessions vont à la corbeille, les tâches en file s'arrêtent et la session globale reçoit une nouvelle conversation.
Une session est bloquée. Ctrl+C arrête le tour, F4 ou /retry redemande après une erreur d'API, /continue reprend après un arrêt. Une session qui s'est arrêtée est relancée sur sa conversation.
Deux sessions peuvent-elles partager un dossier ? Oui ; ce sont des processus indépendants, donc elles peuvent se marcher sur les fichiers comme deux terminaux. Utilisez un fork, un worktree ou une session par dossier.
4. Access from outsideAccès de l'extérieur
Can I use it from my phone away from home? Yes: [web] remote = tailscale (recommended: nothing is opened to the Internet) or router. The Android app follows by itself. See Interfaces and Security.
Is there an iPhone app? No: the web page works in the iPhone browser, with the certificate steps shown on the login page.
Puis-je l'utiliser depuis mon téléphone loin de chez moi ? Oui : [web] remote = tailscale (recommandé : rien n'est ouvert à Internet) ou router. L'application Android suit toute seule. Voir Interfaces et Sécurité.
Y a-t-il une application iPhone ? Non : la page web fonctionne dans le navigateur de l'iPhone, avec les étapes du certificat sur la page de connexion.
5. PlatformsPlateformes
Which systems? Linux: Fedora and Debian / Ubuntu are documented. The window needs Qt6, the voice its local tools, the phone app the Android SDK at build time.
Where do I report a bug? On the repository, with the version and commit shown at the bottom of this page and, if useful, the debug trace ([debug] enabled = true).
Quels systèmes ? Linux : Fedora et Debian / Ubuntu sont documentés. La fenêtre demande Qt6, la voix ses outils locaux, l'application téléphone le SDK Android à la compilation.
Où signaler un bug ? Sur le dépôt, avec la version et le commit affichés en bas de cette page et, si utile, la trace de debug ([debug] enabled = true).