Claude Code の ultracode とは? 何をして、どれだけかかるのか

ultracode は Claude Code の設定で、強度レベルではありません。オンにすると、Claude は中身のあるタスクごとに dynamic workflow、つまり複数のサブエージェントを動かすスクリプトを書きます。オンとオフの切り替え方、max の強度とは違う理由、そして同じコードレビューを Opus 5.5 で 2 回、xhigh と ultracode で実行した結果を紹介します:トークンは約 4 倍、時間は 2 倍以上、そして claude -p では検証結果が最後まで戻ってきませんでした。

「What is ultracode in Claude Code」は Google トレンドで 14 夜連続で上昇していて、Google は今では「what does ultracode do in claude code」「what does opus ultracode do」「what does ultracode mode do」を候補に出します。これに答えるページは互いに食い違っています。あるページは最も高い強度のモードだと言い、別のページは xhigh だと言います。今日の時点では、どちらも正しくありません。

短い答え:ultracode は Claude Code の設定で、中身のあるタスクを 1 つの会話でターンごとに進める代わりに、Claude にそれぞれを dynamic workflow、つまりスクリプトが動かす複数のサブエージェントとして組み立てさせるものです。 強度レベルではなく、トークンも多く使います。どれだけ多いのかは、実際のタスク 1 つで測りました。

以下の内容はすべて 2026年11月19日に、Anthropic のドキュメント(code.claude.com の Model configuration と Dynamic workflows のページ)、Claude Code の changelog、そして私たちのマシンにインストールした Claude Code 2.1.318 で確認しました。

ultracode を 1 段落で

dynamic workflow とは、Claude があなたのタスクのために書く JavaScript スクリプトです。ランタイムがそれをバックグラウンドで実行します。スクリプトはサブエージェントを起動し(多くの場合は複数を同時に)、それぞれに作業の担当部分を渡し、その結果を会話に積み上げる代わりにスクリプトの変数に保持します。ultracode がオンだと、タスクがワークフローに値するほど中身があるかどうかを Claude が自分で判断します。Anthropic の言葉では「1 つのリクエストが、続けて複数のワークフローになることがあります:コードを理解するためのもの、変更を加えるためのもの、それを検証するためのもの」です。Anthropic のモデル設定のページは 1 行でこうまとめています:ultracode は「モデルの強度レベルではなく、Claude Code の設定」です。

オンにする方法、オフにする方法

使い方は 2 つあり、効いている期間が違います。

タスク 1 つだけ:キーワード。 自分で入力するプロンプトに ultracode を入れます。例えば ultracode: audit every API endpoint under src/routes/ for missing auth checks のように。Claude Code がその単語をハイライトし、Claude はそのタスクだけのためにワークフローを書きます。セッションの強度レベルは変わりません。自分の言葉で「ワークフローを使って」と頼んでも同じように動きます。うっかり入力した場合は、macOS なら Option+W、Windows と Linux なら Alt+W で、このプロンプトのハイライトを外せます。

セッション全体:設定。

  • /effort ultracode で現在のセッションでオンになり、/effort ultracode off でオフになります。/effort スライダーでは、Tab で Ultracode のトグルを切り替え、Enter で適用します。
  • claude --effort ultracode はオンの状態でセッションを始め、同時に強度レベルを xhigh にします。
  • 設定ファイルに "ultracode": true を書くと、すべてのセッションでオンになります。Claude Code はこのキーを読みますが、書き込むことはありません。

完全に止めるには。 /config で「Ultracode keyword trigger」をオフにすると、その単語でワークフローが始まらなくなります。/config で「Dynamic workflows」をオフにするか、"disableWorkflows": true を設定するか、CLAUDE_CODE_DISABLE_WORKFLOWS=1 を設定すると、ワークフローは ultracode ごと無くなります。組織は管理設定で同じことができます。

そもそも選択肢に出てこないケースが 2 つあります:ワークフローがオフになっている場合と、モデルが xhigh の強度に対応していない場合です。ワークフロー自体は、すべての有料プラン、Anthropic API のアクセス、そして Amazon Bedrock、Google Cloud、Microsoft Foundry で使えます。Pro では、まず /config で Dynamic workflows の行をオンにします。

ultracode は max の強度ではない

