oh-my-claudecode/README.fr.md

English | 한국어 | 中文 | 日本語 | Español | Tiếng Việt | Português | Русский | Türkçe | Deutsch | Français | Italiano

oh-my-claudecode

Orchestration multi-agents pour Claude Code. Aucune courbe d'apprentissage.

N'apprenez pas Claude Code. Utilisez simplement OMC.

Démarrer • Documentation • Guide de migration • Discord

---

Démarrage rapide

Étape 1 : Installation

/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode

Étape 2 : Configuration

/oh-my-claudecode:omc-setup

Si vous exécutez OMC via omc --plugin-dir <path> ou claude --plugin-dir <path>, ajoutez --plugin-dir-mode à omc setup (ou exportez OMC_PLUGIN_ROOT auparavant) pour éviter de dupliquer les compétences/agents que le plugin fournit déjà au moment de l'exécution. Consultez la section Plugin directory flags dans REFERENCE.md pour une matrice de décision complète et tous les indicateurs disponibles.

Étape 3 : Construisez quelque chose

autopilot: build a REST API for managing tasks

C'est tout. Le reste est automatique.

Team Mode (Recommandé)

À partir de la v4.1.7, Team est la surface d'orchestration canonique dans OMC. Les anciens points d'entrée comme swarm et ultrapilot sont toujours supportés, mais redirigent désormais vers Team en coulisses.

/oh-my-claudecode:team 3:executor "fix all TypeScript errors"

Team fonctionne comme un pipeline par étapes :

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

Activez les teams natifs de Claude Code dans ~/.claude/settings.json :

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

Si les teams sont désactivés, OMC vous avertira et basculera vers une exécution sans Team lorsque possible.

Note : Nom du package — Le projet utilise la marque oh-my-claudecode (repo, plugin, commandes), mais le package npm est publié sous le nom oh-my-claude-sisyphus. Si vous installez les outils CLI via npm/bun, utilisez npm install -g oh-my-claude-sisyphus.

Mise à jour

# 1. Mettre à jour le plugin
/plugin install oh-my-claudecode

# 2. Relancer le setup pour actualiser la configuration
/oh-my-claudecode:omc-setup

Si vous rencontrez des problèmes après la mise à jour, videz l'ancien cache du plugin :

/oh-my-claudecode:omc-doctor

Votre Claude vient de recevoir des super-pouvoirs.

---

Pourquoi oh-my-claudecode ?

• Aucune configuration requise — Fonctionne directement avec des valeurs par défaut intelligentes
• Orchestration team-first — Team est la surface multi-agents canonique (swarm/ultrapilot sont des façades de compatibilité)
• Interface en langage naturel — Aucune commande à mémoriser, décrivez simplement ce que vous voulez
• Parallélisation automatique — Les tâches complexes sont distribuées entre des agents spécialisés
• Exécution persistante — N'abandonne pas tant que le travail n'est pas vérifié et terminé
• Optimisation des coûts — Le routage intelligent des modèles économise 30 à 50 % sur les tokens
• Apprentissage par l'expérience — Extrait et réutilise automatiquement les patterns de résolution de problèmes
• Visibilité en temps réel — La HUD statusline montre ce qui se passe en coulisses

---

Fonctionnalités

Modes d'orchestration

Plusieurs stratégies pour différents cas d'utilisation — de l'orchestration Team au refactoring économe en tokens. En savoir plus →

Mode	Description	Utilisation
Team (recommandé)	Pipeline canonique par étapes (team-plan → team-prd → team-exec → team-verify → team-fix)	Agents coordonnés travaillant sur une liste de tâches partagée
Autopilot	Exécution autonome (un seul agent leader)	Développement de fonctionnalités de bout en bout avec un minimum de cérémonie
Ultrawork	Parallélisme maximal (sans Team)	Corrections/refactorings parallèles en rafale quand Team n'est pas nécessaire
Ralph	Mode persistant avec boucles verify/fix	Tâches devant être entièrement complétées (pas de résultats partiels silencieux)
Ecomode	Routage économe en tokens	Itération soucieuse du budget
Pipeline	Traitement séquentiel par étapes	Transformations multi-étapes avec un ordre strict
Swarm / Ultrapilot (ancien)	Façades de compatibilité redirigeant vers Team	Workflows existants et ancienne documentation

