開発・技術公開

Claude Code のコードレビュー|/code-review と ultrareview・自動レビューの使い分け

Claude Code でコードレビューする5つの方法を公式ドキュメントで整理。/code-review(/review)の対象指定と深さ、/security-review、ultrareview の無料回数、PR を自動で見る Code Review の条件と費用、REVIEW.md の書き方まで解説します。

Claude Code のコードレビュー|/code-review と ultrareview・自動レビューの使い分け

Claude Code にコードを見てもらう方法は、大きく5つあります。 手元のセッションで打つ /code-review(別名 /review)、クラウドで深く調べる /code-review ultra(ultrareview)、GitHub のプルリクエスト(変更の提案)に自動でコメントする「Code Review」、GitHub Actions で自分の CI から動かす方法、そして自作のレビュー担当(サブエージェントやスキル)です。セキュリティの観点だけを見たいときは、別に /security-review があります。

どれを使うかは、「毎回自動で見てほしいか」「どのプランか」「どこまで深く見たいか」で決まります。本記事は、2026年11月16日に取得した Anthropic の公式ドキュメント(Code Review、Review locally with /code-review、Find bugs with ultrareview ほか)を原典にし、手元の Claude Code 2.1.306 で /code-review を実際に動かした結果も載せています。

この記事を読むとわかること

  • Claude Code でコードレビューする5つの方法と、それぞれ「どこで動くか・誰が使えるか・費用がどうかかるか」
  • /code-review で、PR 番号・ブランチ・フォルダを指定してレビューする方法と、深さ(effort)の選び方
  • ultrareview の無料回数(アカウントごとに1回限りの3回)と、その後の課金のしくみ
  • GitHub の PR を自動で見る Code Review の使える条件、@claude review の使い方、費用の上限の付け方
  • REVIEW.md と CLAUDE.md でレビューの観点を指示する書き方
  • 個人・小さなチーム・会社の組織ごとのおすすめの組み合わせ

結論:Claude Code でコードレビューする5つの方法

手元ですぐ見てもらうなら /code-review、マージ前に深く見るなら ultrareview、PR ごとに自動で見るなら Code Review か GitHub Actions です。 公式ドキュメントの比較表をもとに、5つの方法を並べます。

方法レビューが始まるきっかけどこで動くか使える人費用のかかり方
/code-review(別名 /review)自分でコマンドを打つ自分の Claude Code のセッションどのプランでもプランの利用枠、または API の利用料に含まれる
/code-review ultra(ultrareview)自分でコマンドを打つAnthropic のクラウドの作業環境claude.ai のアカウントでログインしている人Pro・Max・Ultra は3回無料、その後は使用クレジット
Code ReviewPR の作成・更新、または @claude review のコメントAnthropic の基盤Team・Enterprise の組織(Owner が有効にした後)使用クレジットから、組織に請求
GitHub Actions で自分の CI から動かすPR などのイベント自分の CI の実行環境Claude の API キーかクラウド事業者の認証情報がある人GitHub Actions の実行時間と、API の利用料(OAuth トークンで認証した場合はサブスクリプションの枠)
自作のレビュー担当(サブエージェント・スキル)自分か Claude が呼び出すClaude Code を動かす場所自分で作った人ふだんの Claude Code の利用と同じ

出典:Code Review の「Compare ways to get a review」、ultrareview の「Pricing and free runs」、Code Review costs and usage、Claude Code GitHub Actions の「Manage costs」(いずれも2026年11月16日取得)

セキュリティの穴(入力値を使った攻撃、認証の不備、情報の漏れなど)に絞って見たいときは、上の5つとは別に /security-review を使います。

「Claude Code の評判」を知りたい方へ

「claude code review」で検索すると、Claude Code という製品そのものの評価(レビュー記事)を探している方もいます。本記事は「Claude Code にコードをレビューさせる方法」を扱います。製品としての評価や他のツールとの比べ方は、Claude Code と GitHub Copilot の比較やClaude Code 完全ガイド、料金の比較はClaude Code の料金プランの比較をご覧ください。

どれを使うか:状況別の選び方

最初の分かれ目は「PR を毎回、自動で見てほしいか」です。 自動で見てほしいなら、Team・Enterprise の組織は Code Review、それ以外は GitHub Actions で自分の CI から動かします。自動でなくてよいなら、大きな変更をマージ前に深く見るときは ultrareview、それ以外は手元の /code-review です。

