Everything Claude Codeの設定ガイド
現在の環境内で対話型ウィザードを実行します。まず棚卸しを実施し、サポートされている選択肢のみを収集し、プレビュー表示後、一度確認を受けてから非対話的に適用、検証し、成功後にのみウェルカム画面を表示します。ECCを一時ディレクトリにクローンしたり、プラグインコンポーネントを手動でコピーしたりしないでください。
人間が操作するターミナルでは、標準的なエントリポイントはecc setupとnpx ecc-universal setupです。AIエージェント環境内では、代わりに以下の明示的な非対話型コマンドを使用してください。
現在の環境に応じたルーティング
- Claude Codeでは、以下の完全なスコープ・フックウィザードを使用します。
- Codexでは、Codexのネイティブプラグインライフサイクルを使用します。Claudeのスコープを提供したり、ECCの4つのClaudeフックプロファイルをCodexにマッピングしたりしないでください。
- Kimiでは、
./.kimi-code下にプロジェクトサーフェスをインストールします。KimiはECCのClaudeライフサイクルフックプロファイルを提供しません。 - 環境が不明な場合は、検出された証拠を提示し、変更コマンドを実行する前にどの環境を設定するかユーザーに確認してください。
このスキルはインストール後の再設定パスです。各プロバイダーの組み込み初回インストールUIを横取りしたり置き換えたりすることはできません。
Claude Code：完全な対話型ウィザードの実行
1. 変更せずに棚卸し
以下の両コマンドを実行し、インストール済みECCのスコープ、有効状態、マーケットプレイスソースを要約します：
claude plugin list --json
claude plugin marketplace list --json
既存の単一のecc@eccインストールは再設定として扱います。Claudeのプロバイダー所有の「Open home page」コントロールをインストールの証拠として解釈しないでください。複数のECCスコープ、レガシー／手動インストール、不正な設定、マーケットプレイスの競合があった場合は、setupが返す復旧方法を報告して停止します。どの状態を削除すべきか推測しないでください。
2. 正確に2つの選択肢を収集
スコープに関する質問を1つだけ行い、1つの値を必要とします：
user | project | localuserはこのユーザーに対してグローバルです。projectはリポジトリ設定を通じて共有されます。localは現在のプロジェクトに対してプライベートです。
選択されたスコープのみを視覚的に「選択済み」または「インストール中」としてマークします。ユーザーが既存の単一インストールとは異なるスコープを選択した場合は、スコープ移行として説明し、以下のコマンドに--move-scopeを含めます。
フックモードに関する質問を1つだけ行い、1つの値を必要とします：
off | minimal | standard | strictoffはスキルとコマンドを維持しますが、ECCフック自動化を無効にします。minimalは最も軽量なライフサイクルとセーフティ自動化を有効にします。standardは品質とセーフティ自動化のバランスを取ります。strictは最も強力なチェックとリマインダーを有効にします。
フックの優先設定は個人のClaudeプラグイン設定であり、選択されたインストールスコープには従いません。
3. プレビューと一度の確認
プラグインにバンドルされたセットアップスクリプトを優先します。選択された2つの値を代入し、スコープ移行の場合のみ--move-scopeを含めます：
node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
--scope <scope> --hooks <hooks> [--move-scope] --dry-run --json
$CLAUDE_PLUGIN_ROOTが利用できない場合は、公開されているnpmパッケージを使用します：
npx --yes --package ecc-universal ecc setup --mode claude-plugin \
--scope <scope> --hooks <hooks> [--move-scope] --dry-run --json
計画されたアクション、1つのスコープ、1つのフックモード、マーケットプレイスアクション、およびソースから宛先への移行を含む、1つの確認サマリーのみを表示します。1つのはい／いいえの質問をします。ハーネスシェルツールを介してインタラクティブなecc setupを実行しないでください。そのシェルは通常非TTYです。
4. 明示的な選択肢を適用
確認後、--dry-runなしで同じルートを再実行します。すべての選択肢を明示的に保持し、成功を確定的にチェックできるようJSONを要求します：
node "$CLAUDE_PLUGIN_ROOT/scripts/setup.js" --mode claude-plugin \
--scope <scope> --hooks <hooks> [--move-scope] --yes --json
フォールバック：
npx --yes --package ecc-universal ecc setup --mode claude-plugin \
--scope <scope> --hooks <hooks> [--move-scope] --yes --json
5. 検証してからウェルカムを表示
終了ステータス0と、scopeとhooksが選択された値と等しいセットアップ結果を要求します。その後、独立して次を実行します：
claude plugin list --json
選択されたスコープに有効なecc@eccエントリが正確に1つ存在する場合のみ続行します。$CLAUDE_PLUGIN_ROOTが利用可能な場合、成功したセットアップのaction（installed、updated、migrated、resumed、またはalready-migrated）をバンドルされたレンダラーに渡します：
呼び出す前に、プロバイダーが報告したバージョンがscripts/lib/terminal-welcome.jsのECC_VERSION_PATTERNと一致することを要求します。予期しないバージョンテキストはシェルコマンドに挿入せずに拒否します。
node -e 'const { renderTerminalWelcome } = require(process.env.CLAUDE_PLUGIN_ROOT + "/scripts/lib/terminal-welcome"); process.stdout.write(renderTerminalWelcome({ action: process.argv[1], version: process.argv[2], color: process.stdout.isTTY }));' "<action>" "<installed-version>"
ウェルカムは正確に1回だけ表示します。失敗、ドライラン、キャンセル、スコープまたはフックの不一致、検証不能な状態の場合は表示せず、代わりにエラーと復旧方法を報告します。確認済みの変更後、ユーザーに/reload-pluginsの実行またはClaude Codeの再起動を伝えます。
Codex：ネイティブプラグインライフサイクルの使用
codex plugin marketplace list --jsonとcodex plugin list --available --jsonで棚卸しします。CodexのネイティブプラグインコマンドにはClaudeスタイルのuser | project | localセレクタはありません。Codexネイティブプラグインはプロバイダー固有のフックをサポートしていますが、Codexはそれらに明示的な信頼を必要とします。Codexにその信頼判断を任せてください。Claudeの4プロファイルフック質問をしたり、これらのプロファイルがCodexにマップされると主張したりしないでください。
ECCマーケットプレイスがない場合は追加します。そうでない場合はスナップショットを更新します：
codex plugin marketplace add affaan-m/ECC
codex plugin marketplace upgrade ecc --json
1回の確認を求め、その後インストールまたは冪等にインストール済みキャッシュを更新し、検証します：
codex plugin add ecc@ecc --json
codex plugin list --json
JSONがECCのインストールとそのinstalledPathを報告する場合のみ続行します。次に、検証済みバンドルのウェルカムを表示します：
Codex JSONが返す正確な絶対パスのinstalledPathのみを使用します。制御文字を拒否し、インストールされたバージョンがECC_VERSION_PATTERNと一致することを要求します。この引数配列でnodeを直接呼び出します。これはツールAPI呼び出しであり、シェルコマンドではありません：
["<installedPath>/scripts/welcome.js", "--action", "configured", "--version", "<installed-version>"]
現在の環境が個別の引数配列で実行可能ファイルを呼び出せない場合は、ウェルカムをスキップします。Codex JSONの値からシェルコマンドを構築しないでください。
Claudeのoff | minimal | standard | strictプロファイルがCodexに適用されたと主張しないでください。
Kimi：プロジェクトサーフェスのインストール
確認前に機能の要約を表示します：宛先./.kimi-code、ECCライフサイクルフックについてはhooks=unsupported。Claudeのスコープやフックモードの質問はしないでください。まずプレビュー：
npx --yes --package ecc-universal ecc install --profile core --target kimi --dry-run
そのプロジェクト宛先について1回の確認を表示し、--dry-runなしで同じコマンドを適用します。以下で検証：
npx --yes --package ecc-universal ecc doctor --target kimi
doctorが成功し、インストールされた命令とスキルが./.kimi-code内に残っている場合のみ、以下を表示：
npx --yes --package ecc-universal ecc welcome --action configured
KimiがECCライフサイクルフックをインストールまたは設定したと主張しないでください。