Déploiement et astuces oh-my-claudecode : 32 Agents professionnels travaillent pour vous, efficacité doublée

Difficulté: Intermédiaire | Durée: 30 minutes | Bénéfices: Maîtriser l'orchestration multi-agents, déploiement sans configuration, mise en place de pipelines d'équipe

Public cible: Développeurs utilisant ou prévoyant d'utiliser Claude Code, équipes souhaitant améliorer l'efficacité de la collaboration entre agents.

Dépendances clés: Node.js ≥18, tmux (optionnel pour le multiplateforme), Claude Code CLI

---

1. Présentation du projet

Claude Code est déjà puissant en soi, mais un seul agent est souvent insuffisant face à des projets complexes multi-modules — vous devez sans cesse basculer entre plusieurs fenêtres de discussion ou coordonner manuellement la révision du code, la conception de l'architecture et la validation des tests.

oh-my-claudecode (ci-après dénommé OMC) est conçu pour résoudre ce problème. Il s'agit d'une couche d'orchestration multi-agents pour Claude Code, dont le concept central est :

N'apprenez pas Claude Code. Utilisez simplement OMC.

En résumé, il vous suffit de décrire ce que vous voulez en langage naturel, et OMC planifiera automatiquement 32 agents spécialisés, choisira les modèles appropriés (Haiku / Sonnet / Opus) et traitera les tâches en parallèle jusqu'à ce que la validation soit réussie. Le processus complet se fait sans configuration, sans avoir à mémoriser de commandes.

Adresse du projet: https://github.com/Yeachan-Heo/oh-my-claudecode

---

2. Aperçu des fonctionnalités clés

2.1 Prêt à l'emploi sans configuration

Aucune configuration YAML ou JSON à écrire. Une fois installé, il suffit de parler normalement pour le faire fonctionner. Les valeurs par défaut intelligentes couvrent 90 % des scénarios.

2.2 32 Agents spécialisés

Chaque agent possède un champ de responsabilité défini. OMC oriente automatiquement la tâche vers l'agent le plus approprié selon son type :

La liste complète est définie dans AGENTS.md.

2.3 Routage intelligent des modèles

OMC sélectionne automatiquement le modèle en fonction de la complexité de la tâche :

• Haiku: Recherches simples, formatage, légères modifications de texte.
• Sonnet: Implémentation standard, débogage, tests (le moteur principal au quotidien).
• Opus: Conception d'architecture, revues de sécurité, refactorisations complexes.

L'avantage est une optimisation des coûts ; les retours de la communauté indiquent une économie moyenne de 30 à 50 % de la consommation de tokens.

2.4 Parallélisation automatique

Les tâches indépendantes sont automatiquement distribuées à différents agents pour une exécution parallèle, sans décomposition manuelle de votre part.

2.5 Exécution persistante (boucle verify/fix)

En mode Ralph, une fois la tâche terminée, l'agent entre automatiquement dans une boucle de validation — si la validation échoue, il se corrige lui-même et relance l'exécution jusqu'à ce que le test passe réellement.

2.6 Auto-apprentissage des compétences (système Learner)

Les expériences de débogage rencontrées lors de l'exécution sont automatiquement extraites sous forme de fichiers Skill réutilisables dans .omc/skills/. Lors d'un problème similaire futur, le contexte est injecté automatiquement — plus besoin de s'en souvenir manuellement.

2.7 Intégration OpenClaw

Prend en charge le transfert des événements de session Claude Code vers la passerelle OpenClaw Gateway pour des notifications automatisées et des déclenchements à distance via Telegram / Discord, etc.

---

3. Structure complète du projet

oh-my-claudecode/
├── agents/              # Fichiers de définition des 32 agents
├── bridge/              # Ponts OpenClaw / tiers
├── docs/                # Documentation archi, guides de migration, monitoring
├── examples/            # Exemples de workflows
├── hooks/               # Injection de hooks Claude Code
├── missions/            # Définitions des missions
├── research/            # Module de recherche
├── scripts/             # Scripts utilitaires (Démo Gateway OpenClaw, etc.)
├── skills/              # Fichiers Skill intégrés à OMC
├── src/                 # Code source principal
├── tests/               # Suite de tests
├── CLAUDE.md            # Config runtime principale (injectée par OMC à Claude Code)
├── AGENTS.md            # Répertoire et descriptions des agents
└── package.json

