Claude Code Ultraplan

ターミナルが人質になっている。Claude Codeが計画モードに入るたびに、計画が完成するまでプロンプトが凍りつく。手軽な機能追加ならそれでいい。40ファイルと3つのサービスにまたがるマイグレーション計画になると、ローカルマシンがすべての処理をしている間、スピナーを何分も眺めることになる。

Ultraplanは計画フェーズ全体をAnthropicのクラウドに送り出すことでこれを解決する。リモートコンテナ上でOpus 4.6を最大30分実行する間、ターミナルは本当の作業に使える。計画はバックグラウンドで下書きされる。インラインコメントと絵文字リアクションを備えたブラウザでレビューする。そしてクラウドで実行（PRを取得）するか、ローカルセッションに転送するかを選ぶ。

これはplan modeが最初に出荷されて以来、Claude Codeの計画スタックへの最大の追加だ。以下は実際の動き方、漏洩したソースが内部構造について何を明かすか、そこから良い結果を引き出す方法だ。

Ultraplanとは実際何か

Ultraplanは計画タスクをローカルのCLIからクラウド上のClaude Code on the webセッション（計画モードで実行中）に引き渡すリサーチプレビュー機能だ。クラウドセッションはAnthropicのCloud Container Runtime（CCR）上のOpus 4.6で動く。ローカルのターミナルは3秒ごとにステータスをポーリングする。

ローカルの計画モードとの主な違い:

必要条件: Claude Code on the webアカウント（Pro、Max、Team、またはEnterprise）とGitHubリポジトリの接続が必要。

Ultraplanを起動する3つの方法

1. スラッシュコマンド

最も明示的な方法。/ultraplanに続けてプロンプトを入力する:

/ultraplan migrate the auth service from sessions to JWTs

クラウドセッションが実際に起動する前に確認ダイアログが表示される。

2. キーワードトリガー

通常のプロンプトのどこかに「ultraplan」という単語を入れる:

I need an ultraplan for refactoring the payment module to support multi-currency

Claudeがキーワードをキャッチして同じ確認ダイアログを開く。タスクをコマンドとしてではなく会話的に説明したいときに便利だ。

3. ローカルの計画から

最もスムーズな方法。Claudeがローカルの計画をまとめて承認ダイアログを表示したとき、**「No, refine with Ultraplan on Claude Code on the web」**を選んでクラウドに下書きを送る。選択自体がすでに確認として機能するため、追加の確認プロンプトはない。

この方法が強力なのは、クラウドセッションがゼロから始まるのではなく、ローカルの計画をコンテキストとして開始するからだ。

ターミナルからの監視

起動後、CLIプロンプトにライブのステータスラインが表示される:

ターミナルで/tasksを実行するとultraplanのエントリが表示される。そこからセッションリンクを開いたり、エージェントのアクティビティを確認したり、Stop ultraplanでクラウドセッションをアーカイブしてインジケーターをクリアしたりできる。

注意点: Remote Controlがアクティブな場合、Ultraplanが起動した瞬間に切断される。両機能がclaude.ai/codeインターフェースを使い、同時に接続できるのは1つだけだ。

ブラウザでのレビュー画面

ここがUltraplanがローカルの計画から抜け出す部分だ。ターミナルのスクロールバックから計画を読む（承認・拒否・フォローアップ入力しかできない）のではなく、3つのレビューツールを持つ専用のブラウザUIが提供される:

インラインコメント: 計画の任意の箇所をハイライトしてコメントを残す。これが本当のアップグレードだ。「データベースマイグレーションのセクションはもっと詳細が必要」と言う代わりに、内容が薄い段落を指定して何が足りないかを説明する。Claudeはそのセクションだけを修正する。

絵文字リアクション: 個々のセクションにリアクションして、フルコメントを書かずに承認や懸念を示す。どの部分が良くてどの部分が要改善かを素早くマークする方法だ。

アウトラインサイドバー: 計画のセクション間を移動する。スクロールが苦痛になる長い計画に必須だ。

何度でも反復できる。Claudeにコメントへの対応を求め、修正版をレビューし、さらにコメントを残し、計画が正しくなるまで繰り返す。

承認後の4つの実行パス

計画が良さそうになったら、どこで実行するかを選ぶ:

パス1: クラウドで実行

ブラウザで**「Approve Claude's plan and start coding」**をクリック。Claudeが同じクラウドセッション内で計画を実装し、完了したらウェブUIから差分をレビューしてプルリクエストを作成できる。ターミナルに確認が表示され、ステータスラインがクリアになる。

これが独立した変更に最もクリーンな方法だ。クラウドセッションはリポジトリへのフルアクセスがあり、PR作成がウェブUIに直接組み込まれている。

パス2: 現在のターミナルセッションで実装

ブラウザで**「Approve plan and teleport back to terminal」をクリック。ウェブセッションがアーカイブされ、ターミナルに「Ultraplan approved」というタイトルのダイアログで計画が表示される。「Implement here」**を選ぶと計画が現在の会話に注入され、中断したところから続けられる。

