メインコンテンツまでスキップ

動的ワークフローと ultracode

上級
What you'll learn
  • プランを誰が握っているかで、ワークフローをサブエージェント・スキル・エージェントチームと見分ける
  • 同梱の /deep-research コマンドで 30 秒で実物を見る
  • 自分で始める 3 つの方法を知る：ultracode キーワード、/effort ultracode、保存したコマンド
  • 「はい」を押す前に、承認プロンプトが何から守ってくれているのかを把握する
  • スライスと許可リストでコストと無人実行を管理下に置く

動的ワークフローとは、サブエージェントを大規模にオーケストレーションする JavaScript スクリプトです。あなたはタスクを説明し、Claude がスクリプトを書き、ランタイムがそれをバックグラウンドで実行する一方で、あなたのセッションは応答可能なままです。通常のマルチステップタスクが Claude のコンテキストウィンドウ内でターンごとに進行するのに対し、ワークフローはプランをコードに移します — ループ、分岐、そしてすべての中間結果はスクリプト変数の中に存在するため、あなたのコンテキストには最終的な答えだけが残ります。

このたった一つの転換こそが、ワークフローを 1 回の実行で数十〜数百のエージェントにスケールさせるものです。通常の委任は数個で頭打ちになります。

ワークフローを選ぶべきとき​

Claude Code はマルチステップ作業を実行する 4 つの方法を提供します。本当の問いは誰がプランを握っているかです：

サブエージェントスキルエージェントチームワークフロー
何であるかClaude が起動するワーカーClaude が従う指示同格セッションを統括するリードランタイムが実行するスクリプト
次に何を実行するか決める者Claude、ターンごとにClaude、プロンプトに従ってリード、ターンごとにスクリプト
結果が存在する場所コンテキストウィンドウコンテキストウィンドウ共有タスクリストスクリプト変数
スケールターンごとに数個サブエージェントと同じ同格が一握り数十〜数百
中断時ターンを再開ターンを再開チームメイトは実行を継続セッション内で再開可能

タスクが1 つの会話で調整できる以上のエージェントを必要とするとき、あるいはオーケストレーションを読んで再実行できるスクリプトとしてコード化したいときにワークフローを使います。代表的なケース：

  • コードベース全体のバグ掃き出し — ファインダーをすべてのモジュールに展開し、報告される前に独立したエージェントが各発見を敵対的に検証する。
  • 500 ファイルの移行 — ファイルごとに 1 エージェント、それぞれ独自のワークツリーで、検証ステージ付き。
  • リサーチの問い — ソースを単に要約するのではなく、互いに相互チェックしなければならない場合。
  • 難しいプラン — いくつかの独立した角度から下書きし、コミットする前に互いに比較検討する価値がある場合。

最後の点が過小評価されがちなものです：ワークフローは再現可能な品質パターン（敵対的レビュー、複数角度の下書き、多数決による検証）を適用できるため、単なるエージェント数の増加にとどまらず、1 回のパスよりも信頼性の高い結果が得られます。

実物を最速で見る方法：/deep-research​

Claude Code には組み込みのワークフローが同梱されているので、このモデルを試すために自分で書く必要はありません。任意の問いで実行してみましょう：

1 つのコマンドでワークフローを試す

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

これはウェブ検索を複数の角度に展開し、ソースを取得して相互チェックし、各主張に投票し、相互チェックを生き残らなかった主張をフィルタリングした、引用付きのレポートを返します。プロンプトが出たら承認し、/workflows で動作を見守りましょう。（WebSearch ツールが利用可能である必要があります。）

自分で始める 3 つの方法​

1. 1 つのプロンプトで頼む。 キーワード ultracode を含めるか、ただ平易な言葉で頼みます（「ワークフローを使って」「ワークフローを実行して」）。Claude はセッションの努力レベルを変えずに、その単一のタスクのためにスクリプトを書きます：

1 つのタスクをワークフローとして実行する

ultracode: audit every API endpoint under src/routes/ for missing auth checks

キーワードは入力内でハイライトされます。そのつもりではなかった？ Option+W（macOS）または Alt+W（Windows/Linux）を押すと、そのプロンプトのハイライトを解除できます。

:::note キーワードの履歴 v2.1.160 より前では、リテラルのトリガーワードは workflow でした。一般的な単語「workflow」が実行を発火させないよう、ultracode に改名されました。自然言語のリクエスト（「run a workflow」）は両方のバージョンで機能します。 :::