Orchestration intelligente

• 32 agents spécialisés pour l'architecture, la recherche, le design, les tests, la data science
• Routage intelligent des modèles — Haiku pour les tâches simples, Opus pour le raisonnement complexe
• Délégation automatique — Le bon agent pour le bon travail, à chaque fois

Expérience développeur

• Mots-clés magiques — ralph, ulw, eco, plan pour un contrôle explicite

• HUD statusline — Métriques d'orchestration en temps réel dans votre barre d'état

  • Si vous lancez Claude Code directement avec claude --plugin-dir <path> (en contournant le shim omc), exportez OMC_PLUGIN_ROOT=<path> dans votre shell afin que le bundle HUD se résolve vers le même checkout que le chargeur de plugin. Voir la section Plugin directory flags dans REFERENCE.md pour les détails.

• Apprentissage de compétences — Extraction de patterns réutilisables depuis vos sessions

• Analytique et suivi des coûts — Compréhension de l'utilisation des tokens sur toutes les sessions

Contribuer

Vous souhaitez contribuer à OMC ? Voir CONTRIBUTING.md pour le guide complet du développeur, incluant comment faire un fork, configurer un checkout local, le lier en tant que plugin actif, exécuter des tests et soumettre des PR.

Compétences Personnalisées

Apprenez une fois, réutilisez à jamais. OMC extrait les connaissances durement acquises lors du débogage en fichiers de compétences portables qui s'injectent automatiquement quand pertinent.

	Portée Projet	Portée Utilisateur
Chemin	.omc/skills/	~/.omc/skills/
Partagé avec	Équipe (versionné)	Tous vos projets
Priorité	Haute (écrase la portée utilisateur)	Basse (repli)

# .omc/skills/fix-proxy-crash.md
---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]
source: extracted
---
Enveloppez le handler à server.py:42 dans try/except ClientDisconnectedError...

Gestion des compétences : /skill list | add | remove | edit | search Auto-apprentissage : /learner extrait des patterns réutilisables avec des critères de qualité stricts Auto-injection : Les compétences correspondantes se chargent automatiquement dans le contexte — aucun rappel manuel nécessaire

Liste complète des fonctionnalités →

---

Mots-clés magiques

Raccourcis optionnels pour les utilisateurs avancés. Le langage naturel fonctionne très bien sans eux.

Mot-clé	Effet	Exemple
team	Orchestration Team canonique	/oh-my-claudecode:team 3:executor "fix all TypeScript errors"
autopilot	Exécution entièrement autonome	autopilot: build a todo app
ralph	Mode persistant	ralph: refactor auth
ulw	Parallélisme maximal	ulw fix all errors
eco	Exécution économe en tokens	eco: migrate database
plan	Entretien de planification	plan the API
ralplan	Consensus de planification itératif	ralplan this feature
swarm	Ancien mot-clé (redirige vers Team)	swarm 5 agents: fix lint errors
ultrapilot	Ancien mot-clé (redirige vers Team)	ultrapilot: build a fullstack app

Notes :

• ralph inclut ultrawork : lorsque vous activez le mode ralph, il inclut automatiquement l'exécution parallèle d'ultrawork.
• La syntaxe swarm N agents est toujours reconnue pour l'extraction du nombre d'agents, mais le runtime est basé sur Team dans v4.1.7+.

Utilitaires

Attente de rate limit

Reprise automatique des sessions Claude Code lorsque les rate limits sont réinitialisés.

omc wait          # Vérifier le statut, obtenir des conseils
omc wait --start  # Activer le daemon de reprise automatique
omc wait --stop   # Désactiver le daemon

Prérequis : tmux (pour la détection de session)

Tags de notification (Telegram/Discord)

Vous pouvez configurer qui est mentionné lorsque les callbacks d'arrêt envoient des résumés de session.

# Définir/remplacer la liste des tags
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,role:987654321098765432"

# Mises à jour incrémentales
omc config-stop-callback telegram --add-tag charlie
omc config-stop-callback discord --remove-tag @here
omc config-stop-callback discord --clear-tags

Comportement des tags :

