Tutoriel d'utilisation d'OpenCode oh-my-openagent
Oh My OpenAgent(abrégé enOmO) est un plugin d'amélioration d'assistant de programmation IA open source, anciennement appeléoh-my-opencode。
oh-my-openagent s'exécute au-dessus d'OpenCode, l'outil de programmation IA, le transformant en11 agents IA professionnelsformant une équipe de développement.
Expliqué en une phrase :
Vous soumettez une requête → OmO orchestre automatiquement plusieurs IA pour travailler en parallèle → Plusieurs fois plus rapide qu'une seule IA
Actuellement sur GitHub54k+ étoiles, c'est le plugin OpenCode le plus populaire.
- URL GitHub :https://github.com/code-yeongyu/oh-my-openagent
- Site officiel :https://ohmyopenagent.com/zh
Installation
Copiez et collez l'invite suivante dans votre outil LLM (OpenCode, Claude Code, AmpCode, Cursor, etc.) :
按照此链接说明安装并配置 oh-my-opencode:https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

Après exécution, il s'installera automatiquement. Pendant l'installation, il peut y avoir des options de configuration de clé API ; vous pouvez choisir de les configurer ou non :

Découvrez les 11 membres de l'équipe IA (agents)
OmO intègre 11 agents spécialisés, chacun avec son propre rôle :
Agents principaux
| Agent | Rôle | Modèle par défaut | Quand l'utiliser |
|---|---|---|---|
| Sisyphus | Coordinateur principal, développeur polyvalent | Claude Opus | Point d'entrée pour toutes les tâches, orchestre automatiquement les autres agents |
| Prometheus | Planificateur stratégique | Claude Opus / GPT-5.4 | Planification de tâches complexes |
| Atlas | Gestion des tâches à faire | Kimi K2.5 | Suivi de la progression des tâches multi-étapes |
Agents professionnels
| Agent | Rôle | Modèle par défaut | Spécialisé dans |
|---|---|---|---|
| Hephaestus | Travailleur autonome avancé | GPT-5.3-codex | Tâches de codage indépendantes de longue durée et de haute intensité |
| Oracle | Consultant en architecture / expert en débogage | GPT-5.4 | Conception de systèmes, localisation de bogues difficiles |
| Momus | Relecteur de haute précision | GPT-5.4 | Revue de code, vérification des sorties |
| Metis | Revue du plan | Claude Opus | Vérifier si le plan de Prometheus comporte des omissions |
Agents de type outil (rapides, à faible coût)
| Agent | Rôle | Modèle par défaut | Pourquoi utiliser des modèles peu coûteux |
|---|---|---|---|
| Explorer | Recherche rapide dans la base de code | MiniMax / Grok Code Fast | Les tâches de recherche ne nécessitent pas une intelligence élevée ; la vitesse importe davantage |
| Bibliothécaire | Récupération de documents/code | MiniMax (Gratuit) | La récupération de documents ne nécessite pas de raisonnement approfondi |
| Observateur multimodal | Analyse de captures d'écran/visuelle | Kimi K2.5 | Kimi excelle dans la compréhension multimodale |
💡 Astuce pour débutants: Vous n'avez pas besoin de sélectionner manuellement les Agents. Sisyphus orchestrera automatiquement la combinaison d'Agents appropriée en fonction de votre type de tâche.
Trois modes de travail
Mode 1 : ultrawork (le plus facile)
Ajouter au promptultraworkouulw, tout est automatisé :
ultrawork 帮我把这个 React 组件改成 TypeScript
Convient pour : les tâches de développement quotidiennes, les scénarios où vous souhaitez que l'IA accomplisse tout automatiquement.
Mode 2 : Mode de planification Prometheus (le plus précis)
appuyez sur latouche Tabpour entrer en mode Prometheus. L'IA commencera par comprendre vos besoins via des questions-réponses, générera un plan d'exécution détaillé et lancera l'exécution après votre confirmation.
Flux de travail :
- appuyez
TabPasser au mode Prometheus - Décrivez vos besoins ; l'IA vous posera quelques questions de clarification
- L'IA génère un plan d'exécution, vous confirmez
- Entrée
/start-workpour lancer l'exécution
Convient pour : le développement de fonctionnalités complexes, la refactorisation d'architecture et d'autres scénarios nécessitant une planification précise.
Mode 3 : Conversation normale (le plus flexible)
Saisissez directement votre question ou besoin sans ajouter de mots-clés :
解释一下 src/auth.ts 里的 JWT 验证逻辑
Convient pour : les tâches légères telles que poser des questions, expliquer du code et effectuer de petites modifications.
Détails du fichier de configuration
OmO dispose de deux fichiers de configuration avec des priorités différentes :
- Configuration au niveau du projet (priorité plus élevée) :.opencode/oh-my-opencode.jsonc
- Configuration au niveau de l'utilisateur (valeur globale par défaut) :~/.config/opencode/oh-my-opencode.jsonc
Les fichiers de configuration prennent en charge les commentaires (format JSONC) et l'auto-complétion JSON Schema :
{
"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-opencode.schema.json",
"agents": {
// 主协调 Agent,建议用 Claude Opus 系列或 Kimi
"sisyphus": {
"model": "anthropic/claude-opus-4-6"
},
// 架构顾问,建议用 GPT 系列
"oracle": {
"model": "openai/gpt-5.4",
"variant": "high"
}
}
}
Conseil aux débutants: Ne modifiez pas la configuration juste après l'installation ; les paramètres par défaut sont déjà bons.
Référence rapide des commandes courantes
| Commande | Description |
|---|---|
opencode |
Démarrer OmO |
bunx oh-my-opencode install |
Installer/reconfigurer le plugin |
bunx oh-my-opencode doctor |
Diagnostiquer les problèmes de configuration |
opencode auth login |
Se connecter au compte du fournisseur d'IA |
opencode models |
Afficher tous les modèles disponibles |
bunx oh-my-opencode refresh-model-capabilities |
Actualiser le cache des capacités des modèles |
Dans l'interface de conversation :
| Raccourci/Commande | Description |
|---|---|
Tab |
Passer au mode de planification Prometheus |
/start-work |
Commencer l'exécution du plan en mode Prometheus |
ultrawork / ulw |
Ajouter au prompt pour activer le mode parallèle complet |
Dépannage des problèmes courants
Q : Après l'installation, l'exécutionopencoden'affiche pas les fonctionnalités OmO
Solution: Vérifiez si le plugin est correctement enregistré dans le fichier de configuration :
cat ~/.config/opencode/opencode.json
Confirmezpluginle champ contient"oh-my-opencode". Si ce n'est pas le cas, réexécutezbunx oh-my-opencode install。
Q : Avertissement d'exécution "Using legacy package name"
Solution: Modifieropencode.jsonle nom du plugin dans ... de"oh-my-opencode"à"oh-my-openagent":
{
"plugin": ["oh-my-openagent"]
}
Q : L'agent Sisyphus est peu performant, semble identique à Claude standard
Cause: Peut-être que vous n'utilisez pas le modèle Claude Opus, ou que vous n'ajoutez pasultrawork。
Solution:
- Confirmez que vous êtes connecté à un compte Claude Pro/Max
- Add
ultraworkmot-clé au prompt - Exécutez
bunx oh-my-opencode doctorpour vérifier la configuration du modèle
Q : La tâche s'arrête à mi-chemin
Solution: Continuez à envoyer des promptsultrawork 继续之前的任务, Sisyphus reprendra la progression grâce au système Todo.
Q : Vous souhaitez désactiver les données de télémétrie anonymes
OmO active la télémétrie anonyme par défaut (utilise PostHog, les données sont hachées). Pour la désactiver :
export OMO_SEND_ANONYMOUS_TELEMETRY=0 # 或 export OMO_DISABLE_POSTHOG=1Autres extensions