設定何が変わるか
low、medium、high1 回のモデル呼び出しが答える前にどれだけ考えるか
xhighより多くのトークンを使って、より深く推論する
max最も深い推論レベル。自分抜きで解いてほしい難しい問題向け
ultracode作業の組み立て方:複数のエージェントによるワークフロー。強度はセッションのレベルのまま

強度レベルは呼び出しごとに作用します。ultracode は仕事の形に作用します。medium で ultracode を使うことも、ultracode なしで max を使うこともできます。

この混乱には経緯があります。dynamic workflow は 2026年5月末に Claude Code v2.1.154 で登場し、きっかけになる単語は workflow でした。数日後、v2.1.160 でキーワードが ultracode に改名されました。9月末の v2.1.284 までは、ultracode をオンにするとセッションも xhigh に切り替わり、別のレベルを選ぶとオフになっていました。夏の間に書かれた多くのページが「ultracode は xhigh だ」と言っているのはこのためです。v2.1.284 以降は、どのレベルでもオンのままの独立したトグルです。唯一の名残は、起動フラグ --effort ultracode が今でも同時に xhigh を設定することです。

オンにすると何が変わるか

ultracode をオンにすることは大きな実行を受け入れたとみなされるので、3 つの安全装置が静かになります:

  • 「Large workflow」の警告は表示されなくなります。通常は、ワークフローが 25 を超えるエージェント、または見込みで 150万を超えるトークンを予定したときに出るものです。
  • セッションの同時サブエージェント数の上限が、Claude が Agent ツールで起動するサブエージェントには適用されなくなります。
  • auto の権限モードでは、最初のワークフロー起動の承認を求められなくなります。

それでも有効なのは、サイズの目安とランタイムの上限です。目安は、Claude がスクリプトを書くときに Claude Code が Claude に渡すアドバイスです:small は 5 エージェント未満、medium は 10 未満、large は 50 未満を意味します。デフォルトは medium、Pro プランでは small です。/config(Dynamic workflow size)または workflowSizeGuideline キーで変更できます。ランタイム自体は、デフォルトで同時に最大 16 エージェントまで動かし、1 回の実行で 1,000 エージェントを超えることを拒否します。

実行中は /workflows で進行状況のビューが開き、各エージェントのトークン使用量が見られます。そこから実行を止めることもできます。

同じレビューを 2 回実行した

Anthropic のドキュメントには、ultracode で各リクエストのトークンが増え、時間も長くなると書かれています。私たちは実際のタスク 1 つで自分たちの数字が欲しかったので、同じ仕事を 2 回実行しました。

タスク。 このサイト自体の 6 つのスクリプトです。夜間エージェントがリンク、翻訳、IndexNow への送信をチェックするのに使うツールで、Python ファイル 3 つと TypeScript ファイル 3 つ、合計 1,394 行です。プロンプトは両方の実行で同じです:本物のバグ(間違ったロジック、クラッシュにつながる未処理のエラー、間違ったエッジケース)を探してフォルダをレビューし、ファイルは一切変更せず、バグごとにファイル、行、1 行の修正案を示し、重大度順に並べること。

条件。 Claude Code 2.1.318、1M コンテキストウィンドウの Opus 5.5、使い捨てのフォルダに置いた 6 ファイルの新しいコピー、読み取り専用のツール(Read、Grep、Glob、それに Agent と Workflow)、サイズの目安は small、claude -p で起動。実行 A は --effort xhigh。実行 B は --effort ultracode で、上で見たとおりこれも xhigh を意味します。同じモデル、同じ強度レベル:違いは ultracode だけです。

実行 A:xhigh実行 B:ultracode
実時間6分8秒14分14秒
エージェント1(セッション)セッションとワークフローのエージェント 4 つ
処理された入力トークン99,400735,111
出力トークン(うち思考)39,054(35,105)148,602(126,222)
それらのトークンの定価換算コスト1.20ドル4.87ドル
コマンドが表示したもの重大度順に並んだ 14 件のバグ実行が始まったというメッセージ

入力トークンの大半はキャッシュ読み取りです(実行 A で 47,730、実行 B で 424,037)。コストの行は、Claude Code が JSON 出力でこれらのトークンについて計算した定価です。サブスクリプションではトークン単位の課金はなく、実行が利用枠からどれだけ使うかの目安です。

