Claude Code 差分レビュー

問題: Claude Code が変更を行ったと告げてきたものの、どのファイルが変わったのか、差分はどんな内容なのか、望む形式で出力を求める方法もわかりません。

すぐできること: 提案された変更が表示されたら、すぐに d を押しましょう。一バイトもディスクに書き込まれる前に、完全な差分が画面に表示されます:

# Claude shows a proposed edit
# Press these keys to control what happens:
y - accept the change
n - reject and continue
d - show full diff
e - edit the change before accepting

理解: ファイルは Claude Code 自体が組み込みツールを通じて書き込みます。すべての変更は、正確な変更内容を最初にあなたの前に表示する承認ステップを経ます。

Claude Code でのファイル出力の仕組み

Claude Code はコードをコピーペーストしてもらうためのものではありません。2つのツールを使ってファイルシステムを直接操作します:

Write: 新しいファイルを作成するか、既存のものをゼロから上書きする Edit: 既存ファイルの対象を絞った一部を変更する

提案された変更は常に実行前にプレビューとして表示されます:

Claude wants to edit src/utils/auth.ts:

- const TOKEN_EXPIRY = 3600;
+ const TOKEN_EXPIRY = 7200;

差分の各行は何が起きているかを明示しています。- の行はファイルから削除されます。+ の行は古い行があった場所に入ります。

承認、拒否、承認ループ

あなたの承認なしには何も書き込まれません。この承認ステップが安全モデルです:

# Claude proposes creating a new file
Claude wants to write to src/components/Button.tsx
 
# Your options:
y    Accept this change
n    Reject and tell Claude why
d    View full diff (for edits)
e    Edit before accepting
Esc  Abort current operation

すでに信頼している変更については、Shift+Tab で自動承認モードをオンにできます。Claude はファイルごとに確認を求めなくなり、作業を続けます。

複数ファイルの操作

一度に一つのファイルがリズムですが、ファイルをまたいでコンテキストが引き継がれます。機能全体を依頼すると、シーケンスがどのように展開されるかを確認できます:

claude "create a user authentication system with login, register, and password reset"
 
# Claude will:
# 1. Create src/auth/login.ts
# 2. Create src/auth/register.ts
# 3. Create src/auth/password-reset.ts
# 4. Update src/routes/index.ts to include new routes
# Each file prompts for approval (unless auto-accept is on)

ここで継続性の価値が発揮されます。最初のファイルに書き込んだ内容は、2番目のファイルを構築している間もメモリに残ります。インポートが揃います。型参照がマッチします。関数シグネチャがファイルからファイルへと同じ形を保ちます。

特定の出力形式の要求

マークダウンがデフォルトの形式です。それを変えるのはプロンプトです:

# Get structured data
claude "list all API endpoints in this project as a markdown table"
 
# Get code blocks with syntax highlighting
claude "show me the database schema as SQL"
 
# Get step-by-step output
claude "explain the authentication flow as a numbered list"

ディスクにコミットせずにコードを確認したい場合は、プランモードが最適です。Claude は考えを声に出して提案しますが、書き込みは行いません。

大きな出力の扱い

大きな出力はターミナルに直接ストリームされます。大規模なコードベースや長時間の処理については、結果を後で使いやすい場所にパイプしましょう:

# Redirect output to a file for later review
claude "analyze all TODO comments in this project" > todos.md
 
# Pipe to other tools
claude "list dependencies that need updates" | grep "security"

よく直面する出力の状況

意図しないファイルが変更された: n を押して、実際に意図していたことを Claude に伝えましょう。同じセッション内で修正が行われ、次の試みがフィードバックを反映します。

差分が大きすぎて確認できない: d でフル表示するか、作業を小さなチャンクに分割しましょう: 「この変更をより小さいステップで行ってください」

書き込みなしのコード: プロンプトを「create」や「add」ではなく「show me」や「explain」で始めましょう。Claude はインラインで回答し、書き込みワークフローは動作しません。

変更を元に戻す: Esc を2回押してチェックポイントに到達します。各編集の前にスナップショットが撮られるため、元に戻すことは常に可能です。

変更が機能したことを確認する

承認はゴールラインではありません。変更が実際に機能していることを確認しましょう:

# Check the file exists and looks right
cat src/components/Button.tsx
 
# Run your build to catch issues
npm run build
 
# Test the changes
npm test

次のステップ

Claude Code ワークフローの残りの部分も整えましょう:

• 承認/拒否ループがスムーズに動くように権限を調整する
• コミット前に変更を確認するためのプランニングモードを習得する
• フィードバックループを設定して反復サイクルを改善する
• より重い出力のためのコンテキスト管理を深く理解する
• 出力がおかしい場合のトラブルシューティングに手を伸ばす

覚えておく: Claude Code はスニペットを渡して自分でペーストするためのものではありません。すべての編集についてあなたの承認に答えるファイル書き込みエージェントと考えましょう。これが理解できると、インタラクションパターン全体が違って見えてきます。