Claude Code動的ワークフロー：公式ステップバイステップガイド

リリース内容

2026年5月28日、Claudeは Claude Codeにおける動的ワークフローを導入しました。公式のリリース投稿では、Claudeがオーケストレーションコードを記述し、作業を多数のサブエージェントに分散させ、結果を検証してから報告する、長時間実行される並列処理として説明されています。検証済みのClaudeDevsスレッドでは、製品の動作がより直接的に表現されており、プロンプト内で workflow という単語を使用することで開始できます。

このリリースの有益な解釈：ワークフローは単なるプロンプトテンプレートではありません。これは、コードベースの監査、サービス全体のバグ調査、大規模な移行、クロスチェックを伴うリサーチ、そして承認前に多角的なアプローチが必要な計画など、単一の会話ループでは収まりきらない作業のための、Claude Code内の新しいオーケストレーションパスです。

The workflow shape:

Your prompt
  -> Claude writes workflow JavaScript
  -> Runtime starts background phases
  -> Subagents investigate, edit, test, or review
  -> Results are cross-checked
  -> One coordinated answer returns to the session

定義

Claude Codeの動的ワークフローとは、Claudeがタスクに応じて記述するJavaScriptのオーケストレーションスクリプトであり、バックグラウンドで個別のランタイムが実行されます。エージェントが実際の読み取り、書き込み、シェル操作、調査、レビューを行います。スクリプトは実行を調整し、中間結果をメインのチャットコンテキストの外に保存します。

この違いこそが本機能のすべてです。通常のチャットでは、Claudeがターンごとに次の行動を決定し、すべての結果を会話内に収める必要があります。一方、ワークフローでは、計画、ループ、分岐、中間値がワークフローのスクリプト内で管理されます。メインセッションは応答性を維持し、調整された結果を受け取ります。

要件と利用可能性

運用の信頼できる情報源は Claude Code のワークフローに関するドキュメントです。それによると、動的ワークフローは現在リサーチプレビュー版であり、Claude Code v2.1.154 以降が必要で、有料プランおよびサポートされている API/プロバイダーのデプロイメントで利用可能です。ローンチブログおよび ClaudeDevs のスレッドには、Claude Code CLI、Desktop、VS Code、Claude API、Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry も記載されています。

# Check your version
claude --version

# Update if needed
claude update

# Inside Claude Code, open settings and confirm Dynamic workflows
/config

ローンチ当日の注意点として、ブログや X のスレッドでは Max、Team、Enterprise での利用が強調されていますが、ドキュメントでは現在、より具体的な有料プランの設定に関する注記が記載されており、Pro での有効化については以下に言及されています。 /config実際の設定については、ドキュメントページおよびアカウントの settings 画面に従ってください。

メンタルモデル：サブエージェント、スキル、ワークフロー

Claude Codeには、作業を並列化または再利用するための方法がすでにいくつか存在していました。Dynamic workflowsはサブエージェントの上位に位置します。これらはサブエージェントを利用しますが、その調整はスクリプト内で行われます。そのため、この機能は反復可能なファンアウトや検証パターンにおいて有用です。

1つか2つの独立した調査が必要な場合はサブエージェントを使用してください。ノウハウを再利用可能にすべき場合はスキルを使用してください。ファンアウト、結果の比較、失敗したエージェントの再起動、成功した実行の保存、そしてコマンドとしての再利用など、オーケストレーション自体を反復可能にする必要がある場合はワークフローを使用してください。

クイックスタート：組み込みワークフローを実行する

最速の安全なテストは、 /deep-researchClaude Codeでドキュメント化されているバンドル済みのワークフローです。これは複数の角度から検索を並列実行し、ソースを取得し、主張をクロスチェックした上で、引用付きのレポートを1つ返します。大規模な移行を試す前に、まずは使用感や挙動を確認できるよう、範囲を絞った質問から始めてください。

ステップ 1: プロジェクトで Claude Code を起動する

cd /path/to/your/project
claude

ステップ 2: スコープを絞ったリサーチワークフローを実行する

/deep-research What changed in the Node.js permission model between v20 and v22?

ステップ 3: ワークフローを承認する

Claude Code は実行前に計画されたワークフローを表示します。意図と一致している場合は、 Yes, run itを選択してください。生成されたオーケストレーションを確認したい場合は、 View raw scriptを選択してください。プロンプトが広すぎる場合は、キャンセルして範囲を絞り込んでください。

ステップ 4: 実行状況を監視する /workflows

/workflows

ワークフロービューには、フェーズ、エージェント数、トークン合計、経過時間が表示されます。各フェーズを掘り下げることで、各エージェントのプロンプト、最近のツール呼び出し、結果を確認できます。実行が完了すると、Claude は現在のセッションにレポートを挿入します。