2. Claude に判断させる — ultracode 努力。 セッションを ultracode に設定すると、Claude はすべての実質的なタスクについてワークフローをプランし、ワークフローが妥当かどうかを自身で判断します：

セッションの自動オーケストレーションをオンにする

/effort ultracode

Ultracode は xhigh の推論努力と自動オーケストレーションを組み合わせます。1 つのリクエストが連続したいくつものワークフローになることがあります — コードを理解する 1 つ、変更を加える 1 つ、それを検証する 1 つ。そのため各タスクはより多くのトークンを使い、より長くかかるので、ルーチンの作業では /effort high に戻しましょう。これは現在のセッションの間だけ持続します。

3. 保存済みまたは同梱のコマンドを実行する。 /deep-research、または保存した任意のワークフロー（下記）は、他のスラッシュコマンドと同様に / のオートコンプリートに表示されます。

実行前に承認する​

ワークフローは多くのエージェントを起動しうるため、CLI はプランされたフェーズを表示し、先に尋ねます：

  • はい、実行する — 実行を開始する
  • はい、[path] の [name] については今後尋ねない — 開始し、このプロジェクトのこのワークフローについてはプロンプトをスキップする
  • 生のスクリプトを表示（Ctrl+G でエディタで開く）— 決める前に読む
  • いいえ — キャンセル（Tab を押すと先にプロンプトを微調整できる）

プロンプトが出るかどうかは、あなたの権限モードによります：Default / accept-edits は毎回の実行でプロンプトを出します（そのワークフローについてオプトアウトしていない限り）。Auto は初回起動時のみプロンプトを出します。bypass / claude -p / Agent SDK は決してプロンプトを出さず、実行はただちに始まります。

:::warning サブエージェントはあなたのセッションのモードを継承しない あなたのセッションの権限モードが何であれ、ワークフローが起動するエージェントは常に acceptEdits で実行され、あなたのツール許可リストを継承します — ファイル編集は自動承認されます。あなたの許可リストにないシェルコマンド、ウェブフェッチ、MCP ツールは、依然として実行を一時停止してあなたにプロンプトを出すことがあります。長い無人実行では、停止してあなたを待つことがないよう、開始前にエージェントが必要とするコマンドを許可リストに追加しておきましょう。自律実行のハードニングを参照してください。 :::

実行がどう進むか​

ランタイムはスクリプトを隔離された環境で、あなたの会話とは別に実行します — 中間結果はスクリプト変数の中にとどまり、Claude のコンテキストに触れることは決してありません。スクリプト自体はファイルシステムやシェルへの直接アクセスを持ちません：エージェントが読み、書き、コマンドを実行し、スクリプトはそれらを調整するだけです。

すべての実行は、~/.claude/projects/ のセッションディレクトリ配下のファイルにスクリプトを書き出し、Claude はそのパスを取得します。そのため、Claude にスクリプトを尋ねたり、書かれたオーケストレーションを読んだり、前回の実行と差分を取ったり、編集して Claude に編集版から再起動するよう頼んだりできます。

ランタイムは、不正なスクリプトが暴走できないよう、いくつかの上限を強制します：

制約理由
実行中のユーザー入力なし（エージェントの権限プロンプトのみが一時停止させる）ステージ間のサインオフには、各ステージを独自のワークフローとして実行する
スクリプトはファイルシステム/シェルへの直接アクセスを持たないエージェントが作業を行い、スクリプトが調整する
同時実行は最大 16 エージェント（低コア数のマシンではより少ない）ローカルのリソース使用を制限する
1 回の実行あたり合計 1,000 エージェント暴走ループを防ぐ

実行を見守り、管理する​

/workflows を実行すると、実行中および完了した実行が一覧表示され、1 つを選択すると進捗ビューが開きます — 各フェーズにそのエージェント数、トークン合計、経過時間が表示されます。フェーズへ、次にエージェントへドリルインすると、そのプロンプト、最近のツール呼び出し、結果を読めます。主な操作：

キーアクション
↑ / ↓フェーズまたはエージェントを選択
Enter / →ドリルイン；Esc で戻る
fステータスでエージェントをフィルタ（v2.1.186+）
p実行を一時停止または再開
x選択中のエージェントを停止 — フォーカスが実行全体にあるときは実行全体を停止
r選択中の実行中エージェントを再起動
sこの実行のスクリプトをコマンドとして保存

入力ボックスの下のタスクパネルにも 1 行の進捗サマリーが表示されます。下矢印でフォーカスし、Enter で展開します。

