oh-my-claudecode/README.ja.md

English | 한국어 | 中文 | 日本語 | Español | Tiếng Việt | Português

oh-my-claudecode

Codex ユーザーの方へ: oh-my-codex をチェックしてください — OpenAI Codex CLI 向けの同じオーケストレーション体験を提供します。

Claude Code のためのマルチエージェント・オーケストレーション。学習コストゼロ。

Claude Code を学ぶ必要はありません。OMC を使うだけ。

はじめる • ドキュメント • CLI リファレンス • ワークフロー • 移行ガイド • Discord

---

クイックスタート

ステップ 1: インストール

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

ステップ 2: セットアップ

/omc-setup

omc --plugin-dir <path> または claude --plugin-dir <path> 経由で OMC を実行する場合、omc setup に --plugin-dir-mode を追加します (または事前に OMC_PLUGIN_ROOT をエクスポート) ので、プラグインが既に実行時に提供するスキル/エージェントが重複しません。完全な決定マトリックスと利用可能なすべてのフラグについては、REFERENCE.md の Plugin directory flags セクション を参照してください。

ステップ 3: 何か作ってみる

autopilot: build a REST API for managing tasks

以上です。あとは自動で進みます。

何から始めればいいかわからない？

要件が不明確だったり、漠然としたアイデアしかなかったり、設計を細かくコントロールしたい場合:

/deep-interview "I want to build a task management app"

ディープインタビューはソクラテス式質問法を使い、コードを書く前に思考を明確にします。隠れた前提を明らかにし、加重次元で明確さを測定することで、実行開始前に何を構築すべきかを正確に把握できます。

Team モード（推奨）

v4.1.7 から Team が OMC の標準オーケストレーション方式です。swarm や ultrapilot などのレガシーエントリポイントは引き続きサポートされていますが、内部的に Team にルーティングされます。

/team 3:executor "fix all TypeScript errors"

Team はステージ型パイプラインで実行されます:

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

~/.claude/settings.json で Claude Code ネイティブチームを有効化:

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

チームが無効の場合、OMC は警告を表示し、可能な場合は Team なしの実行にフォールバックします。

tmux CLI ワーカー — Codex & Gemini (v4.4.0+)

v4.4.0 で Codex/Gemini MCP サーバー（x、g プロバイダー）が削除されます。代わりに /omc-teams を使って tmux 分割ペインで実際の CLI プロセスを起動してください:

/omc-teams 2:codex   "review auth module for security issues"
/omc-teams 2:gemini  "redesign UI components for accessibility"
/omc-teams 1:claude  "implement the payment flow"

Codex + Gemini を一つのコマンドで使うには /ccg スキルを使います:

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

スキル	ワーカー	最適用途
/omc-teams N:codex	N 個の Codex CLI ペイン	コードレビュー、セキュリティ解析、アーキテクチャ
/omc-teams N:gemini	N 個の Gemini CLI ペイン	UI/UX デザイン、ドキュメント、大規模コンテキスト
/omc-teams N:claude	N 個の Claude CLI ペイン	tmux で Claude CLI を使う汎用タスク
/ccg	Codex 1 個 + Gemini 1 個	並列トライモデルオーケストレーション

ワーカーはオンデマンドで起動し、タスク完了後に終了します — アイドルリソースの無駄なし。codex / gemini CLI のインストールとアクティブな tmux セッションが必要です。

注意: パッケージ名について — プロジェクトのブランド名は oh-my-claudecode（リポジトリ、プラグイン、コマンド）ですが、npmパッケージは oh-my-claude-sisyphus として公開されています。npm/bunでCLIツールをインストールする場合は npm install -g oh-my-claude-sisyphus を使用してください。

アップデート

# 1. マーケットプレイスクローンを更新
/plugin marketplace update omc

# 2. セットアップを再実行して設定を更新
/omc-setup

注意: マーケットプレイスの自動更新が有効になっていない場合は、セットアップ実行前に /plugin marketplace update omc を手動で実行して最新バージョンを同期する必要があります。

更新後に問題が発生した場合は、古いプラグインキャッシュをクリアしてください：

/omc-doctor

あなたの Claude がステロイド級にパワーアップ。

---

なぜ oh-my-claudecode なのか?

• 設定不要 - 賢いデフォルト設定ですぐに使える
• Team ファースト・オーケストレーション - Team が標準マルチエージェントサーフェス（swarm/ultrapilot は互換性ファサード）
• 自然言語インターフェース - コマンドを覚える必要なし、やりたいことを話すだけ
• 自動並列化 - 複雑なタスクを専門エージェントに自動分散
• 粘り強い実行 - 検証完了まで諦めない
• コスト最適化 - スマートなモデルルーティングでトークンを30〜50%節約
• 経験から学習 - 問題解決パターンを自動抽出して再利用
• リアルタイム可視化 - HUD ステータスラインで裏側の動きが見える