Pour l'utilisateur standard, les dossiers les plus consultés sont :

• skills/ — Fichiers Skill personnalisés
• .omc/ — Sessions, états et fichiers de planification générés au runtime

---

4. Installation et Configuration

4.1 Prérequis

Installation obligatoire :

• Claude Code CLI — Nécessite un abonnement Max/Pro ou une clé API Anthropic
• Node.js ≥18 — OMC est un projet TypeScript/npm

Optionnel mais fortement recommandé :

• tmux — Le mode omc team et la récupération automatique des limites de taux dépendent de tmux

Installation de tmux par plateforme :

# macOS
brew install tmux

# Ubuntu / Debian
sudo apt install tmux

# Arch
sudo pacman -S tmux

# Windows Natif (recommandé)
winget install psmux

# Windows WSL2
sudo apt install tmux

4.2 Installation d'OMC (deux méthodes)

Méthode 1 : Installation via Marketplace (recommandé)

# Ajouter la source du plugin
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode

# Installer le plugin
/plugin install oh-my-claudecode

Méthode 2 : Installation globale via npm

npm i -g oh-my-claude-sisyphus@latest

Une fois l'installation terminée, OMC s'active automatiquement ; toutes les commandes / et les mots-clés magiques sont prêts à l'emploi.

4.3 Initialisation de la configuration

# Exécuter dans n'importe quel répertoire
/setup
/omc-setup

Le premier lancement vous guidera pour :

• Confirmer le répertoire de configuration de Claude Code
• Configurer OpenClaw Gateway (optionnel)
• Détecter les sessions tmux

En cas d'anomalie, lancez l'outil de diagnostic :

/omc-doctor

4.4 Activer le Mode Team (recommandé)

Le mode Team est le mode d'orchestration par défaut depuis OMC v4.1.7. Il nécessite d'activer les fonctionnalités expérimentales dans la configuration de Claude Code :

# Modifier ~/.claude/settings.json

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

---

5. Analyse approfondie des modes d'exécution

OMC propose plusieurs modes d'exécution adaptés à différents scénarios. Comprendre leurs différences est la clé d'une utilisation efficace.

5.1 Mode Team (Recommandé) ⭐

Usage: Tâches complexes multi-modules nécessitant la collaboration entre architecture, codage, révision et tests.

Le mode Team fonctionne sur un pipeline strict :

team-plan → team-prd → team-exec → team-verify → team-fix (boucle)

La tâche commence par la planification, passe par la conception produit, l'exécution du code, la vérification, et revient à l'exécution si des problèmes sont détectés lors de la phase de correction (fix). Le processus est coordonné automatiquement par OMC.

Utilisation de base :

/team 3:executor "Corriger toutes les erreurs de compilation TypeScript"

Le chiffre 3 indique l'utilisation de 3 agents exécuteurs en parallèle.

Workers tmux version CLI (v4.4.0+) :

omc team 2:codex "Réviser la sécurité du module auth"
omc team 2:gemini "Redessiner l'accessibilité des composants UI"
omc team 1:claude "Implémenter le flux de paiement"
omc team status auth-review
omc team shutdown auth-review

Ce sont de véritables processus tmux indépendants qui s'arrêtent automatiquement une fois terminés, sans consommer de ressources inutilement.

5.2 Autopilot

Usage: Besoins clairs, réalisation d'une fonctionnalité de bout en bout sans intervention humaine excessive.

autopilot: build a REST API for managing tasks

En mode Autopilot, un seul Agent Lead est responsable de tout le cycle, de la conception à l'implémentation, sans dépendre d'un pipeline.

5.3 Ralph (Mode persistant)

Usage: La tâche doit être impérativement terminée, sans possibilité de "sortie en cours de route".

Le mode Ralph inclut les capacités de parallélisation d'Ultrawork et ajoute une boucle verify/fix :