Claude Code のコードレビューの選び方。PRを毎回、自動で見てほしい場合、Team・Enterprise の組織なら Code Review が PR に自動でコメントし、そうでなければ GitHub Actions で自分の CI から動かす。自動でなくてよい場合、大きな変更をマージ前に深く見るなら ultrareview がクラウドで深く確認し、そうでなければ /code-review で手元ですぐ確認する。迷ったら手元の /code-review から始め、セキュリティは /security-review も使う。

自分に近い状況から、次に読む節を選んでください。

当てはまる状況次に読むセクション
自分の書いた変更を、コミットや PR の前にすぐ見てもらいたい/code-review:手元でいま見てもらう
ログイン処理やお金の計算など、セキュリティの穴が心配な変更がある/security-review:セキュリティの観点だけを見る
大きな変更を、マージする前に時間をかけて深く見てほしいultrareview:マージ前にクラウドで深く見る
会社で Team・Enterprise プランを契約していて、全部の PR を自動で見てほしいCode Review:GitHub の PR を自動でレビューする
チームの決まり(見てほしい点・見なくてよい点)をレビューに反映したい観点を指示する:REVIEW.md と CLAUDE.md
Team・Enterprise の Code Review を使わずに、PR ごとの自動レビューを自分の CI に組み込みたい(API キーでも、Pro・Max などのサブスクのトークンでも可)GitHub Actions で自分の CI に組み込む

/code-review:手元でいま見てもらう

/code-review は、作業中の Claude Code のセッションで打つと、今のブランチの変更からバグを探して会話に報告するコマンドです。 どのプランでも使え、費用はそのセッションのほかの作業と同じく、プランの利用枠か API の利用料に含まれます(出典:Review locally with /code-review)。/review は同じコマンドの別名です。

基本の使い方

使い方は、Claude Code のプロンプトでコマンドを打つだけです。

/code-review

対象を指定しないと、今のブランチで上流のブランチより先に進んでいるコミットと、まだコミットしていない変更をまとめて見ます。上流のブランチが無いときは main か、1つ前のコミットと比べます。

ターミナルで使うと、レビューは別の作業枠(サブエージェント)として裏で動き、自分の会話を埋めません。終わると、見つかった問題が会話に届きます。届いた指摘は「直して」と頼めば、Claude がそのまま修正します。

レビューの主な対象は「動作を壊すバグ」です。使っているモデルと深さ(effort)によっては、既存の部品の使い回しや、書き方の簡素化、効率の改善の指摘も加わります。

レビューする対象を指定する

コマンドの後ろに対象を書くと、今のブランチ以外も見てもらえます。公式ドキュメントの表を日本語にまとめると次のとおりです。

見てほしいもの打つコマンド
今のブランチと、コミットしていない変更/code-review
直近15件のコミット/code-review HEAD~15..HEAD
あるブランチと別のブランチの差/code-review main...my-feature
1つのコミット(abc1234 はコミットの番号)/code-review abc1234^..abc1234
番号を指定したプルリクエスト/code-review 1234
ファイルやフォルダ/code-review src/auth

出典:Review locally with /code-review の「Choose what to review」

同僚の PR を承認する前に /code-review 1234 のように番号を渡して確かめる、という使い方も公式ドキュメントで紹介されています。

深さ(effort)と、--fix・--comment などの指定

/code-review には、深さを low・medium・high・xhigh・max から指定できます。low は自信の高い指摘だけを返すので誤った指摘が少なく、medium から max に上げるほど見る範囲が広がります。 深さを省くと、前に自分で打った深さ(別のセッションで打ったものも含む)を使い回します。一度も打ったことがなければ、そのセッションの深さで動きます。

あわせて使える主な指定は次のとおりです。

指定すること使える版
--fixレビューの後、指摘を作業中のファイルに反映するよう Claude に頼む。編集は今の権限モード(確認の出し方の設定)に従う—
--comment指摘を GitHub の PR に行ごとのコメントとして書き込む。GitLab のマージリクエストには1つのメモとして書き込むGitLab は v2.1.257 以降
--max-findings 数報告する指摘の上限を変える。all で全件、default で元に戻すv2.1.288 以降
ultraクラウドで深く調べる ultrareview に切り替える(後述)—

