> ## Documentation Index > Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # 動的ワークフローで大規模にサブエージェントをオーケストレーションする > 動的ワークフローは、Claude が作成したスクリプトから多くのサブエージェントをオーケストレーションし、再実行できます。コードベース監査、大規模マイグレーション、相互検証研究に使用します。 {/* plan-availability: feature=workflows plans=pro,max,team,enterprise providers=all */} 動的ワークフローは Claude Code v2.1.154 以降が必要で、すべての有料プランで利用可能です。Anthropic API アクセス、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry で利用できます。Pro では、`/config` の Dynamic workflows 行からオンにしてください。 動的ワークフローは、[サブエージェント](/ja/sub-agents)を大規模にオーケストレーションする JavaScript スクリプトです。Claude は説明したタスク用のスクリプトを作成し、ランタイムはバックグラウンドで実行しながら、セッションは応答性を保ちます。 1 つの会話が調整できるより多くのエージェントが必要なタスク、またはオーケストレーションを読み直して再実行できるスクリプトとしてコード化したい場合にワークフローを使用します。例としては、コードベース全体のバグスイープ、500 ファイルのマイグレーション、複数のソースに対して相互検証が必要な研究質問、1 つにコミットする前に複数の独立した角度から下書きする価値のある難しい計画があります。

ワークフローを使用するタイミング

[サブエージェント](/ja/sub-agents)、[スキル](/ja/skills)、[エージェントチーム](/ja/agent-teams)、およびワークフローはすべてマルチステップタスクを実行できます。違いは、計画を保持する者です。 | | サブエージェント | スキル | エージェントチーム | ワークフロー | | :--------------- | :------------------ | :------------------ | :-------------------- | :----------------- | | それは何か | Claude が生成するワーカー | Claude が従う指示 | ピアセッションを監督するリードエージェント | ランタイムが実行するスクリプト | | 次に何が実行されるかを決定する者 | Claude、ターンごと | Claude、プロンプトに従う | リードエージェント、ターンごと | スクリプト | | 中間結果が存在する場所 | Claude のコンテキストウィンドウ | Claude のコンテキストウィンドウ | 共有タスクリスト | スクリプト変数 | | 繰り返し可能なもの | ワーカー定義 | 指示 | チーム定義 | オーケストレーション自体 | | スケール | ターンごとに委任されたいくつかのタスク | サブエージェントと同じ | 長時間実行される少数のピア | 実行ごとに数十から数百のエージェント | | 中断 | ターンを再開始 | ターンを再開始 | チームメイトは実行を続ける | 同じセッション内で再開可能 | ワークフローは計画をコードに移動します。サブエージェント、スキル、およびエージェントチームでは、Claude がオーケストレーターです。ターンごとに次に何を生成または割り当てるかを決定し、すべての結果は Claude のコンテキストウィンドウに入ります。ワークフロースクリプトはループ、分岐、および中間結果自体を保持するため、Claude のコンテキストは最終的な答えのみを保持します。 計画をコードに移動することで、ワークフローは単に複数のエージェントを実行するだけでなく、繰り返し可能な品質パターンを適用することもできます。独立したエージェントが相互に対立的にレビューしてから報告されるようにすることも、複数の角度から計画を下書きして相互に比較することもできるため、単一パスより信頼性の高い結果が得られます。

バンドルされたワークフローを実行する

