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 Code v2.1.154 以降が必要で、すべての有料プランで利用可能です。Anthropic API アクセス、Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry で利用できます。Pro では、
/config の Dynamic workflows 行からオンにしてください。- ワークフローをサブエージェントまたはスキルの代わりに使用するタイミングを決定する
/deep-researchでバンドルされたワークフローを実行する- Claude にワークフローを作成させてタスク用に保存する
- ワークフローの実行方法を理解し、実行を管理する
ワークフローを使用するタイミング
サブエージェント、スキル、ワークフローはすべてマルチステップタスクを実行できます。違いは、計画を保持する者です。| サブエージェント | スキル | ワークフロー | |
|---|---|---|---|
| それは何か | Claude が生成するワーカー | Claude が従う指示 | ランタイムが実行するスクリプト |
| 次に何が実行されるかを決定する者 | Claude、ターンごと | Claude、プロンプトに従う | スクリプト |
| 中間結果が存在する場所 | Claude のコンテキストウィンドウ | Claude のコンテキストウィンドウ | スクリプト変数 |
| 繰り返し可能なもの | ワーカー定義 | 指示 | オーケストレーション自体 |
| スケール | ターンごとに委任されたいくつかのタスク | サブエージェントと同じ | 実行ごとに数十から数百のエージェント |
| 中断 | ターンを再開始 | ターンを再開始 | 同じセッション内で再開可能 |
バンドルされたワークフローを実行する
ワークフローの動作を確認する最速の方法は、Claude Code に含まれている組み込みワークフロー/deep-research を実行することです。これは多くのソースにわたって質問を調査するためのものです。セッションが無料のままで、ターンバイターンのトランスクリプトの代わりに 1 つのレポートを取得しながら、エージェントがバックグラウンドで一連のフェーズを処理するのを見ることができます。
ワークフローを実行する
調査したい質問で
/deep-research を実行します。複数の角度にわたって Web 検索をファンアウトし、見つけたソースをフェッチして相互検証し、引用されたレポートを合成します。ワークフローを許可する
Claude Code はワークフローを許可するかどうかを尋ねます。Yes を選択して続行します。正確なプロンプトはパーミッションモードによって異なります。実行前に計画を承認するでモードごとのオプションを参照してください。
進捗を監視する
実行がバックグラウンドで開始されます。ビューは各フェーズをエージェント数、トークン合計、経過時間とともに表示します。任意のフェーズにドリルダウンして、そのエージェントと各エージェントが見つけたものを確認します。実行を監視するで完全なコントロールセットを参照してください。入力ボックスの下のタスクパネルからも監視できます。実行中は 1 行の進捗サマリーが表示されます。下矢印を押してフォーカスし、Enter キーを押して展開します。
/workflows を実行し、矢印キーを使用して実行を選択し、Enter キーを押して進捗ビューを開きます。バンドルされたワークフロー
Claude Code には、組み込みワークフローとして/deep-research が含まれています。
| コマンド | 実行内容 |
|---|---|
/deep-research <question> | 複数の角度にわたって質問に対する Web 検索をファンアウトし、見つけたソースをフェッチして相互検証し、各クレームに投票し、相互検証を生き残らなかったクレームがフィルタリングされた引用されたレポートを返します。WebSearch ツールが利用可能である必要があります |
/ オートコンプリートに表示されます。
実行を監視する
ワークフローはバックグラウンドで実行されるため、エージェントが作業している間、セッションは応答性を保ちます。任意の時点で/workflows を実行して、実行中および完了したワークフローをリストアップし、1 つを選択して進捗ビューを開きます。
| キー | アクション |
|---|---|
↑ / ↓ | フェーズまたはエージェントを選択 |
Enter または → | 選択したフェーズにドリルダウンし、次にエージェントにドリルダウンしてプロンプト、最近のツール呼び出し、結果を読む |
Esc | 1 レベル戻る |
j / k | オーバーフローするときにエージェント詳細内でスクロール |
p | 実行を一時停止または再開 |
x | 選択したエージェントを停止するか、フォーカスが実行にあるときにワークフロー全体を停止 |
r | 選択した実行中のエージェントを再開始 |
s | 実行のスクリプトを保存してコマンドとして保存 |
Claude にワークフローを作成させる
Claude にワークフローを作成させるには 2 つの方法があります。- プロンプトでワークフローを要求し、単語
workflowを使用して、Claude がタスク用のワークフローを作成します。 - ultracode で Claude に決定させる。
/effort ultracodeを設定し、Claude はセッション内のすべての実質的なタスク用にワークフローを計画します。
/deep-research など）、または保存したワークフロー。
プロンプトでワークフローを要求する
セッションの努力レベルを変更せずに単一のタスクをワークフローとして実行するには、プロンプトの任意の場所に単語workflow を含めます。
alt+w を押してこのプロンプトでそれを無視します。
ultracode で Claude に決定させる
Ultracode は、xhigh 推論努力と自動ワークフローオーケストレーションを組み合わせた Claude Code 設定です。オンにすると、Claude は各実質的なタスク用にワークフローを計画し、待機しません。
/effort high でドロップバックします。xhigh 努力をサポートするモデルで利用可能です。他のモデルでは、/effort メニューはそれを提供しません。
実行前に計画を承認する
CLI では、実行ごとのプロンプトは計画されたフェーズとこれらのオプションを表示します。- Yes, run it: 実行を開始
- Yes, and don’t ask again for
<name>in<path>: 開始し、このプロジェクトからこのワークフロー用にこのプロンプトをスキップ - View raw script: 決定する前にスクリプトを読む
- No: キャンセル
Ctrl+G はエディターでスクリプトを開きます。Tab を使用すると、実行開始前にプロンプトを調整できます。
このプロンプトを表示するかどうかは、パーミッションモードによって異なります。
| パーミッションモード | プロンプトが表示される場合 |
|---|---|
| デフォルト、編集を受け入れ | すべての実行、そのワークフロー用にYes, and don’t ask again を選択していない限り |
| 自動 | 最初の起動のみ。任意の Yes はユーザー設定に同意を記録し、後の起動はプロンプトなしで開始します。ultracode がオンの場合は完全にスキップされます |
パーミッションをバイパス、claude -p、Agent SDK | なし。実行は直ちに開始 |
acceptEdits モードで実行され、セッションのモードに関係なく、ツール許可リストを継承します。ファイル編集は自動承認されます。
シェルコマンド、Web フェッチ、許可リストにない MCP ツールは、実行中にプロンプトを表示できます。長い実行でこれを回避するには、エージェントが必要とするコマンドを開始前に許可リストに追加します。
claude -p と Agent SDK では、プロンプトする人がいないため、ツール呼び出しは対話的な確認なしに設定されたパーミッションルールに従います。
再利用用にワークフローを保存する
Claude が繰り返すタスク用にワークフローを作成した場合、その実行のスクリプトをコマンドとして保存できます。すべてのブランチで実行するレビューなどのプロセスは、毎回同じオーケストレーションを実行します。/workflows を実行し、保持したい実行を選択し、s を押します。保存ダイアログで、Tab は 2 つの保存場所を切り替えます。
.claude/workflows/プロジェクト内。リポジトリをクローンする全員と共有~/.claude/workflows/ホームディレクトリ内。すべてのプロジェクトで利用可能、自分にのみ表示
/<name> として実行されます。
プロジェクトワークフローと個人ワークフローが名前を共有する場合、プロジェクトワークフローが実行されます。
ワークフローの実行方法
ワークフローランタイムは、会話から分離された隔離環境でスクリプトを実行します。中間結果は Claude のコンテキストに入る代わりにスクリプト変数に留まります。 ランタイムは実行が進むにつれて各エージェントの結果を追跡します。これが実行を一時停止後に再開可能にする理由です。同じセッション内で。動作と制限
ランタイムは以下の制約を適用します。| 制約 | 理由 |
|---|---|
| 実行中のユーザー入力なし | エージェントパーミッションプロンプトのみが実行を一時停止できます。ステージ間の署名のために、各ステージを独自のワークフローとして実行します |
| ワークフロー自体からの直接ファイルシステムまたはシェルアクセスなし | エージェントは読み取り、書き込み、コマンドを実行します。スクリプトはエージェントを調整します |
| 最大 16 個の同時エージェント、CPU コアが限定されたマシンではより少ない | ローカルリソース使用を制限 |
| 実行ごとに合計 1,000 エージェント | 暴走ループを防止 |
実行を管理する
実行が開始されたら、/workflows ビューから、または入力ボックスの下のタスクパネルで進捗行を展開して管理します。
一時停止後に再開する
実行を停止した場合、再開できます。既に完了したエージェントはキャッシュされた結果を返し、残りはライブで実行されます。一時停止した実行を/workflows から再開するには、それを選択して p を押すか、Claude に同じスクリプトでワークフローを再起動するよう依頼します。
再開は同じ Claude Code セッション内で機能します。ワークフローが実行中に Claude Code を終了した場合、次のセッションはワークフローを新規に開始します。
コスト
ワークフローは多くのエージェントを生成するため、単一の実行は会話で同じタスクを処理するより意味のあるほど多くのトークンを使用できます。実行は他のセッションと同様にプランの使用量とレート制限にカウントされます。/workflows からいつでも実行中のワークフローを停止でき、完了した作業を失うことはありません。
ワークフロー内のすべてのエージェントは、スクリプトがステージを別のモデルにルーティングしない限り、セッションのモデルを使用します。モデルコストを制御するには。
- 通常、ルーチンワーク用に小さいモデルに切り替える場合は、大規模な実行前に
/modelを確認 - タスクを説明するときに、最強のモデルが必要ないステージ用に小さいモデルを使用するよう Claude に依頼
ワークフローをオフにする
ワークフローは CLI、Desktop アプリ、IDE 拡張機能、非対話モード（claude -p）、Agent SDK で利用可能です。同じ無効化設定がすべてのサーフェスに適用されます。
自分用にワークフローをオフにするには。
/configで Dynamic workflows をオフに切り替え。セッション間で保持~/.claude/settings.jsonで"disableWorkflows": trueを設定。セッション間で保持CLAUDE_CODE_DISABLE_WORKFLOWS=1を設定。起動時に読み取られるため、設定した場所に適用
"disableWorkflows": true を設定するか、Claude Code 管理設定ページのトグルを使用します。
ワークフローが無効化されている場合、バンドルされたワークフローコマンドは利用不可、workflow キーワードは実行をトリガーしなくなり、ultracode は /effort メニューから削除されます。
関連リソース
- エージェントを並列実行。サブエージェント、エージェントビュー、エージェントチーム、ワークフローを比較
- カスタムサブエージェントを作成。ワークフローがオーケストレーションするワーカープリミティブ
- コストを管理。マルチエージェント実行が使用制限にカウントされる方法