出典:Review locally with /code-review の「Tune effort and arguments」

--fix を付けるときは、元に戻す方法に注意します。 裏で動くレビューが --fix で直したファイルは、会話の巻き戻し(/rewind)の対象外です。/rewind で戻るのは、それまで Claude が会話の中で編集していたファイルだけなので、レビューが直したほかのファイルは git で元に戻します。コミットしてから --fix を使うと、戻すのが簡単です。

実際に動かした例

2026年11月16日に、手元の Claude Code 2.1.306 で、次の小さな変更に /code-review を実行しました。割引の計算に上限を付け、会員ランクごとの割引率を返す関数を足した変更です。わざと2つの誤りを入れています。

-// 合計金額に割引を適用する
+// 合計金額に割引を適用する(クーポンは最大50%まで)
 function applyDiscount(total, percent) {
-  return total - total * (percent / 100);
+  if (percent > 50) percent = 50;
+  return total - total * percent / 10;
 }
-module.exports = { applyDiscount };
+
+// 会員ランクごとの割引率を返す
+function rankPercent(rank) {
+  const table = { gold: 20, silver: 10 };
+  return table[rank];
+}
+
+module.exports = { applyDiscount, rankPercent };

実行したコマンドは claude -p '/code-review low main...feature' です(-p は対話せずに結果だけを受け取る起動方法)。深さは、自信の高い指摘だけを返す low にしました。返ってきた指摘は次の2件です。

  • 4行目:percent / 100 が percent / 10 に変わっていて、割引が10倍になる。applyDiscount(1000, 20) は本来 800 のところ、-1000 になり合計金額がマイナスになる
  • 9行目:割引表に無いランク(bronze など)を渡すと undefined が返り、それを applyDiscount に渡すと計算結果が NaN(数として扱えない値)になる。表に無いランクの既定値が要る

入れた2つの誤りは、どちらも行番号つきで指摘されました。2件目は、関数を単独で見れば動く書き方ですが、もう一方の関数と組み合わせたときに壊れることまで説明しています。一方で、上限を50%で切る1行(引数を書き換える書き方)は、この実行では指摘されませんでした。公式ドキュメントによると、low は最も自信のある指摘を返して誤った指摘を減らす深さで、書き方の整理の指摘が加わるかどうかはモデルと深さによって変わります。今回の結果は1回の実行の例として見てください。

観点を指示する:CLAUDE.md と自作のレビュー担当

/code-review は、プロジェクトの CLAUDE.md(Claude Code が毎回読むプロジェクトの決まりのファイル)に従ってレビューします。claude -p で動かしたときも同じです。チームで毎回見てほしい点は、CLAUDE.md に書いておくのが確実です。 書き方はCLAUDE.md の書き方ガイドで詳しく扱っています。

一方で、後述する REVIEW.md は、GitHub の PR を自動で見る Code Review 専用のファイルで、/code-review は読みません。手元と PR の両方で効かせたい決まりは CLAUDE.md、PR のレビューだけの決まりは REVIEW.md と分けます。

もっと自分たちに合わせたいときは、次の2つの方法があります。

  • コマンドを置き換える:プロジェクトか個人のスキルに code-review という名前のものを作ると、組み込みの /code-review の代わりに動きます。別名の /review は組み込みのレビューのまま動きます
  • レビュー担当を自作する:観点ごとのレビュー担当をサブエージェントやスキルとして作り、必要なときに呼び出します

なお、/code-review は組み込みのスキルなので、ディスク上に開いて書き換える SKILL.md はありません(出典:Review locally with /code-review の「Change or build on the review」)。

似たコマンドとの違い:/simplify と /verify

/code-review と名前や役割が近いコマンドが2つあります。

  • /simplify:使い回し・簡素化・効率・抽象化の度合いの4つの観点で整理だけを見て、直すところまで行います。バグは探しません。 v2.1.147 より前は、バグ探しのコマンドが /simplify という名前で、既定で修正まで行っていました。昔の手順で /simplify をバグ探しに使っていた場合は、/code-review --fix に置き換えます
  • /verify:アプリを実際にビルドして動かし、変更が意図どおりに動くかを確かめます。テストや型の検査では分からない「画面で本当に動くか」を見る用途です