ultracode がオンのとき Claude がしたこと。 まず自分で 6 つのファイルを読み、疑わしいバグを 23 件挙げました。次に、small の目安を守った 2 段階のワークフロースクリプトを書きました:ファイルのグループごとに 1 つ、計 3 つの探索役を並列で動かし(結合した 2 つの TypeScript ファイル、リンクチェッカー、3 つの Python スクリプト)、その後に懐疑役を 1 つ。懐疑役の仕事は、自分の 23 件も含めて、すべての候補を反証しようとすることだけです。これは Anthropic のドキュメントが説明している相互チェックのパターンで、理屈の上ではバグ探しに求めるものそのものです。

探索役が見つけたもの。 23 件の指摘です。実行 A の重要なバグはすべて含まれていました(IndexNow に届かない新しいファイル、10,000 件の URL を超えると削除されるキュー、引用符のないタイトルでのクラッシュ、zh-TW を取りこぼすロケールの除去、孤立ページを隠してしまう自己リンク)。さらに実行 A が報告しなかったものが 8 件あり、その多くは重大度の低いものでした:JSX 属性の中の最初の > で止まってしまう nofollow チェック、ハイフンで止まる namespace の正規表現、ブログ記事を対象から外している監査。実行 A が見逃した重大なものはありませんでした。

戻ってこなかったもの。 claude -p では、Claude はワークフローをバックグラウンドで起動し、「I'll send the final list, sorted by severity, when it finishes」と書いてターンを終えました。コマンドが表示したのはこの一文です。その後プロセスは待ち続け、601 秒後に終了しました。懐疑役はまだ確認の途中でした。検証済みのリストは届かず、探索役の結果は ~/.claude/projects/ 以下にある実行のファイルの中でしか読めませんでした。私たちが読んだページには、-p でのバックグラウンド作業の待機上限についての記載は見つかりませんでした。これは 2.1.318 で私たちが見たことです。対話型のセッションなら会話は開いたままで、実行が終わると結果が戻ってきます。

私たちの見方。 1 つのセッションで全部読める 6 ファイルのレビューでは、ultracode はトークン約 4 倍、時間 2 倍以上と引き換えに重大度の低い候補を 8 件増やしただけで、スクリプトの中では検証済みのリストを返しませんでした。1 つの会話にすべてのファイルが収まらないリポジトリ全体の監査なら、損得は変わります。このタスクでは、素の xhigh のほうが割に合いました。

何を消費するか、いつオフのままにするか

Anthropic は代償について明言しています:ultracode がオンだと「各リクエストは、ワークフローなしの同じリクエストより多くのトークンを使い、時間も長くかかります」、そしてサブスクリプションのプランでは「ultracode をオンにしたセッションは、オフで同じ作業をするより早くセッションまたは週の上限に達します」。私たちの実行は 1 つのタスクでの 1 つのデータ点にすぎず、ベンチマークではありませんが、同じ方向を示しています。

オフのままにする場面:

  • 日常的な作業:名前の変更、小さな修正、コードについての質問。
  • 5時間ウィンドウや週の上限の残りがすでに少ないとき。1 つのリクエストが続けて複数のワークフローになることがあるためです。
  • スクリプトやスケジュールされたジョブ:そこではキーワードは無視され、フラグを使った私たちの claude -p の実行は検証結果が戻る前に終了しました。
  • Pro:Anthropic がすでにデフォルトのサイズを small にしています。

オンにするなら、セッション全体ではなく、できればキーワードでタスク 1 つだけに:

  • 1 つの会話には広すぎる作業:リポジトリ全体の監査、数百ファイルの移行、情報源を互いに突き合わせる必要のある調査。
  • 結果を読む前に、独立したエージェント同士に互いの指摘をチェックさせたいとき。

大きな実行の前には、ドキュメント自身の助言がそのまま正解です:まず小さな範囲でワークフローを試し、/workflows を見守り、トークン数が手に負えなくなったら実行を止めます。

AgentsRoom から ultracode エージェントはどう見えるか

