本文へスキップ
claudemods

Diff:Claude Code diffペインでセッションの未コミット変更を確認

Claude Code用の/diffペイン。未コミットのgit変更をファイルごとにhunk付きで表示し、Claudeの編集に合わせて更新します。

権限

  • ファイルを読み取るお使いのマシン上のファイルの読み取りやディレクトリの一覧取得ができます($.fs.read / list / stat / exists)。
  • コマンドを実行お使いのマシン上でシェルのプログラムを実行できます($.process.run / spawn)。具体的に何を実行するかはソースで確認してください。
  • ツール呼び出しを傍受Claude が行うすべてのツール呼び出しを参照でき(tool.call / tool.check)、ブロックや変更も可能です。
  • プロンプトを読み取る入力内容と会話のトランスクリプトを参照できます(prompt.* / session.append / session.messages)。
  • UI を変更Claude Code の画面に描画します。バンド、ペイン、ステータス表示、トーストなど(ui.render / $.ui.*)。
  • コマンド・ツールを追加あなたや Claude が呼び出せる新しいスラッシュコマンドやツールを登録します($.command.register / $.tool.register)。
  • データを保存プラグイン専用のストアにセッションをまたいでデータを保持します($.store.*)。
検証バージョン
v2.1.310
最終検証日
必要バージョン
Claude Code ≥ 2.1.287
表示先
ペイン

Claude Code 内でインストール:

git clone https://github.com/anthropics/claude-code
claude --plugin-dir ./claude-code/mods/diff
すべてのインストール方法 ↓

このModでできること

Diffは、Anthropicがclaude-codeリポジトリで公開しているModで、ここではコミュニティModとして紹介します。これはClaude Code diffペインで、/diffを入力するとセッションの未コミット変更がトランスクリプトの横に開きます。変更されたファイルが1行ずつ並び、その下に各ファイルのhunkが続きます。もう一度/diffで閉じます。切り替えのたびにトランスクリプトにDiff panel shownまたはDiff panel hiddenが残ります。

Claudeがファイルを編集したりシェルコマンドを実行したりすると、ペインは更新されます。開いている間はリポジトリのHEADもポーリングするので、別の場所で行ったコミットやチェックアウトも反映されます。作業ツリーの比較先は、セッション開始時点のHEAD(既定)、HEADそのもの、またはデフォルトブランチとのmerge-baseから選べ、ピッカーで過去の1ターンの編集を表示することもできます。セッション開始前から変更されていたファイルや、ロックファイル、生成ファイル、テストは別枠で折りたたまれます。

ターミナルが十分広ければ、セッション最初の編集成功でペインが自動的に開きます。フルスクリーンレイアウトでない場合、/diffはインラインのダイアログを開きます。選択行の前後5行のファイル一覧が表示され、Enterでそのファイルのhunkだけを表示、Escapeで戻ります。ファイルの[ ask ]ボタンはそのファイルを装填し、hunkが次のプロンプトにコンテキストとして一度だけ付きます。

デモ

録画では、未コミットの変更が1つある小さなデモプロジェクトで、Modを読み込んだClaude Codeを起動します。/diffを入力すると、オートコンプリートに「Toggle the diff panel showing uncommitted changes」と表示されます。Enterを押すと、プロンプトの上に枠付きのダイアログが開き、タイトルはUncommitted changes (git diff HEAD)、その下に1 file changed +2と出ます。src/index.jsと[ ask ]ボタンが並び、その下に行番号付きのhunkが表示され、追加された2行が緑でハイライトされます。フッターには↑/↓ to scroll · Esc to back。動画は数秒間このダイアログのままです。デモ用ターミナルはドッキングレイアウトではないため、インラインのダイアログ形式です。

インストール

インストールブロックの方法のどれかを使ってください。いずれも作者自身のリポジトリから直接インストールします。次のセッション開始後、変更されたファイルのあるgitリポジトリで/diffと入力します。

$ install diff

Claude Code 2.1.287 以上が必要