出典:Commands(2026年11月16日取得)。コマンド全体の一覧はClaude Code のコマンド一覧にまとめています。

/security-review:セキュリティの観点だけを見る

/security-review は、今のブランチの変更をセキュリティの穴に絞って調べるコマンドです。 公式のコマンド一覧によると、自分のブランチと、origin(リモートの GitHub など)の既定のブランチとの差を見て、入力値を使った攻撃(インジェクション)、認証の不備、データの漏れといった危険を挙げます(出典:Commands)。

使う前に、次の点を押さえておきます。

  • origin/HEAD という参照が要る:/security-review は、origin の既定のブランチを指す origin/HEAD との差を取ります。リモートが無いリポジトリのほか、CI などで1つのブランチだけを取り出した場合にも、この参照が無く ambiguous argument というエラーで止まります。直すには git remote set-head origin main(main は既定のブランチ名)を実行してから、もう一度 /security-review を打ちます。1つのブランチだけを取り出した CI では、その前に git remote set-branches --add origin main と git fetch origin で既定のブランチを取り込んでおきます(出典:Errors の「/security-review fails without origin/HEAD」)
  • バグ全般の確認は /code-review に任せる:/security-review はセキュリティに絞ったコマンドなので、ふつうのバグ探しは /code-review、ログイン処理・権限・個人情報を扱う変更には /security-review も、と使い分けます

Claude が書いている最中から自分のコードを見直させたい場合は、Anthropic 公式の「security-guidance」プラグインもあります。入れておくと、Claude が自分の変更を作業中に見直し、見つけた問題をその場で直します(出典:Catch security issues as Claude writes code)。インストールは /plugin install security-guidance@claude-plugins-official です。使うには Python 3.7 以上が要り、コミット時のレビューを AI に任せる機能は Python 3.10 以上が要ります。ターンの終わりとコミット時のレビューは、作業しているフォルダが git のリポジトリであることが前提です。プラグインの選び方はClaude Code のプラグインとマーケットプレイス、会社で使うときのセキュリティの考え方はClaude Code の企業向けセキュリティで扱っています。

ultrareview:マージ前にクラウドで深く見る

ultrareview(/code-review ultra)は、Anthropic のクラウドで複数のレビュー担当を同時に動かし、見つけた問題を一つずつ再現して確かめる深いレビューです。 公式ドキュメントでは研究プレビュー(試験提供)の機能とされ、機能・料金・提供範囲は今後変わる可能性があると書かれています(出典:Find bugs with ultrareview)。今の呼び方は /code-review ultra で、/ultrareview は別名です。

手元の /code-review との違いを、公式の比較表から抜き出します。

/code-review/code-review ultra(ultrareview)
対象作業中の差分、PR、ブランチ、フォルダ作業中の差分か PR
動く場所自分のセッションクラウドの作業環境
深さ深さ(effort)の指定で変わる複数のレビュー担当が調べ、指摘を一つずつ確かめる
かかる時間数秒から数分おおむね5〜15分
費用ふだんの利用枠に含まれる無料の回数の後は、使用クレジットから1回ごと
向いている場面作業しながらの素早い確認大きな変更をマージする前の念入りな確認

出典:ultrareview の「How ultrareview compares to /code-review」

使える条件

  • claude.ai のアカウントでのログインが必要:API キーだけでログインしている場合は、/login で claude.ai にログインし直します
  • 使えない環境:Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry 経由で使っている場合、データを保存しない契約(Zero Data Retention)や HIPAA の設定を有効にした組織では使えず、/code-review ultra を打っても手元のレビューに切り替わります。顧客管理の暗号鍵(CMEK)を使う組織も実行できません
  • 大きすぎる変更は断られる:ブランチのレビューは、既定で変更ファイル500件・変更行8,000行までです。超えると、上限と自分の変更の大きさを示して断られます

無料の回数と料金のしくみ

Pro・Max・Ultra には3回の無料分があり、これはアカウントごとに1回限りで、毎月の補充はありません。 「月3回まで無料」と紹介している記事もありますが、公式ドキュメントは「一度きりの割り当てで、補充されない」と書いています。無料の3回を使い切った後は、プランに含まれる利用枠ではなく、使用クレジットから1回ごとに引かれます(出典:ultrareview の「Pricing and free runs」)。使用クレジットは、プランに含まれる利用枠とは別に、API の標準の単価で使った分だけ払うしくみです(出典:Manage usage credits for paid Claude plans)。