executor → verify → fix → verify (jusqu'au succès)

ralph: refactoriser le module auth, tous les tests doivent passer

Si vous trouvez que Claude Code quitte souvent alors que le travail "semble fini" mais n'est pas validé, Ralph est la solution.

5.4 Ultrawork (Parallélisme maximal)

Usage: Corrections/refactorisations massives nécessitant une vitesse maximale.

ulw corriger toutes les erreurs ESLint
ulw renommer tous les composants en PascalCase

Toutes les corrections s'exécutent en parallèle sans attendre la fin de la précédente, idéal pour le traitement par lots d'une liste de problèmes connus.

5.5 /ccg Conseiller tri-modèles

Usage: Obtenir simultanément les perspectives de Codex et Gemini, puis laisser Claude faire la synthèse.

/ccg Review this PR — architecture (Codex) and UI components (Gemini)

Il appelle /ask codex + /ask gemini, et Claude se charge de la synthèse finale. Parfait pour les revues croisées backend+frontend.

5.6 Tableau comparatif des modes

---

6. Démonstrations pratiques

6.1 Scénario 1 : Construire une API REST (Mode Team)

Supposons que nous voulions construire une API REST de gestion de tâches :

/team 2:executor "Implémenter une API REST de gestion de tâches, incluant le CRUD, avec Express + TypeScript"

OMC décomposera automatiquement la tâche :

1. architect conçoit la structure de l'API et le modèle de données
2. executor implémente les interfaces en parallèle
3. test-engineer écrit les tests d'intégration
4. code-reviewer révise le code
5. verifier exécute les tests de validation

Vous n'avez qu'à attendre le résultat final.

6.2 Scénario 2 : Correction automatique de toutes les erreurs (Ultrawork)

ulw corriger toutes les erreurs de type TypeScript et les avertissements ESLint

Idéal pour le nettoyage rapide lors de l'intégration dans un pipeline CI/CD ou la reprise d'un vieux projet.

6.3 Scénario 3 : Besoins flous (Deep Interview)

Si vous n'êtes pas sûr de ce que vous voulez faire :

/deep-interview "Je veux créer un système de blog personnel"

Deep Interview utilisera une méthode socratique pour clarifier vos besoins : public cible, stack technique, besoin d'un CMS, exigences SEO... Précisez tout avant de commencer pour éviter de tout refaire à mi-chemin.

6.4 Scénario 4 : Revue croisée multi-modèles (/ccg)

/ccg réviser l'architecture backend de cette PR avec Codex et les composants UI avec Gemini

6.5 Scénario 5 : Récupération automatique de la limite de taux

Lorsque l'API Claude déclenche une limite de taux (rate limit) :

omc wait          # Voir l'état actuel et les instructions de récupération
omc wait --start  # Lancer le démon de récupération automatique
omc wait --stop   # Arrêter le démon

---

7. Dépannage des problèmes courants

Q1: La commande /team ne fonctionne pas, erreur "Team Mode non activé"

Cause: La variable d'environnement CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS n'est pas définie.

Solution:

# Modifier ~/.claude/settings.json, ajouter :
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Redémarrez la session Claude Code pour appliquer les changements.

---

Q2: omc team affiche une erreur liée à tmux

Cause: Utilisateur Windows sans tmux installé, ou tmux absent du PATH.

Solution:

# Windows natif
winget install psmux

# macOS
brew install tmux

# Vérifier l'installation
tmux -V

Si déjà installé, vérifiez que le répertoire bin de psmux est dans le PATH système.

---

Q3: Les commandes OMC ne fonctionnent pas après l'installation via Marketplace

Cause: Le cache du plugin n'est pas rafraîchi ou le chemin d'installation est incorrect.

Solution:

# Mettre à jour le clone du marketplace
/plugin marketplace update omc

# Réinitialiser
/setup

# Exécuter le diagnostic
/omc-doctor

---

Q4: Claude Code signale une limite de taux mais la récupération automatique ne démarre pas

Cause: omc wait --start n'a pas été exécuté, ou n'est pas lancé dans une session tmux.

Solution:

# S'assurer d'être dans une session tmux
tmux new -s omc-watch
omc wait --start

Le démon tournera en arrière-plan dans tmux et reprendra automatiquement la session Claude Code une fois la limite levée.

---

Q5: Comportement anormal après la mise à jour d'OMC

Cause: Incompatibilité entre le cache de l'ancienne version et le code de la nouvelle.

Solution:

# Si installation Marketplace :
/plugin marketplace update omc
/setup

# Si installation npm :
npm i -g oh-my-claude-sisyphus@latest
/omc-doctor

---

Q6: Les fichiers Skill ne sont pas injectés automatiquement

Cause: Les mots-clés (triggers) ne correspondent pas ou le chemin du fichier est erroné.

Solution:

Les fichiers Skill sont placés à deux endroits avec des priorités différentes :

# Niveau projet (priorité haute) : .omc/skills/
# Niveau utilisateur (priorité basse) : ~/.omc/skills/

Assurez-vous que le tableau triggers dans le frontmatter du fichier Skill contient les mots-clés présents dans la discussion :

---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]  # Correspondance par mots-clés
source: extracted
---