クラウドセッションが見えないローカルコンテキスト（環境変数、ローカルサービス、リポジトリ外のファイル）に計画が触れるときに最適だ。

パス3: 新しいローカルセッションを開始

同じテレポートダイアログ、別のボタン: 「Start new session」。現在の会話がクリアされ、計画のみをコンテキストとして新しいセッションが開始される。Claudeがclaude --resumeコマンドを出力するので、後で前の会話に戻ることができる。

現在のセッションがすでに邪魔になるコンテキストで重くなっているときに最適だ。クリーンなウィンドウで、単一目的のフォーカス。

パス4: 保存してキャンセル

テレポートダイアログから**「Cancel」**を選択。Claudeが計画をファイルに書き出してパスを表示する。何も実行されない。後で戻ることも、チームメイトとレビューのために共有することも、手動実装の仕様として使うこともできる。

ソースコードの漏洩が明らかにしたこと

2026年3月31日、Claude Codeのソースコードがnpmパッケージングのミスで漏洩した。512,000行以上のTypeScriptの中に、Ultraplanを動かすシステムプロンプトがあった。Ultraplanが1つのものではないことを示している。少なくとも3つのバリアントがあり、A/Bテストで割り当てられるようだ。

バリアント1: simple_plan

軽量なオプション。サブエージェントは不使用。システムプロンプトはClaude に次を指示する:

Run a lightweight planning process, consistent with how you would
in regular plan mode:
- Explore the codebase directly with Glob, Grep, and Read.
- Do not spawn subagents.
When you've settled on an approach, call ExitPlanMode with the plan.

基本的にはクラウドハードウェア上の通常の計画モードだ。速いが、徹底度は劣る。

バリアント2: visual_plan

simple_planと同じ、プラス構造変更にMermaidまたはASCII図を含めるよう求める一段落。図は依存関係の順序、データフロー、または変更の形を示す。

Ultraplanが建築図と一緒に戻ってきたなら、このバリアントだ。純粋なテキストで画像なしなら、そうではない。

バリアント3: three_subagents_with_critique

深いバリアント。これはオフィシャルのPiebald-AIシステムプロンプトトラッカーがバージョン2.1.88でキャプチャしたものだ:

Produce an exceptionally thorough implementation plan using
multi-agent exploration.
1. Spawn parallel agents to explore: existing code/architecture,
   files needing modification, risks/edge cases/dependencies
2. Synthesize findings into detailed step-by-step plan
3. Spawn a critique agent to review the plan
4. Incorporate critique feedback, then call ExitPlanMode

3つの並列リサーチエージェントがコードベースの異なる次元に同時にアタックする。そして4番目のエージェントが統合された計画のギャップをレビューする。これが30分ウィンドウを正当化するバリアントだ。深いアーキテクチャの作業で、リスクサーフェス、依存関係の連鎖、既存のパターンを見る複数のエージェントは、単一パスよりも著しく良い計画を生成する。

サブエージェントの設計パターンについてのガイドを読んだなら、これはexplore-synthesize-critiqueパターンの実装だ。Anthropicは、上級のClaude Codeユーザーがすでに手動で構築しているのと同じマルチエージェントアプローチを計画に使っている。

バリアントの抽選

3つのUltraplanシステムプロンプトのバリアントはサイレントに割り当てられるようだ。どのバリアントを受け取るかは誰も選べず、UIには何が実行されているかも表示されない。ソースにはまたtengu_pewter_ledgerという4つのバリアント（null、trim、cut、cap）を持つ別のA/Bテストが含まれており、一般的な計画の出力の詳細度を変えるが、そのテストが特にUltraplanセッションに適用されるかどうかは明確でない。

実際にはこれを意味する: 一部のユーザーはリスク分析を持つ徹底的なマルチセクション計画を生成するUltraplanを報告し、他のユーザーはローカルの計画とほとんど変わらない薄いアウトラインしか得られない。その差がバリアントの割り当て、詳細度のテスト、またはその両方から来るかどうかにかかわらず、不一致は実際のものであり、初期のHacker Newsスレッドで十分に記録されている。

バージョン履歴

Piebald-AIトラッカーはClaude Codeのリリースをまたいだ Ultraplanの進化を記録している:

v2.1.89で/ultraplanを外してv2.1.91で戻したことは、Anthropicがキーワードのみの起動モデルを試してから戻ったことを示唆している。この機能は公式ドキュメントでまだ「リサーチプレビュー」として記されており、AnthropicのオフィシャルCHANGELOG.mdには一度も登場していない。フィーチャーフラグの裏に存在している。

Ultraplanでより良い結果を得るための実践的なヒント

1. プロンプトにコンテキストを先に入れる

Ultraplanのクラウドセッションはコードベースを読めるが、コールドスタートする。最初により多くのコンテキストを与えることで、探索時間が減り、より良い計画が得られる:

/ultraplan migrate auth from express-session to JWTs.
Key files: src/middleware/auth.ts, src/routes/api/*.ts, src/models/User.ts.
Current session store is Redis. 47 protected routes.
Must maintain backward compatibility during rollout.

それを単に/ultraplan migrate auth to JWTsと比較してみよう。最初のバージョンはプランナーに有利なスタートを与える。

2. 複雑な作業にはローカル計画パスを使う

最も重要な計画には、直接起動をスキップする。ローカルの計画からアウトラインを得て、次にそれをUltraplanで洗練させる。クラウドセッションはコールドな探索よりも強いベースで開始する。

その2ステップのフローはまた、クラウドサイクルを使う前に方向性を確認したことを意味する。ローカルの計画が間違った問題を解いているとわかれば、30分のUltraplan実行の前に気づける。

3. インラインコメントを積極的に使う

ブラウザのレビューUIはUltraplanの最強の機能だ。計画をざっと見て承認するだけにしないこと。特定のセクションをハイライトして的を絞ったフィードバックを残す:

• 「このセクションは単一データベースを想定している。私たちは3つある: users、analytics、billing。」
• 「テスト戦略はunitテストだけでなく、webhookハンドラの統合テストが必要だ。」
• 「ステップ4はステップ7に依存している。順番を入れ替えて。」

「もっと詳細にして」のような一般的なフィードバックより、的を絞ったインラインコメントの方が強い修正につながる。

4. スコープに応じて実行パスを選ぶ

5. Ultraplanを使わない方が良いとき

Ultraplanはレイテンシを加える。クラウドセッションはリポジトリをクローンし、コードベースを歩いて、計画を下書きしてから何かが表示される。すでにアプローチを知っているシンプルな変更には、ローカルの計画モード（Shift+Tabを2回）の方が速い。

Ultraplanを使う場合: 計画そのものが難しい部分のとき。マイグレーション、多くのファイルにわたるリファクタリング、複数の有効なルートがあるアーキテクチャ上の決断、または10〜30分の計画が後で何時間ものやり直しを省けるタスク。

Ultraplanをスキップする場合: 集中した変更の素早い計画が必要なとき、実装を素早く反復しているとき、またはGitHubリポジトリが接続されていないとき（必須要件）。

Ultraplanが計画エコシステムにどう収まるか

Claude Codeには現在4つの計画ティアがあり、それぞれ異なる複雑さのレベルに対応している:

各ティアはオーバーヘッドのコストで多くの能力を追加する。スキルはタスクに正しいティアを合わせることだ。Claude Codeのコンテキスト管理戦略をすでに使っているなら、Ultraplanはコンテキストの優位性も与えてくれる。計画が作業セッションとは別のコンテキストウィンドウで実行される。ローカルのコンテキストは実装のためにクリーンに保たれる。

現在の制限

Ultraplanはリサーチプレビューであり、それが見て取れる:

バリアントの選択不可。 シンプル、ビジュアル、深い計画バリアントを選べない。A/Bテストが割り当てるものになる。

GitHubのみ。 接続されたGitHubリポジトリが必要。GitLab、Bitbucket、ローカルのみのリポジトリは対象外。

ウェブからの起動不可。 CLIからしかUltraplanを起動できない。ウェブインターフェースから直接起動する機能は複数のユーザーから要望されているが、まだ対応していない。

UXの摩擦。 Hacker Newsの初期ユーザーはインラインコメントの残し方がわかりにくいと報告し、プロセスを「重い」と表現した。ブラウザのレビュー画面は機能するが、発見可能性が粗い。

不透明なメカニズム。 ローカルマシンとクラウドセッション間でのファイル同期の仕組みが十分に文書化されていない。ユーザーはセッション途中で終了した場合に何が起きるか不明と報告している。

公式のchangelogエントリなし。 完全に機能するにもかかわらず、Ultraplanはアントロピックの公式CHANGELOG.mdにゼロエントリだ。機能全体がフィーチャーフラグの裏に存在し、予告なく変更または廃止される可能性がある。

この先に来るもの

UltraplanはAnthropicのベットだ。AI支援開発のボトルネックは計画にある。コード生成でも、テストでも、デプロイでもなく。Opus 4.6のクラウドセッションを計画フェーズだけに最大30分使うということは、彼らが最大の見返りがどこにあると考えているかを語っている。

3つのバリアントの形も方向性を示唆している。今のところバリアントの割り当ては静かでランダムだ。しかし「計画の深さを選ぶ」をサポートするインフラはすでに構築されている。将来のバージョンでは、タスクが必要とするものに応じてシンプル・ビジュアル・深い計画を明示的に要求できるようになるかもしれない。

今のところ、Ultraplanは複雑で重要度の高い作業のための高度な計画ツールとして扱うのが最善だ。日常的なタスクにはローカルの計画モードを使う。最初から正確でなければならない計画のためにUltraplanを取っておこう。