Claude CodeのUltracode 2026：コマンド1つで有効にする方法

サービスの使い方については、Ailootのドキュメントをご覧ください。

Ultracodeとは何か、誰に必要か#

2026年5月28日まで、Claude Codeには/effortパラメーターしかなく、レベルはlow / medium / high / xhighでした。これはモデルの「思考」のレベルです。高くするほど推論に使うトークンが増え、結果の精度が上がり、Claudeの応答に時間がかかります。

Ultracodeは/effort low → xhighの尺度には当てはまりません。これらと並ぶ別の設定です。有効にすると、Claudeはタスクの規模を自動で見て、「このタスクは30の並列エージェントに分割し、結果をまとめたほうがよい」と判断します。以前は独自のワークフローを書くか、サブエージェントのコマンドを組み立てて、手動で行う必要がありました。今では、必要に応じてClaudeが自ら判断します。

主な対象は、単一のプロンプトでは限界があると感じている人です。たとえば、次のような場合です。

• 200ファイルあるリポジトリで/code-reviewを実行したら、50ファイル目でセッションが止まった
• 「非推奨APIを使っている箇所をすべて見つけて」と頼んだのに、Claudeが3か所だけ挙げ、さらに15か所を見落とした
• 回答する前に、Claude自身の仮説を3つの観点から検証してほしい

そんな人にはUltracodeが向いています。関数を1つ書いて解決策を1つ得たいだけなら、必要ありません。通常の/effort highで十分で、トークンの消費も3分の1です。

Ultracodeと通常のlow / medium / high / xhighの違い#

要点を比較します。

一言で言えば、/effort xhighは「じっくり考える」、Ultracodeは「じっくり考え、1つのプロンプトで対応できるか、30人のチームが必要かも自分で判断する」という意味です。つまりUltracodeは、xhighの上に自動オーケストレーションという層を加えます。

Anthropicは公式ドキュメントで、次のように明記しています。

つまり、あなたの1つのリクエストから、「コードの理解」「変更」「検証」の3つのワークフローが順番に実行されることがあります。それぞれが10～30の並列エージェントを起動できます。

Ultracodeに対応するバージョンとモデル#

バージョンを確認します。

claude --version

2.1.154より古い場合は更新します。

npm install -g @anthropic-ai/claude-code

次に、effortレベルの一覧を確認します。

claude /effort

ドロップダウンにultracodeが表示されれば準備完了です。表示されない場合、主な原因は次のとおりです。

• 現在のモデルがOpus 4.8ではない（たとえばSonnet 4.7はxhighに対応していない）
• Proを使っていて、/configでモードが無効になっている（「Dynamic workflows」オプションを有効にしてください）
• 組織の管理者が管理対象の設定でワークフローを無効にしている

モデルを確認します。

claude /model

デフォルトのモデルがOpus 4.8でなければ切り替えます。モデルメニューからOpus 4.8を選ぶか、dキーでデフォルトに設定します。

Ultracodeを有効にする2つの方法#

方法1. セッション全体で有効にする。

Claude Codeのセッションで、次を実行します。

/effort ultracode

以降、実質的なタスクごとにワークフローを起動するかどうかを、Claudeが自分で判断します。セッションは閉じるまで続きます。Claude Codeを閉じて再度開くと、Ultracodeはリセットされます。これは意図的な仕様です。「デフォルトで」有効にするのではなく、このモードを使うときに意識して有効にするためです。

方法2. 1つのタスクだけで使う。

プロンプトの冒頭にultracodeと入力します（v2.1.160より前はキーワードがworkflowでしたが、通常の実行との混同を避けるため、リリース後にAnthropicがトリガーを変更しました）。