費用の注意点は次の3つです。

  • 使用クレジットを有効にしないと、有料の回は始められない:/usage-credits で設定を確かめたり変えたりできます
  • 実行前に見積もりが出る:起動前の確認画面に、レビューの範囲、残りの無料回数、見込みの費用が表示されます。1回の費用は変更の大きさで変わります
  • 途中で止めても回数は減る:クラウドの作業が始まった時点で1回と数えます。無料の回は途中で止めても1回使ったことになり、有料の回は動いた分だけ請求されます

使い方:ブランチと PR

/code-review ultra              # 今のブランチと既定のブランチの差を見る
/code-review ultra develop      # develop との差を見る
/code-review ultra 1234         # github.com の PR 1234 を見る
/code-review ultra check my auth changes   # 今のブランチを見て、メモに沿って結果を説明する

ブランチを見るときは、手元のリポジトリの中身をまとめてクラウドに送ります。コミットしていない .env のような鍵や認証情報らしい名前のファイルは、クラウドへの送り方の決まりに従って扱われます。PR の番号を渡したときは、手元からは何も送らず、クラウド側が github.com から PR を取り出します。このとき、Claude のアカウントにつないだ GitHub のアカウントに、そのリポジトリを読む権限が要ります(つなぐには /web-setup)。

始まった後はセッションの裏で動くので、ほかの作業を続けられます。動いているレビューは /tasks で確認・停止でき、終わると確かめられた指摘がセッションに届きます。なお、ultrareview は自分で /code-review ultra を打ったときだけ動き、Claude が勝手に始めることはありません。

github.com の PR を見たときは、v2.1.227 以降なら、終わった指摘を自分の GitHub アカウントから PR に1件のコメントとして書き込めます。書き込むかどうかは実行のたびに確認画面で選び、既定は書き込まない設定です。

CI やスクリプトから動かす

CI やスクリプトからは、claude ultrareview という別のコマンドを使います。終わるまで待ち、結果を標準出力に出します。

claude ultrareview              # 今のブランチと既定のブランチの差
claude ultrareview 1234         # PR 1234
claude ultrareview origin/main  # origin/main との差

--json で生のデータ、--timeout 分 で待つ上限(既定は45分)、--post で PR へのコメントを指定できます。claude -p '/code-review ultra' は結果を待たずに終わるので、スクリプトでは claude ultrareview を使います。

CI では、フォルダを信頼するかの確認で止まる点に注意します。 確認に答えられない CI の中では Error: Workspace not trusted で終わるため、v2.1.309 以降の --trust-workspace を付け、その1回だけフォルダを信頼させます(例:claude ultrareview 1234 --trust-workspace)。信頼すると、git や Claude Code がそのフォルダの設定に書かれたプログラムを動かせるようになるので、中身を信頼できるリポジトリだけに使います(出典:ultrareview の「Trust the folder before the review runs」)。

Code Review:GitHub の PR を自動でレビューする

Code Review は、Team・Enterprise の組織向けに、GitHub の PR を Anthropic の基盤で自動レビューし、指摘を行ごとのコメントで書き込むサービスです。 組織の Owner(管理者)が有効にすれば、リポジトリにワークフローのファイルを足さずに動きます(出典:Code Review、Set up Code Review)。

使える条件

項目条件
プランTeam・Enterprise
コードの置き場所GitHub(GitHub Enterprise Server、データ所在地つきの GitHub Enterprise Cloud を含む)
有効にする人Claude の組織の Owner が管理画面(Admin settings の Claude Code)で有効にする。Claude GitHub App のインストールは GitHub の組織の Owner が行う
使えない組織データを保存しない契約(Zero Data Retention)や HIPAA の設定を有効にした組織、顧客管理の暗号鍵(CMEK)を使う組織
クラウド事業者経由の会社Bedrock などで Claude Code を使っていても、上のプランの Claude の組織が別に要る

出典:Code Review の「Availability」

動くしくみと、PR に付くもの