---

機能

実行モード

用途に応じた複数の戦略 - 完全自律ビルドからトークン効率の良いリファクタリングまで。詳しくはこちら →

モード	特徴	用途
Team（推奨）	ステージ型パイプライン	共有タスクリストで協力する Claude エージェント
omc-teams	tmux CLI ワーカー	Codex/Gemini CLI タスク; オンデマンド起動、完了後終了
ccg	トライモデル並列	Codex（分析）+ Gemini（デザイン）、Claude が統合
Autopilot	自律実行	最小限のセレモニーで end-to-end 機能開発
Ultrawork	最大並列	Team 不要な並列修正/リファクタリング
Ralph	粘り強いモード	完全に完了させるべきタスク
Pipeline	逐次処理	厳密な順序が必要な多段階変換
Swarm / Ultrapilot（レガシー）	Team へルーティング	既存ワークフローと古いドキュメント

インテリジェント・オーケストレーション

• 32の専門エージェント - アーキテクチャ、リサーチ、デザイン、テスト、データサイエンス対応
• スマートモデルルーティング - シンプルなタスクは Haiku、複雑な推論は Opus
• 自動委譲 - 常に適材適所

開発者体験

• マジックキーワード - ralph、ulw、plan で明示的制御

• HUD ステータスライン - ステータスバーでリアルタイムのオーケストレーション指標を表示

  • claude --plugin-dir <path> で Claude Code を直接起動する場合 (omc shim をバイパス)、シェルで OMC_PLUGIN_ROOT=<path> をエクスポートして、HUD バンドルがプラグイン ローダーと同じ checkout に解決されるようにします。詳細については、REFERENCE.md の Plugin directory flags セクション を参照してください。

• スキル学習 - セッションから再利用可能なパターンを抽出

• 分析とコスト追跡 - 全セッションのトークン使用状況を把握

貢献

OMC に貢献したいですか？フォーク、ローカル checkout の設定、アクティブ プラグインとしてのリンク、テスト実行、PR の送信方法など、完全な開発者ガイドについては CONTRIBUTING.md を参照してください。

カスタムスキル

一度学んだことを永遠に再利用。OMC はデバッグで得た実践的な知識をポータブルなスキルファイルに抽出し、関連する場面で自動的に注入します。

	プロジェクトスコープ	ユーザースコープ
パス	.omc/skills/	~/.omc/skills/
共有先	チーム（バージョン管理対象）	すべてのプロジェクトで利用可能
優先度	高（ユーザースコープを上書き）	低（フォールバック）

# .omc/skills/fix-proxy-crash.md
---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]
source: extracted
---
server.py:42 のハンドラーを try/except ClientDisconnectedError で囲んでください...

スキル管理： /skill list | add | remove | edit | search 自動学習： /learner が厳格な品質基準で再利用可能なパターンを抽出します 自動注入： マッチするスキルが自動的にコンテキストに読み込まれます — 手動呼び出し不要

全機能リスト →

---

マジックキーワード

パワーユーザー向けのオプション・ショートカット。自然言語でも問題なく動作します。

キーワード	効果	例
team	標準 Team オーケストレーション	/team 3:executor "fix all TypeScript errors"
omc-teams	tmux CLI ワーカー (codex/gemini/claude)	/omc-teams 2:codex "security review"
ccg	トライモデル Codex+Gemini オーケストレーション	/ccg review this PR
autopilot	完全自律実行	autopilot: build a todo app
ralph	粘り強いモード	ralph: refactor auth
ulw	最大並列化	ulw fix all errors
plan	計画インタビュー	plan the API
ralplan	反復的計画合意形成	ralplan this feature
deep-interview	ソクラテス式の要件明確化	deep-interview "vague idea"
swarm	非推奨 — 代わりに team を使用	swarm 5 agents: fix lint errors
ultrapilot	非推奨 — 代わりに team を使用	ultrapilot: build a fullstack app

注意:

• ralph は ultrawork を含む: ralph モードを有効にすると、ultrawork の並列実行が自動的に含まれます。キーワードを組み合わせる必要はありません。
• swarm N agents 構文はエージェント数抽出のために引き続き認識されますが、v4.1.7+ ではランタイムは Team ベースです。

---

ユーティリティ

レート制限待機

レート制限がリセットされたら Claude Code セッションを自動再開。

omc wait          # ステータス確認とガイダンス取得
omc wait --start  # 自動再開デーモンを有効化
omc wait --stop   # デーモンを無効化