作者のマーケットプレイスからインストール: anthropics/claude-code

  1. 1.インストールせずに試す

    git clone https://github.com/anthropics/claude-code
    claude --plugin-dir ./claude-code/mods/diff

    その1セッションだけ Mod を読み込みます。設定には何も追加されません。

仕組み

モジュールhooks/register.tsはsession.startで/diffを登録し、Paneコンポーネントを描画し、Edit、Write、NotebookEdit、Bash、PowerShellのtool.callを監視して更新のタイミングを知ります。gitの子プロセスにはすべて固定されたリポジトリのgitディレクトリとワークツリーが渡され、diffは常に同じ固定引数で始まります。hooks/git/argv/diff-leading-args.tsより:

export const DIFF_LEADING_ARGS = [
  '--no-optional-locks',
  '-c',
  'diff.relative=false',
  '-c',
  'core.quotePath=false',
  'diff',
  '--no-ext-diff',
  '--no-textconv',
  '--ignore-submodules=dirty',
  '--submodule=short',
] as const

gitが実行されるのは、組み込みパネルが実行するタイミングだけです。セッション開始時は実行せず、/diffまたは最初の編集が必要としたときにリポジトリを探すために1回、その後は編集やシェルコマンドの後の取得で実行します。出力には上限があり、500ファイルを超えると合計だけが表示されます。セッションに別の/diffコマンドがすでに登録されている場合、このModは何もしません。

カスタマイズ

/configにオプションはありません。比較基準はペインで選び、ctrl+x bで次へ切り替わります。選択はリポジトリごとにプラグイン自身のストアに保存されます。一覧はctrl+up/ctrl+downとopt+up/opt+downでスクロールできます。最初の編集でペインを開きたくない場合は、一度閉じれば記憶されます。CLAUDE_CODE_DISABLE_FILE_CHECKPOINTINGを設定しても自動オープンは止まります。

権限と安全性

マニフェスト、hooks/hooks.json、hooks/register.tsを読み、hooks/以下の残り約800ファイルをネットワーク、プロセス、ファイル書き込み、環境変数のアクセスについて検索しました。3.4 MBのディレクトリを1行ずつ読んだわけではありませんが、大半は小さなTypeScriptモジュールとテストです。package.json、インストールスクリプト、バイナリ、圧縮・エンコードされたコードはありません。

  • **UIの変更:**ペインまたはダイアログ、そしてトースト。
  • コマンドの追加:/diff。
  • プロセス:$.process.runは読み取り専用のgitサブコマンド(rev-parse、status、diff、ls-files、merge-base、show-ref、symbolic-ref)だけを、ロケールをCに固定して実行します。
  • **ネットワーク:**見つかりませんでした。ファイル:$.fsでリポジトリ内のファイルとタイムスタンプを読み、書き込みは$.storeのみです。
  • 環境変数:CLAUDE_CODE_DISABLE_FILE_CHECKPOINTINGを読みます。
  • テレメトリ:$.telemetry.logと$.telemetry.markを呼びますが、Claude Codeにテレメトリの組み込み機能がなければ破棄されます。Mod自身が何かを送信している形跡は見つかりませんでした。
  • モデルへの影響:prompt.submitフックは、装填されたファイルのhunkをプロンプトのコンテキストに追加します。そのファイルのaskボタンを押した後だけです。
  • ライセンス:LICENSE.mdは著作権を留保(all rights reserved)し、SPDX IDはありません。そのため本ページはリンクのみでミラーしません。

claude plugin validateはエラーも警告も報告しませんでしたが、READMEにインストール行がないこと、アイコンがないこと、7つのフックに.catchがないことを案内しました。作者のテストはClaude Code 2.1.310で、30ファイル234件がすべて成功、失敗は0件でした。