再開： 実行を停止し、後で再開できます（p）— すでに完了したエージェントはキャッシュされた結果を返し、残りはライブで実行されます。再開は同じセッション内で機能します。実行中に Claude Code を終了すると、次のセッションは最初から開始します。

再利用のためにワークフローを保存する​

繰り返す何か — すべてのブランチで実行するレビュー — のために Claude が良いオーケストレーションを書いたら、/workflows で s を押してその実行のスクリプトを保存します。Tab で保存先を切り替えます：

  • プロジェクト内の .claude/workflows/ — リポジトリをクローンする全員と共有される
  • ホーム内の ~/.claude/workflows/ — どこでも利用でき、あなただけが見られる

その後、今後のセッションでは /[name] として実行されます。保存されたワークフローは args グローバルを介して入力を受け取れるので、スクリプトを編集する代わりに呼び出し時にパラメータ化できます：

> Run /triage-issues on issues 1024, 1025, and 1030

Claude はリストを構造化データとして渡すので、スクリプトは args に対して配列/オブジェクトのメソッドを直接呼び出します。

コストに注意する​

ワークフローは多くのエージェントを起動するため、1 回の実行は同じタスクを会話で行うよりもかなり多くのトークンを使うことがあり、プランの使用量とレート制限にカウントされます。2 つの習慣でこれを正気に保てます：

  • まずスライスする。 支出を見積もるために、まず 1 つのディレクトリ（リポジトリ全体ではなく）や絞り込んだ問いで実行します。/workflows はエージェントごとのトークン使用量をライブで表示し、完了した作業を失うことなくいつでも停止できます。
  • モデルを適正サイズにする。 スクリプトがあるステージを別の場所にルーティングしない限り、すべてのエージェントはあなたのセッションのモデルを使います。大規模な実行の前に /model を確認し、タスクを説明するときに、最も強力なものを必要としないステージにはより小さいモデルを使うよう Claude に頼みましょう。コストとレイテンシとモデルの選択を参照してください。

よくある間違い​

  • 実行中の人間の介在を期待する。 実行中の入力はありません。タスクがステージ間であなたのサインオフを必要とするなら、別々のワークフローに分割しましょう。
  • 無人実行で許可リストを忘れる。 長いワークフローは、エージェントが許可リストにないシェルコマンドにぶつかった瞬間に停止します。エージェントが必要とするものを事前に承認しておきましょう。
  • サブエージェントで十分なときにワークフローに手を伸ばす。 ターンごとに数個の委任タスクはサブエージェントの役目です。ワークフローがそのオーバーヘッドに見合うのは艦隊規模のとき、またはオーケストレーションを再実行可能なスクリプトとして保存したいときです。
  • ルーチンの編集のためにセッション中ずっと ultracode 努力を実行する。 それはすべてに対してワークフローをプランします — 難しい作業には素晴らしいが、1 行の修正には無駄です。/effort high に下げましょう。

理解度チェック

0/3
  1. ワークフローと、サブエージェント・スキル・エージェントチームとを決定づける違いは何ですか？
  2. 長い無人ワークフローを実行していて、エージェントが許可リストにないシェルコマンドを必要とします。何が起きますか？
  3. 大規模なワークフローにコミットする前に、そのコストを見積もる最も安価な方法はどれですか？
Key takeaways
  • ワークフローはプランをコードに移す — スクリプトがループと中間結果を保持するので、実行は数十〜数百のエージェントにスケールする。
  • /deep-research で即座に 1 つ試し、ultracode キーワード、/effort ultracode、または保存した /command で自分のものを始める。
  • 実行が多くのエージェントを起動しうるからこそ承認プロンプトが存在する — Default と accept-edits は毎回プロンプトを出し、Auto は 1 回、bypass とヘッドレスは決してプロンプトを出さない。
  • 起動されたエージェントはあなたの許可リストとともに acceptEdits で実行されるので、無人実行の前にそれらが必要とするコマンドを事前承認する。
  • ワークフローはかなり多くのトークンを消費する — まずスライスし、ステージごとにモデルを適正サイズにし、ルーチンの編集では ultracode 努力を /effort high に戻す。

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

/config で動的ワークフローをオフに切り替えるか、~/.claude/settings.json で "disableWorkflows": true を設定するか、CLAUDE_CODE_DISABLE_WORKFLOWS=1 環境変数を設定します。組織は管理設定で無効化できます。オフのとき、同梱のワークフローコマンドは消え、ultracode はもはや実行を発火させず、/effort メニューにも表示されなくなります。

次に​