Dynamic Workflows（動的ワークフロー）は、Claudeがサブエージェントを大規模にオーケストレーションするJavaScriptスクリプトを書き、専用のランタイムがバックグラウンドで実行する機能です。コードベース全体の監査、数百ファイル規模の移行、相互チェックが必要なリサーチなど、1回の会話では制御しきれない規模のタスクに向いています。

スポンサーリンク

なぜ「スクリプト」なのか

サブエージェント・スキル・エージェントチームは、いずれもClaude自身がターンごとに次の一手を判断する方式です。Dynamic Workflowsはこれと違い、計画そのものをコードに落とし込みます。ループ・分岐・中間結果がすべてスクリプトの変数として保持されるため、Claudeの会話コンテキストには最終的な結果だけが残ります。

計画をコード化することで、独立したエージェント同士に互いの結果を敵対的にレビューさせたり、複数の切り口から立案した計画同士を比較検討させたりといった、単純な物量ではない品質パターンも再現しやすくなります。

まず試す：バンドル済みワークフロー

最も手軽に体験できるのが、標準搭載の/deep-researchです。

/deep-research Node.jsのパーミッションモデルはv20からv22でどう変わったか

複数の切り口でWeb検索を展開し、見つけたソースを相互チェックしながら、出典付きのレポートを1本にまとめて返します。実行はバックグラウンドで進むため、セッションは自由に使い続けられます。

/workflows

フェーズごとのエージェント数・トークン消費量・経過時間を確認できます。個々のエージェントまでドリルダウンして、何をしていたかも見られます。

自分のタスクでワークフローを使う

プロンプトにultracodeというキーワードを含めるか、単に「ワークフローを使って」と自然文で頼めば、Claudeがそのタスク用のスクリプトを書きます。

ultracode: src/routes/ 以下の全APIエンドポイントを
認証チェック漏れがないか監査して

他の依頼パターン

実行前に計画を確認できる

CLIでは、実行前にフェーズ一覧と選択肢が表示されます。

• Yes, run it：実行を開始
• Yes, and don’t ask again：このプロジェクトのこのワークフローでは以後確認をスキップ
• View raw script：実行前にスクリプトの中身を確認
• No：キャンセル

Ctrl+Gでスクリプトをエディタで開くこともできます。この確認プロンプトが出るかどうかは権限モードによって変わり、Auto Modeでは初回起動時のみ確認され、以降は確認なしで実行されます。

再利用可能なコマンドとして保存する

うまくいったワークフローは、/workflowsから選んでsキーで保存できます。「毎回同じレビューを走らせたい」といった繰り返し作業を、以後は/<name>という自分のコマンドとして呼び出せるようになります。

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)

agent()が1体のサブエージェントを起動し、pipeline()がリストの各要素に対して1体ずつ起動します。保存先は、リポジトリで共有する.claude/workflows/と、自分だけが使う~/.claude/workflows/の2択です。

規模をコントロールする

/configの「Dynamic workflow size」設定で、Claudeが書くスクリプトの規模に目安を与えられます。

これはあくまで「助言」で、プロンプト側で明確に大規模な処理を求めていれば上書きされます。一方、ランタイム側の上限（同時実行16体、1回の実行あたり合計1,000体）は設定に関わらず常に適用されます。

コストの考え方

ワークフローは多数のエージェントを起動するため、同じタスクを会話ベースで進めるより意味のある差でトークン消費が増えることがあります。実行はプランの利用量・レート制限にそのままカウントされます。

利用条件

• Claude Code v2.1.154以降が必要
• すべての有料プラン、Anthropic API、Amazon Bedrock、Google Cloud Agent Platform（旧Vertex AI）、Microsoft Foundryで利用可能
• Proプランでは/configの「Dynamic workflows」の行から有効化が必要

オフにする方法

{
  "disableWorkflows": true
}

または環境変数CLAUDE_CODE_DISABLE_WORKFLOWS=1でも同様に無効化できます。組織全体でオフにしたい場合はmanaged settingsに同じ設定を配置します。

よくある質問

まとめ

1回の会話ではとても回しきれない規模のタスクに直面したら、まずは/deep-researchで仕組みを体感してから、自分のリファクタリングや監査タスクに応用してみてください。