ファイルを読み取る
お使いのマシン上のファイルの読み取りやディレクトリの一覧取得ができます($.fs.read / list / stat / exists)。
コマンドを実行
お使いのマシン上でシェルのプログラムを実行できます($.process.run / spawn)。具体的に何を実行するかはソースで確認してください。
ツール呼び出しを傍受
Claude が行うすべてのツール呼び出しを参照でき(tool.call / tool.check)、ブロックや変更も可能です。
プロンプトを読み取る
入力内容と会話のトランスクリプトを参照できます(prompt.* / session.append / session.messages)。
UI を変更
Claude Code の画面に描画します。バンド、ペイン、ステータス表示、トーストなど(ui.render / $.ui.*)。
コマンド・ツールを追加
あなたや Claude が呼び出せる新しいスラッシュコマンドやツールを登録します($.command.register / $.tool.register)。
データを保存
プラグイン専用のストアにセッションをまたいでデータを保持します($.store.*)。

互換性とトラブルシューティング

macOS上のClaude Code 2.1.310で確認しました(validate、テスト、録画)。/diffが何も表示しない場合:

  • gitリポジトリの中にいること。リポジトリ外では/diffがそう伝えるだけで何もしません。
  • 実際に変更されたファイルがあること。なければNo changes this sessionと表示されます。
  • 別の/diffが登録されていないこと。その場合、このModは待機状態になります。
  • 自動で開くには、フルスクリーンレイアウトでターミナルが144桁以上あること。
  • フルスクリーンレイアウトで110桁未満の場合は、より広いターミナルを求める1行が表示されます。

よくある質問

Diffはコードをどこかに送信しますか?
ネットワーク関連のコードは見つかりませんでした。お使いのマシン上で読み取り専用のgitコマンド(rev-parse、status、diff、ls-files、merge-base、show-ref、symbolic-ref)を実行し、結果を描画するだけです。モデルに渡るのは、そのファイルのaskボタンを押した場合のhunkだけです。
リポジトリを変更しますか?
いいえ。確認できたgitコマンドはすべて読み取りで、--no-optional-locks、--no-ext-diff、--no-textconvが付いています。書き込み先はプラグイン自身のストアだけで、ペインが開いていたかどうかと、選んだ比較基準を記憶します。
なぜ/diffが自動で開くことがあるのですか?
セッション内で最初の編集が成功した後、ファイルチェックポイントが有効で、ターミナルが十分広い(144桁、以前開いたままにしていた場合は110桁)ときです。閉じた場合は何もしません。より狭いターミナルやインラインレイアウトでは/diffでのみ開きます。
askボタンは何をしますか?
1つのファイルを「装填」します。次のプロンプトで、そのファイルのhunkがコンテキストとして一度だけ追加され、装填は解除されます。コンテキストに収まらない場合はhunkが破棄され、ステータスに表示されます。
再配布やフォークはできますか?
確認した範囲ではできません。リポジトリのLICENSE.mdは「All rights reserved」で、AnthropicのCommercial Terms of Serviceを指しています。そのため、当サイトはリポジトリへのリンクのみで、コードはミラーしていません。
Claude Code で動作中の プロンプト上の Git ブランチ表示おすすめ

プロンプト上の Git ブランチ表示

Git のブランチ、変更ファイル数、ahead/behind の状態を Claude Code のプロンプトの上に 1 行で表示します。

  • プロンプト上部
  • コマンドを実行
  • ツール呼び出しを傍受
  • UI を変更

v2.1.310 で検証済み

Claude Code で動作中の cc-pr-trackerおすすめ

cc-pr-tracker

GitHub の PR ごとに 1 行を Claude Code のプロンプトの上に表示します。マージ状態、レビュー、必須チェック、変化時の通知付き。

  • プロンプト上部
  • トースト
  • ファイルを読み取る
  • コマンドを実行
  • ツール呼び出しを傍受
  • プロンプトを読み取る
  • UI を変更
  • コマンド・ツールを追加
  • データを保存

v2.1.296 で検証済み

Claude Code で動作中の Blast Radiusおすすめ

Blast Radius

rm -r、強制プッシュ、データベースのマイグレーションを実行前に止め、影響を受けるファイルやコミットを一覧表示して、あなたの判断を待ちます。

  • ペイン
  • プロンプト上部
  • コマンドを実行
  • ツール呼び出しを傍受
  • UI を変更

v2.1.291 で検証済み

同じカテゴリの Mod: Git と GitHub、Claude に追加するツール。