---

8. Lecture complémentaire / Aller plus loin

8.1 Écriture de Skills personnalisés

OMC permet d'extraire des Skills réutilisables à partir d'expériences de débogage réelles :

/learner

Cela génère un fichier YAML dans .omc/skills/. Il sera injecté automatiquement lors d'un problème similaire.

8.2 Intégration OpenClaw

OMC peut transférer les événements de session vers OpenClaw Gateway pour des notifications à distance :

# Guide de configuration automatique
/oh-my-claudecode:configure-notifications
# → Choisir "OpenClaw Gateway"

Configuration manuelle dans ~/.claude/omc_config.openclaw.json :

{
  "enabled": true,
  "gateways": {
    "my-gateway": {
      "url": "https://votre-gateway.exemple.com/wake",
      "headers": { "Authorization": "Bearer VOTRE_TOKEN" },
      "method": "POST",
      "timeout": 10000
    }
  },
  "hooks": {
    "session-start": { "gateway": "my-gateway", "instruction": "Session démarrée pour {{projectName}}", "enabled": true },
    "stop":          { "gateway": "my-gateway", "instruction": "Session arrêtée pour {{projectName}}", "enabled": true }
  }
}

Les événements supportés incluent : session-start, stop, keyword-detector, ask-user-question, pre-tool-use, post-tool-use.

8.3 Système de notification (Telegram / Discord / Slack)

omc config-stop-callback telegram --enable --token <bot_token> --chat <chat_id> --tag-list "@alice,bob"
omc config-stop-callback discord --enable --webhook <url> --tag-list "@here,123456789012345678"

Un résumé est automatiquement poussé vers le groupe à la fin de la session, avec support des tags incrémentaux.

8.4 Workflow collaboratif OpenClaw + OMC

En combinant l'automatisation d'OpenClaw et l'orchestration multi-agents d'OMC, vous pouvez réaliser :

• OpenClaw écoute Discord/Telegram et déclenche une session Claude Code
• OMC orchestre 32 agents dans Claude Code pour accomplir des tâches complexes
• OpenClaw Gateway renvoie le résultat sur le canal de discussion

Vous disposez ainsi d'un assistant multi-agents en ligne 24h/24, pilotable via vos outils de messagerie habituels.

Consultez scripts/openclaw-gateway-demo.mjs pour apprendre à monter cette architecture.

8.5 Surveillance des performances et débogage

OMC génère plusieurs types de fichiers dans .omc/ au runtime :

.omc/sessions/*.json        # Résumés de sessions
.omc/state/agent-replay-*.jsonl  # Journaux de relecture d'exécution
.omc/plans/                 # Plans de tâches
.omc/research/              # Sorties de recherche

Lancez le HUD pour voir l'état de l'orchestration en temps réel :

/oh-my-claudecode:hud setup
omc hud

---

Liens de référence

• Page du projet: https://github.com/Yeachan-Heo/oh-my-claudecode
• Paquet npm: https://www.npmjs.com/package/oh-my-claude-sisyphus
• Documentation complète: https://yeachan-heo.github.io/oh-my-claudecode-website
• Référence CLI: https://yeachan-heo.github.io/oh-my-claudecode-website/docs.html#cli-reference
• Communauté Discord: https://discord.gg/PUwSMR9XNk