Installation, profils et raccourcis de Claude Squad. Voir aussi les avis sur Claude Squad.

Prérequis et installation

# Prérequis macOS
brew install tmux gh
gh auth status
 
# Installer Claude Squad
brew install claude-squad
ln -s "$(brew --prefix)/bin/claude-squad" "$(brew --prefix)/bin/cs"
 
# Alternative officielle
curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash
 
# Diagnostic
cs debug
cs version

Lancer

# Agent par défaut : claude
cs
 
# Codex
cs -p "codex"
 
# Gemini ou Aider
cs -p "gemini"
cs -p "aider --model ollama_chat/gemma3:1b"
 
# Auto-accept expérimental — VM/conteneur jetable uniquement
cs -y

Raccourcis TUI

ToucheAction
nNouvelle session.
NNouvelle session avec prompt.
DSupprimer la session sélectionnée.
↑/j, ↓/kNaviguer entre les sessions.
Entrée ou oAttacher la session.
Ctrl+QSe détacher et revenir à la liste.
TabBasculer aperçu terminal / diff.
sCommit et push de la branche.
cCheckout : commit puis pause.
rReprendre une session en pause.
?Aide.
qQuitter l’interface.

Profils

Le fichier se trouve généralement dans ~/.claude-squad/config.json ; confirmer avec cs debug.

{
  "default_program": "claude",
  "profiles": [
    { "name": "claude", "program": "claude" },
    { "name": "codex", "program": "codex" },
    { "name": "gemini", "program": "gemini" },
    { "name": "opencode", "program": "opencode" }
  ]
}

Utiliser ← et → dans l’écran de création pour changer de profil.

Préparer le dépôt

  • Partir d’un git status propre ou comprendre exactement les changements présents.
  • Installer les CLI d’agents et vérifier leur authentification avant de lancer cs.
  • Prévoir un script de préparation des worktrees pour .env, dépendances et ports.
  • Définir une tâche livrable et non chevauchante par session.

Routine sûre

  1. Créer la session avec un prompt contenant fichiers, critères et tests.
  2. Vérifier le diff avec Tab avant toute opération Git.
  3. Se rattacher avec o pour demander corrections et résumé.
  4. Lancer manuellement les tests critiques.
  5. Utiliser s seulement après revue.
  6. Supprimer les sessions fusionnées et exécuter git worktree prune si nécessaire.

Dépannage

ProblèmeAction
Session tmux en timeoutMettre à jour la CLI d’agent.
Variables absentesRelancer tmux après export ou utiliser un script de setup.
Prompt envoyé trop tôtAttendre le démarrage complet de la CLI avant l’injection.
État Git confusgit worktree list, git branch -vv, puis inspection manuelle.
WindowsPréférer WSL2 ou une machine Unix ; le support natif reste fragile.

Sources