AIコードレビューの使い方|任せる範囲の線引き
業務効率化支援を行う「Ai-Raku(アイラク)」代表。国立大学でAIの研究を行い、ITコンサル・ウェブコンサルを経て独立。官公庁向けの業務効率化や上場企業の支援等を経て、中小企業の現場に定着するAI活用を企画から運用まで一気通貫で支援している。

- 人のレビューの代わりになりますか?
- なりません。任せられるのは「気になる箇所を漏れなく挙げる」工程までです。どれを直すか決める判断と、直した結果が意図どおりか確認する工程は、人が持ってください。この線引きをせずに導入すると、指摘の山を前に誰も動かなくなります。
- どんな指摘が得意ですか?
- コードだけを読めば判断できるものです。記述ミスや取りこぼし、社内規約からの逸脱、可読性や重複、テストの抜け。特に、変更した箇所の影響が離れた場所に及ぶケースは、人が最も見落とす領域なので効果が出ます。
- 逆に苦手なのはどこですか?
- コードの外側の情報が必要なものです。業務仕様との整合、その実装を選んだ意図が妥当かどうか、性能が実際に問題になるか、セキュリティ上これで安全と言えるか。この4つは必ず人が判断してください。
- 指摘が多すぎて読み切れません
- 最も多い相談です。対処は3つ。軽微な指摘の件数に上限を決めること、変更の規模を超える修正はその場でやらないこと、「見送る」と判断したものは理由をコメントに残すことです。3つ目を省くと、毎回同じ議論を繰り返します。
- 無料で試せますか?
- Claude Codeの場合、セッション内で/code-reviewを実行して手元の差分をレビューする方法は、GitHubアプリの導入なしに使えると公式ドキュメントに記載されています。GitHub連携の自動レビューはTeam・Enterprise向けのリサーチプレビューです。まずは手元での実行から始めてください。
- 費用はどれくらいかかりますか?
- Claude CodeのGitHub連携版について、公式ドキュメントにはレビュー1回あたり平均15〜25米ドル、PRの規模や複雑さで変動すると記載されています。プランの利用枠とは別課金です。プッシュのたびに動かす設定は費用が積み上がるため、まずは手動またはPR作成時1回から始めるのが現実的です。
- マージがブロックされませんか?
- Claude CodeのCode Reviewについては、承認もブロックもせず、チェックは常に中立の結果で完了すると公式ドキュメントに明記されています。ブランチ保護ルールでマージが止まることはありません。マージ可否の判断は人の側に残る設計です。
- 指摘を自社ルールに合わせられますか?
- できます。Claude CodeではCLAUDE.mdにプロジェクト全体の指示を、REVIEW.mdにレビュー専用の指示を書く方式が公式に用意されています。重要度の定義変更、軽微な指摘の件数上限、指摘しない対象の指定などが調整例として挙げられています。ただし書きすぎると効果が薄れるとも明記されているので、最初は3〜5項目に絞ってください。
- 社外秘のコードを読み込ませて大丈夫ですか?
- 使うサービスのデータ取り扱い設定を、導入前に管理者が確認してください。学習に使われるか、どれくらい保持されるか、契約形態で条件が変わるかを提供元の記載で確認します。なおClaude CodeのCode Reviewは、ゼロデータ保持を有効にしている組織では利用できないと公式に明記されています。
- 顧客データが入ったファイルはどうしますか?
- 対象から除いてください。実務で問題になりやすいのは、コード本体より「紛れ込んでいるもの」です。設定ファイルの接続情報や鍵、テストデータの中の実在する顧客名、コメントに書かれた取引先との経緯。レビューに出す前に一度確認する習慣をつけてください。
- AIが間違った指摘をしてきます
- 前提として起こります。存在しない関数を前提にした指摘や、事情があってそうしている実装への「非効率だ」という指摘は珍しくありません。対策は、意図があってそう書いている箇所にコメントで理由を残すことと、指摘そのものを検証する工程を省かないことです。
- 外注先の納品物のチェックに使えますか?
- 使えます。テストが書かれているか、エラー処理が入っているか、明らかに危険な書き方がないかは確認できます。ただし黙って使わず、事前に外注先に伝えてください。伝えずに指摘を投げると関係が悪化します。
- AIの指摘を根拠に修正を求められますか?
- 契約でどう定めているかによります。契約形態によって成果物への責任範囲が変わるため、「AIが指摘したから直してほしい」だけでは根拠になりません。特に「今回の変更で作り込まれたのではない既存の問題」を対応対象に含めると、実質的に契約範囲外の作業を求めることになります。事前に合意してください。
- AIペアプログラミングとどう違いますか?
- 書いている最中にAIが横で助言するのがペアプログラミング的な使い方、書き終わったものをまとめて見るのがコードレビューです。小規模チームで効果が出やすいのは後者です。助言は書いた本人にしか届きませんが、レビューはチーム全体の品質基準を揃える働きをするからです。
- 導入すれば不具合は減りますか?
- 大きくは減らないと考えてください。実務の不具合の多くは業務仕様の認識違いが原因で、これはコードをいくらレビューしても見つかりません。減るのはレビュー待ちの時間と、レビュー担当者が単純な指摘に使っていた時間です。仕様起因の手戻りを減らすには、レビューではなく仕様の詰め方を変える必要があります。
- 何から始めればよいですか?
- 1つのリポジトリ、1人の担当者、止まっても業務が止まらない対象から始めてください。手元で2週間ほど動かして指摘の傾向を掴み、扱いを3点だけ決めて文書化する。この順番なら、指摘の山に埋もれる失敗を避けられます。
AIにコードレビューをやらせてみた、という話は増えました。ところが実際に導入したチームで起きているのは、「指摘は大量に出たが、結局どれを直せばいいのか分からない」という状態です。レビューが楽になるどころか、指摘を仕分ける仕事が新しく増えてしまう。これがいま最も多く聞く失敗です。
原因ははっきりしています。AIに何を任せて、何を任せないかの線引きをせずに導入しているからです。AIコードレビューは「レビュー担当者の代わり」ではありません。任せられるのは指摘の一次抽出までで、その先の「これは直すべきか」という判断は人の仕事として必ず残ります。
本記事は、その線引きを具体的に決めるための記事です。小規模な開発チーム、情報システム担当が兼務で見ている会社、外注先と協業しながら開発を進めている担当者を想定しています。大企業のように専任のレビュアーが何人もいる体制は前提にしていません。
- AIコードレビューに任せてよい範囲と、人が判断すべき範囲
- AIが得意な指摘4つ/苦手な指摘4つの具体例
- 指摘が多すぎてレビューが形骸化する問題への対処
- Claude Codeで実際にどう動くか(公式ドキュメントで確認できる範囲)
- 社外秘のコード・顧客データを含むコードの扱い方
- 外注先の成果物を確認する用途で使うときの注意点
- モデルケース試算(当社が想定する典型的な状況にもとづく数字)
- 結論:任せるのは一次抽出まで
- AIコードレビューとは何をするものか
- AIが得意な指摘4つ
- AIが苦手な指摘4つ
- 最大の失敗は指摘が多すぎること
- Claude Codeでは実際にどう動くか
- 導入の手順は4ステップ
- コードを外部に出すときの扱い
- 外注先の成果物を確認する用途
- モデルケース|5名のチームでの導入(試算)
- 経営側が見るべき指標
- よくある質問(FAQ)
- Q. 人のレビューの代わりになりますか?
- Q. どんな指摘が得意ですか?
- Q. 逆に苦手なのはどこですか?
- Q. 指摘が多すぎて読み切れません
- Q. 無料で試せますか?
- Q. 費用はどれくらいかかりますか?
- Q. マージがブロックされませんか?
- Q. 指摘を自社ルールに合わせられますか?
- Q. 社外秘のコードを読み込ませて大丈夫ですか?
- Q. 顧客データが入ったファイルはどうしますか?
- Q. AIが間違った指摘をしてきます
- Q. 外注先の納品物のチェックに使えますか?
- Q. AIの指摘を根拠に修正を求められますか?
- Q. AIペアプログラミングとどう違いますか?
- Q. 導入すれば不具合は減りますか?
- Q. 何から始めればよいですか?
- まとめ
結論:任せるのは一次抽出まで
最初に結論を書きます。AIコードレビューに任せてよいのは「見落としを拾い上げる」工程だけです。拾い上げた指摘のうち、どれを直し、どれを見送るかを決める工程は人が持ってください。
この線引きが重要なのは、AIの指摘には「正しいが、いま直す必要はない」ものが大量に含まれるからです。変数名がやや分かりにくい、この処理は共通化できる、この分岐は到達しない可能性がある。どれも指摘としては間違っていません。しかし、納期が迫った修正パッチに対してそれを全部やれば、直す必要のなかった場所を触ることになり、かえって新しい不具合を作ります。
言い換えると、AIコードレビューの価値は「見落としをゼロに近づけること」にあり、「判断を代わりにやってくれること」ではありません。この2つを混同したまま導入すると、指摘の山を前に誰も動かなくなります。
3つの工程に分けて考える
コードレビューを3つの工程に分けると、任せる範囲が見えます。
| 工程 | やること | 担当 |
|---|---|---|
| ①抽出 | 気になる箇所を漏れなく挙げる | AI(人は補助) |
| ②仕分け | 直すもの・見送るものを決める | 人 |
| ③確認 | 直した結果が意図どおりか見る | 人 |
従来のレビューでは、この3つを1人のレビュアーが同時にやっていました。だから時間がかかり、特定の人に集中していたのです。AIを入れる意味は、最も時間がかかり、かつ最も属人性が低い①だけを切り出せる点にあります。②と③はもともと属人性が高く、切り出せません。
AIコードレビューとは何をするものか
言葉の整理をしておきます。AIコードレビューとは、コードの変更差分をAIに読ませ、問題になりそうな箇所を指摘として出力させる仕組みのことです。人が書いたコードにも、AIが書いたコードにも使えます。
静的解析ツールとの違い
「それはLintや静的解析ツールと何が違うのか」という質問をよく受けます。違いはルールが事前に決まっているかどうかです。
静的解析ツールは「この書き方は禁止」というルールをあらかじめ登録しておき、それに反する箇所を機械的に検出します。ルール外のことは絶対に見つけません。逆に言えば、誤検知は少なく、結果が安定します。
AIによるレビューは、ルールを登録しなくても文脈から「これはおかしいのでは」と指摘します。そのぶん、ルール化しづらい問題を拾える代わりに、誤検知が混じります。両者は代替関係ではなく、Lintで機械的に潰せるものはLintに任せ、AIにはそれ以外を見せるのが正しい組み合わせです。
AIペアプログラミングとの関係
「AIペアプログラミング」という言葉も同じ文脈で使われます。こちらは書いている最中にAIが横で助言する形、コードレビューは書き終わったものをまとめて見る形、という違いです。
小規模なチームで効果が出やすいのは、実は後者です。書いている最中の助言は書いた本人にしか届きませんが、レビューはチーム全体の品質基準を揃える働きをするからです。1人が気づいたことをチームの基準にしていく作業を、AIが下書きしてくれると考えてください。
AIが書いたコードを見る用途が増えている
近年もう1つ需要が伸びているのが、AIに書かせたコードをAIにレビューさせる使い方です。自然言語で指示してコードを生成させる進め方が広がった結果、「動いてはいるが、中身を誰も把握していないコード」が生まれやすくなりました。この進め方の利点と落とし穴はバイブコーディングとは|非エンジニアの落とし穴と線引きで整理しています。
この場合、レビューの目的は「バグ探し」というより「何が作られたのかを人が把握し直すこと」になります。目的が違えば、見るべき指摘も変わります。ここを意識しないまま同じ設定で回すと、指摘の量に埋もれます。
AIが得意な指摘4つ
実務で「これはAIに任せてよい」と言い切れる領域を挙げます。共通しているのは、コードだけを読めば判断できるという点です。
得意①|記述ミスと単純な取りこぼし
変数の取り違え、条件式の反転、nullや空文字が来たときの考慮漏れ、例外を握りつぶしている箇所。人の目が最も滑りやすく、しかもコードだけで判断できる領域です。
特に価値が高いのは、差分の外にある影響を拾える点です。修正した関数を呼んでいる別の場所で前提が崩れる、といった指摘は、人がレビューすると「その関数の周辺を知っている人」しか気づけません。ここが属人性の温床でした。
得意②|社内規約や書き方の逸脱
命名規則、ディレクトリ構成、ログの出し方、エラーの返し方。「うちではこう書く」という決めごとから外れている箇所の検出です。
これは本来Lintで潰すべき領域ですが、小規模なチームではLintの設定を書く工数自体が確保できないことが多くあります。ルールを文章で書いておけば読んでくれるのがAIレビューの実務的な利点です。後述するとおり、Claude CodeではCLAUDE.mdというファイルにルールを書いておく方式が公式に用意されています。
得意③|可読性と重複
関数が長すぎる、同じ処理が複数箇所にある、コメントと実装が食い違っている。「今すぐ困らないが、半年後に困る」類の指摘です。
人のレビューではこの領域が最初に省略されます。時間がないときに真っ先に飛ばされるからです。逆に言えば、AIに任せて最も差が出るのがここです。ただし後述するとおり、この領域の指摘は量が多くなりがちなので、扱い方を決めておく必要があります。
得意④|テストの抜け
この分岐を通るテストがない、異常系が試されていない、追加した関数にテストが1つもない。網羅性の確認は機械の得意分野です。
「テストを書く時間がない」という理由でテストが薄いチームほど、この指摘の価値が高くなります。どこが試されていないかが可視化されるだけで、リスクの所在が分かるからです。全部書かなくても、危ない場所が分かれば判断できます。
AIが苦手な指摘4つ
ここからが本題です。AIに任せてはいけない4領域を挙げます。共通しているのは、コードの外側にある情報がないと判断できないという点です。
苦手①|業務仕様との整合
最も重要な弱点です。「このコードは正しく動くが、業務としては間違っている」という状態を、AIは検出できません。
例えば、締め日をまたぐ請求処理で月末を含めるか含めないか。返品時の在庫を戻すタイミング。値引きを税抜と税込のどちらに適用するか。これらはその会社の商習慣や契約で決まっていることであり、コードを読んでも分かりません。AIは「実装として整合している」ことしか確認できないのです。
ここが抜けると、レビューを通ったのに現場から「数字が合わない」と言われる事態が起きます。業務仕様の確認だけは、業務を知っている人が必ず見てください。そもそも仕様が文書として存在しないケースも多く、その場合はレビュー以前の問題です。仕様の固め方は要件定義の進め方|中小企業がつまずく5つの原因と対策で整理しています。
苦手②|その実装を選んだ意図の妥当性
AIは「別のやり方がある」とは言えますが、「なぜこのやり方を選んだのか」を知りません。
実務のコードには、過去の事情で意図的にそうしている箇所が必ずあります。取引先のシステムが古い形式しか受け付けない、あるタイミングで発生した障害の再発防止で冗長にしている、次の改修で捨てる前提で仮に置いてある。AIはこれらを「非効率な実装」として指摘します。
この指摘に素直に従うと、事情を知らないまま「きれいに」書き直してしまい、過去に潰した問題が復活します。実務で最も損害が大きい失敗パターンの1つです。意図があってそうしている箇所には、コメントで理由を残しておくのが唯一の防御策になります。
苦手③|性能は実測でしか分からない
「この処理は遅くなる可能性があります」という指摘は頻繁に出ます。ところが、本当に遅いかどうかは実際のデータ量で動かさないと分かりません。
件数が100件しかないテーブルなら、どんな書き方をしても体感差は出ません。逆に、AIが問題視しなかった箇所が本番のデータ量で詰まることもあります。性能に関する指摘は「測る対象の候補」として扱い、指摘の数だけ直すことはしないでください。
苦手④|セキュリティの最終判断
誤解が多い領域です。AIは典型的な危険パターンの検出は得意です。入力値をそのまま組み立てている、認証を通らない経路がある、ログに機密情報が出ている。こうした指摘は有用です。
しかし、「この設計で安全と言えるか」という最終判断は別の仕事です。何を守るべきか、誰が攻撃者として想定されるか、どこまでのリスクを許容するか。これらは経営判断を含みます。「AIのレビューを通したから安全です」とは、絶対に言えません。
また、AIが存在しない関数やライブラリを前提に指摘してくることもあります。もっともらしいが事実でない出力への向き合い方はAIのハルシネーション対策|業務で誤情報を防ぐ手順にまとめています。指摘そのものを検証する工程を省かないでください。
最大の失敗は指摘が多すぎること
導入して最初にぶつかる壁がこれです。1回のレビューで数十件の指摘が出て、誰も全部は読まなくなる。そして「AIレビューは形だけ通す作業」になり、本当に重要な指摘まで見落とされます。
これは設定の問題であり、AIの性能の問題ではありません。放っておけば指摘は増え続けます。機械は疲れないので、指摘できることは全部指摘するからです。人が上限を決めない限り止まりません。
なぜ形骸化するのか
形骸化の流れは決まっています。
- 導入直後は全部読む。指摘が有用に見えて満足する
- 2〜3回目で、同じ種類の軽微な指摘が繰り返されることに気づく
- 「軽微なやつは飛ばそう」となる
- 飛ばす基準が人によって違うので、誰も全体を把握していない状態になる
- 重要な指摘も同じ見た目で並んでいるため、一緒に飛ばされる
ポイントは、4番目で「基準が人によって違う」まま放置されることです。ここでチームとして基準を決めれば形骸化は止まります。決めないと、レビュー結果は「見た人によって違うもの」になります。
全部直そうとしない
最も重要な原則です。AIの指摘は「直すべき候補」であって「宿題」ではありません。
特に、既にある機能を修正するだけの小さな変更に対して、周辺のコード全体を整理させるような指摘が出たときは要注意です。変更の規模を超える修正は、その場でやらないと決めてください。別のタスクとして記録し、まとめて手を入れるタイミングで扱います。
重要度で仕分ける仕組みを持つ
指摘に重要度が付いていないと仕分けできません。最低限、次の3段階で分けてください。
| 区分 | 意味 | 扱い |
|---|---|---|
| 直す | このまま出すと不具合になる | 今すぐ直す |
| ためる | 直したほうがよいが急がない | 記録して後日まとめて |
| 見送る | 意図があってそうしている | 理由をコメントに残す |
「見送る」に理由を残すのが効きます。次回のレビューで同じ指摘が出たときに、「前回見送った件だ」と即座に判断できるからです。これをやらないと、毎回同じ議論を繰り返します。
指摘の上限を決める
もう1つ実務的な対処が、軽微な指摘の件数に上限を設けることです。「軽微な指摘は1回のレビューで5件まで、残りは件数だけ報告」といった形にします。
後述するClaude Codeでは、この種の調整をリポジトリ内のファイルに文章で書いておく方式が公式に用意されています。公式ドキュメントも、長い指示は効果が薄れると明記しています。ルールは絞ってください。
Claude Codeでは実際にどう動くか
ここからは、実際のツールの挙動を公式ドキュメントで確認できる範囲で整理します。当社が支援で使っているClaude Codeを例にします。(出典:Claude Code 公式ドキュメント Code Review)
手元の差分を見る方法
Claude Codeのセッション内で/code-reviewというコマンドを実行すると、作業中のブランチの変更内容と、未コミットの変更をレビューします。ファイルパス、プルリクエスト番号、ブランチ名などを指定して対象を変えることもできます。(出典:同上)
公式ドキュメントによれば、このレビューはバックグラウンドの別セッションとして動くため、実行している間も自分の作業を続けられます。指摘を自動で反映させる--fix、プルリクエストにコメントとして投稿する--commentというオプションも用意されています。
まず試すならこの形が現実的です。外部サービスの設定も、組織の管理者権限も不要で、いま書いているコードに対してすぐ実行できます。Claude Code全体でできることはClaude Codeでできること|非エンジニアの業務活用にまとめています。
プルリクエストを自動で見る方法
もう1つが、GitHubのプルリクエストに対して自動でレビューを走らせる方式です。公式ドキュメントではCode Reviewという名称で説明されており、Team・Enterpriseプラン向けのリサーチプレビューとして提供されています。(出典:同上)
レビューが走るタイミングはリポジトリごとに選べます。公式ドキュメントに記載されている選択肢は次の3つです。
| 設定 | いつ動くか |
|---|---|
| PR作成後に1回 | プルリクエストを開いたときだけ |
| プッシュのたび | 変更を push するたびに毎回 |
| 手動 | コメントで依頼したときだけ |
小規模なチームで最初に選ぶべきは「手動」または「PR作成後に1回」です。公式ドキュメントも、プッシュのたびに動かす設定が最もレビュー回数が多く、費用も最もかかると明記しています。
指摘には重要度が付く
前述した「重要度で仕分ける」を、この仕組みは標準で備えています。公式ドキュメントによれば、指摘はImportant(マージ前に直すべきバグ)/Nit(軽微だが直す価値のある問題)/Pre-existing(このPRで作り込まれたのではない既存のバグ)の3段階に分類されます。(出典:同上)
3つ目の区分があるのが実務的です。「今回の変更のせいではないが、ついでに見つかった問題」を分けておかないと、修正の責任範囲が曖昧になります。特に外注先の納品物を見る場合、ここが混ざると話がこじれます。
ルールはファイルに書いて調整する
指摘の内容を自社に合わせる方法も用意されています。公式ドキュメントには2つのファイルが説明されています。
CLAUDE.md:プロジェクト全体の指示を書くファイル。レビュー以外の作業でも読まれる。ここに書いたルールへの違反は、原則としてNit(軽微)扱いで指摘されるREVIEW.md:レビュー専用の指示ファイル。レビューの各工程に最優先の指示として渡されるため、何をどの重要度で指摘するかを変えたいときはこちらを使う
公式ドキュメントはREVIEW.mdで調整できる例として、重要度の定義変更、軽微な指摘の件数上限、指摘しない対象(自動生成ファイルなど)の指定、リポジトリ固有のチェック項目の追加などを挙げています。本記事で述べた「指摘が多すぎる問題」への対処が、公式に想定された使い方として書かれているということです。(出典:同上)
マージは止まらない仕組みになっている
導入前に必ず知っておくべき仕様です。公式ドキュメントによれば、このレビューはプルリクエストを承認もブロックもしません。GitHub上のチェックは常に中立の結果で完了するため、ブランチ保護ルールでマージが止まることはありません。(出典:同上)
これは設計思想として重要です。AIの指摘を「通過すべきゲート」にしていないということであり、本記事の冒頭で述べた「任せるのは一次抽出まで」という考え方と一致します。マージしてよいかの判断は、あくまで人の側に残されています。
費用は事前に把握しておく
GitHub連携版を検討する場合、費用の考え方も確認してください。公式ドキュメントには、レビュー1回あたり平均15〜25米ドルで、PRの規模やコードベースの複雑さによって変動すると記載されています。また、この費用はプランに含まれる利用枠とは別に課金されると明記されています。(出典:同上)
つまり、プッシュのたびにレビューを回す設定は、そのまま費用に跳ね返ります。月にどれだけプルリクエストが出るかを数えてから設定を決めてください。組織単位で月額の上限を設定する機能も用意されています。手元の/code-reviewから始めるべき理由は、ここにもあります。
導入の手順は4ステップ
実際の進め方を示します。いきなり全社で回さないでください。
1|対象を1つに絞る
まず1つのリポジトリ、できれば1人の担当者から始めてください。複数のチームで同時に始めると、指摘の扱いに関する基準がバラバラになり、後から統一するほうが大変になります。
選ぶべきは、止まっても業務が止まらないものです。社内向けの小さなツール、管理画面、まだ本番に出ていない機能。ここで指摘の傾向を掴んでください。
2|まず手元の差分で試す
外部サービスとの連携を設定する前に、手元で数回動かして指摘の量と質を見てください。ここで「自社のコードに対してどんな指摘が出るか」が分かります。
このとき、意図的に既知のバグを含む差分を見せてみるのが有効です。過去に本番で起きた不具合を再現し、それを検出できるかを見ます。検出できれば信頼の根拠になり、できなければ「その種類の問題は人が見る」という線引きの根拠になります。どちらに転んでも収穫があります。
3|指摘の扱いを決める
3回ほど動かすと、指摘の傾向が見えてきます。ここでチームとして扱いを決めてください。決めるのは次の3点だけで十分です。
- どの重要度までを「今すぐ直す」対象にするか
- 軽微な指摘は何件までにするか、超えた分はどうするか
- 「見送る」と判断したものをどこに残すか
3番目を決めていないチームが非常に多く、これが形骸化の直接の原因になります。見送った理由が残っていないと、次回また同じ議論をします。
4|ルールを文書化する
決めた内容を、前述のCLAUDE.mdやREVIEW.mdに書いて反映させます。ここで初めて、AIの指摘が自社仕様に近づきます。
注意点は書きすぎないことです。公式ドキュメントは、指示が長いと重要なルールの効果が薄れると明記しています。最初は3〜5項目から始め、実際に困ったことだけを追加してください。
コードを外部に出すときの扱い
ここは経営判断が必要な領域です。AIレビューを使うということは、コードを外部のサービスに送るということでもあります。
総務省「令和7年版 情報通信白書」によれば、生成AI導入に際しての懸念事項として、日本では「効果的な活用方法がわからない」が最も多く、次いで「社内情報の漏えい等のセキュリティリスク」が挙げられています。(出典:総務省「令和7年版 情報通信白書」)この懸念は、コードを扱う場面では特に具体的な形をとります。
コードには機密が混ざっている
まず認識してほしいのは、コードそのものよりも、コードに紛れ込んでいるものが問題になるという点です。
- 接続情報や鍵が、設定ファイルに直接書かれている
- テストデータとして、実際の顧客名や取引先名が入っている
- コメントに、取引先との交渉経緯や社内の事情が書かれている
- 取り込み処理の中に、取引先固有の仕様が具体的に書かれている
いずれも「よくあること」です。レビューに出す前に、これらが含まれていないかを一度確認してください。特に接続情報や鍵は、外部に出す出さない以前の問題として、コードから分離すべきものです。AIレビューの導入は、それを点検するよい機会になります。
設定と契約を先に確認する
使うサービスのデータの取り扱い設定を、導入前に管理者が確認してください。入力内容が学習に使われるか、どれくらいの期間保持されるか、契約形態によって条件が変わるか。ここは推測で判断せず、必ず提供元の記載を確認します。
なお、Claude CodeのCode Review機能について、公式ドキュメントにはゼロデータ保持(Zero Data Retention)を有効にしている組織では利用できないと明記されています。(出典:Claude Code 公式ドキュメント Code Review)組織の設定によって使える機能が変わるということであり、自社がどの設定なのかを把握してから検討してください。
社内ルールに1行足す
AIの利用ルールを作っている会社は増えましたが、その多くは文書作成やチャット利用を想定した内容で、コードの扱いが書かれていません。
白書によれば、日本の中小企業では生成AIの活用方針について「方針を明確に定めていない」との回答が多く、約半数を占めています。(出典:総務省「令和7年版 情報通信白書」)ルールがないまま各自の判断で使っている状態が、実際には最も多いということです。
難しいルールは要りません。「顧客データを含むコードは対象外」「鍵や接続情報が入ったファイルは事前に除く」の2行から始めてください。ルール全体の作り方は社内AIルールの作り方|情報漏洩を防ぐ生成AIガイドライン8項目で解説しています。
外注先の成果物を確認する用途
開発を外注している会社にとって、実はここが最も価値のある使い道かもしれません。納品されたコードの中身を、発注側が自分で確認できるようになるからです。
発注側が中身を見られるようになる
これまで、外注先から納品されたコードの品質を発注側が確認する手段は、ほぼありませんでした。社内にレビューできる人がいなければ、「動いているから良しとする」以外に選択肢がなかったのです。
AIレビューを使うと、少なくともテストが書かれているか、エラー処理が入っているか、明らかに危険な書き方が残っていないかは確認できます。専門家のレビューには及びませんが、「何も見ていない」状態からは大きく前進します。
契約と責任の線引きは別の話
ただし、ここで必ず区別すべきことがあります。AIが指摘を出したからといって、それを根拠に無条件で修正を求められるわけではありません。
修正を求められる範囲は契約でどう定めているかで決まります。契約の形態によって、成果物の完成に責任を持つのか、作業時間に対して対価を払うのかが変わり、瑕疵の扱いも変わります。「AIが指摘したから直してほしい」は、契約上の根拠にはなりません。契約形態ごとの責任範囲の違いは準委任契約と請負契約の違い|AI開発の契約で失敗しないためにで整理しています。
事前に合意しておくこと
外注先に対してAIレビューを使うなら、黙って使わず、事前に伝えてください。伝えずに指摘を投げると、確実に関係が悪くなります。
合意しておくべきは次の3点です。
| 決めること | 典型的な着地 |
|---|---|
| 指摘のうち何を対応対象とするか | 重要度の高いものに限る |
| 既存コードへの指摘の扱い | 今回の対象外とする |
| 意見が割れたときの決め方 | 最終判断は発注側の担当者 |
2番目が特に重要です。前述のとおり「このPRで作り込まれたのではない既存のバグ」という区分が付く仕組みがありますが、これを対応対象に含めると、実質的に契約範囲外の作業を求めることになります。ここを最初に決めておくと、揉めません。
モデルケース|5名のチームでの導入(試算)
導入イメージを示します。以下は実在の企業ではなく、当社が想定する典型的な状況にもとづく試算です。効果は状況によって変わります。
置かれた状況
社内システムを開発している5名のチーム。うちレビューができるのはリーダー1名のみで、レビュー待ちが常態化していました。
| 項目 | 状態 |
|---|---|
| レビュー担当 | リーダー1名のみ |
| レビューにかける時間 | 約20時間/月 |
| レビュー待ちの平均 | 1件あたり1〜2営業日 |
| 本番での手戻り | 月2〜3件(軽微な不具合の差し戻し) |
| 止まっていた理由 | レビューできる人を増やせない |
やったこと
第1段階|手元で試す。リーダーが自分の変更に対して手元のレビューコマンドを実行し、2週間ほど指摘の傾向を確認。過去に起きた不具合を再現した差分も見せて、検出できるものとできないものを仕分けた。
第2段階|メンバー側に前倒し。レビュー依頼を出す前に、各メンバーが自分で一度レビューを実行し、明らかな指摘は自分で直してから依頼する運用に変更。リーダーに届く時点で、単純な指摘は消えている状態を作った。
第3段階|扱いを文書化。「軽微な指摘は5件まで」「既存コードへの指摘は別タスクに記録」「業務仕様の確認は必ず人が見る」の3点をルールとして書き、設定ファイルに反映した。
結果の試算
時給換算2,500円・月20営業日を前提とした試算です。
| 項目 | 従来 | 実施後(試算) |
|---|---|---|
| リーダーのレビュー時間 | 20時間/月 | 約12時間/月 |
| 削減見込み(月) | — | 約8時間 |
| 金額換算(月) | — | 約20,000円 |
| レビュー待ち | 1〜2営業日 | おおむね当日〜翌日 |
| リーダーが見る内容 | 記述ミスから仕様まで全部 | 仕様の整合と設計判断に集中 |
このチームで意味があったのは、削減した8時間そのものより、リーダーが見る内容が変わったことです。記述ミスの指摘に時間を使わなくなったぶん、「この実装で業務が回るか」という、その人にしか判断できない部分に時間を使えるようになりました。AIに任せた領域と、人が担うべき領域が分離できたのが本質的な変化です。
一方で、変わらなかったこともあります。本番での手戻りは大きくは減りませんでした。手戻りの原因の多くが業務仕様の認識違いであり、これはAIレビューが検出できない領域だからです。ここを減らすには、レビューではなく仕様の詰め方を変える必要があります。
「自社の開発体制でどこまで任せられるか」でお困りの方へ。線引きの整理からご一緒します。初回のご相談は無料です。無料相談はこちら。
経営側が見るべき指標
非エンジニアの立場でこの導入を判断する場合、何を見ればよいかを整理します。
品質が上がるとは限らない
最初に期待値を下げてください。AIレビューを入れても、本番の不具合が劇的に減ることは期待しないほうがよいです。
理由は前述のとおりで、実務で起きる不具合の多くは業務仕様の認識違いだからです。コードとしては正しく動いているが、業務としては間違っている。この種の問題は、コードを何回レビューしても見つかりません。
見るべきは待ち時間と集中先
代わりに見るべき指標は2つです。
- レビュー待ちの時間:依頼から返答までの日数。ここは短くなります
- レビュー担当者が何を見ているか:記述ミスの指摘から、仕様と設計の判断に移っているか
2番目が最も重要です。レビューできる人が1人しかいない、という構造的な問題は、AIでは解決しません。しかし、その1人が本当に必要な判断だけに集中できるようになれば、実質的な処理能力は上がります。
属人性は形を変えて残る
期待しすぎないでほしい点をもう1つ。「レビューできる人がいない」問題は、AIでは解消しません。
AIの指摘を仕分ける作業自体に、判断力が要るからです。「この指摘は無視してよい」と決めるには、そう決められるだけの経験が必要です。属人性は「指摘を出す」から「指摘を仕分ける」に移動しただけで、消えたわけではありません。ここを正しく理解しておかないと、導入後に「思ったほど楽にならない」と感じます。
よくある質問(FAQ)
Q. 人のレビューの代わりになりますか?
A. なりません。任せられるのは「気になる箇所を漏れなく挙げる」工程までです。どれを直すか決める判断と、直した結果が意図どおりか確認する工程は、人が持ってください。この線引きをせずに導入すると、指摘の山を前に誰も動かなくなります。
Q. どんな指摘が得意ですか?
A. コードだけを読めば判断できるものです。記述ミスや取りこぼし、社内規約からの逸脱、可読性や重複、テストの抜け。特に、変更した箇所の影響が離れた場所に及ぶケースは、人が最も見落とす領域なので効果が出ます。
Q. 逆に苦手なのはどこですか?
A. コードの外側の情報が必要なものです。業務仕様との整合、その実装を選んだ意図が妥当かどうか、性能が実際に問題になるか、セキュリティ上これで安全と言えるか。この4つは必ず人が判断してください。
Q. 指摘が多すぎて読み切れません
A. 最も多い相談です。対処は3つ。軽微な指摘の件数に上限を決めること、変更の規模を超える修正はその場でやらないこと、「見送る」と判断したものは理由をコメントに残すことです。3つ目を省くと、毎回同じ議論を繰り返します。
Q. 無料で試せますか?
A. Claude Codeの場合、セッション内で/code-reviewを実行して手元の差分をレビューする方法は、GitHubアプリの導入なしに使えると公式ドキュメントに記載されています。GitHub連携の自動レビューはTeam・Enterprise向けのリサーチプレビューです。まずは手元での実行から始めてください。
Q. 費用はどれくらいかかりますか?
A. Claude CodeのGitHub連携版について、公式ドキュメントにはレビュー1回あたり平均15〜25米ドル、PRの規模や複雑さで変動すると記載されています。プランの利用枠とは別課金です。プッシュのたびに動かす設定は費用が積み上がるため、まずは手動またはPR作成時1回から始めるのが現実的です。
Q. マージがブロックされませんか?
A. Claude CodeのCode Reviewについては、承認もブロックもせず、チェックは常に中立の結果で完了すると公式ドキュメントに明記されています。ブランチ保護ルールでマージが止まることはありません。マージ可否の判断は人の側に残る設計です。
Q. 指摘を自社ルールに合わせられますか?
A. できます。Claude CodeではCLAUDE.mdにプロジェクト全体の指示を、REVIEW.mdにレビュー専用の指示を書く方式が公式に用意されています。重要度の定義変更、軽微な指摘の件数上限、指摘しない対象の指定などが調整例として挙げられています。ただし書きすぎると効果が薄れるとも明記されているので、最初は3〜5項目に絞ってください。
Q. 社外秘のコードを読み込ませて大丈夫ですか?
A. 使うサービスのデータ取り扱い設定を、導入前に管理者が確認してください。学習に使われるか、どれくらい保持されるか、契約形態で条件が変わるかを提供元の記載で確認します。なおClaude CodeのCode Reviewは、ゼロデータ保持を有効にしている組織では利用できないと公式に明記されています。
Q. 顧客データが入ったファイルはどうしますか?
A. 対象から除いてください。実務で問題になりやすいのは、コード本体より「紛れ込んでいるもの」です。設定ファイルの接続情報や鍵、テストデータの中の実在する顧客名、コメントに書かれた取引先との経緯。レビューに出す前に一度確認する習慣をつけてください。
Q. AIが間違った指摘をしてきます
A. 前提として起こります。存在しない関数を前提にした指摘や、事情があってそうしている実装への「非効率だ」という指摘は珍しくありません。対策は、意図があってそう書いている箇所にコメントで理由を残すことと、指摘そのものを検証する工程を省かないことです。
Q. 外注先の納品物のチェックに使えますか?
A. 使えます。テストが書かれているか、エラー処理が入っているか、明らかに危険な書き方がないかは確認できます。ただし黙って使わず、事前に外注先に伝えてください。伝えずに指摘を投げると関係が悪化します。
Q. AIの指摘を根拠に修正を求められますか?
A. 契約でどう定めているかによります。契約形態によって成果物への責任範囲が変わるため、「AIが指摘したから直してほしい」だけでは根拠になりません。特に「今回の変更で作り込まれたのではない既存の問題」を対応対象に含めると、実質的に契約範囲外の作業を求めることになります。事前に合意してください。
Q. AIペアプログラミングとどう違いますか?
A. 書いている最中にAIが横で助言するのがペアプログラミング的な使い方、書き終わったものをまとめて見るのがコードレビューです。小規模チームで効果が出やすいのは後者です。助言は書いた本人にしか届きませんが、レビューはチーム全体の品質基準を揃える働きをするからです。
Q. 導入すれば不具合は減りますか?
A. 大きくは減らないと考えてください。実務の不具合の多くは業務仕様の認識違いが原因で、これはコードをいくらレビューしても見つかりません。減るのはレビュー待ちの時間と、レビュー担当者が単純な指摘に使っていた時間です。仕様起因の手戻りを減らすには、レビューではなく仕様の詰め方を変える必要があります。
Q. 何から始めればよいですか?
A. 1つのリポジトリ、1人の担当者、止まっても業務が止まらない対象から始めてください。手元で2週間ほど動かして指摘の傾向を掴み、扱いを3点だけ決めて文書化する。この順番なら、指摘の山に埋もれる失敗を避けられます。
まとめ
- AIに任せられるのは指摘の一次抽出まで。仕分けと最終確認は人の仕事
- 得意なのは記述ミス/規約違反/可読性・重複/テストの抜け(コードだけで判断できるもの)
- 苦手なのは業務仕様との整合/実装の意図の妥当性/性能/セキュリティの最終判断
- 最大の失敗は指摘が多すぎて形骸化すること。全部直そうとしない
- 対処は軽微な指摘に上限を設ける・見送った理由を残すの2点から
- Claude Codeでは手元の
/code-reviewから始め、必要ならGitHub連携へ。連携版は1回あたり平均15〜25米ドル - コードに鍵・顧客名・取引先との経緯が紛れていないかを出す前に確認する
- 外注先の成果物確認にも使えるが、契約上の責任範囲は別の話
- 期待すべきは品質向上よりレビュー待ちの短縮と、担当者の集中先の変化
AIコードレビューは、レビューできる人を増やす道具ではありません。いま見ている人が、本当に必要な判断だけに時間を使えるようにする道具です。この位置づけで導入すれば、小規模なチームでも確実に効果が出ます。
Claude Code全体の使いどころはClaude Codeでできること、AIに書かせたコードの扱いはバイブコーディングとは、社内での運用ルールは社内AIルールの作り方にまとめています。
エディタの中でレビューを受けたい場合は別の選択肢になります。Cursorの使い方もあわせてご覧ください。


