Claude Code Desktopの差分レビュー機能(diff view)の使い方
Claude Code Desktopのdiff viewは、Claudeが変更したファイルを行単位でレビューしコメントできる機能です。開き方から自己レビューのさせ方まで手順で確認します。
Claude Code Desktopのdiff viewは、Claudeが変更したファイルを行単位でレビューし、気になる行にコメントして修正を依頼できる画面です。使いどころは、変更が反映された後、コミットやプルリクエストの前です。CLI版で同じ役割を担う/diffコマンドは、Claude Code diffコマンドの使い方と差分ビューアー操作で扱っています。
変更の確認は「承認の前」と「反映の後」で画面が変わる
Desktopでは、権限モードによって差分を見るタイミングが違います。ここを取り違えると、diff viewのつもりで承認画面を見ていた、という混乱が起きます。
差分を見るタイミングの違い
Manualモード
Claudeが変更を提案し、承認を待ちます。承認するまでファイルは変更されません。
各ファイルの差分とAccept / Rejectのボタンが出て、拒否するとClaudeは進め方を尋ねてきます。
Auto / Accept edits
Claudeが変更をそのまま適用します。
+12 -1のような差分統計が出るので、これをクリックしてdiff viewで確認します。
本記事で扱うのは右側、反映後にまとめて見直す使い方です。1回の依頼で複数ファイルが動いたときや、あとから全体を見返したいときに向いています。
モードはプロンプト欄の送信ボタン横のセレクターで切り替えます。選んだモードはフォルダーごとに記憶され、既定値のpermissions.defaultModeより優先されます。例外はPlanモードで、現在のセッションだけに効きます。Planは計画を出すだけでソースコードを編集しないため、差分を見る場面はそもそも来ません。
各モードの挙動の違いは次のとおりです。
| モード | 設定キー | 変更の扱い |
|---|---|---|
| Manual | 設定キーdefault | 変更の扱いファイル編集もコマンド実行も確認を求める |
| Accept edits | 設定キーacceptEdits | 変更の扱いファイル編集とmkdir・touch・mvなどを自動承認し、ほかのコマンドは確認する |
| Plan | 設定キーplan | 変更の扱い計画を出すだけで、ソースコードは編集しない |
| Auto | 設定キーauto | 変更の扱いバックグラウンドの安全確認を挟みつつ、確認なしで実行する |
| Bypass permissions | 設定キーbypassPermissions | 変更の扱い権限確認を省く。Pro / MaxはSettings → Claude Codeで許可すると選べ、Team / Enterpriseは組織ポリシーに従う |
以前のバージョンでは、Manualは「Ask permissions」、Accept editsは「Auto accept edits」、Planは「Plan mode」という表示でした。古い解説記事の画面名はこの対応で読み替えられます。モードの選び方はClaude Code Desktopの使い分け方の面ごとの比較も参考になります。
差分統計から行コメントを送るまで
流れは、統計のクリック、ファイル選択、行コメント、一括送信の4段階です。
diff viewでレビューして修正を返す
- 1
差分統計をクリックする
Claudeがファイルを変更すると、セッションに
+12 -1のような追加行・削除行の数が出ます。これをクリックするとdiff viewが開きます。 - 2
ファイルを選ぶ
左にファイル一覧、右に選んだファイルの変更が並びます。一覧を上から順にたどれば、変更を見落としにくくなります。
- 3
行にコメントする
気になる行をクリックするとコメントボックスが開きます。入力してEnterを押すと、その行にコメントが追加されます。
- 4
まとめて送る
複数行にコメントしたら、macOSは
Cmd+Enter、WindowsはCtrl+Enterで一括送信します。Claudeはコメントを読んで修正し、結果が新しい差分として現れます。
Enterで確定するのは「コメントの追加」で、送信はCmd+Enter(WindowsはCtrl+Enter)です。公式の手順は「複数行にコメントを付けたあとで一括送信する」流れで書かれています。Enterだけで済ませて、Claudeが動かないと思い込む取り違えに注意してください。
差分ペインだけを素早く出し入れしたいときは、Cmd+Shift+D(公式のショートカット表では「Toggle diff pane」)が使えます。
自己レビューの範囲と、任せてよい線引き
diff viewの右上ツールバーにあるReview codeを押すと、Claudeが現在の差分を評価し、diff view上に直接コメントを残します。コメントには返信でき、修正の依頼にもつなげられます。
見る対象は、コンパイルエラー、明確なロジックの誤り、セキュリティー上の脆弱性、明らかなバグの4種類です。スタイル、フォーマット、既存コードの問題、リンターが拾う指摘は対象外です。
読者の状況で言い換えると、次のとおりです。
- 動くかどうかの大きな見落としを確認したい: Review codeが向いています
- 命名や書式、既存コードの整理まで見たい: Review codeの守備範囲外なので、自分の目かリンターに任せます
- 指摘に納得できない: コメントに返信して根拠を尋ねます。採否は自分で決めます
ローカルの/code-reviewコマンドなど、Claude Codeのレビュー手段は面によって複数あります。それぞれの実行場所と使い分けはClaude Codeのコードレビュー — 4つの実行経路の使い分けにあります。Claude Codeの全体像を先に押さえておくと位置関係がつかみやすくなります。
ペインの配置とファイル編集
diff viewは、チャット・ブラウザー・ターミナルと並ぶペインの1つです。セッションツールバーのViewsメニューから、必要なペインを開けます。ヘッダーをドラッグして位置を、端をドラッグして大きさを変えられます。選択中のペインを閉じるショートカットは、macOSがCmdとバックスラッシュ、WindowsがCtrlとバックスラッシュです。
差分やターミナルなどのペインは、別ウィンドウに切り出して別の画面に置けます。Claudeはメインウィンドウで作業を続けます。差分を副画面に出して、主画面でチャットを見る使い方です。
レビューしながらテストを回すなら、ターミナルペインを開きます。開くのはViewsメニューか、macOS・WindowsともCtrlとバッククォートのキーです。ターミナルはセッションの作業ディレクトリで開き、Claudeと同じ環境で動くため、npm testやgit statusはClaudeが編集中のファイルをそのまま見ます。
ペイン配置やターミナル、ファイルエディターは、Claude Desktop v1.2581.0以降が前提です。更新はmacOSならClaude → Check for Updates、WindowsならHelp → Check for Updatesから行えます。
ファイルパスから使える操作
ファイルペインで開く
パスをクリックするとファイルペインで開きます。スポット修正してSaveで書き戻せます。
右クリックのメニュー
Attach as context、Open in(VS Code・Cursor・Zedなど)、Show in Finder(WindowsはShow in Explorer)、Copy pathが選べます。メニューはチャットとファイルペインでも出ます。
HTMLや画像は別ペイン
HTML・PDF・画像・動画のパスは、ファイルペインではなくBrowserペインで開きます。
ファイルペインで開いたファイルがディスク上で変わっていたときは、警告が出て、上書きするか自分の編集を破棄するかを選べます。開いている間にClaudeがそのファイルを書き換えた場合も、ディスク上の変更として同じ警告の対象になります。
クラウドセッションではファイルを直接直せない
ファイルペインが使えるのは、ローカルセッションとSSHセッションです。クラウドセッションでは直接編集せず、Claudeに変更を依頼します。ターミナルもローカルセッションだけで使えます。
したがって、diff viewで見つけた誤りをその場でSaveして直せるかは、セッションの種類で決まります。クラウドで長い作業を回した場合は、行コメントで指摘して直させる形になります。クラウドセッションのモード選択には、Manualがありません。ファイル編集は事前承認され、Accept edits、Plan、Autoの3つから選ぶので、常に「反映の後」に見直す側になります。claude.ai/code側のセッションでも、差分表示と行コメントが使えます。既定ではベースブランチとの比較です。
ベースブランチ以外との比較と、差分の計算方法
claude.ai/code側のdiff viewは、既定でセッションの変更をベースブランチと比べます。別のブランチと比べたいときは、Compare againstを選び、リポジトリ内の任意のブランチを指定します。
差分の計算には注意点が1つあります。セッションの差分は、Gitのblobの生の内容から計算されます。リポジトリに設定したdiffドライバーやtextconvフィルターは適用されません。
セッション中にワークスペース内へクローンした別リポジトリのファイルでは、Gitの比較ではなく、Claudeが行った編集そのものが差分として表示されます。手元のgit diffと見え方が食い違うときは、この仕様が関係している可能性があります。
SSHセッションでのレビュー
SSHセッションは、リモートマシン上でClaudeを動かし、Desktopを操作画面として使う形態です。リモートはLinuxかmacOSが前提で、初回の接続時にClaude Codeが自動でインストールされます。
ファイルペインはローカルとSSHで使えます。diff viewで見つけた誤りは、クラウドと違ってその場でSaveして直せます。
SSH接続の追加手順と、管理者による接続の配布はClaude Code SSH接続ガイドで扱っています。
スキルは手元ではなく、リモートホストの~/.claude/skills/から読まれます。レビュー用のスキルを使うなら、リモート側に置く必要があります。
作業をクラウドへ移すContinue inのWeb送りは、SSHセッションでは使えません。ローカルセッションから送る場合も、作業ツリーがクリーンであることが条件です。
レビューのあとはPRの流れへ
diff viewはレビューの画面で、PRの作成は別の操作です。レビューが済んだら、セッション内でコミットとPR作成を進めます。PRを開くとCIステータスバーが現れ、状況を追えます。CIの失敗を自動で直させるAuto-fixと、全チェック通過後にスカッシュでマージするAuto-mergeは、ステータスバーのトグルで有効にします。Auto-mergeを使うには、先にGitHubリポジトリ側で自動マージを許可しておく必要があります。どちらもGitHub CLI(gh)がインストールされ、認証済みであることが前提です。手順はClaude Code DesktopのPR監視機能の使い方にあります。
まとめ
行コメントで直させるか、Saveで自分で直すかは、セッションの種類で決まります。ローカルとSSHなら両方、クラウドなら行コメントだけです。Manualの承認画面は反映前の確認なので、diff viewの出番は反映後です。