最速の方法でワークフローの動作を確認するには、Claude Code に含まれている組み込みワークフロー `/deep-research` を実行します。これは[バンドルされたワークフロー](#bundled-workflows)で、多くのソースにわたって質問を調査するためのものです。セッションが無料のままで、ターンバイターンのトランスクリプトの代わりに 1 つのレポートを取得しながら、エージェントがバックグラウンドで一連のフェーズを処理するのを見ることができます。 調査したい質問で `/deep-research` を実行します。複数の角度にわたって Web 検索をファンアウトし、見つけたソースをフェッチして相互検証し、引用されたレポートを合成します。 ```text theme={null} /deep-research What changed in the Node.js permission model between v20 and v22? ``` Claude Code はワークフローを許可するかどうかを尋ねます。**Yes** を選択して続行します。正確なプロンプトはパーミッションモードによって異なります。[実行前に計画を承認する](#approve-the-plan-before-it-runs)でモードごとのオプションを参照してください。 実行がバックグラウンドで開始されます。`/workflows` を実行し、矢印キーを使用して実行を選択し、Enter キーを押して進捗ビューを開きます。 ```text theme={null} /workflows ``` ビューは各フェーズをエージェント数、トークン合計、経過時間とともに表示します。任意のフェーズにドリルダウンして、そのエージェントと各エージェントが見つけたものを確認します。[実行を監視する](#watch-the-run)で完全なコントロールセットを参照してください。 入力ボックスの下のタスクパネルからも監視できます。実行中は 1 行の進捗サマリーが表示されます。下矢印を押してフォーカスし、Enter キーを押して展開します。 実行が完了すると、レポートがセッションに表示されます。各クレームが由来するソースを引用し、相互検証を生き残らなかったクレームは既にフィルタリングされています。 {/* min-version: 2.1.196 */}v2.1.196 以降、検証エージェントがレート制限や API エラーの後など、クレームを確認できない場合、レポートはそのクレームを未検証として列挙し、反論されたものとしてカウントしません。 独自のタスク用にワークフローを実行するには、[Claude にワークフローを作成させ](#have-claude-write-a-workflow)、実行が必要なことを実行したら、[保存して](#save-the-workflow-for-reuse)独自のコマンドとして使用できます。

バンドルされたワークフロー

Claude Code には、組み込みワークフローとして `/deep-research` が含まれています。 | コマンド | 実行内容 | | :-------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/deep-research ` | 複数の角度にわたって質問に対する Web 検索をファンアウトし、見つけたソースをフェッチして相互検証し、各クレームに投票し、相互検証を生き残らなかったクレームがフィルタリングされた引用されたレポートを返します。[WebSearch ツール](/ja/tools-reference#websearch-tool-behavior)が利用可能である必要があります | [自分で保存](#save-the-workflow-for-reuse)したワークフローは同じ方法でコマンドになり、バンドルされたものと一緒に `/` オートコンプリートに表示されます。

実行を監視する

ワークフローはバックグラウンドで実行されるため、エージェントが作業している間、セッションは応答性を保ちます。任意の時点で `/workflows` を実行して、実行中および完了したワークフローをリストアップし、1 つを選択して進捗ビューを開きます。 ```text theme={null} /workflows ``` 進捗ビューは各フェーズをエージェント数、トークン合計、経過時間とともに表示します。フッターは各アクションのキーをリストアップします。 | キー | アクション | | :-------------- | :----------------------------------------------------------------------------- | | `↑` / `↓` | フェーズまたはエージェントを選択 | | `Enter` または `→` | 選択したフェーズにドリルダウンし、次にエージェントにドリルダウンしてプロンプト、最近のツール呼び出し、結果を読む | | `Esc` | 1 レベル戻る | | `j` / `k` | オーバーフローするときにエージェント詳細内でスクロール | | `f` | {/* min-version: 2.1.186 */}選択したフェーズのエージェントリストをステータスでフィルタリングします。もう一度押すとサイクルします | | `p` | 実行を一時停止または再開 | | `x` | 選択したエージェントを停止するか、フォーカスが実行にあるときにワークフロー全体を停止 | | `r` | 選択した実行中のエージェントを再開始 | | `s` | 実行のスクリプトを[保存](#save-the-workflow-for-reuse)してコマンドとして保存 |

Claude にワークフローを作成させる

Claude にワークフローを作成させるには 2 つの方法があります。 * [プロンプトでワークフローを要求](#ask-for-a-workflow-in-your-prompt)し、キーワード `ultracode` を含めるか、自分の言葉で要求して、Claude がタスク用のワークフローを作成します。 * [ultracode で Claude に決定させる](#let-claude-decide-with-ultracode)。`/effort ultracode` を設定し、Claude はセッション内のすべての実質的なタスク用にワークフローを計画します。 既に存在するワークフローコマンドを実行することもできます。[バンドルされたワークフロー](#bundled-workflows)（`/deep-research` など）、または[保存](#save-the-workflow-for-reuse)したワークフロー。

プロンプトでワークフローを要求する

セッションの努力レベルを変更せずに単一のタスクをワークフローとして実行するには、プロンプトにキーワード `ultracode` を含めます。「ワークフローを使用する」または「ワークフローを実行する」など、自分の言葉で要求することもできます。Claude は直接的な要求を同じオプトインとして扱います。v2.1.160 より前は、リテラルトリガーキーワードは `workflow` でした。自然言語リクエストは両方のバージョンで機能します。 ```text theme={null} ultracode: audit every API endpoint under src/routes/ for missing auth checks ``` Claude Code はキーワードをプロンプトでハイライトし、Claude はターンバイターンで処理する代わりにタスク用のワークフロースクリプトを作成します。意図しない場合は、macOS で `Option+W` または Windows と Linux で `Alt+W` を押してこのプロンプトのハイライトを無視するか、ハイライトされたキーワードの直後にカーソルがある状態でバックスペースを押します。キーワードがまったくトリガーされないようにするには、`/config` で Ultracode キーワードトリガーをオフにします。 実行が必要なことを実行した場合、その後[コマンドとして保存](#save-the-workflow-for-reuse)できます。 別の方法で構築されたオーケストレーター（サブエージェントプロンプトのフォルダーや、作業をファンアウトするスキルなど）が既にある場合は、Claude にそれを指し示し、同じことを行うワークフローを要求できます。

ultracode で Claude に決定させる

Ultracode は、`xhigh` [推論努力](/ja/model-config#adjust-effort-level)と自動ワークフローオーケストレーションを組み合わせた Claude Code 設定です。オンにすると、Claude は各実質的なタスク用にワークフローを計画し、あなたが要求するのを待ちません。 ```text theme={null} /effort ultracode ``` ultracode がオンの状態でセッションを開始するには、`claude --effort ultracode` で起動します。Claude Code v2.1.203 以降が必要です。 ultracode がオンの場合、Claude はタスクがワークフローを必要とするかどうかを決定します。単一のリクエストは複数のワークフローに変わる可能性があります。コードを理解するためのワークフロー、変更を加えるためのワークフロー、検証するためのワークフロー。これはセッション内のすべてのタスクに適用されるため、各リクエストはより多くのトークンを使用し、より低い努力レベルより長くかかります。 Ultracode は現在のセッション用に続き、新しいセッションを開始するときにリセットされます。ルーチンワークに戻るときは `/effort high` でドロップバックします。`xhigh` [努力](/ja/model-config#adjust-effort-level)をサポートするモデルで利用可能です。他のモデルでは、`/effort` メニューはそれを提供しません。

実行前に計画を承認する

CLI では、実行ごとのプロンプトは計画されたフェーズとこれらのオプションを表示します。 * **Yes, run it**: 実行を開始 * **Yes, and don't ask again for `` in ``**: 開始し、このプロジェクトからこのワークフロー用にこのプロンプトをスキップ * **View raw script**: 決定する前にスクリプトを読む * **No**: キャンセル `Ctrl+G` はエディターでスクリプトを開きます。`Tab` を使用すると、実行開始前にプロンプトを調整できます。 このプロンプトを表示するかどうかは、[権限モード](/ja/permission-modes)によって異なります。 | 権限モード | プロンプトが表示される場合 | | :---------------------------- | :--------------------------------------------------------------------------------- | | デフォルト、編集を受け入れ | すべての実行、そのワークフロー用に**Yes, and don't ask again** を選択していない限り | | 自動 | 最初の起動のみ。任意の **Yes** はユーザー設定に同意を記録し、後の起動はプロンプトなしで開始します。ultracode がオンの場合は完全にスキップされます | | 権限をバイパス、`claude -p`、Agent SDK | なし。実行は直ちに開始 | Desktop アプリでは、承認カードはワークフロー名、フェーズリスト、トークン使用量の注意を表示し、**Once**、**Always**、**Deny** アクションがあります。進捗ビューは Background tasks サイドペインに表示されます。 権限モードは上記の起動プロンプトのみを制御します。ワークフローが生成するサブエージェントは常に `acceptEdits` モードで実行され、セッションのモードに関係なく、[ツール許可リスト](/ja/settings#permission-settings)を継承します。ファイル編集は自動承認されます。 シェルコマンド、Web フェッチ、許可リストにない MCP ツールは、実行中にプロンプトを表示できます。長い実行でこれを回避するには、エージェントが必要とするコマンドを開始前に許可リストに追加します。 `claude -p` と Agent SDK では、プロンプトする人がいないため、ツール呼び出しは対話的な確認なしに設定されたパーミッションルールに従います。

再利用用にワークフローを保存する

Claude が繰り返すタスク用にワークフローを作成した場合、その実行のスクリプトをコマンドとして保存できます。すべてのブランチで実行するレビューなどのプロセスは、毎回同じオーケストレーションを実行します。 `/workflows` を実行し、保持したい実行を選択し、`s` を押します。保存ダイアログで、Tab は 2 つの保存場所を切り替えます。 * `.claude/workflows/` プロジェクト内。リポジトリをクローンする全員と共有 * `~/.claude/workflows/` ホームディレクトリ内。すべてのプロジェクトで利用可能、自分にのみ表示 Enter キーを押して保存します。ワークフローは、どちらかの場所から今後のセッションで `/` として実行されます。 複数の `.claude/` ディレクトリを持つモノレポでは、ワークフローをそれが適用されるパッケージの横に保持できます。v2.1.178 以降、プロジェクトの場所に保存すると、作業ディレクトリとリポジトリルートの間に既に存在する最も近い `.claude/workflows/` ディレクトリに書き込まれるか、まだ存在しない場合はリポジトリルートに書き込まれます。プロジェクトワークフローはその経路に沿ったすべての `.claude/workflows/` から読み込まれ、複数が同じ名前を定義する場合、Claude Code は作業ディレクトリに最も近いものを実行します。 プロジェクトワークフローと個人ワークフローが名前を共有する場合、プロジェクトワークフローが実行されます。

保存されたワークフローに入力を渡す

保存されたワークフローは、`args` パラメーターを通じて入力を受け入れることができます。スクリプトはそれを `args` という名前のグローバルとして読み取ります。これを使用して、スクリプトを実行するたびに編集する代わりに、呼び出し時に研究質問、ターゲットパスのリスト、または設定オブジェクトを提供します。 次のプロンプトは、問題番号のリストを使用して保存されたワークフローを実行します。 ```text theme={null} > Run /triage-issues on issues 1024, 1025, and 1030 ``` Claude はリストを構造化データとして渡すため、スクリプトは最初に解析することなく、`args` に対して配列とオブジェクトメソッドを直接呼び出すことができます。`args` が省略された場合、グローバルはスクリプト内で `undefined` です。

ワークフローの実行例プロンプト

ワークフローは、タスクが 1 つのエージェントがコンテキストに保持できるより大きい場合、または同じステップが多くのアイテムにわたって実行する必要がある場合に最適です。以下のプロンプトは一般的な形を示しています。それぞれは Claude にそのタスク用のワークフローを作成して実行するよう依頼します。スクリプト自体は作成しません。

同じ問題について多くのファイルを監査する

1 つのエージェントをファイルごとにファンアウトし、その後、検出結果を収集して検証します。 ```text theme={null} > use a workflow to audit every route handler under src/routes/ for missing authentication checks, and adversarially verify each finding before reporting it ```

チェックが合格するまで修正を続ける

チェッカーを実行し、失敗したものを修正し、合格するか進捗が止まるまで繰り返します。 ```text theme={null} > use a workflow to run npx tsc --noEmit and keep fixing the reported errors until the type check passes or two rounds in a row make no progress ```

多くのファイルを並列でマイグレーションする

マイグレーションするファイルを検出し、編集が競合しないように各ファイルを分離されたコピーで変換し、各結果を検証します。 ```text theme={null} > use a workflow to migrate every component under src/components/ from styled-components to Tailwind, working on each file in its own isolated copy ```

すべての変更されたファイルをレビューして 1 つのサマリーを作成する

ファイルごとにレビュアーを実行し、その後、すべての検出結果を 1 つのエージェントに渡して、それらをランク付けして重複排除します。 ```text theme={null} > use a workflow to review every file changed in this PR for correctness issues, then merge the per-file findings into one ranked summary ```

多くのソースにわたってトピックを研究する

チェンジログ、問題、ドキュメント全体でリーダーをファンアウトし、その後、合成します。バンドルされた `/deep-research` ワークフローはこれを実行します。より狭いバージョンを説明することもできます。 ```text theme={null} > use a workflow to research how our three competitors handle rate limiting: read their public docs and recent changelog entries in parallel, then compare the approaches ```

リストが成長を停止するまで問題を見つける

ラウンドで検索を続け、新しいラウンドが新しいものを見つけなくなったら停止します。 ```text theme={null} > use a workflow to find flaky tests in this repo: run the suite repeatedly, record which tests fail intermittently, and stop once two rounds in a row find nothing new ```

保存されたスクリプトの外観

[ワークフローを保存](#save-the-workflow-for-reuse)すると、`.claude/workflows/` のファイルは `meta` ブロックの後にサブエージェントをオーケストレーションするスクリプト本体を保持します。通常は編集する必要はありませんが、ここは小さいものの形なので、Claude が生成したものを認識できます。 ```javascript theme={null} export const meta = { name: 'audit-routes', description: 'Audit every route handler for missing auth checks', } const found = await agent('List every .ts file under src/routes/.', { schema: { type: 'object', required: ['files'], properties: { files: { type: 'array', items: { type: 'string' } } } }, }) const audits = await pipeline(found.files, file => agent(`Audit ${file} for missing authentication checks.`, { label: file }), ) return audits.filter(Boolean) ``` 本体は最上位の `await` を持つプレーン JavaScript です。`agent()` は 1 つのサブエージェントを生成し、`pipeline()` はリスト内の 1 つのアイテムごとに 1 つを実行します。スクリプトを手動で編集したい場合は、Claude に変更を説明するよう依頼するか、[Agent SDK リファレンス](/ja/agent-sdk/typescript)のワークフロー ツール エントリを参照して、オプションの完全なセットを確認してください。

ワークフローの実行方法

ワークフローランタイムは、会話から分離された隔離環境でスクリプトを実行します。中間結果は Claude のコンテキストに入る代わりにスクリプト変数に留まります。 すべての実行は、セッションディレクトリの `~/.claude/projects/` 配下のファイルにスクリプトを書き込みます。実行が開始されると Claude はパスを受け取るため、それを尋ねることができます。そのファイルを開いて、Claude が作成したオーケストレーションを読んだり、前回の実行のスクリプトと比較したり、編集して Claude に編集版から再起動するよう依頼したりできます。 ランタイムは実行が進むにつれて各エージェントの結果を追跡します。これが実行を[一時停止後に再開](#resume-after-a-pause)可能にする理由です。同じセッション内で。

動作と制限

ランタイムは以下の制約を適用します。 | 制約 | 理由 | | :-------------------------------------- | :-------------------------------------------------------------------- | | 実行中のユーザー入力なし | エージェントパーミッションプロンプトのみが実行を一時停止できます。ステージ間の署名のために、各ステージを独自のワークフローとして実行します | | ワークフロー自体からの直接ファイルシステムまたはシェルアクセスなし | エージェントは読み取り、書き込み、コマンドを実行します。スクリプトはエージェントを調整します | | 最大 16 個の同時エージェント、CPU コアが限定されたマシンではより少ない | ローカルリソース使用を制限 | | 実行ごとに合計 1,000 エージェント | 暴走ループを防止 |

実行を管理する

実行が開始されたら、`/workflows` ビューから、または入力ボックスの下のタスクパネルで進捗行を展開して管理します。

一時停止後に再開する

実行を停止した場合、再開できます。既に完了したエージェントはキャッシュされた結果を返し、残りはライブで実行されます。一時停止した実行を `/workflows` から再開するには、それを選択して `p` を押すか、Claude に同じスクリプトでワークフローを再起動するよう依頼します。 再開は同じ Claude Code セッション内で機能します。ワークフローが実行中に Claude Code を終了した場合、次のセッションはワークフローを新規に開始します。

コスト

ワークフローは多くのエージェントを生成するため、単一の実行は会話で同じタスクを処理するより意味のあるほど多くのトークンを使用できます。実行は他のセッションと同様にプランの使用量とレート制限にカウントされます。 大規模なタスクにコミットする前に支出を見積もるには、まず小さなスライスでワークフローを実行します。リポジトリ全体ではなく 1 つのディレクトリ、または広い質問ではなく狭い質問です。`/workflows` ビューは実行の進行に伴い各エージェントのトークン使用量を表示し、完了した作業を失うことなくいつでも実行を停止できます。ランタイムの[エージェント上限](#behavior-and-limits)は単一の実行が生成できるエージェント数を制限し、暴走スクリプトのコストを制限します。デフォルトですべての実行をより小さく保つには、`/config` で[サイズガイドラインを設定](#set-a-size-guideline)します。 Claude Code はまた、異常に大きくなった実行にフラグを立てます。ワークフローが 25 個を超えるエージェントをスケジュールするか、その予想トークン合計が 150 万を超える場合、入力ボックスの下のタスクパネルの進捗行に `Large workflow` 警告が表示されます。警告は [`/workflows`](#watch-the-run) を指し、そこで実行を停止できます。Claude Code v2.1.203 以降が必要です。 警告は参考情報です。実行を一時停止または制限しません。警告が表示されたときに 2 つの設定が変わります。 * [サイズガイドラインを設定](#set-a-size-guideline)した場合、ガイドラインのエージェント数が 25 エージェントのしきい値に置き換わります。 * [ultracode](#let-claude-decide-with-ultracode) がオンのセッションは警告を表示しません。ultracode をオンにすることで既に大規模な実行にオプトインしているためです。 ワークフロー内のすべてのエージェントは、スクリプトがステージを別のモデルにルーティングしない限り、セッションのモデルを使用します。モデルコストを制御するには： * 通常、ルーチンワーク用に小さいモデルに切り替える場合は、大規模な実行前に `/model` を確認 * タスクを説明するときに、最強のモデルが必要ないステージ用に小さいモデルを使用するよう Claude に依頼

サイズガイドラインを設定する

`/config` の Dynamic workflow size 設定は、Claude が作成するワークフローをデフォルトでより小さなスケールに保ちます。Claude Code は設定を Claude へのアドバイスとして送信するため、異なるスケールを要求するプロンプトはそれをオーバーライドします。Claude Code v2.1.202 以降が必要です。 各値は、Claude がスクリプトで目指すエージェント数を設定します。 | 値 | Claude に送信されるガイダンス | | :------------- | :------------------- | | `unrestricted` | ガイドラインなし。これがデフォルトです。 | | `small` | 5 未満のエージェントを目指します。 | | `medium` | 15 未満のエージェントを目指します。 | | `large` | 50 未満のエージェントを目指します。 | 変更は次のプロンプトで有効になります。[ランタイムエージェント上限](#behavior-and-limits)は設定に関係なく引き続き適用されます。

ワークフローをオフにする

ワークフローは CLI、Desktop アプリ、IDE 拡張機能、[非対話モード](/ja/headless)（`claude -p`）、[Agent SDK](/ja/agent-sdk/overview)で利用可能です。同じ無効化設定がすべてのサーフェスに適用されます。 自分用にワークフローをオフにするには： * `/config` で Dynamic workflows をオフに切り替え。セッション間で保持 * `~/.claude/settings.json` で `"disableWorkflows": true` を設定。セッション間で保持 * `CLAUDE_CODE_DISABLE_WORKFLOWS=1` を設定。起動時に読み取られるため、設定した場所に適用 組織全体のワークフローをオフにするには、[管理設定](/ja/server-managed-settings)で `"disableWorkflows": true` を設定するか、[Claude Code 管理設定](https://claude.ai/admin-settings/claude-code)ページのトグルを使用します。 ワークフローが無効化されている場合、バンドルされたワークフローコマンドは利用不可、`ultracode` キーワードは実行をトリガーしなくなり、`ultracode` は `/effort` メニューから削除されます。 * [エージェントを並列実行](/ja/agents)：サブエージェント、エージェントビュー、エージェントチーム、ワークフローを比較 * [カスタムサブエージェントを作成](/ja/sub-agents)：ワークフローがオーケストレーションするワーカープリミティブ * [コストを管理](/ja/costs)：マルチエージェント実行が使用制限にカウントされる方法