Claude Codeで安全に作業するためのGit準備

はじめに

Claude Code でコード修正を任せるときは、Git で「いつでも戻れる状態」を整えておくことが重要です。本記事では、安全な Git 準備を解説します。

準備1：ブランチ戦略

基本方針

メインブランチ（main / master）
  ↓ 修正前にコミット ✅
  ↓
作業ブランチ（feature/fix-something）
  ↓ Claude Code で修正
  ↓
確認 OK → main にマージ
確認 NG → ブランチ削除で取消

具体的な手順

# 1. 現在の状態をコミット
git status  # 変更がないか確認
git add .
git commit -m "Before Claude Code modification"

# 2. 作業ブランチを切る
git branch feature/optimize-function
git checkout feature/optimize-function

# 3. Claude Code で修正

# 4. 修正内容を確認
git diff

# 5. OK なら commit
git commit -am "Optimize function A"

# 6. NG なら戻す
git reset --hard HEAD~1  # 前のコミットに戻す

準備2：commit 単位の整理

Claude Code に任せる前に

確認：
「このタスクは 1 つの commit で完結するか」

YES → そのまま Claude Code に任せる OK

NO → タスクを分割

例：複数タスクの場合

❌ 間違い：
「関数 A 最適化＋関数 B テスト追加＋ドキュメント更新」
を 1 つのコマンドで Claude Code に任せる
  ↓
1 つの大きい commit になる
  ↓
後で「関数 A だけ取り消したい」が困難

✅ 正解：
1. 関数 A 最適化（Claude Code）
   ↓ commit
2. 関数 B テスト追加（Claude Code）
   ↓ commit
3. ドキュメント更新（Claude Code）
   ↓ commit

細かい commit で、後で柔軟に対応可能

準備3：差分確認の徹底

確認すべき項目チェックリスト

□ 変更行数が予想範囲か
□ 削除されたファイルはないか
□ .gitignore を削除していないか
□ パッケージマネージャーファイルを編集していないか
□ 機密情報を追加していないか
□ コメントが日本語で文字化けしていないか
□ import / require が正しいか

差分確認の方法

# ファイル単位の diff
git diff src/main.py

# 統計情報
git diff --stat

# 色付き表示
git diff --color

# VS Code で表示
code . # VS Code で source control パネルから確認

準備4：戻せる状態の作成

ローカルなら簡単に戻せる

# 前のコミットに戻す
git reset --hard HEAD~1

# 特定コミットに戻す
git reset --hard <commit-id>

# ブランチごと削除
git branch -D feature/failed-attempt

リモートに push 前が重要

ローカル：何度でも戻せる ✅
リモート push 後：履歴が複雑になる ⚠️
main にマージ後：戻すのが困難 ❌

対策：
「ローカルで何度も確認 → OK なら push」

よくある失敗

❌ 失敗例1：ブランチ切らずに Claude Code

main ブランチで直接修正
  ↓
何かおかしい
  ↓
前に戻したい → 複雑

✅ 改善例

必ず作業ブランチを切る
  ↓
修正 OK なら main にマージ
修正 NG なら削除

❌ 失敗例2：差分確認せず commit

Claude Code で修正
  ↓
すぐに commit
  ↓
後で「あ、これおかしい」
  ↓
修正に時間がかかる

✅ 改善例

修正 → diff 確認 → 確認 OK → commit
  ↓
品質と安全性を両立

安全な Git 準備チェックリスト

□ 修正前に main ブランチで commit 済み
□ 作業ブランチを切った
□ Claude Code で修正
□ git diff で確認済み
□ 不要な変更がない
□ commit 単位が適切
□ diff を最後もう 1 度確認
□ OK なら commit

全てチェック → Claude Code 修正は成功！

まとめ

Claude Code で安全に作業するための Git 準備：

4 つの準備：

1. ブランチ戦略（作業ブランチを切る）
2. commit 単位の整理（タスク分割）
3. 差分確認の徹底（チェックリスト活用）
4. 戻せる状態の作成（ローカルで確認）

安全な Git 準備があれば、Claude Code の安定性が大幅に向上します。

Claude CodeとVS Codeを組み合わせる基本と合わせることで、安全で確実な開発ワークフローが実現します。