Claude Code に diff のレビューを頼む習慣をつけたら、プッシュ前の見落としがかなり減った話

👀 結論から

コミット前に git diff HEAD の出力を Claude Code に渡して「この変更の問題点を教えて」と聞くだけで、自分では気づかなかったバグや考慮漏れがけっこう見つかります！

仕事でこのセルフレビューの習慣をつけてから、レビュワーからの指摘が以前より確実に減りました。

「自分の目でちゃんと確認したはずなのに指摘される」という場面、エンジニアなら誰でも経験があると思うのですが、AI の別視点を通すだけでかなり変わります(^o^)/

やっていることはシンプルです。

ターミナルで git diff HEAD を実行して出力をコピーし、Claude Code のチャットに貼り付けて「この変更点について、バグ・考慮漏れ・可読性の問題を指摘してください」と伝えるだけ。

カスタムスラッシュコマンドを活用している場合は /diff-review のようなコマンドを作って呼び出すとさらに楽になります！

差分が大きい場合は git diff HEAD -- src/特定のファイル.ts のようにファイルを絞って渡すと、精度が上がりやすいです。

いくつか印象に残った指摘を紹介します(^^)

エラーハンドリングの抜け

API を呼ぶ関数を追加したとき、ネットワークエラーの場合の処理が抜けていることを指摘してもらいました。

自分で確認していたつもりでしたが、ハッピーパスしか追えていなかったことに気づけました(・_・;)

型の不整合

TypeScript のコードで、関数の戻り値の型と実際に返しているオブジェクトのプロパティが微妙にズレていた箇所を見つけてもらったこともあります。

コンパイルは通っていたので自分では気づきにくい類のズレでした！

コメントと実装の乖離

修正したのにコメントが古いままだった箇所も複数回指摘されました。

地味ですが、後から読む人には混乱のもとになるので、これは特にありがたいです😄

一番実感しているのは、プッシュ前の心理的ハードルが下がったことです。

以前は「変更が合ってるかどうか自信がないまま PR を出す」ことがたまにあったのですが、AI に一度見てもらうことで「少なくとも明らかなミスはないはず」という安心感が生まれます。

レビュワーへの負担も減らせているはずなので、チームへの貢献にも少しつながっていると感じています！

差分が大きいとき、Claude Code の集中力が分散するのか、指摘の質がやや落ちる印象があります(´･ω･`)

なので私は、コミットをこまめに分けて、レビューも細切れにやる運用に変えました。

また、Claude Code が「問題ない」と言ったとしても、それが完全な保証ではありません。

あくまでセルフレビューの補助ツールとして使い、人のレビューを省くわけではないという前提は大事だと思います。

最初は「コピーして貼り付けて」という手動フローでやっていたんですが、これだと意外と手間がかかるので、途中からパイプで直接流し込むやり方に変えました。

git diff --staged | claude -p "この変更をレビューして。バグ・考慮漏れ・可読性の問題を指摘して"

claude コマンドは標準入力をそのままプロンプトとして受け取れるので、git diff の出力をパイプでつなぐだけでレビューが始まります(^^)

ターミナルからコピー＆ペーストする手間がゼロになったので、コミット前に「とりあえず1回流す」のハードルがかなり下がりました。

これをシェルの関数にして .zshrc に登録しておくと、review-diff のようなコマンド一発で毎回同じ確認ができて、さらに楽になります！

review-diff() {
  git diff --staged | claude -p "この変更をレビューして。バグ・考慮漏れ・可読性の問題を指摘して"
}

もうひとつ意識するようになったのが、複数のセッションを並行して走らせるときの git worktree の使い方です。

diff レビューを頼んでいる間に別のタスクを Claude Code に振ろうとして、同じブランチで作業がかち合ってしまったことがあって、そこから worktree でセッションごとにブランチを分ける運用に変えました。

レビュー待ちの間も他の作業を止めずに進められるようになったのは、かなり大きい効果を感じています(・∀・)

パパ系Webエンジニア〜愛用ガジェット一覧 🛍️

AI開発・執筆に使っている作業デスク環境を楽天ROOMにまとめています ✨ デスク周りの参考にどうぞ 🙌

Claude Code に git diff を渡してセルフレビューする習慣、導入コストがほぼゼロの割に効果が大きくておすすめです🙌

Claude Code を仕事で使っていて、まだセルフレビューに活用していない方はぜひ試してみてください！