プロンプト1つでカスタムワークフローを作成する

セッション全体を変更せずに独自のタスクをワークフローとして実行するには、プロンプト内のどこかに workflow という単語を含めてください。Claude Code がその単語をハイライトし、ワークフロー作成プロセスを通じてタスクをルーティングします。

Run a workflow to audit every API endpoint under src/routes for missing auth checks.

Scope:
- read-only first pass
- group findings by endpoint
- verify each finding with an independent reviewer agent
- return only confirmed issues
- do not edit files unless I approve a follow-up workflow

ドキュメントには小さな回避策が記載されています。Claude Code が workflowをハイライトしたものの、その機能をトリガーする意図がなかった場合は、 alt+w を押すことで、そのプロンプトでの実行を無視できます。

プロンプトパターン

Claudeに判断を委ねたい場合はUltracodeを使用する

ultracode は、通常のモデルの努力レベルではありません。モデル設定ドキュメントでは、Claude Codeのセッション設定として次のように定義されています。 xhigh reasoning effort を使用し、さらにClaudeが実質的なタスクに対して動的なワークフローをオーケストレーションします。

# Turn on automatic workflow orchestration for this session
/effort ultracode

# Return to normal high effort for routine work
/effort high

大規模、曖昧、または高リスクなタスク（移行、詳細な監査、設計のストレステスト、リポジトリ全体のクリーンアップなど）が中心となるセッションには、ultracodeを使用してください。日常的な編集作業でオンにしたままにしないでください。ワークフローのドキュメントによると、ultracodeはセッション内のすべての実質的なタスクに適用され、より多くのトークンを消費し、時間がかかり、新しいセッションを開始するとリセットされます。

承認フロー：実行前に必ず確認

CLIの承認プロンプトには計画されたフェーズが表示され、4つのアクションが提示されます。これは、実行によって大幅なトークン消費が発生したり、エージェントを通じてファイル編集が承認されたりする前の、最後のチェックポイントとして扱ってください。

キーボードに関する2つの詳細が重要です。 Ctrl+G 生成されたスクリプトをエディタで開きます。 Tab 実行開始前にプロンプトを調整できます。デスクトップ版では、同じ決定が以下の承認カードとして表示されます。 1回のみ、 常に、および 拒否 アクション。

ワークフローをスラッシュコマンドとして保存

ワークフローが繰り返し可能な有用なプロセスを生み出した場合、それを保存します。保存されたワークフローはスラッシュコマンドとなり、 / 組み込みコマンドと同様にオートコンプリートに表示されます。

/workflows

# Select the completed run
# Press s
# Choose project or user location
# Press Enter to save

# Later:
/api-auth-audit

プロジェクトワークフローと個人ワークフローで名前が重複した場合、プロジェクトワークフローが優先されます。これはチームの一貫性を保つための適切なデフォルト設定ですが、ワークフロー名には具体的な名前を付ける必要があることを意味します。

実行の監視、一時停止、再開、再起動、停止

ワークフローはバックグラウンドで実行されます。 /workflows を使用して実行中および完了した実行内容を確認し、フッターに表示されるキーを使用してください。入力欄の下にあるタスクパネルでは、実行中に1行の進捗サマリーも表示されます。

再開（Resume）はセッション単位で管理されます。実行を一時停止または停止した場合、完了済みのエージェントはキャッシュされた結果を返すことができ、残りのエージェントは同じ Claude Code セッション内で再開した際にライブで実行されます。ワークフローの実行中に Claude Code を終了した場合、次のセッションではワークフローは最初から開始されます。

ランタイムの動作と制限

ワークフローのランタイムは会話から分離されています。ワークフローのスクリプトはエージェントを調整し、エージェントがファイル、シェル、Web、および MCP の作業を実行します。ドキュメントには具体的な制限が記載されており、ユーザーはリソース使用量を把握できます。

コストと使用量の管理

ドキュメントおよび ClaudeDevs のスレッドでは、ワークフローが通常の Claude Code の会話よりもはるかに多くの使用量を消費する可能性があると警告されています。ワークフローは多数のエージェントを開始する可能性があり、スクリプトが特定のフェーズを別のモデルにルーティングしない限り、各エージェントはセッションのモデルを使用します。

# Before a large workflow
/model
/usage

# In your prompt
Use a smaller model for indexing and low-risk classification phases.
Use the strongest model only for final verification and architectural judgment.

• モノレポ全体ではなく、範囲を限定した実行から始めてください。
• 確認（Check） /model 高コストな作業を開始する前に。
• 使用（Use） /usage 現在のセッションの使用量とプランの制限への影響を確認するために。
• 低リスクのステージについては、適切なタイミングでClaudeに小規模なモデルへルーティングするよう指示してください。
• 暴走やスコープ外の実行を停止するには、 /workflows.
• ほとんどのタスクでワークフローのオーケストレーションが必要となるセッションには、ultracodeを使用してください。

