# Claude CodeのUltracode 2026：コマンド1つで有効にする方法
> Claude CodeのUltracode：Claudeが自らエージェントチームを起動するモードです。/effort xhighとの違い、有効化方法、トークンをどれほど速く消費するかを解説します。
Source: https://ailoot.ai/blog/ja/ultracode-claude-code/
Canonical: https://ailoot.ai/blog/ja/ultracode-claude-code/
Language: ja
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-227
Revision: sha256-a121e5ff3f8b278bc4e3240ebaa4f64011b080a966299a1810c9d588a29c4ce8
重要なポイント
UltracodeはClaude Codeのモードで、Claudeが単一のプロンプトで回答する代わりに、数十の並列エージェントを使うワークフローとして実行する価値があるタスクかどうかを自ら判断します。セッション全体で有効にするには`/effort ultracode`を使い、単一のタスクで使うにはタスクの冒頭に`ultracode`という単語を置きます。内部では、xhighの推論（Opus 4.8を最大に設定した場合と同様）と自動オーケストレーターを組み合わせています。大規模なコード監査、数百ファイルに及ぶ移行、詳細な調査に役立ちます。通常モードより数倍速くトークンを消費するため、日常的な作業では`/effort high`を使うのがおすすめです。
サービスの使い方については、[Ailootのドキュメント](https://ailoot.ai/docs/)をご覧ください。
## Ultracodeとは何か、誰に必要か
重要なポイント
UltracodeはClaude Codeのセッション単位の設定で、最大の推論レベル（xhigh）と動的ワークフローの自動オーケストレーションを組み合わせています。2026年5月28日、Opus 4.8のリリースと同時にv2.1.154で登場しました。プロジェクト全体の監査、500ファイルの移行、20の情報源にまたがる複雑な質問の調査など、1つのプロンプトでは対応できない大規模なタスクを想定しています。
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は、単一の回答でどれだけ深く推論するかを変えます。Ultracodeは、並列エージェントによるワークフローを起動するか、1回でタスクを解決するかを自動で選択します。推論の深さはxhighの最大レベルのまま、さらにオーケストレーションの層が加わります。
要点を比較します。
| パラメーター | `/effort low` | `/effort medium` | `/effort high` | `/effort xhigh` | `/effort ultracode` |
|----|----|----|----|----|----|
| 推論の深さ | 最小 | 中程度 | 深い | 最大 | 最大（xhigh） |
| 推論に使うトークン | 少ない | 中程度 | 多い | 非常に多い | 非常に多い＋オーケストレーション |
| タスクを分割する判断者 | あなた | あなた | あなた | あなた | Claudeが自動で判断 |
| ワークフローの開始タイミング | あなたの指示時 | あなたの指示時 | あなたの指示時 | あなたの指示時 | 実質的なタスクごと |
| セッション間のリセット | なし | なし | なし | なし | あり。有効化し直す必要がある |
| 利用可能なモデル | すべて | すべて | すべて | xhigh対応モデルのみ | xhigh対応モデルのみ（Opus 4.8） |
一言で言えば、`/effort xhigh`は「じっくり考える」、Ultracodeは「じっくり考え、1つのプロンプトで対応できるか、30人のチームが必要かも自分で判断する」という意味です。つまりUltracodeは、xhighの上に自動オーケストレーションという層を加えます。
Anthropicは[公式ドキュメント](https://code.claude.com/docs/en/workflows#let-claude-decide-with-ultracode)で、次のように明記しています。
Ultracodeを有効にすると、タスクにワークフローが必要かどうかをClaudeが判断します。1つのリクエストから、コードを理解するワークフロー、変更を加えるワークフロー、検証するワークフローと、複数のワークフローが続けて実行される場合があります。
— Anthropic Docs、code.claude.com/docs/en/workflows
つまり、あなたの1つのリクエストから、「コードの理解」「変更」「検証」の3つのワークフローが順番に実行されることがあります。それぞれが10～30の並列エージェントを起動できます。
## Ultracodeに対応するバージョンとモデル
重要なポイント
Claude Code v2.1.154以降と、xhigh effortに対応するモデルが必要です。2026年6月時点で、Anthropicは実質的にxhighのリリースをOpus 4.8に結び付けています（変更履歴で確認できるxhigh対応モデルはほかにありません）。Pro / Max / Team / EnterpriseとAPIで利用できます。Proでは`/config`で手動で有効にする必要がありますが、ほかのプランでは初期状態で動作します。Bedrock、Vertex AI、Microsoft Foundryも対応しています。
バージョンを確認します。
```bash
claude --version
```
`2.1.154`より古い場合は更新します。
```bash
npm install -g @anthropic-ai/claude-code
```
次に、effortレベルの一覧を確認します。
```bash
claude /effort
```
ドロップダウンに`ultracode`が表示されれば準備完了です。表示されない場合、主な原因は次のとおりです。
- 現在のモデルがOpus 4.8ではない（たとえばSonnet 4.7はxhighに対応していない）
- Proを使っていて、`/config`でモードが無効になっている（「Dynamic workflows」オプションを有効にしてください）
- 組織の管理者が管理対象の設定でワークフローを無効にしている
モデルを確認します。
```bash
claude /model
```
デフォルトのモデルがOpus 4.8でなければ切り替えます。モデルメニューからOpus 4.8を選ぶか、`d`キーでデフォルトに設定します。
## Ultracodeを有効にする2つの方法
重要なポイント
1つ目は、`/effort ultracode`でセッション全体に有効にする方法です。そのセッションで以降に行うすべてのタスクについて、自動でワークフローが選択されます。2つ目は、1つのタスクだけに使う方法です。プロンプトの冒頭に`ultracode`と入力すると、その単語が強調表示され、そのタスクだけがワークフローとして開始します。セッションのeffortレベルは変わりません。
**方法1. セッション全体で有効にする。**
Claude Codeのセッションで、次を実行します。
```bash
/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は[こちら](https://code.claude.com/docs/en/workflows#ask-for-a-workflow-in-your-prompt)で、自然な言葉でも同じように指示できると説明しています。
「use a workflow」や「run a workflow」のように、自分の言葉で頼んでも同じように機能します。Claudeは明確なリクエストを同じオプトインとして扱います。
— Anthropic Docs、code.claude.com/docs/en/workflows
誤って`ultracode`と入力し、ワークフローを起動するつもりがなかった場合は、カーソルを強調表示された単語の直後に置き、`Option+W`（macOS）または`Alt+W`（Windows/Linux）を押します。強調表示が消え、タスクは通常どおり進みます。
## 有効にするとClaudeの作業はどう変わるか
重要なポイント
Claudeは「1ターンずつ」、つまりあなたの1つのプロンプトにClaudeが1つの回答を返す形式ではなくなります。代わりに、ランタイムがバックグラウンドで実行するJavaScriptスクリプトを書きます。このスクリプトは、それぞれ独自のコンテキストを持つ10～30の並列エージェントを起動して、結果をまとめられます。ワークフローがバックグラウンドで実行されている間もセッションは応答可能なので、新しいタスクを割り当てられます。
Ultracodeを使わない場合：プロンプトを書くと、Claudeは30秒考えて応答します。タスクが大きいと、途中の結果でコンテキストが埋まり、セッションの終わりにはすべてが「ずれて」いきます。
Ultracodeを使う場合：プロンプトを書くと、Claudeが規模を見てスクリプトを書きます。スクリプトは隔離された環境で実行され、途中の結果はセッションのコンテキストではなく、スクリプトの変数に保持されます。あなたに返されるのは最終回答だけです。
実際には、次の3つの効果があります。
1. **セッションのコンテキストが埋まりません。** `/compact`を使わずに、より長く作業できます。
2. **並列化できます。** 1回の実行で、同時に最大16のエージェントを起動できます（CPU性能が低いマシンでは少なくなります）。実行全体では、合計1000エージェントまでです。
3. **結果が自動で検証されます。** Claudeは、あるエージェントに解決策を書かせ、別のエージェントに批判的なレビューを依頼できます。複雑なタスクでの幻覚を減らせます。
実行中の様子を確認するには、次のコマンドを使います。
```bash
/workflows
```
実行中と完了済みのワークフローの一覧が開きます。矢印キーで選択してEnterを押すと、各フェーズの詳細を確認できます。エージェント、それぞれのトークン使用量、実行時間が表示されます。`p`で一時停止、`x`で停止、`r`でエージェントを再起動します。
## Ultracodeを有効にする場合、しない場合
重要なポイント
1つのプロンプトでは対応できないタスク、たとえばプロジェクト全体の監査、数百ファイルの移行、情報源を相互確認する詳細な調査では有効にします。バグ1つの修正、関数1つの作成、誤字の修正といった日常業務では有効にしないでください。Ultracodeモードではタスクごとに数倍のトークンを消費するため、小さな作業に使うと予算を無駄にします。
⚠️ 2026年6月15日以降、Anthropicはサブスクリプションを分離しました。ワークフローを含むプログラムによる処理には、月額$20～$200の別クレジットが使われます。クレジットがなくなると、サブスクリプションに切り替わることなくワークフローのリクエストが停止します。これは特にProでの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が動作し、不要なトークンを消費するためです。
## トークン数と費用の目安
重要なポイント
ワークフローが使うトークン数は、すべてのエージェントが使った量の合計です。30エージェントのワークフローは、それぞれがシステムプロンプト、ツール、独自の推論を持つ30個のコンテキストを意味します。トークン消費は、単一のプロンプトを大きく上回ります。Proでは、大規模なワークフロー1回で1日の上限の半分を消費することがあります。MaxとTeamでは余裕がありますが、それでも使用量を確認する必要があります。
概算してみましょう。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自身も、ワークフローを実行する前に費用を見積もるよう[推奨しています](https://code.claude.com/docs/en/workflows#cost)。
大きなタスクに取りかかる前に費用を把握するには、まずワークフローを小さな範囲で実行します。リポジトリ全体ではなく1つのディレクトリ、広範な質問ではなく対象を絞った質問を使います。
— Anthropic Docs、code.claude.com/docs/en/workflows#cost
つまり、まず1つのフォルダーでワークフローを実行し、`/workflows`で費用を確認してから、リポジトリ全体で実行するか決めます。1回の実行では合計1000エージェントまでですが、大規模なリポジトリでは100エージェントでも数十万トークンを消費します。
使用量を「減らしたい」なら、ワークフロースクリプトで二次的な段階に小型モデルを明示的に割り当てられます。プロンプトでは、「ファイル分類の段階はSonnet 4.7を使い、最終分析だけOpus 4.8を使って」と指定します。Anthropicはこれに対応しています。
## 内部の仕組み：ワークフロー、/workflows、制限
重要なポイント
ワークフローとは、Claudeがタスク用に書き、ランタイムが隔離環境で実行するJavaScriptスクリプトです。ループ、分岐、中間結果はスクリプトが処理するため、コンテキストを散らかしません。スクリプトを読んだり編集したり、コマンドとして保存したりできます。ランタイムの制限は、並列エージェント16、1回の実行あたり合計1000エージェントです。
各実行では、`~/.claude/projects/`の下にあるファイルに専用のスクリプトが書き込まれます。実行が始まると、Claudeはスクリプトのパスを受け取ります。つまり、次の操作ができます。
- Claudeに「このワークフローのスクリプトを見せて」と頼む
- エディターで開き、ロジックを確認する
- 前回の実行と差分を取る
- 編集した版をClaudeに再実行させる
ランタイムには次の制限があります。
| 制限 | 理由 |
|----|----|
| 実行中にユーザーが入力できない | 実行が無期限に待機しないようにするためです。段階の間に確認が必要なら、段階ごとにワークフローを分けます |
| スクリプトからファイルやシェルに直接アクセスできない | その操作はエージェントが行います。スクリプトはエージェントを調整するだけです |
| 一度に最大16の並列エージェント | ローカルCPUに過度な負荷をかけないためです |
| 1回の実行あたり合計1000エージェント | 不具合のあるスクリプトが無限ループに入るのを防ぐためです |
実行ごとに権限モードが適用されます。デフォルトでは、Claude Codeは毎回許可を求めます。「Yes, and don't ask again for `` in ``」を選ぶと、そのプロジェクトで該当するワークフローについて、以後は許可を求めなくなります。Autoモードでは、初回だけ許可を求め、その後はユーザー設定に承認を保存します。`claude -p`とAgent SDKでは、回答するユーザーがいないため、許可を求めません。
重要な点として、ワークフロー内のサブエージェントは常に`acceptEdits`モードで実行され、現在の権限モードにかかわらず、許可されたツールの一覧を引き継ぎます。ファイル編集は自動的に承認されます。重要なものを扱う場合は、この点に注意してください。
## 使えるワークフローをコマンドとして保存する方法
重要なポイント
ワークフローを実行して、その動作が気に入り、再利用すると分かっている場合は、`/workflows`で`s`キーを押して`/command`として保存します。保存後は通常のスラッシュコマンドと同じように、`/workflow_name arguments`の形式で使えます。チームで使う場合はプロジェクトの`.claude/workflows/`に、自分だけで使う場合は`~/.claude/workflows/`に保存されます。
例として、新しいブランチでUltracodeを使って`/code-review`を実行したとします。ワークフローは3回実行されました。最初はdiff全体を手早くレビューし、2回目はセキュリティ関数を詳しく確認し、3回目は変更された関数のテストを実行しました。結果はよく一致し、2つの問題が見つかりました。
今度は、マージ前にすべてのブランチで実行したいとします。次を開きます。
```bash
/workflows
```
完了済みの実行を選び、`s`を押します。ダイアログで保存先を選びます。プロジェクト内の`.claude/workflows/`（Gitに含まれ、チームで利用可能）または`~/.claude/workflows/`（個人用で、どのプロジェクトでも利用可能）です。たとえば`pre-merge-review`という名前を付け、Enterを押します。
これで、今後のどのセッションでも次を実行できます。
```bash
/pre-merge-review
```
ワークフローは、デバッグしたときと同じスクリプトで開始します。
ワークフローに引数が必要な場合は、保存時のプロンプトで説明します。するとスクリプトがグローバル変数`args`を受け取ります。パスの一覧、課題番号、ファイルIDなど、必要な値を渡せます。
Anthropicは[こちら](https://code.claude.com/docs/en/workflows#pass-input-to-a-saved-workflow)で、引数が構造化データとして渡されると説明しています。
Claudeはリストを構造化データとして渡すため、スクリプトでは最初に解析しなくても、`args`に対して配列やオブジェクトのメソッドを直接呼び出せます。
— Anthropic Docs、code.claude.com/docs/en/workflows#pass-input-to-a-saved-workflow
つまり、文字列を解析せずに、スクリプト内で`args.map(...)`を直接使えます。チケット、フォルダー、エンドポイントの一覧を処理する一括タスクに便利です。
## Ultracodeを無効にする方法と、その理由
重要なポイント
`/effort high`（または必要な別のレベル）を使うと無効になり、セッションは通常のモードに戻ります。ワークフローを恒久的に無効にするには、`/config`の「Dynamic workflows」切り替えを使うか、環境変数`CLAUDE_CODE_DISABLE_WORKFLOWS=1`を設定します。組織では管理対象の設定で無効にできます。
無効にする主な理由は、日常的な作業に戻ることです。大きなタスクにUltracodeを使い、終わったらすぐに通常の設定へ戻します。
```bash
/effort high
```
そうしないと、次の小さな編集もワークフローとして実行され、メリットがないままトークンを消費します。
キーワードを使うときだけ起動したいなら、Dynamic workflowsは有効のままにし、セッションは`/effort high`など通常のeffortにします。選んだタスクにだけ`ultracode`を付けてください。以下の全体無効化はキーワードも止めるため、この目的には使いません。セッション全体とキーワードの両方からの起動を禁止したい場合は、次の全体設定を使います。
```bash
# クライアント設定
# /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 Docs](https://code.claude.com/docs/en/workflows)
- [Claude Codeの変更履歴](https://code.claude.com/docs/en/changelog)
関連記事：
- [Claude Codeの動的ワークフロー：数百の並列エージェントをオーケストレーションする方法](https://ailoot.ai/blog/ja/claude-code-dynamic-workflows/)
- [Claude Codeのマルチエージェント：サブエージェントを並列化する方法](https://ailoot.ai/blog/ja/claude-code-parallel-worktree-agents/)
- [Claude Codeのルーティン：cronではなくスケジュールで自動化する](https://ailoot.ai/blog/ja/claude-code-routines/)
- [Claude CodeのSonnetとOpus：タスクごとにどのモデルを使うか](https://ailoot.ai/blog/ja/claude-code-model-effort-sonnet-opus/)
- [Claude CodeとCodexのゴールモード：目標を設定して作業を進める](https://ailoot.ai/blog/ja/goal-mode-claude-code-codex/)
[Ailoot](https://ailoot.ai/)について詳しく見る。
## Claude CodeのUltracode 2026：コマンド1つで有効にする方法：よくある質問
### キーワードを意図的に使うときだけワークフローを起動するには？
Dynamic workflowsを有効のままにし、セッションのeffortは/effort highなど通常のレベルにします。ワークフローで動かしたい特定タスクにだけultracodeを付けます。全体の無効化はキーワード経由も止めます。
### セッションが自動でワークフローを選ぶのを止めるには？
/effort ultracodeから通常のeffortへ戻します。セッションとキーワードの両方を禁止したい場合は、記事の全体無効化を使い、キーワードでも起動しないことを確認してください。
## Ailoot · 企業とそのプロジェクト群
Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。
企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。
Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。