ultracode: go through all /api/* endpoints in src/routes/ and find where authorization checks are missing

Claude Codeはultracodeという単語を強調表示し、このタスクをワークフローとして起動します。セッションのeffortレベル（設定したhighまたはmedium）は変わりません。

Anthropicはこちらで、自然な言葉でも同じように指示できると説明しています。

誤ってultracodeと入力し、ワークフローを起動するつもりがなかった場合は、カーソルを強調表示された単語の直後に置き、Option+W（macOS）またはAlt+W（Windows/Linux）を押します。強調表示が消え、タスクは通常どおり進みます。

有効にするとClaudeの作業はどう変わるか#

Ultracodeを使わない場合：プロンプトを書くと、Claudeは30秒考えて応答します。タスクが大きいと、途中の結果でコンテキストが埋まり、セッションの終わりにはすべてが「ずれて」いきます。

Ultracodeを使う場合：プロンプトを書くと、Claudeが規模を見てスクリプトを書きます。スクリプトは隔離された環境で実行され、途中の結果はセッションのコンテキストではなく、スクリプトの変数に保持されます。あなたに返されるのは最終回答だけです。

実際には、次の3つの効果があります。

1. セッションのコンテキストが埋まりません。 /compactを使わずに、より長く作業できます。
2. 並列化できます。 1回の実行で、同時に最大16のエージェントを起動できます（CPU性能が低いマシンでは少なくなります）。実行全体では、合計1000エージェントまでです。
3. 結果が自動で検証されます。 Claudeは、あるエージェントに解決策を書かせ、別のエージェントに批判的なレビューを依頼できます。複雑なタスクでの幻覚を減らせます。

実行中の様子を確認するには、次のコマンドを使います。

/workflows

実行中と完了済みのワークフローの一覧が開きます。矢印キーで選択してEnterを押すと、各フェーズの詳細を確認できます。エージェント、それぞれのトークン使用量、実行時間が表示されます。pで一時停止、xで停止、rでエージェントを再起動します。

Ultracodeを有効にする場合、しない場合#

Ultracodeが適している状況は、次の3つです。

1. 大規模なコードベースを監査する。 たとえば、「プロジェクト内でパスワードをログに書き込んでいる場所をすべて見つけて」といったタスクです。小規模なリポジトリなら1つのプロンプトで対応できます。500ファイルのリポジトリでは、1つのClaudeだと半分を忘れる一方、ワークフローなら20のエージェントを並列で起動し、それぞれが25ファイルを担当します。

2. 多数のファイルに及ぶ移行をする。 非推奨APIの置き換え、ライブラリの切り替え、プロジェクト全体にわたるパターンのリファクタリングなどです。ワークフローなら、10ファイルずつ処理して、バッチごとに自動で確認できます。

3. 複数の情報源を比較する必要がある調査をする。 Anthropicはこれを/deep-researchワークフローとして提供しています。質問を複数の観点に分け、情報源を探し、事実を相互確認し、裏付けられないものを除外します。AIコーディング市場のデータ収集に使ったところ、手作業で1時間かけるより良いレポートが得られました。

Ultracodeを使うとトークンが無駄になる状況は、次の3つです。

1. 関数1つのバグを修正する。 通常の/effort highプロンプトなら、コストは10分の1で済みます。こうした作業にワークフローを起動しないでください。

2. 関数またはコンポーネントを1つ新しく作る。 同様に、/effort high、あるいはmediumでも十分です。複雑さはエージェントの数に応じて増えるのではなく、推論の深さに応じて増えます。オーケストレーションなしでも、xhighだけで深い推論ができます。

3. すぐに答えがほしい。 ワークフローは、定義上、通常のプロンプトより時間がかかります。エージェントを並列にしても、調整に時間を使うからです。「今すぐ、同じ1分のうちに」必要なら、有効にしないでください。

ここで説明した例の方針は、日常的な編集ではデフォルトとして/effort highを使うことです。Ultracodeは、セッション全体ではなく、プロンプトにその単語を入れて特定のタスクにだけ使います。有効にしたまま解除し忘れると、その後の日常的な作業でもUltracodeが動作し、不要なトークンを消費するためです。

トークン数と費用の目安#

概算してみましょう。Opus 4.8で通常のプロンプトをeffort highにして使うと、推論に約5,000～15,000トークンを消費し、さらにモデルの回答分が加わります。適度な規模のタスクでは、合計50,000～100,000トークンほどになります。

20エージェントのワークフローは、並列で動く20個のプロンプトを意味します。それぞれが独自のシステムプロンプトのコンテキスト（約5～10K）、推論（xhighで10～30K）、回答を持ちます。1回の実行でおよそ600,000～150万トークンと見積もられます。通常のプロンプト1回と比べて10～30倍のコストです。

費用に換算すると、次のようになります。

• Pro（月額$20）： 2026年2月、Anthropicはプログラムによるアクセスを禁止する方針を明確にし、2026年6月15日にはワークフローのクレジットをチャットのサブスクリプションから分離しました。Proではプログラムによる処理に$20のクレジットが付与されます。大規模なワークフロー1回でその半分を消費します。クレジットがなくなると、超過料金を有効にするまでワークフローは起動しなくなります。
• Max 5x（月額$100）： クレジットは$100です。大規模なワークフローを月に5～10回実行できます。
• Max 20x（月額$200）： クレジットは$200です。
• Team（1メンバーあたり$30/$150）： クレジットは各メンバーのサブスクリプションプランに対応します。
• API： トークン単価に応じて支払います。

Anthropic自身も、ワークフローを実行する前に費用を見積もるよう推奨しています。

つまり、まず1つのフォルダーでワークフローを実行し、/workflowsで費用を確認してから、リポジトリ全体で実行するか決めます。1回の実行では合計1000エージェントまでですが、大規模なリポジトリでは100エージェントでも数十万トークンを消費します。

使用量を「減らしたい」なら、ワークフロースクリプトで二次的な段階に小型モデルを明示的に割り当てられます。プロンプトでは、「ファイル分類の段階はSonnet 4.7を使い、最終分析だけOpus 4.8を使って」と指定します。Anthropicはこれに対応しています。

内部の仕組み：ワークフロー、/workflows、制限#

各実行では、~/.claude/projects/の下にあるファイルに専用のスクリプトが書き込まれます。実行が始まると、Claudeはスクリプトのパスを受け取ります。つまり、次の操作ができます。

• Claudeに「このワークフローのスクリプトを見せて」と頼む
• エディターで開き、ロジックを確認する
• 前回の実行と差分を取る
• 編集した版をClaudeに再実行させる

ランタイムには次の制限があります。

実行ごとに権限モードが適用されます。デフォルトでは、Claude Codeは毎回許可を求めます。「Yes, and don't ask again for <name> in <path>」を選ぶと、そのプロジェクトで該当するワークフローについて、以後は許可を求めなくなります。Autoモードでは、初回だけ許可を求め、その後はユーザー設定に承認を保存します。claude -pとAgent SDKでは、回答するユーザーがいないため、許可を求めません。

重要な点として、ワークフロー内のサブエージェントは常にacceptEditsモードで実行され、現在の権限モードにかかわらず、許可されたツールの一覧を引き継ぎます。ファイル編集は自動的に承認されます。重要なものを扱う場合は、この点に注意してください。

使えるワークフローをコマンドとして保存する方法#

例として、新しいブランチでUltracodeを使って/code-reviewを実行したとします。ワークフローは3回実行されました。最初はdiff全体を手早くレビューし、2回目はセキュリティ関数を詳しく確認し、3回目は変更された関数のテストを実行しました。結果はよく一致し、2つの問題が見つかりました。

今度は、マージ前にすべてのブランチで実行したいとします。次を開きます。

/workflows

完了済みの実行を選び、sを押します。ダイアログで保存先を選びます。プロジェクト内の.claude/workflows/（Gitに含まれ、チームで利用可能）または~/.claude/workflows/（個人用で、どのプロジェクトでも利用可能）です。たとえばpre-merge-reviewという名前を付け、Enterを押します。

これで、今後のどのセッションでも次を実行できます。

/pre-merge-review

ワークフローは、デバッグしたときと同じスクリプトで開始します。

ワークフローに引数が必要な場合は、保存時のプロンプトで説明します。するとスクリプトがグローバル変数argsを受け取ります。パスの一覧、課題番号、ファイルIDなど、必要な値を渡せます。

Anthropicはこちらで、引数が構造化データとして渡されると説明しています。

つまり、文字列を解析せずに、スクリプト内でargs.map(...)を直接使えます。チケット、フォルダー、エンドポイントの一覧を処理する一括タスクに便利です。

Ultracodeを無効にする方法と、その理由#

無効にする主な理由は、日常的な作業に戻ることです。大きなタスクにUltracodeを使い、終わったらすぐに通常の設定へ戻します。

/effort high

そうしないと、次の小さな編集もワークフローとして実行され、メリットがないままトークンを消費します。

キーワードを使うときだけ起動したいなら、Dynamic workflowsは有効のままにし、セッションは/effort highなど通常のeffortにします。選んだタスクにだけultracodeを付けてください。以下の全体無効化はキーワードも止めるため、この目的には使いません。セッション全体とキーワードの両方からの起動を禁止したい場合は、次の全体設定を使います。

# クライアント設定
# /config → Dynamic workflows → off
# または
# ~/.claude/settings.json
{
  "disableWorkflows": true
}

# または環境変数で設定
export CLAUDE_CODE_DISABLE_WORKFLOWS=1

無効にすると、プロンプト内のultracodeキーワードがワークフローを起動しなくなり、/effortメニューからultracodeの選択肢も消えます。「自動ワークフローを使わない」という共通ルールをチームで設けたい場合に便利です。その場合は、組織の管理対象設定で指定します。

私は/effort highをデフォルトにして、Ultracodeを必要なときだけ使います。「必要なときはきちんと対応し、理由なく予算を使わない」を両立する方法です。ここで説明しているプロジェクトの日常的な編集には、通常のhighで十分です。大規模なセキュリティ監査や20の情報源からの調査が必要なときは、/effort ultracodeを使うか、プロンプトの冒頭にその単語を入れます。

次にすること#

今Claude Codeを使っていて、v2.1.154+とOpus 4.8モデルを確認できたら、今すぐ試してみましょう。セッション全体ではなく、特定のタスクだけで使います。

ultracode: go through all the files in src/components/ui/ and find where the same button is styled differently

/workflowsを確認すると、起動したエージェントの数と使用したトークン数が分かります。文章で読むよりも、費用と効果を現実的に把握できます。

出典#

関連記事：

• Claude Codeの動的ワークフロー：数百の並列エージェントをオーケストレーションする方法
• Claude Codeのマルチエージェント：サブエージェントを並列化する方法
• Claude Codeのルーティン：cronではなくスケジュールで自動化する
• Claude CodeのSonnetとOpus：タスクごとにどのモデルを使うか
• Claude CodeとCodexのゴールモード：目標を設定して作業を進める

Ailootについて詳しく見る。