• Telegram : alice est normalisé en @alice
• Discord : supporte @here, @everyone, les IDs utilisateur numériques et role:<id>
• Les callbacks de type file ignorent les options de tags

Intégration OpenClaw

Transmettez les événements de session Claude Code vers une passerelle OpenClaw pour activer des réponses automatisées et des workflows via votre agent OpenClaw.

Configuration rapide (recommandé) :

/oh-my-claudecode:configure-notifications
# → Tapez "openclaw" quand demandé → choisir "OpenClaw Gateway"

Configuration manuelle : créez ~/.claude/omc_config.openclaw.json :

{
  "enabled": true,
  "gateways": {
    "my-gateway": {
      "url": "https://your-gateway.example.com/wake",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
      "method": "POST",
      "timeout": 10000
    }
  },
  "hooks": {
    "session-start": { "gateway": "my-gateway", "instruction": "Session started for {{projectName}}", "enabled": true },
    "stop":          { "gateway": "my-gateway", "instruction": "Session stopping for {{projectName}}", "enabled": true }
  }
}

Variables d'environnement :

Variable	Description
OMC_OPENCLAW=1	Activer OpenClaw
OMC_OPENCLAW_DEBUG=1	Activer la journalisation de débogage
OMC_OPENCLAW_CONFIG=/path/to/config.json	Chemin alternatif du fichier de configuration

Événements hook pris en charge (6 actifs dans bridge.ts) :

Événement	Déclencheur	Variables de template principales
session-start	La session démarre	{{sessionId}}, {{projectName}}, {{projectPath}}
stop	La réponse de Claude est terminée	{{sessionId}}, {{projectName}}
keyword-detector	À chaque soumission de prompt	{{prompt}}, {{sessionId}}
ask-user-question	Claude demande une saisie utilisateur	{{question}}, {{sessionId}}
pre-tool-use	Avant l'invocation d'outil (fréquence élevée)	{{toolName}}, {{sessionId}}
post-tool-use	Après l'invocation d'outil (fréquence élevée)	{{toolName}}, {{sessionId}}

Variables d'environnement du canal de réponse :

Variable	Description
OPENCLAW_REPLY_CHANNEL	Canal de réponse (ex. discord)
OPENCLAW_REPLY_TARGET	ID du canal
OPENCLAW_REPLY_THREAD	ID du thread

Voir scripts/openclaw-gateway-demo.mjs pour un gateway de référence qui relaie les payloads OpenClaw vers Discord via ClawdBot.

---

Documentation

• Référence complète — Documentation complète des fonctionnalités
• Monitoring de performance — Suivi des agents, débogage et optimisation
• Site web — Guides interactifs et exemples
• Guide de migration — Mise à jour depuis v2.x
• Architecture — Comment ça fonctionne en coulisses

---

Prérequis

• Claude Code CLI
• Abonnement Claude Max/Pro OU clé API Anthropic

Optionnel : Orchestration Multi-AI

OMC peut optionnellement orchestrer des fournisseurs d'IA externes pour la validation croisée et la cohérence du design. Ils ne sont pas requis — OMC fonctionne pleinement sans eux.

Fournisseur	Installation	Ce que ça apporte
Gemini CLI	npm install -g @google/gemini-cli	Revue de design, cohérence UI (contexte de 1M tokens)
Codex CLI	npm install -g @openai/codex	Validation d'architecture, vérification croisée de code review

Coût : 3 plans Pro (Claude + Gemini + ChatGPT) couvrent tout pour environ 60 $/mois.

---

Licence

MIT

---

Inspiré par : oh-my-opencode • claude-hud • Superpowers • everything-claude-code

Aucune courbe d'apprentissage. Puissance maximale.

Star History

💖 Soutenir ce projet

Si Oh-My-ClaudeCode améliore votre workflow, envisagez de devenir sponsor :

Pourquoi sponsoriser ?

• Maintenir le développement actif
• Support prioritaire pour les sponsors
• Influencer la roadmap et les fonctionnalités
• Aider à maintenir le logiciel libre et open source

Autres façons d'aider

• ⭐ Mettre une étoile au dépôt
• 🐛 Signaler des bugs
• 💡 Suggérer des fonctionnalités
• 📝 Contribuer au code