レビューは「探す → 確かめる → 並べる → 書き込む」の4段で動きます。複数のレビュー担当が差分と周りのコードを同時に読み、見つけた候補をコードと照らし合わせて誤った指摘を落とし、重複をまとめて重大度の順に並べてから PR に書き込みます。既定で見るのは「本番で壊れるバグ」で、書き方の好みやテストの不足は対象外です。

PR に付くのは、問題のある行へのコメント、まとめの文、「Claude Code Review」という名前のチェックです。指摘には3つの重大度が付きます。

印重大度意味
🔴Importantマージ前に直すべきバグ
🟡Nit小さな問題。直したほうがよいが、止めるほどではない
🟣Pre-existingこの PR で入ったものではなく、もともとあったバグ

出典:Read and request reviews on a pull request の「Severity levels」

Code Review は PR を承認も差し止めもしません。 チェックは失敗の結果にならないので、マージするかどうかは人が決めます。レビューの中ではリポジトリを読むだけで、コミットを書き込むことも、コードをビルドしたり動かしたりすることもありません。

Important の指摘があればマージを止めたい場合は、チェックの詳細の最後の行に重大度ごとの件数が入っているので、自分の CI からそれを読んで止める方法が公式ドキュメントに載っています(normal という項目が Important の件数)。

いつ動くか:3つの設定と @claude review

リポジトリごとに、いつレビューが動くかを Owner が選びます。

設定動くとき
Once after PR creationPR を開いたとき、開き直したとき、下書きから「レビュー可」にしたとき
After every push変更を送るたび(管理画面からリポジトリを足したときの初期値)
Manual (@claude review)開いたときも変更を送ったときも動かない。コメントで頼んだときだけ

出典:Code Review costs and usage の「How often reviews run」

どの設定でも、リポジトリに書き込む権限がある人は、PR にコメントでレビューを頼めます。

コメントすること
@claude review今1回だけレビューする
@claude review always今レビューし、以後は変更を送るたびにレビューする
@claude review stop「送るたびにレビュー」をやめる(動いているレビューは止めない)

コメントは、行へのコメントではなく PR 全体へのコメントとして新しく書き、コマンドを1行目の先頭に置きます。2026年7月の更新より前は、@claude review だけで「以後も毎回レビュー」になっていました。 以前の動きを前提にしている場合は、@claude review always に書き換えます。下書きの PR と、フォーク(別のアカウントに複製したリポジトリ)からの PR は、自動のレビューでは飛ばされるので、コメントで頼みます。

費用のかかり方と上限の付け方

Code Review には1回いくらという決まった料金がなく、使った量(トークン)に応じて、プランの利用枠とは別に使用クレジットから組織に請求されます。 PR を出した開発者ではなく組織への請求です。Bedrock などを使っている会社でも、Code Review の費用は Anthropic の請求に載ります(出典:Code Review costs and usage)。

1回の費用を左右するのは、次の4つです。

  • レビューの深さ:軽い Quick、標準の Standard、最も念入りな Deep の3段階。深いほど時間も費用もかかる。Owner が組織の既定を決め、リポジトリごとに変えられる
  • 変更の大きさ
  • 周りのコードの複雑さ
  • 確かめる必要のある指摘の候補の数

回数を左右するのは、上の「いつ動くか」の設定です。「After every push」は変更を送るたびに動くので、1つの PR で何度も送るチームでは費用が膨らみます。

公式ドキュメントは、広く使う前に小さく試して見積もる手順を勧めています。

  1. Code Review 用の月の上限額を設定する
  2. 代表的なリポジトリをいくつか選び、「Once after PR creation」か「Manual」で有効にする
  3. 何回か動いた後、管理画面のリポジトリ一覧の「Average cost」で1回あたりの平均を見る
  4. 平均に月の PR の数を掛ける。「After every push」にするなら、PR ごとの平均の送信回数も掛ける

月の上限額は、claude.ai の管理画面の使用量の設定で、Code Review のサービスに対して付けます。上限や組織のクレジットの残りが足りなくなるとレビューは飛ばされ、PR にその理由のコメントが付きます。

観点を指示する:REVIEW.md と CLAUDE.md

Code Review に「何を指摘してほしいか・何を見なくてよいか」を伝えるには、リポジトリの一番上に REVIEW.md を置きます。 Code Review は CLAUDE.md も読み、その決まりに反する変更を、内容に合った重大度で指摘します。REVIEW.md はレビュー専用の指示で、指摘を探す担当にも確かめる担当にも渡されます(出典:Customize Code Review)。

