configure

OrchestKit の設定

OrchestKit のインストールをカスタマイズするための対話型セットアップです。

クイックスタート

configure
configure mcp memory

引数の解決

PRESET = "$ARGUMENTS[0]"   # Optional preset name or subcommand, e.g., "mcp"
TARGET = "$ARGUMENTS[1]"   # Optional target, e.g., "memory"
# If no arguments, run interactive wizard.
# $ARGUMENTS is the full string (CC 2.1.59 indexed access)

完了とは、~/.claude/plugins/orchestkit/config.json が書き込まれ、ユーザーがステップ 11 のプレビューを確認し、/reload-plugins が推奨された状態を指します。 予算は、各ステップにつき AskUserQuestion を最大 1 回、全 11 ステップです。上限に達した時点、または完了地点に到達した時点のいずれか早い方で停止して報告してください。

ステップ 1：プリセットを選択

AskUserQuestion を使用します。

プリセット	スキル	エージェント	フック	説明
Complete	すべて	すべて	すべて	すべて
Standard	すべて	0	すべて	スキルのみ、エージェントなし
Lite	28	0	すべて	必須項目のみ（テスト、セキュリティ、計画）
Hooks-only	0	0	すべて	安全性、生産性、チーム連携のフック
Monorepo	すべて	すべて	すべて	Complete ＋モノレポ検出

現在の数：claude plugin details ork を実行してください（2026-09-25 時点で 107 スキル、36 エージェント）。

ステップ 2：スキルカテゴリーをカスタマイズ

利用可能なカテゴリー：

• AI/ML（28 スキル）
• バックエンド（16 スキル）
• フロントエンド（9 スキル）
• テスト（14 スキル）
• セキュリティ（7 スキル）
• DevOps（5 スキル）
• 計画（7 スキル）
• ワークフロー（5 スキル）

ステップ 3：エージェントをカスタマイズ

プロダクトエージェント（2）：

• market-intelligence
• product-strategist

技術エージェント（17）：

• backend-system-architect
• frontend-ui-developer
• database-engineer
• llm-integrator
• workflow-architect
• data-pipeline-engineer
• test-generator
• code-quality-reviewer
• security-auditor
• security-layer-auditor
• debug-investigator
• system-design-reviewer
• python-performance-engineer
• frontend-performance-engineer
• monitoring-engineer
• event-driven-architect
• infrastructure-architect

運用エージェント（6）：

• ci-cd-engineer
• deployment-manager
• git-operations-engineer
• release-engineer
• ai-safety-auditor
• multimodal-specialist

調査エージェント（4）：

• web-research-analyst
• market-intelligence
• design-system-architect
• demo-producer

ステップ 4：フックを設定

安全性フック（常に有効）：

• git-branch-protection
• file-guard
• redact-secrets

切り替え可能なフック：

• 生産性（自動承認、ログ記録）
• 品質ゲート（カバレッジ、パターン）
• チーム連携（ロック、競合）
• 通知（デスクトップ、サウンド）

CC 2.1.49 の管理対象設定： OrchestKit はデフォルトのフック権限を含むプラグイン settings.json を提供します。これらは管理対象のデフォルト設定であり、ユーザーはプロジェクトまたはユーザー設定で上書きできます。エンタープライズ管理者は、管理対象プロファイルを通じて管理対象設定をロックできます。

CC 2.1.111 — 広範すぎる Bash 権限を削除： 2.1.111 以降、glob パターンを使った読み取り専用の Bash コマンド（ls:*、head:*、grep:*、wc:*、find:* など）では、デフォルトで権限確認が表示されなくなりました。古い確認を抑止するために、.claude/settings.local.json に Bash(ls:*)／Bash(grep:*) のような明示的な許可を追加している場合、それらは不要になりました。組み込みの /less-permission-prompts スキルはトランスクリプトをスキャンして削除差分を提案します。プロジェクトごと、およびユーザープロファイルごとに一度実行し、承認した項目をコミットしてください。コミット済みの OrchestKit src/settings/ork.settings.json はすでに最小限（許可対象は Read、Glob、Grep、少数の MCP エントリー）であり、変更は不要です。