必要なもの: tmux (セッション検出用)

通知タグ設定 (Telegram/Discord/Slack)

stop コールバックがセッション要約を送るときに、誰をタグ付けするか設定できます。

# タグ一覧を設定/置換
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"
omc config-stop-callback slack --enable --webhook <url> --tag-list "<!here>,<@U1234567890>"

# 追加・削除・クリア
omc config-stop-callback telegram --add-tag charlie
omc config-stop-callback discord --remove-tag @here
omc config-stop-callback discord --clear-tags

タグの挙動:

• Telegram: alice は @alice に正規化
• Discord: @here、@everyone、数値ユーザーID、role:<id> をサポート
• Slack: <@MEMBER_ID>、<!channel>、<!here>、<!everyone>、<!subteam^GROUP_ID> をサポート
• file コールバックはタグオプションを無視

OpenClaw 連携

Claude Code セッションイベントを OpenClaw ゲートウェイに転送し、OpenClaw エージェントを通じた自動応答とワークフローを実現します。

クイックセットアップ（推奨）:

/oh-my-claudecode:configure-notifications
# → プロンプトで "openclaw" と入力 → "OpenClaw Gateway" を選択

手動セットアップ: ~/.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 }
  }
}

環境変数:

変数	説明
OMC_OPENCLAW=1	OpenClaw を有効化
OMC_OPENCLAW_DEBUG=1	デバッグログを有効化
OMC_OPENCLAW_CONFIG=/path/to/config.json	設定ファイルパスを変更

サポートされるフックイベント（bridge.ts で 6 つがアクティブ）:

イベント	トリガー	主要テンプレート変数
session-start	セッション開始時	{{sessionId}}, {{projectName}}, {{projectPath}}
stop	Claude のレスポンス完了時	{{sessionId}}, {{projectName}}
keyword-detector	プロンプト送信ごと	{{prompt}}, {{sessionId}}
ask-user-question	Claude がユーザー入力を要求した時	{{question}}, {{sessionId}}
pre-tool-use	ツール呼び出し前（高頻度）	{{toolName}}, {{sessionId}}
post-tool-use	ツール呼び出し後（高頻度）	{{toolName}}, {{sessionId}}

Reply Channel 環境変数:

変数	説明
OPENCLAW_REPLY_CHANNEL	応答チャンネル（例: discord）
OPENCLAW_REPLY_TARGET	チャンネル ID
OPENCLAW_REPLY_THREAD	スレッド ID

OpenClaw ペイロードを ClawdBot 経由で Discord にリレーするリファレンスゲートウェイについては scripts/openclaw-gateway-demo.mjs を参照してください。

---

ドキュメント

• 完全リファレンス - 全機能の詳細ドキュメント
• CLI リファレンス - すべての omc コマンド、フラグ、ツール
• 通知ガイド - Discord、Telegram、Slack、webhook のセットアップ
• 推奨ワークフロー - 一般的なタスクのための実績あるスキルチェーン
• リリースノート - 各バージョンの新機能
• ウェブサイト - インタラクティブガイドと例
• 移行ガイド - v2.x からのアップグレード
• アーキテクチャ - 内部の仕組み
• パフォーマンス監視 - エージェント追跡、デバッグ、最適化

---

動作環境

• Claude Code CLI
• Claude Max/Pro サブスクリプション または Anthropic API キー

オプション：マルチ AI オーケストレーション

OMC はクロスバリデーションとデザイン一貫性のために、外部 AI プロバイダーをオプションで活用できます。必須ではありません — これらがなくても OMC は完全に動作します。

プロバイダー	インストール	機能
Gemini CLI	npm install -g @google/gemini-cli	デザインレビュー、UI 一貫性（1M トークンコンテキスト）
Codex CLI	npm install -g @openai/codex	アーキテクチャ検証、コードレビュークロスチェック

コスト： 3つの Pro プラン（Claude + Gemini + ChatGPT）で月額約 $60 ですべてをカバーできます。

---

ライセンス

MIT

---

インスピレーション元: oh-my-opencode • claude-hud • Superpowers • everything-claude-code • Ouroboros

学習コストゼロ。最大パワー。

Star History

💖 このプロジェクトを支援

Oh-My-ClaudeCode があなたのワークフローに役立っているなら、スポンサーをご検討ください:

スポンサーになる理由は?

• 開発を活発に保つ
• スポンサー向け優先サポート
• ロードマップと機能に影響力
• 無料オープンソースの維持を支援

その他の協力方法

• ⭐ リポジトリにスター
• 🐛 バグ報告
• 💡 機能提案
• 📝 コード貢献