ウルトラコードの
すごいところ

Claude Code に「専門家たちのスーパーチームを作って、この作業をやってくれ」とお願いすると、 5人、6人の分身（サブエージェント）が現れて、手分けして仕事をしてくれます。 とても分かりやすいし、実際よく働きます。

では、なぜそれとは別に「ウルトラコード（ultracode）」なんてものが用意されているのでしょうか。 名前が ultra + code なので「もっとすごいコードを書いてくれるモード」に見えます。 でも、そうではありません。

図-1 / おさらい「スーパーチーム」はこう動いている

まず、いつものやり方を確認しましょう。難しく考える必要はありません。 Claude は部長です。

あなたが「調べて、直して、確認して」と頼むと、部長は部下（サブエージェント）を呼びます。 「君はコードを調べてきて」「君は修正して」「君は動作確認して」。 部下たちは仕事を終えると、報告書を部長の机の上に置きます。 部長はそれを読み、考え、次に誰を呼ぶかを決める。

部下が5人なら、机の上には報告書が5通。余裕です。部長は全部読めます。 ここまでは、まったく問題ありません。 5、6人で済む仕事なら、「スーパーチームを作って」で完璧です。ウルトラコードは要りません。

図-2 / 実験では、100人にしてみましょう

ここが、この記事のいちばん大事なところです。下のつまみを右にずらして、 部下の人数を増やしてみてください。 左が「いつものスーパーチーム」、右が「ウルトラコード」の机です。

つまみを 50 あたりまで動かすと、左の机が埋まりはじめます。 これは比喩ではなく、実際に起きていたことです。 ワークフローという仕組みが登場する前は、 50体のサブエージェントを走らせると、50個の中間報告がコンテキストに積み上がり、 コンテキストが埋まり、仕事が終わるずっと前に品質が劣化していったと説明されています。

「100体まで」という上限があったわけではありません。 ただ、モデルの作業記憶が先に尽きるという、やわらかい壁があったのです。

図-3 / 診断大人数にすると壊れる、4つの理由

机が溢れる以外にも、「部長が全部を頭の中で仕切る」やり方には、人数が増えるほど効いてくる弱点があります。4つあります。

図-4 / 正体ウルトラコードは、何をしているのか

ここまで来れば、正体はもう単純です。ウルトラコードをオンにすると、Claude は いきなり作業を始める代わりに、まず「段取り書」を書きます。 それが JavaScript のプログラムです。そしてそのプログラムを、Claude Code のランタイムが実行します。

プログラムの中の agent( ... ) という 1 行が、部下 1 人に対応します。 実物はこんな形をしています。全部わからなくて大丈夫です。色のついた行だけ見てください。

// フェーズ1：まず1人、下調べに行かせる
const files = await agent('src/routes/ のファイル一覧を出せ');

// フェーズ2：ファイルの数だけ、部下を並列に起動する
const findings = await parallel(
  files.map(f => () => agent(`${f} の認証漏れを探せ`))
);

// ← ここはただのJavaScript。モデルは1トークンも使っていない
const suspicious = findings.filter(x => x.risk > 0.5);

// フェーズ3：別の部下に、その指摘を潰させる（反証させる）
const verified = await parallel(
  suspicious.map(x => () => agent(`本当か？反証せよ: ${x.claim}`))
);

return summarize(verified);   // ← これだけが机に戻る

「なぜわざわざプログラムにするのか」——理由はもうお分かりだと思います。 プログラムは、疲れず、忘れず、甘い採点をせず、そして机を占領しないからです。 おまけに、ファイルとして残るので、翌週まったく同じ段取りをもう一度回せます。

図-5 / 整理「効率」ではなく、2本の軸で考える

混乱の原因は、実は名前です。/effort（考える深さ）のメニューの中に ultracode が並んでいるので、 「low → medium → high → ultracode」という賢さの階段に見えてしまう。 でも実際は違います。軸が 2 本あるのです。

公式ドキュメントの言い方は、驚くほど素っ気ないものです。 「ウルトラコードは、モデルのエフォートレベルではなく Claude Code の設定である。 モデルには xhigh を送り、加えて、実質的なタスクに対して動的ワークフローを組ませる」。

つまり API に effort: "ultracode" という値は存在しません。 送られているのは xhigh です。ウルトラコードとは、 「頭は xhigh で回せ」＋「段取りは毎回コードに書け」を、まとめてオンにするスイッチ。 それだけです。

図-6 / 実務で、いつ使えばいいのか

念のため書き添えておくと、公式ドキュメント自身が 「ほとんどのタスクにワークフローは必要ない」とはっきり書いています。 日常の作業には、ふつうの会話のほうが安く、速く、そして結果をレビューしやすい。