権限と安全に関する詳細

権限モードはワークフローの開始プロンプトを制御しますが、すべてのサブエージェントの動作がメインのターンと同じように機能するわけではありません。ドキュメントによると、ワークフローのサブエージェントは acceptEdits モードで実行され、ユーザーのツール許可リストを継承します。ファイルの編集は自動的に承認されます。シェルコマンド、Webフェッチ、および許可リスト外のMCPツールについては、実行中にプロンプトが表示される場合があります。

高リスクな作業では、2段階のパターンを使用してください。最初のワークフローで確認済みの調査結果のみを出力し、2番目のワークフローで承認された変更を適用します。これは、ワークフローが実行中に任意のユーザー入力を受け付けないというドキュメントの記述と一致します。

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

動的ワークフローは、ユーザー単位または組織単位で無効化できます。無効にすると、 workflow キーワードは実行を ultracode は /effortメニューから削除されます。

# Option 1: interactive setting
/config
# Toggle Dynamic workflows off

# Option 2: user settings
{
  "disableWorkflows": true
}

# Option 3: environment variable, read at startup
CLAUDE_CODE_DISABLE_WORKFLOWS=1 claude

組織の管理者は、管理された "disableWorkflows": true 設定で

活用できるワークフローの例

Anthropicのローンチ投稿では、初期のワークフローのユースケースとして、コードベース全体のバグ調査、プロファイラー主導の最適化、セキュリティ監査、移行、モダナイゼーション作業、および重要なタスクのダブルチェックが挙げられています。また、同投稿ではBunのZigからRustへの移植が大規模な例として引用されていますが、公開時点では本番環境ではなかったという注意書きが添えられています。

例1：API認証の監査

Run a workflow to audit src/routes and src/api for missing authentication checks.

Rules:
- read files only
- group endpoints by auth pattern
- have one agent find issues and another verify them
- exclude test fixtures and generated files
- return confirmed findings with file paths and suggested fixes

例2：編集前の移行計画

Run a workflow to plan the migration from the old payments client to the new billing SDK.

Do not edit files.
Map every call site, classify risk, propose phases, and have reviewer agents challenge the plan.
Return a phased migration plan with test commands for each phase.

例3：クロスチェックされたリサーチ

/deep-research Compare the official migration paths for React 19 Server Actions and Next.js 16 forms.

Focus on official docs.
Return only claims that are supported by source links.

例4：チームレビューコマンドの保存

Run a workflow to review this branch for correctness bugs.

Scope:
- current git diff only
- no style-only feedback
- verify each finding against code
- include test commands that would catch the bug

# After the run succeeds:
/workflows
# press s and save to .claude/workflows/branch-correctness-review

よくある間違い

起動チェックリスト

• Confirm claude --version が少なくとも v2.1.154であることを確認してください。
• Open /config を開き、Dynamic workflowsが有効になっていることを確認してください。
• 小規模な実行を行う /deep-research コード編集前のワークフロー。
• Use /workflows を使用して、フェーズ、トークン合計、およびエージェントの出力を確認します。
• カスタムワークフローの場合は、パススコープ、出力形式、検証ルール、および編集ポリシーを含めてください。
• Use /effort ultracode は、ほとんどのタスクでその必要性が認められるセッションでのみ使用してください。
• 繰り返し実行可能なワークフローは、チームコマンド用に .claude/workflows/ に保存してください。
• Use /usage、 /model、および小規模モデルのルーティングを使用して、コストを管理してください。
• ポリシーで必要な場合は、 /config、設定、環境変数、または管理設定を通じてワークフローを無効化してください。

FAQ

用語集

公式ソース

この投稿では、Claude、Claude Code、Anthropic所有、および検証済みのClaudeDevsの公式ソースのみを意図的に使用しています。

• Claudeブログ: Claude Codeにおける動的ワークフローの導入
• Claude Codeドキュメント: 動的ワークフローによるサブエージェントの大規模なオーケストレーション
• ClaudeDevs公式Xスレッド: 動的ワークフローのローンチ
• Claude Codeドキュメント: コマンド
• Claude Code ドキュメント: エージェントを並列実行する
• Claude Code ドキュメント: モデル設定とエフォートレベル
• Claude Code ドキュメント: 設定
• Claude Code ドキュメント: コストを効率的に管理する
• Claude Code ドキュメント: クイックスタート

関連情報: Opus 4.8 公式リリースの詳細 および Opus 4.8 API 移行ガイド。