claude-cluster docs1.10.1
User guideGuide utilisateur

First start and first sessionPremier démarrage et première session

Start claude-cluster, answer the first questions, talk to the global session, open a session on a project.Lancer claude-cluster, répondre aux premières questions, parler à la session globale, ouvrir une session sur un projet.

1. First startPremier démarrage

claude-cluster

In a terminal this opens the terminal interface, otherwise the window (--tty / --gui force one). At the first start two questions are asked:

  • Restore the previous run? ([ui] restore: ask, always, never). Esc restores.
  • Map this computer? The map (machine.md) is what the global session reads to know your projects, tools and shell: your OS and hardware, installed tools, the dangerous shell aliases, your git repositories. It is local, shown before it is read, and proposed again when older than [ui] machine_days (30). Answering no is remembered.

The interface shows the list of sessions on the left, the conversation in the middle and optional panels (tokens, context, cost, git...) on the right. F1 lists every key, Ctrl+K opens the command palette, F9 the settings.

claude-cluster

Dans un terminal cela ouvre l'interface terminal, sinon la fenêtre (--tty / --gui en imposent une). Au premier démarrage deux questions sont posées :

  • Restaurer l'exécution précédente ? ([ui] restore : ask, always, never). Échap restaure.
  • Cartographier cet ordinateur ? La carte (machine.md) est ce que la session globale lit pour connaître vos projets, outils et shell : votre système et matériel, les outils installés, les alias de shell dangereux, vos dépôts git. Elle est locale, montrée avant d'être lue, et reproposée quand elle a plus de [ui] machine_days (30) jours. Répondre non est mémorisé.

L'interface montre la liste des sessions à gauche, la conversation au milieu et des panneaux optionnels (tokens, contexte, coût, git...) à droite. F1 liste toutes les touches, Ctrl+K ouvre la palette de commandes, F9 les réglages.

2. Talk to the global sessionParler à la session globale

The first session is the global session (Ctrl+G). It is a Claude Code session that drives all the others through its own tools: ask it in plain words, or by voice.

Open a session on the libutils project and ask it to run its tests.

It looks the project up in the map of your computer, spawns a sub-session in that folder, sends the prompt, and tells you the answer when the sub-session is done (no polling). See The global session.

La première session est la session globale (Ctrl+G). C'est une session Claude Code qui pilote toutes les autres avec ses propres outils : demandez-lui en langage courant, ou à la voix.

Ouvre une session sur le projet libutils et demande-lui de lancer ses tests.

Elle retrouve le projet dans la carte de votre ordinateur, crée une sous-session dans ce dossier, envoie le prompt, et vous donne la réponse quand la sous-session a fini (sans interrogation). Voir La session globale.

3. Open a session yourselfOuvrir une session soi-même

WayEffect
Ctrl+T, /new <folder>, palette New session on a projecta new session in a folder or a project of the map (the closest name wins, typos tolerated)
claude-cluster spawn <folder> --name x --prompt "..."the same from a shell, on the running instance
/cd <folder>move the current session to another project

Then type in the prompt and press Enter. While a turn runs your next prompts are queued under the transcript; Esc takes the last one back.

FaçonEffet
Ctrl+T, /new <dossier>, palette New session on a projectune nouvelle session dans un dossier ou un projet de la carte (le nom le plus proche gagne, fautes de frappe tolérées)
claude-cluster spawn <dossier> --name x --prompt "..."pareil depuis un shell, sur l'instance en cours
/cd <dossier>déplacer la session courante vers un autre projet

Tapez ensuite dans le prompt et appuyez sur Entrée. Pendant qu'un tour tourne, vos prompts suivants sont mis en file sous la transcription ; Échap reprend le dernier.

4. PermissionsPermissions

A new session starts in auto mode: the classifier of Claude Code allows the safe actions. When something needs your answer a popup appears on the session, a notification says so, and you answer with Alt+Y (allow), Alt+A (always allow) or Alt+D (deny). Shift+Tab cycles the mode. See Permissions and models.

Une nouvelle session démarre en mode auto : le classificateur de Claude Code autorise les actions sûres. Quand quelque chose attend votre réponse, une fenêtre apparaît sur la session, une notification le dit, et vous répondez par Alt+Y (autoriser), Alt+A (toujours autoriser) ou Alt+D (refuser). Shift+Tab change de mode. Voir Permissions et modèles.

5. Close, restore, quitFermer, restaurer, quitter

  • Ctrl+W or /close closes a session to the trash (restorable for [sessions] trash_days, 14 by default): Ctrl+Shift+T / Alt+T reopens one; /delete removes it for good after a question.
  • Ctrl+Q quits. A session still working asks whether to keep it running in the background or stop everything.
  • claude-cluster serve runs the core with no interface; the commands below and the MCP server drive it.
claude-cluster list                      # the sessions and their state
claude-cluster send s2 "run the tests"   # a prompt to a session
claude-cluster status s2                 # details and the last messages

Next: the interfaces and the keys.

  • Ctrl+W ou /close ferme une session vers la corbeille (restaurable [sessions] trash_days jours, 14 par défaut) : Ctrl+Shift+T / Alt+T en rouvre une ; /delete la supprime pour de bon après une question.
  • Ctrl+Q quitte. Une session encore au travail demande s'il faut la laisser tourner en arrière-plan ou tout arrêter.
  • claude-cluster serve lance le cœur sans interface ; les commandes ci-dessous et le serveur MCP le pilotent.
claude-cluster list                      # les sessions et leur état
claude-cluster send s2 "lance les tests" # un prompt à une session
claude-cluster status s2                 # détails et derniers messages

Ensuite : les interfaces et les touches.