私たちはほとんどのエージェントを AgentsRoom で並べて動かしていますが、ultracode はまず私たち自身の製品の一部を壊しました。ワークフローの実行中、Claude Code のメインループはプロンプトに戻ります。残る唯一の動いている印は、タスクパネルの進行状況の行で、6/7 agents done · 5m 45s · 411.6k tokens や「Waiting for 1 dynamic workflow to finish」のようなものです。私たちの状態検出はこの静かなプロンプトを「完了」と読み取り、ワークフローのサブエージェントがまだ作業しているのにエージェントをアイドル扱いにしていました。AgentsRoom は今ではこの進行状況の行を読むので、ワークフローを実行中のエージェントは、最後のサブエージェントが戻るまで、デスクトップでもスマートフォンでもカード上で「作業中」のままです。

同じことをするなら、実用上のメモが 2 つあります:

  • AgentsRoom は、CLI ごとに選んだデフォルトの推論の強度(low から max まで)で Claude Code を起動します。ultracode はそのどのレベルでもありません。そもそもレベルではないからです。タスクがそれに値するときはエージェントのターミナルで /effort ultracode と入力し、終わったら /effort ultracode off と入力します。
  • 進行状況の行には、実行のトークン数が増えていく様子がそのまま出ます。私たちのトークンカウンターはその横にセッションの使用量を表示します。そして5時間ウィンドウは、長い ultracode の実行が真っ先に削っていくものです。

よくある質問

Claude Code の ultracode とは何ですか?

Claude Code の設定で、推論の強度レベルではありません。オンにすると、Claude は中身のあるタスクごとに dynamic workflow を計画します。複数のサブエージェントを起動してバックグラウンドで動く短いスクリプトで、その間もセッションは使えます。入力したプロンプトにキーワード ultracode を入れると、そのタスク 1 つだけで同じことが起きます。

ultracode は max の強度と同じですか?

いいえ。強度レベルは、1 回のモデル呼び出しがどれだけ考えるかを決めます。ultracode は作業の組み立て方を決め、1 つの会話の代わりに複数のエージェントを使います。v2.1.284 以降はどの強度レベルでもオンのままです。今でも xhigh と一緒に付いてくるのは、起動フラグ --effort ultracode だけです。

ultracode をオンにしたりオフにしたりするには?

タスク 1 つなら、自分で入力するプロンプトにキーワードを入れます。セッションなら /effort ultracode と /effort ultracode off、または /effort スライダーで Tab。起動時なら claude --effort ultracode。すべてのセッションなら設定ファイルに "ultracode": true。/config の Ultracode keyword trigger でキーワードを止められ、disableWorkflows でワークフローと ultracode をまとめて無くせます。

ultracode はトークンを多く使いますか?

はい。Anthropic のドキュメントによると、ワークフローを使うと各リクエストのトークンが増えて時間も長くかかり、サブスクリプションではセッションまたは週の上限に早く達します。私たちが測った実行では、Opus 5.5 で 6 ファイルを同じようにレビューしたところ、出力トークンは ultracode で 148,602、素の xhigh で 39,054 でした。定価換算のコストは約 4 倍(4.87ドルに対して 1.20ドル)で、Claude が自分でファイルを読んだあと、さらに 4 つのエージェントを起動したためです。

claude -p やスケジュールされたタスクで ultracode というキーワードが何もしないのはなぜですか?

キーワードが効くのは、人が入力したときだけです:対話型のプロンプト、IDE のパネル、Remote Control のクライアント、または入力を人間のものとして示す Agent SDK アプリ。-p、スケジュールされたタスク、webhook、中継された pull request のコメントでは、代わりに --effort ultracode か ultracode の設定を使います。

ultracode は Claude の Ultra プランや ultrareview と関係がありますか?

いいえ。Ultra は、Anthropic が Max 20x から改名したサブスクリプションで、月200ドルです。ultrareview は複数のエージェントが行うクラウドでのコードレビュー(/code-review ultra)で、リサーチプレビュー段階にあり、Pro、Max、Ultra では 3 回まで無料、その後は利用クレジットを使います。ultracode は手元の Claude Code セッションの設定です。

AgentsRoomをダウンロード

すべてのAIエージェントを、すべてのプロジェクトで、ひとつのウィンドウから実行。

AgentsRoomをダウンロード無料

コンパニオンアプリ:外出先でもエージェントを確認

Claude、Codex、Antigravity CLI、またはその他の AI プロバイダーを使用します。

バグや要望を公開バックログに直接送信できます。

続きを読む