公式ドキュメントの例を、日本語のチームで使う形にすると次のようになります。

# レビューの指示

## このリポジトリでの Important の意味

Important は、動作を壊す・データを漏らす・元に戻せなくなる指摘だけに使う。
例:誤った処理、テナントで絞り込んでいないデータベースの検索、
ログやエラー文への個人情報の出力、後方互換の無いマイグレーション。
書き方・命名・リファクタリングの提案は、最大でも Nit とする。

## Nit の上限

Nit は1回のレビューで5件まで。

## 指摘しないもの

- CI ですでに検査しているもの(lint、整形、型エラー)
- src/gen/ の下の自動生成ファイルと、すべての *.lock ファイル
- 意図的に本番の決まりから外しているテスト専用のコード

## 必ず確かめること

- 新しい API の入口には結合テストがある
- ログに、メールアドレス・ユーザーID・リクエストの本文を出していない
- データベースの検索が、呼び出した人のテナントで絞り込まれている

REVIEW.md で効果が出やすい書き方は、公式ドキュメントによると次の5つです。

  • Important の基準を決め直す:初期の基準は本番のコード向けなので、資料や設定だけのリポジトリでは狭く定義する
  • Nit の件数に上限を付ける:「Nit は5件まで」のようにして、指摘を読み切れる量にする
  • 見なくてよい場所と種類を書く:自動生成のコード、ロックファイル、CI で検査済みのもの
  • チームの決まりを足す:「新しい API には結合テストを付ける」など
  • 誤った指摘を減らす条件を書く:「動作についての指摘には、名前からの推測ではなく、ソースのファイルと行を示す」

大事な注意が1つあります。 REVIEW.md は、PR の変更の中ではなく、PR の向き先のブランチか既定のブランチから読まれます。指示を変えたいときは、先に REVIEW.md の変更をマージします。また、重大度を下げる・場所や種類を除く・Nit に上限を付けるといった指示は、既定のブランチを保護しているときに守られます。保護が無いと、フォルダごとの REVIEW.md や、@ファイル名 で取り込んだ別ファイルも読まれません。

Code Review が「保護」と数える設定は、公式ドキュメントでは次のとおりです(出典:Customize Code Review の「What counts as branch protection」)。

  • 既定のブランチ:従来のブランチ保護ルール(classic)でも、ルールセット(ruleset)でもよい
  • それ以外のブランチ:ルールセットだけ
  • ルールセットの条件:「更新を制限する」か「1件以上の承認つきの PR を必須にする」もの。承認を必須にする場合は、さらに「新しい push で承認を取り消す」か「最後の push の後の承認を必須にする」のどちらかも要る。承認1件を必須にしただけのルールセットは、保護とは数えられない

GitHub Actions で自分の CI に組み込む

Team・Enterprise の Code Review を使わずに PR ごとの自動レビューをしたいなら、GitHub Actions で自分の CI から Claude Code を動かします。 公式ドキュメントの比較表でも、「自分の CI で、GitHub Actions か GitLab CI/CD を使って動かす」方法は、API キーかクラウド事業者の認証情報があれば誰でも使える選択肢として並んでいます。GitHub Actions の場合は、API キーの代わりに、Pro・Max・Ultra・Team・Enterprise のサブスクリプションで claude setup-token を実行して作るトークンでも認証できます(出典:Claude Code GitHub Actions)。コードを GitLab に置いている場合は、同じ考え方で GitLab CI/CD から動かせます。

この方法は、Claude の GitHub アプリの入れ方、ワークフローのファイルの書き方、@claude での呼び出し、費用と権限の注意など、準備することが多くあります。手順はClaude Code と GitHub の連携方法(GitHub Actions・@claude の設定)で詳しく扱っているので、そちらをご覧ください。

Code Review と比べたときの違いは、動く場所が自分の CI の実行環境で、費用が CI の実行時間と、API の利用料(サブスクのトークンならサブスクリプションの枠)になる点です。一方で Code Review は、ワークフローのファイルを足さずに動き、指摘を確かめる段や重大度のしくみが最初から組み込まれています。

