Claude Code Ultracodeとは：/effort ultracode、xhigh、動的ワークフロー、コスト停止ルール

2026年6月3日時点で、Claude Code Ultracodeは新しいモデル名ではありません。Claude Code側のセッション設定であり、モデルにはxhigh effortを送り、実質的なタスクではClaude Codeがdynamic workflowsを自動で編成できるようにします。

コマンドは/effort ultracodeです。日本語では「全力モード」「自動チーム編成」と説明されがちですが、実務での見方はもっと冷静でよいです。Ultracodeは、調査、移行、監査、反証、検証のように複数の作業laneが別々の証拠を出すときに使う設定です。単一ファイルの修正や、手順がすでに決まっている小さなリファクタでは、highまたはxhighのほうが扱いやすいことが多いです。

先に停止ルールを決めてください。小さな範囲で試す、workflow planを見てから編集を許可する、各laneが新しい証拠を出しているか見る、同じ探索を繰り返したら止める、重い作業が終わったらhighかxhighへ戻す。この順序がないと、Ultracodeは便利な編成ではなく、レビュー量とトークン量を増やすだけの設定になります。

すぐ分かる答え

Ultracodeは、Claude Codeの重い作業向けモードです。ただし「常に品質が上がるボタン」ではありません。実際には二つの制御を組み合わせます。ひとつはモデルにxhigh effortを送ること。もうひとつは、タスクが十分に大きい場合にClaude Codeがdynamic workflowsを作り、複数laneで調査、実装、反証、検証を進められることです。

Claude Code内での最短コマンドは次です。

text
/effort ultracode

一度だけworkflowを使いたい場合は、セッション全体を切り替えずにこう頼めます。

text
Use an ultracode workflow for this task.
First create the workflow plan, keep edits scoped, and stop after verification.

バージョン確認は省略できません。AnthropicのClaude Code dynamic workflows docsでは、dynamic workflowsにClaude Code v2.1.154以降が必要とされています。この2026年6月3日の確認では、npm view @anthropic-ai/claude-code version dist-tags --jsonの結果はlatestとnextが2.1.161、stableが2.1.150でした。つまり、stableという見た目でもworkflowの最低要件より古い可能性があります。必ず自分のCLIを確認してください。

bash
claude --version
npm view @anthropic-ai/claude-code version dist-tags --json

チームで使うかどうかを決めるときは、先にタスクの形を見ます。Ultracodeが強いのは、複数の視点が必要な作業です。移行候補を比較する、監査laneと反証laneを分ける、修正案を実装するlaneと壊すlaneを並べる、広い調査をrouteごとに分担する。逆に、変更範囲が小さい、判断が連続した一本の推論に依存する、あるいはレビューコストが厳しい場合は、通常のClaude Codeのほうが安全です。

Ultracodeが実際に変えるもの

重要なのは、モデル名ではなく設定であることです。Claude Code Ultracodeという名前を見ても、Ultracodeという別モデルに切り替わるわけではありません。Claude Codeの設定がxhigh effortをモデルへ送り、さらにdynamic workflowsを編成できるようにします。

xhighはモデル努力の強度です。より難しい問題に多くの推論を使わせます。Ultracodeはそこへworkflow編成の許可を足します。Claude Codeは大きな仕事をlaneへ分け、調査、検証、比較、実装、反証、統合を行えるようになります。これは「自動チーム編成」のように見えますが、実務上は「高コストな編成許可」と考えるほうが正確です。

安全な言い方は、Ultracodeは「編成がコストに見合うときの設定」です。lane分割も独立検証も不要なら、highやxhighで十分です。強い名前に引きずられて常時ONにすると、ファイル変更、レビュー、トークン、待ち時間が増えます。

有効化のしかた

通常のClaude Code利用者にとって、最初の入口はこのコマンドです。

text
/effort ultracode

設定ファイル経由やAgent SDK control requestの経路もありますが、それらは特定の運用やSDK制御のためのものです。ターミナルでClaude Codeを使っているだけなら、まずは対話セッション内の/effort ultracodeで十分です。

一回だけ重いworkflowが必要なら、通常モードのままpromptで頼むのがよいです。これなら、その後の小さな修正や確認までUltracodeの編成対象に巻き込まれません。

見つからない時の確認リスト

Ultracodeが見えない、またはworkflowらしい動きが始まらない場合は、まず基本項目を確認します。

1. claude --versionを実行する。
2. 現在のdynamic workflows docsが求める最小バージョン以上か確認する。
3. そのClaude Code経路でworkflowsが有効か見る。Pro利用者は/config、管理下の環境ではadmin設定も確認する。
4. 選択しているモデル経路がxhighをサポートしているか確認する。
5. plan、provider、enterprise設定、feature availabilityを確認する。
6. 設定変更後はセッションを再起動する。

unsupportedなknobを増やしても、診断はきれいになりません。--effort、CLAUDE_CODE_EFFORT_LEVEL、effortLevelが別の挙動に見えることはあっても、それらをUltracodeの正規入口と見なさないでください。

今回のpackage tag差は、実務上の注意点です。stableは当時2.1.150で、workflow docsの最小要件より下でした。一方latestは2.1.161でした。重要なのは、どちらのtagが永遠に正しいかではありません。自分のCLIと現在の公式docsを同じタイミングで確認することです。

近い名前との違い

