Claude Codeでコンフリクト解決をAIに任せる

コンフリクトとは何か

コンフリクト（衝突）は、2つのブランチが同じファイルの同じ部分を異なる内容で変更した場合に発生します。Gitが自動的にどちらの変更を採用すべきか判断できず、人間（またはAI）の判断が必要になります。

コンフリクトは「エラー」ではなく、チーム開発では日常的に発生するものです。怖がる必要はありません。Claude Codeを使えば、コンフリクトの内容を理解し、最適な解決策を提案してくれます。

コンフリクトが発生する典型的な場面

2人が同じ関数を別々に修正した
一方がファイルを削除し、もう一方が編集した
同じ設定ファイルに異なる値を追加した
長期間分岐したブランチをマージしようとした

マージマーカーの読み方

コンフリクトが発生すると、Gitはファイルに「マージマーカー」を挿入します。

function getGreeting(name) {
<<<<<<< HEAD
  return `こんにちは、${name}さん！`;
=======
  return `ようこそ、${name}様！`;
>>>>>>> feature/formal-greeting
}

マーカー	意味
`<<<<<<< HEAD`	現在のブランチ（マージ先）の変更開始
`=======`	2つの変更の区切り
`>>>>>>> ブランチ名`	マージ元ブランチの変更終了

Claude Codeにコンフリクト解決を依頼する

ステップバイステップの解決手順

コンフリクトの発生を確認: git mergeやgit pull後にコンフリクト警告
Claude Codeに状況を伝える: 「コンフリクトが起きたので解決して」
Claude Codeが内容を分析: 両方の変更内容を理解
解決策を提案: どちらの変更を採用するか、または統合案を提示
確認後に適用: マージマーカーを除去し、正しいコードに置換
コミット: 解決済みファイルをコミット

実際のやり取り例

あなた: mainをマージしたらコンフリクトが起きた。解決して。

Claude Code:
コンフリクトの状態を確認します...

コンフリクトファイル:
1. src/config/database.ts (設定値の違い)
2. src/components/Header.tsx (UI変更の競合)

--- ファイル1: src/config/database.ts ---
HEAD（あなたの変更）: コネクションプール数を10に設定
feature/optimization: コネクションプール数を20に設定

→ 提案: 本番想定のパフォーマンスを考慮すると20が適切です。
   feature/optimizationの変更を採用します。

--- ファイル2: src/components/Header.tsx ---
HEAD: ロゴを左寄せに変更
feature/redesign: ナビゲーションメニューを追加

→ 提案: 両方の変更は競合しないため、統合します。
   ロゴ左寄せ + ナビメニュー追加の両方を適用します。

この方針で解決してよいですか？

解決戦略: ours / theirs / 手動マージ

戦略	コマンド	使用場面
ours（自分の変更を採用）	`git checkout --ours ファイル`	自分の変更が正しい場合
theirs（相手の変更を採用）	`git checkout --theirs ファイル`	相手の変更が正しい場合
手動マージ（統合）	ファイルを編集	両方の変更を取り込む場合

Claude Codeへの指示例

# 全体的に相手の変更を優先したい場合
あなた: コンフリクトは全部theirsで解決して

# 個別に判断してほしい場合
あなた: コンフリクトの内容を確認して、最適な方を選んで解決して

# 特定ファイルだけ指定する場合
あなた: database.tsは自分の変更を維持して、Header.tsxは統合して

リベース vs マージ

方式	特徴	適する場面
merge	マージコミットが残る、履歴が分岐	チーム開発、長期ブランチ
rebase	履歴が直線的、コンフリクト解決が逐次	個人ブランチの整理、クリーンな履歴

# マージの場合
あなた: mainブランチをマージして

# リベースの場合
あなた: mainブランチにリベースして

# Claude Codeはどちらの場合もコンフリクトが発生したら解決を手伝います

コンフリクトを予防する方法

5つの予防策

頻繁にmainをマージ: 長期間放置せず、こまめにmainの変更を取り込む
小さな単位でコミット: 大きな変更は衝突リスクが高い
ファイルの責任分担: 同じファイルを複数人が同時に編集しない
設定ファイルの分割: 環境別設定ファイルを分離する
コミュニケーション: 影響範囲の大きい変更は事前にチームに共有

まとめ

コンフリクトはチーム開発で日常的に発生する正常な状態
マージマーカーの読み方を理解しておくと状況把握が早い
Claude Codeに「コンフリクトを解決して」と依頼するだけで対応可能
ours/theirs/統合の3つの戦略を状況に応じて使い分ける
こまめなマージと小さなコミットで予防するのが最善