Code Review と GitHub Actions を同じリポジトリで併用するときは、呼び出しの言葉を分けます。 Action が既定の @claude で反応する設定のままだと、Code Review を頼む @claude review のコメントで Action も動きます。公式ドキュメントは、Action の trigger_phrase を別の言葉に変えるよう書いています(出典:Read and request reviews on a pull request の「Use Code Review alongside the Claude Code GitHub Action」)。

ローカルと PR での使い分け:おすすめの組み合わせ

手元の /code-review は「書いている人が自分で使う確認」、PR の自動レビューは「チームで漏れを防ぐ確認」と役割が違うので、両方を組み合わせるのが基本です。 立場ごとの組み合わせの目安をまとめます。

立場おすすめの組み合わせ
個人の開発(Pro・Max・Ultra)ふだんはコミット前に /code-review。大きな変更をマージする前だけ /code-review ultra(無料の3回から)。PR ごとの自動レビューが欲しければ、サブスクのトークンで GitHub Actions を動かす
API キーで使う小さなチーム手元で /code-review。PR ごとの自動レビューは GitHub Actions で組み込む。共有の鍵は個人のサブスクのトークンではなく API キーにする
Team・Enterprise の組織手元で /code-review、PR は Code Review。費用を見るため、最初は「Once after PR creation」か「Manual」から。GitHub Actions も使うなら trigger_phrase を変える
Bedrock・Agent Platform・Foundry 経由の会社手元で /code-review と /security-review。ultrareview は使えないため、深い確認は /code-review の深さを上げるか、Code Review 用に Claude の組織を用意する
ログイン・権限・個人情報を扱う変更どの立場でも /security-review を足す

テストを先に書く進め方と組み合わせると、レビューの前にテストで動作を確かめられるので、レビューは設計や漏れの確認に集中できます。進め方はClaude Code でのテスト駆動開発で扱っています。PR を出す前の手作業のセルフレビューや、コミット・PR の作成の効率化はClaude Code での PR とコミットの自動化が参考になります。

導入前に確認したい注意点

  • AI のレビューは見落としがある:公式ドキュメントは Code Review について「A review with no findings doesn't mean your code is error-free or secure.」(指摘が無いことは、コードに誤りが無い・安全だという意味ではない)と注意しています。最後に判断するのは人です
  • 「After every push」は費用が送信回数に比例する:最初は回数の少ない設定で、1回あたりの平均を見てから広げます
  • ultrareview のブランチのレビューは、手元の中身をクラウドに送る:送りたくないファイルがある場合や、手元のリポジトリが大きすぎる場合は、PR の番号を渡す方法を使います
  • REVIEW.md は保護されたブランチでないと一部が効かない:Nit の上限や除外の指示が効いていないと感じたら、既定のブランチの保護の設定を見直します。承認1件を必須にしただけのルールセットは保護と数えられません
  • --fix の修正は巻き戻しの対象外になることがある:コミットしてから使い、戻すときは git を使います

よくある質問

まとめ

  • Claude Code でコードレビューする方法は、/code-review(別名 /review)、/code-review ultra(ultrareview)、Code Review、GitHub Actions で自分の CI から動かす方法、自作のレビュー担当の5つ。セキュリティに絞るなら /security-review
  • /code-review はどのプランでも使え、PR 番号・ブランチ・フォルダを指定でき、深さは low から max。--fix の修正はコミットしてから使う
  • ultrareview はクラウドで指摘を一つずつ確かめる深いレビュー。Pro・Max・Ultra の無料3回はアカウントごとに1回限りで、その後は使用クレジット
  • Code Review は Team・Enterprise の組織で、GitHub の PR を自動でレビューする。費用は使った量に応じて組織に請求され、上限額を付けられる
  • 観点の指示は、手元と PR の両方なら CLAUDE.md、PR だけなら REVIEW.md。REVIEW.md は既定のブランチを保護して使う

レビューの機能は更新が早く、ultrareview は試験提供の段階です。本記事も、公式ドキュメントの更新にあわせて見直します。

この記事に合う資料

関連記事

資料で全体をつかんでから、御社の場合をご相談ください

  • 研修・稟議・外注の準備に使える資料を無料で
  • 見積書の確認は、登録なしで診断できます
  • 相談は 30 分無料。代表が直接お返事します
  • 要件が決まっていなくても大丈夫です