名前が似ているので、Ultracode、xhigh、ultrathink、dynamic workflows、Ultraplanを混ぜやすいです。比較軸は「何を制御するか」です。

もし本当の問題がcontext過多、tool outputの肥大化、MCP設定の散らかりなら、Ultracodeではなく環境整理が先です。Claude Code MCP context overload guideを確認してください。再利用できる作業規則が必要ならClaude Code best skills、外部データや操作面が必要ならClaude Code best MCP serversのほうが近いです。

安全なprompt例

Ultracodeでは、Claudeに自由を与えるほど境界も必要です。目的、lane、編集範囲、証拠、停止条件を一緒に書きます。

read-only監査なら：

text
Use an ultracode workflow for a read-only audit.
Map the risky areas first, split into independent verification lanes, and return findings with evidence.
Do not edit files. Stop if the task needs credentials, production data, or broad repo changes.

移行pilotなら：

text
Use Ultracode for a migration pilot, not the full migration.
Pick one representative module, create the workflow plan, and ask before editing shared files.
Return the migration rule, the test command, and what would block scaling.

反証込みの検証なら：

text
Create a workflow with two lanes: one implements the candidate fix, one tries to disprove it.
Keep changes scoped to the named files.
Report the commands run, strongest counterexample, and whether the fix should proceed.

route比較なら：

text
Use a workflow to compare the viable routes.
Each lane should own one route, cite its evidence, and state the stop condition.
Synthesize only after the lanes report back.

この形は単純です。タスク、境界、workflow構造、許可された編集、証拠、stop condition。Ultracodeはownershipが明確な時に強く、曖昧な時には中間成果を増やすだけになりやすいです。

コストと停止ルール

Dynamic workflowsは、より多くの推論、調査、検証、統合を作るため、tokenを多く使うことがあります。それ自体は悪ではありません。問題は、budget ruleなしに使うことです。

おすすめの順序は次です。

1. 最小の代表範囲から始める。
2. 広い編集の前にworkflow planを出させる。
3. laneが目的から外れたら止める。
4. 共有ファイル、設定、migration、generated codeの編集は明示的に承認する。
5. 新しい証拠が出ない探索を止める。
6. 重い作業が終わったらhighかxhighへ戻す。

停止ルールは「tokenが高い」だけの話ではありません。工程管理の話です。workflowが決定より分岐を増やしているなら止めます。各laneが同じ主張を繰り返し、proof anchorを増やしていないなら止めます。作業が探索から実装に移ったら、一つのセッションに畳んで丁寧に完了させます。

usage limitやbillingの解釈も分けてください。Ultracode後に制限へ当たっても、それだけでUltracodeが壊れているとは言えません。モード、subscription、API key、provider、enterprise route、quotaは別の層です。アカウント層はClaude Code API key vs subscription billing、Claude Code pricing guide、Claude Code usage limit issuesを分けて確認するほうが安全です。

トラブルシューティング

復旧は、さらに別のモードを試すことではなく、有用なfindingsを保存し、workflowを狭め、次の単一決定へ戻ることです。ローカルのバックグラウンドセッションを見たいだけなら、関連ページのClaude Code Agent Viewのほうが役に立ちます。

よくある質問

Claude Code Ultracodeは新しいモデルですか？

いいえ。Claude Codeの設定です。モデルにはxhigh effortが送られ、Claude Codeは実質的なタスクでdynamic workflowsを編成できます。

Ultracodeのコマンドは何ですか？

Claude Code内で/effort ultracodeを使います。一回だけなら、promptでultracode workflowを頼み、セッション全体は変えない方法もあります。

どのバージョンが必要ですか？

公式workflow docsはClaude Code v2.1.154以降を求めます。2026年6月3日の確認ではnpm latestが2.1.161、stableが2.1.150でした。claude --versionで自分のCLIを確認してください。

Ultracodeとxhighの違いは何ですか？

xhighはモデルeffortです。Ultracodeはxhighを使い、さらにClaude Codeがdynamic workflowsを自動編成できるようにします。一本の難問ならxhigh、複数laneが必要ならUltracodeです。

Ultracodeはコストが増えますか？

増える可能性があります。higher effort、workflow lane、中間推論、検証出力が増えるためです。小さなpilot、plan確認、繰り返し探索の停止、作業後のdowngradeを使ってください。

Ultracodeが見えない理由は？

CLI version、workflow enablement、xhigh対応、plan/provider/admin設定、古いセッション状態を確認してください。--effort、env effort、effortLevelを代替にしないでください。

常にUltracodeをONにしてよいですか？

通常はよくありません。監査、移行pilot、検証、multi-route researchのように編成が価値を持つ間だけ使い、終わったらhighまたはxhighへ戻します。

Ultracodeとdynamic workflowsは同じですか？

同じではありません。Dynamic workflowsは編成runtimeです。Ultracodeはそのruntimeを自動的に使えるClaude Code設定であり、同時にxhigh effortを使います。

まとめ

Claude Code Ultracodeは、ただ深く考えるためではなく、複数laneの作業を証拠付きで調整するための設定です。監査、移行、調査、反証、検証では強力ですが、普通の小さな修正に常用するものではありません。

使う順序は明確です。現在のバージョンとworkflow routeを確認し、編成がコストに見合う重い作業だけで/effort ultracodeを使い、小さなpilotから始め、workflow planを確認し、広い編集は承認し、重い部分が終わったらモードを下げてください。