Claude Code ultrareviewの使い方 — /code-review ultraの実行手順
Claude CodeのultrareviewをCLIから動かす手順を、ブランチ・PR指定、結果の投稿、非対話実行、無料枠の管理まで具体的にまとめます。
/code-review ultraを実行すると、Claude Code on the webのインフラ上でレビューエージェントの一群が起動し、あなたのブランチかPRのバグを並行して探します。ローカルの/code-reviewと違い、報告される指摘はすべて独立に再現・検証済みです。この記事では、実際に手を動かして呼び出すところから、結果をPRへ投稿し、CIに組み込むところまでの手順を扱います。
Claude Code ultrareviewは何をするコマンドか
ultrareviewはリサーチプレビュー機能で、/code-review ultraというコマンド名で呼び出します。利用できるアカウントでは/ultrareviewという別名でも同じ処理が走ります。ローカル/code-reviewとの違いは3点です。指摘の信頼度が高いこと(複数エージェントが実コードで再現・検証してから返す)、カバレッジが広いこと(大きめのエージェント群が並行して探索する)、そして手元のリソースを使わないことです。レビューはリモートのサンドボックスで完結するため、実行中も端末は空いたままです。
実行前に確認しておく3つの前提
ultrareviewはclaude.aiアカウントでの認証を必要とします。APIキーのみでサインインしている場合は/loginでclaude.ai認証を済ませてから呼び出してください。次にPro・Max・Team・Enterpriseいずれのプランでも使えますが、Amazon Bedrock・Google CloudのAgent Platform・Microsoft Foundry経由でClaude Codeを使っている場合と、Zero Data Retentionを有効化した組織では利用できません。この条件下で/code-review ultraを呼ぶと、自動的にセッション内でのローカルレビューが走ります。エラーにはなりません。
最後にリポジトリの状態です。ブランチレビューにはリモートリポジトリとの正常なgit履歴が必要で、detached HEADのように参照するブランチが1つも無いチェックアウトでは実行を拒否されます。この場合は先にブランチを作成してから呼び直します。
基本の実行方法 — 対象は引数で決まる
引数なしで実行すると、現在のブランチとデフォルトブランチの差分(未コミット・ステージ済みの変更を含む)がレビュー対象になります。実行前には確認ダイアログが出て、対象範囲・残っている無料枠・見積もり費用が表示されます。ブランチレビューでは対象ファイル数と変更行数も併せて表示されるので、確認してから進められます。
/code-review ultra比較先をデフォルトブランチ以外にしたいときは、ブランチ名を引数に渡します。指定したブランチがローカルに無くても、Claude Codeがoriginから取得します。名前を打ち間違えたときは、近いブランチ名を提案してくれます。
/code-review ultra developGitHubのPRをレビューしたいときはPR番号を渡します。#1234やPR 1234、貼り付けたPRのURL(現在のディレクトリのリポジトリを指すものに限る)も認識されます。PRモードでは手元の作業ツリーをアップロードせず、リモートのサンドボックスがPRを直接クローンします。対応するのはgithub.comと、Owner権限で接続済みのGitHub Enterprise Serverインスタンスです。
/code-review ultra 1234Claude Code v2.1.218以降では、地の文で作業内容を説明してから呼び出すこともできます。対象は引数なしの場合と同じ現在のブランチのままで、渡した文章はメモとして確認ダイアログに表示され、届いた指摘と関連付けられます。2語以上でブランチ名やPR参照に見えない文字列だけがメモとして扱われ、1語だけならブランチ名かPR参照として解釈される点に注意してください。
/code-review ultra check my auth changes結果をPRに投稿するまでの流れ
Claude Code v2.1.227以降、github.comのPRをレビューした場合に限り、完成した指摘を自分のGitHubアカウントからPRへ1件のプレーンコメントとして投稿できます。承認やレビューそのものではなく、コメントの末尾には生成元を示す注記が付きます。ブランチレビューやGitHub Enterprise ServerのPRでは、指摘はセッション内に表示されるだけです。
投稿するかどうかは実行のたびに選びます。既定は投稿しない--no-postです。対話セッションでは、起動ダイアログで「Run and post the findings to the PR as me」を選ぶか、コマンドに--postを付けて起動を先に選択しておきます。いずれの場合も投稿を最終確認するのはダイアログです。指摘が届くまでセッションを開いたままにしておく必要があり、途中でセッションが終わると、後で会話を再開しても投稿されません。
レビューの進行を/tasksで管理する
レビューは通常5〜10分で終わります。バックグラウンドタスクとして走るため、その間もセッションで別の作業を続けられますし、端末を閉じても構いません(投稿を選んだ場合はセッションを開いたままにしてください)。/tasksで実行中・完了済みのレビュー一覧を確認し、詳細を開いたり、途中で停止したりできます。停止するとクラウドセッションはアーカイブされ、途中経過の指摘は返ってきません。完了すると、検証済みの指摘がファイル位置と説明付きの通知として届き、その場でClaude Codeに修正を依頼できます。
CI・スクリプトから動かす — claude ultrareviewサブコマンド
対話セッションを開かずにCIやスクリプトからultrareviewを起動するには、claude ultrareviewサブコマンドを使います。/code-review ultraと同じレビューを起動し、完了まで待ってから指摘を標準出力に表示します。
claude ultrareview
claude ultrareview 1234
claude ultrareview origin/mainサブコマンドを実行すること自体が、マージ元が見つからない場合の全ファイルフォールバックと、課金確認への同意を兼ねるため、入力を待たずに開始します。進行メッセージとセッションURLは標準エラー出力に流れるので、標準出力はJSONなどをそのままパースできる状態を保ちます。
| フラグ | 効果 |
|---|---|
--json | 効果整形済みでなく生の指摘データをそのまま出力 |
--timeout <分> | 効果完了を待つ上限時間(既定30分) |
--post | 効果完了した指摘をPRへ1件のコメントとして投稿(github.com対象・v2.1.227以降) |
--no-post | 効果投稿しない(既定) |
終了コードは、指摘の有無に関わらず完了時が0、起動失敗・セッションエラー・タイムアウト時が1、Ctrl-Cで中断したときが130です。中断してもリモートのレビュー自体は止まらないため、標準エラー出力に出るセッションURLからブラウザで様子を見られます。v2.1.218以降はclaude -p '/code-review ultra'のように非対話セッションで/code-review ultraを直接呼ぶこともできますが、こちらは追跡リンクを表示した時点で処理が終わり指摘を待ちません。課金が発生する見込みのレビューは対話確認が必要なため起動前に止まり、claude ultrareviewサブコマンドを使うよう案内されます。
料金と無料枠の管理
ultrareviewは通常のプラン利用枠ではなく、使用量クレジットとして課金されるプレミアム機能です。
| プラン | 無料枠 | 超過後 |
|---|---|---|
| Pro | 無料枠3回 | 超過後使用量クレジットで課金 |
| Max | 無料枠3回 | 超過後使用量クレジットで課金 |
| Team・Enterprise | 無料枠なし | 超過後使用量クレジットで課金 |
Pro・Maxの3回はアカウントごとに一度きりの割り当てで、時間が経っても補充されません。無料枠を使い切ると、変更の規模に応じておおよそ5〜25ドルが使用量クレジットから引かれます。クラウドセッションが起動した時点でその回はカウントされるため、途中で停止したりレビューが失敗したりしても無料枠は1回消費されます。有料レビューは実際に走った分だけ課金されます。
使用量クレジットが有効になっていないアカウント・組織では、有料レビューの起動自体がブロックされます。請求管理の権限がある場合はそのまま設定画面へ案内され、Team・Enterpriseで権限が無いメンバーはCLIから管理者へリクエストを送ります。現在の設定確認や変更には/usage-creditsを使います。使用量クレジットでの課金確認は会話ごとに1回表示され、/clearで新しい会話を始めると次の有料レビューで再度確認されます。
/code-reviewとの使い分け早見表
| 観点 | /code-review | /code-review ultra |
|---|---|---|
| 実行場所 | /code-reviewローカルセッション内 | /code-review ultraリモートのクラウドサンドボックス |
| 深さ | /code-reviewエフォート引数に応じて変わる | /code-review ultra複数エージェントが独立に検証 |
| 所要時間 | /code-review数秒〜数分 | /code-review ultra5〜10分 |
| 費用 | /code-review通常の利用枠に計上 | /code-review ultra無料枠、超過分は使用量クレジット |
| 向く場面 | /code-review作業中の素早いフィードバック | /code-review ultraマージ直前の重要な変更 |
日常の差分にはローカルの/code-reviewを、認証・課金・データ破壊に関わる変更のマージ直前にだけultrareviewを充てる組み合わせが無理のない使い分けです。この判断軸そのものはClaude Codeコードレビューの4経路で扱っています。
よくあるつまずき
- diffが大きすぎて拒否される: ブランチレビューは既定で最大500ファイル・8,000変更行までです。超えるとPRモードへの切り替えを促されます。上限値自体は変わりうるため、実際のエラーメッセージに出る数値を確認してください
- マージ元が見つからない: 対象ブランチがベースと共通の履歴を持たない場合、リポジトリ全体を対象にしたフルクローンでのレビューにフォールバックします。サイズ上限は通常のレビューと同じです
- 比較する差分が空: ベースとの差分が無いと、ステージや別ベースの指定を促されます。何もレビューせず終了します
- リポジトリが大きすぎてアップロードできない: ブランチをpushしてドラフトPRを作成し、PR番号を指定するPRモードに切り替えると解決します
- 投稿したのにPRにコメントが付かない: セッションが指摘の到着前に終了すると投稿はされません。会話を再開しても後追いでは投稿されないため、投稿を選んだレビューはセッションを開いたまま待つ必要があります
よくある質問
/ultrareviewと/code-review ultraは同じコマンドですか
同じ処理を呼びます。/ultrareviewは利用できるアカウントで使える別名で、推奨される呼び出し方は/code-review ultraです。
GitHub以外のホスティングでも使えますか
PRモードはgithub.comと、Owner権限で接続済みのGitHub Enterprise Serverのみに対応します。それ以外のホスティングではブランチレビューのみが対象になります。
無料枠を使い切ったらどうなりますか
起動できなくなるわけではありません。使用量クレジットが有効になっていれば、そのまま有料レビューとして起動できます。無効な場合は起動前にブロックされ、有効化の案内が表示されます。
レビュー中にセッションを閉じても大丈夫ですか
指摘をセッション内で確認するだけなら閉じても構いません。ただしPRへの投稿を選んでいる場合は、投稿が完了するまでセッションを開いたままにする必要があります。
まとめ
ultrareviewはローカルレビューの延長ではなく、独立した検証を挟むぶん重い判断材料です。日常の差分は/code-reviewで素早く回し、認証・課金・データ破壊に関わる変更のマージ直前にultrareviewを充てると、無料枠と使用量クレジットの両方を無駄にしません。CI組み込みにはclaude ultrareviewサブコマンドと--json・--postの組み合わせが使えます。呼び出し方の全体像はClaude Codeスラッシュコマンド一覧、レビュー以外のワークフローとの組み合わせ方はClaude Codeワークフローで扱っています。