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-clusterIn 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-clusterDans 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
| Way | Effect |
|---|---|
Ctrl+T, /new <folder>, palette New session on a project | a 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çon | Effet |
|---|---|
Ctrl+T, /new <dossier>, palette New session on a project | une 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+Wor/closecloses a session to the trash (restorable for[sessions] trash_days, 14 by default):Ctrl+Shift+T/Alt+Treopens one;/deleteremoves it for good after a question.Ctrl+Qquits. A session still working asks whether to keep it running in the background or stop everything.claude-cluster serveruns 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 messagesNext: the interfaces and the keys.
Ctrl+Wou/closeferme une session vers la corbeille (restaurable[sessions] trash_daysjours, 14 par défaut) :Ctrl+Shift+T/Alt+Ten rouvre une ;/deletela supprime pour de bon après une question.Ctrl+Qquitte. Une session encore au travail demande s'il faut la laisser tourner en arrière-plan ou tout arrêter.claude-cluster servelance 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 messagesEnsuite : les interfaces et les touches.