CC 2.1.129 — Bash(mkdir *)／Bash(touch *) の許可ルールがプロジェクト内のパスで機能するようになりました： 以前はプロジェクト相対パスに対して黙って拒否されていましたが、現在はドキュメントどおりに許可されます。明示的なサブパスを列挙した回避策（Bash(mkdir:./src/*) など）は、標準の glob 形式に戻してまとめることができます。references/cc-version-settings.md § CC 2.1.129 を参照してください。 CC 2.1.157 — プラグインの自動読み込み＋ワークフロートリガーの制御： .claude/skills 内のプラグインは自動的に読み込まれます（マーケットプレイスは不要）。claude plugin init <name> で、その場所にプラグインのひな形を作成できます。/config の「Workflow keyword trigger」トグルをオフにするか、キーワードの直後に Backspace キーを押すと、「workflow」や「ultracode」だけで動的なワークフローが起動するのを防げます。claude agents は settings.json の agent フィールドを参照し、--agent <name> で上書きできます。

CC 2.1.160 — 起動ファイルとビルド設定への書き込みプロンプト： Claude がシェルの起動ファイル（.zshenv／.zlogin／.bash_login、~/.config/git/）に書き込む前、または acceptEdits モードでコード実行を許可するビルドツール設定（.npmrc、bunfig.toml、.bazelrc、.pre-commit-config.yaml、.devcontainer/）に書き込む前に、承認プロンプトが表示されます。これらはセキュリティ上のデフォルト設定です。意図的に承認し、事前に許可しないでください。

CC 2.1.141 — ワークロード ID フェデレーション用の ANTHROPIC_WORKSPACE_ID： Anthropic の WIF フローを通じてヘッドレス／CI エージェント（例：ci-sentinel、bare-eval）を認証するとき、フェデレーションルールが複数のワークスペースを対象としている場合は、ANTHROPIC_WORKSPACE_ID を設定して、発行されたトークンのスコープを1つのワークスペースに限定します。設定しない場合、複数ワークスペースを対象とするルールでは、スコープが限定されないトークンが発行されます。

CC 2.1.142 — リモート MCP 用の MCP_TOOL_TIMEOUT： リクエストごとのタイムアウトが、リモートの HTTP/SSE MCP サーバーにも適用されるようになりました（以前は、設定値にかかわらず60秒に制限されていました）。NotebookLM の studio_status、ナレッジベースの取り込み、インデックスの再構築など、正当な理由で60秒を超えるロングポーリングツールでは、タイムアウト値を引き上げてください（例：MCP_TOOL_TIMEOUT=180000）。これにより、タイムアウトが通知されないまま処理が中断されるのを防げます。

CC 2.1.169 — セーフモード＋ポリシー適用の修正： --safe-mode（または CLAUDE_CODE_SAFE_MODE=1）を指定すると、すべてのカスタマイズ（CLAUDE.md、プラグイン、スキル、フック、MCP サーバー）を無効にして CC が起動します。「ork（または他のプラグイン）が原因か？」を切り分けてからバグを報告する最速の方法です。エンタープライズの管理対象 MCP ポリシー（allowedMcpServers／deniedMcpServers）が、再接続時、IDE 形式の設定、初回のインストール後セッションにおける --mcp-config サーバー、およびリモート設定の読み込み前にも適用されるようになりました。組織でこれらを設定している場合、これまで動作していた未登録のサーバーが、今後は正しくブロックされる可能性があります。信頼されていないプロジェクト設定では、信頼確認なしに OTEL クライアント証明書のパスを設定できなくなりました。セルフホストランナーには、未コミットの作業のスナップショット作成やログのエクスポートに使える post-session ライフサイクルフック（セッション終了後、ワークスペース削除前）が追加されました。また、設定可能な SIGTERM→SIGKILL の猶予時間（デフォルト5秒）も追加されました。

CC 2.1.166 — fallbackModel 設定（最大3モデル）： fallbackModel 設定で最大3つのモデルを指定できるようになりました。プライマリモデルが過負荷または利用不可の場合、指定順に試行します。また、--fallback-model はヘッドレスセッションだけでなく、対話型セッションにも適用されるようになりました。長時間の ork:implement／ork:brainstorm の実行ではこの設定を使用すると、プライマリモデルが過負荷になった際、実行が停止する代わりに次のモデルへ切り替わります。references/cc-version-settings.md にある 2.1.152 のフォールバックに関する注記を拡張する内容です。

CC 2.1.181 — 単発設定用の /config key=value： /config メニューを開いたり設定ファイルを手動で編集したりせずに、プロンプトから直接、任意の設定を1つ変更できます（例：/config thinking=false、/config model=opus）。対話型、-p、Remote Control で動作します。これは単発の臨時設定を変更するための最速の方法です。永続的な自動化の代わりにはなりません。「X のときは常に Y を行う」という動作には、引き続き**settings.json のフック**が必要です（フックを実行するのはハーネスであり、/config が書き込むのは設定値のみです）。今すぐ設定を切り替えるには /config key=value を使用してください。変更を毎回のセッションで自動的に実行するには、このスキルのフローに従ってフックを設定してください。references/cc-version-settings.md の § CC 2.1.181 を参照してください。

ステップ 5：MCP の設定（任意）

4 つの MCP はすべて、デフォルトで有効になっています。Tavily には API キーが必要です。

MCP	用途	デフォルト	必要なもの
context7	ライブラリのドキュメント	有効	なし
memory	セッションをまたいだ永続化	有効	なし
sequential-thinking	サブエージェント向けの構造化された推論	有効	なし
tavily	ウェブ検索 + 抽出	有効	API キー（無料枠：app.tavily.com）

有効になっている理由： OrchestKit には 30 以上の Sonnet/Haiku サブエージェントが含まれています。Opus 5.5、Sonnet 5、Haiku 5.5 はネイティブで思考するため（適応型思考はデフォルトで有効）、sequential-thinking が最も役立つのは、budget_tokens の明示が必要な Haiku 4.5 など、古いモデルに固定されたサブエージェントです。haiku が引き続き Haiku 4.5 に解決される環境（CC 2.1.293 未満、Bedrock、Vertex、Foundry）では、model: haiku のすべてのサブエージェントが対象となります。Tavily は特定のエージェントで使用されます（エージェントのフロントマターにある mcpServers を参照）。CC の MCPSearch は、オーバーヘッドがコンテキストの 10% を超えるとスキーマを自動的に遅延読み込みするため、トークンコストは自動的に管理されます。

バックグラウンドエージェント： MCP ツールはバックグラウンドのサブエージェントでは利用できません（CC プラットフォームの厳格な制限です）。MCP ツールが必要なエージェントは、フォアグラウンドで実行する必要があります。

これらの MCP をすでにグローバルにインストールしていますか？ Tavily または memory がすでに ~/.claude/mcp.json にある場合は、エントリーの重複を避けるため、ここでは有効化しないでください。OrchestKit のエージェントは、Claude Code が最初に解決したインスタンスを使用します。

claude.ai の MCP サーバーを無効にする（CC 2.1.63 以降）： Claude Code はデフォルトで claude.ai の MCP サーバーを読み込む場合があります。これを無効にし、ローカルで設定した MCP のみを使用するには、次のようにします。

export ENABLE_CLAUDEAI_MCP_SERVERS=false

セッションをまたいで設定を維持するには、シェルプロファイル（~/.zshrc または ~/.bashrc）に追加します。これは claude.ai から読み込まれる MCP サーバーにのみ影響します。.mcp.json および ~/.claude/mcp.json でローカルに設定した MCP には影響しません。

ステップ 6～9：CC バージョン固有の設定

詳細を読み込むには、Read("references/cc-version-settings.md") を実行して、設定オプション全体を確認してください。

CC 2.1.7（MCP の遅延読み込みしきい値、有効なコンテキストウィンドウ）、CC 2.1.20（タスクの削除、PR の拡充、エージェントの権限、モノレポの検出、チームへの配布）、CC 2.1.23（スピナーの動詞のカスタマイズ）、CC 2.1.79（ターン所要時間の表示）について説明します。

CC 2.1.119：prUrlTemplate（M122）

標準とは異なる URL 形式を使用するエンタープライズ向けの GitLab／GitHub Enterprise／Bitbucket 環境では、~/.claude/settings.json（またはプロジェクトレベル）に prUrlTemplate を設定すると、review-pr／create-pr／fix-issue による URL の組み立てを上書きできます。

{
  "prUrlTemplate": "https://gitlab.acme.com/{owner}/{repo}/-/merge_requests/{n}"
}

トークン：{host}、{owner}、{repo}、{n}。ホストファミリーの一覧とスキル側の分岐パターンについては、src/skills/chain-patterns/references/pr-from-platform.md を参照してください。

ステップ 10：Webhook とテレメトリーの設定

セッションイベントを HQ または独自の API にストリーミングするよう設定します。チャネルは 1 つあり、HMAC 署名付きの http-sink（バッチ処理、バックオフ付き再試行、サーキットブレーカー）です。.claude/orchestration/config.json に webhookUrl が設定され、起動するシェルで ORCHESTKIT_HOOK_TOKEN がエクスポートされている場合に有効になります。イベントごとのネイティブ HTTP フック生成機能（チャネル 1）は #3867 で削除されました。settings.local.json に type: "http" のエントリーを書き込むものはありません。

AskUserQuestion(questions=[{
  "question": "Set up session telemetry?",
  "header": "Telemetry",
  "options": [
    {"label": "Stream to a webhook", "description": "Analytics events and SessionEnd summaries POST to your endpoint via the HMAC-signed http-sink"},
    {"label": "Skip", "description": "No telemetry, hooks run locally only"}
  ],
  "multiSelect": false
}])

「Webhook にストリーミング」を選んだ場合

1. Webhook URL をプレーンテキストで尋ねます。AskUserQuestion は少なくとも 2 つの選択肢が必要で（CC スキーマの minItems: 2）、自由形式の URL を受け取れないため、直接質問してください。

   Webhook エンドポイントの URL を教えてください。完全な URL で回答してください（例：https://api.example.com/hooks）。

2. orchestration config に webhookUrl を保存します。

# File: .claude/orchestration/config.json
saveConfig({ webhookUrl: "<webhook-url>" })

3. 認証トークンを設定するようユーザーに伝えます。

Set ORCHESTKIT_HOOK_TOKEN in your environment (never in config files):
  export ORCHESTKIT_HOOK_TOKEN=your-secret

チャネルの履歴と CC の URL 検証制約については、Read("references/http-hooks.md") を読み込んでください。

ステップ 11：プレビューと保存

ヒント（CC 2.1.69 以降）： 設定の変更を保存した後、/reload-plugins を実行すると、セッションを再起動せずに変更を有効化できます。

ヒント（CC 2.1.152 以降）： スキルディレクトリ（個人用の ~/.claude/skills/ またはプロジェクトの .claude/skills/ — プラグインに同梱されたものを除く）でスキルを編集または追加した場合、/reload-skills を実行すると、同じセッション内で再スキャンして反映できます。SessionStart フックも reloadSkills: true を返すことで同じ処理を実行できます。

保存先：~/.claude/plugins/orchestkit/config.json

{
  "version": "1.0.0",
  "preset": "complete",
  "skills": { "ai_ml": true, "backend": true, ... },
  "agents": { "product": true, "technical": true },
  "hooks": { "safety": true, "productivity": true, ... },
  "mcps": { "context7": false, ... }
}

オペレーター範囲の設定

一部の制御は、プラグインに含めることができません。プラグインに同梱された settings.json が設定できるのは agent と subagentStatusLine のみです。それ以外はすべて通知なく除去されるため、sandbox や permissions.deny などが有効になるのは、オペレーター自身の ~/.claude/settings.json 内だけです。ork は以前、完全な sandbox ブロックを宣言していましたが（a93ccb735、#3357 で削除）、存在していた期間を通じて機能していませんでした。

ork:doctor のチェック 16 で、この設定がないことを検出します。コピーしてすぐ使える JSON はこちらにあります：

Read("references/operator-scope-settings.md")

このリファレンスでは、すべてを一度に適用するのではなく、#3424 に沿って段階的に導入します：

段階	内容	適用するタイミング
1 LOOSE	sandbox.enabled、19 ホストの情報流出拒否リスト、認証情報ファイルと環境変数の拒否設定、op * / docker * / ssh * 用の excludedCommands 例外（ワイルドカード形式 — コマンド名だけの場合、引数のないコマンドにしか一致しません）、ネットワーク許可リストなし	最初に、通常稼働中のマシンで
2 STRICT	strictAllowlist: true を指定した network.allowedDomains を追加	ステージ 1 を数日間問題なく運用した後に限る

ステージ 1 から始めてください。 ステージ 2 では、リストにないすべてのホストがプロンプトなしで拒否され、まず api.github.com、ローカルホストの開発用 URL、テレメトリの取り込み先で問題が発生します。リファレンスには、想定される問題の発生順序と、行ごとのロールバック方法が記載されています。

このスキルは、オペレーターの設定ファイルを書き換えることはありません。サンドボックスを有効にするかどうかはオペレーターの判断であり、ロールバックはキーを 1 つ削除するだけです。

VSCode：リモートコントロール（CC 2.1.79 以降）

VSCode ユーザーは /remote-control を実行して、ターミナルセッションを claude.ai/code に接続できます。これにより、ブラウザーやスマートフォンから同じセッションを続けられます。デスクを離れている間に、長時間実行される設定作業やエージェントのタスクを監視するのに便利です。

関連スキル

• ork:doctor：設定の問題を診断します

リファレンス

Read("references/<file>") で必要に応じて読み込みます：

ファイル	内容
references/presets.md	プリセットの定義
references/mcp-config.md	MCP の設定
references/http-hooks.md	CC 2.1.63 以降の可観測性フック（Langfuse、Datadog、カスタムエンドポイント）
references/operator-scope-settings.md	~/.claude/settings.json 用の段階的な sandbox + permissions.deny JSON（#3424）
references/cc-version-settings.md	CC 2.1.7、2.1.20、2.1.23、2.1.79 固有の設定