同じファイルを同時に触らせると、だいたい面倒になる。Claude Code でもそこは変わらない。
「同時に走らせれば速いはず」と思って並列に投げると、diff がぶつかる、指示が食い違う、片方の修正をもう片方が上書きする、で手戻りが増える。やるべきことは単純で、同じファイルを同時に触らせない、衝突しにくい分担にすることだ。
筆者も最初は、複数の作業をまとめて投げてしまっていた。たとえば README と設定ファイルとメモ類を一気に直させる。見た目は速いが、あとで差分を見たら、同じ導入文を別の依頼で微妙に書き換えていたり、設定の文言だけ先祖返りしていたりする。人間が手で整える時間が増えるだけだった。Claude Code は魔法の共有フォルダではない。分担設計が雑だと、普通に詰まる。
一番効くのは、最初に「どの作業がどのファイル群を触るか」を切ることだ。Claude Code に渡す依頼も、ここを先に固定する。たとえば文書整理なら、章の並べ替え担当と誤字修正担当を分けない。どちらも同じ本文を触るからだ。先に構成を固め、そのあとで表記や体裁を直す順番にする。
この作業では docs/ 以下の Markdown だけを触ってください。
構成の変更はしないでください。誤字、表記ゆれ、冗長な言い回しの削減だけに絞ってください。
もし構成の修正が必要なら、まず提案だけ出して止まってください。
この一文が地味に効く。構成変更まで許すと、本文の移動と文章の修正が混ざる。すると diff が広がるし、あとで「どこを直したのか」が追いにくい。逆に、触ってよい範囲を狭めると、Claude Code の出力が読みやすくなる。人間が確認すべきところも減る。
開発寄りの作業なら、ファイル単位での分離がさらに大事だ。設定ファイル、テスト、実装を同時にいじると、変更理由がぐちゃぐちゃになる。実装だけ先にやる。次にテストだけやる。最後に設定を足す。この順番にすると、失敗したときの原因が追いやすい。
特に、複数のエージェントや複数回の依頼を並行させるなら、各タスクが触る範囲を明示したほうがいい。
タスクA:
src/report/ 以下だけを編集する。UI の文言は変えない。
タスクB:
tests/report/ 以下だけを編集する。実装ファイルは触らない。
タスクC:
docs/report.md だけを更新する。コード例以外は動かさない。
こう切っておけば、差分の衝突が起きにくい。もし同じファイルをまたぐなら、並行ではなく直列に回す。先に A を終えて、その結果を見てから B を走らせる。地味だが、これが一番事故が少ない。
やってはいけないのは、「とりあえず全部見て、気づいたところを全部直して」で投げることだ。Claude Code は広く見られるぶん、広く触りたがる。こちらが境界を示さないと、修正が拡散する。筆者は以前、不要ファイルの削除と README の整理と設定調整を一度に頼んで、結果的に差分が膨らみすぎたことがある。作業自体は終わっているのに、レビューにやたら時間がかかった。コンフリクトを避けたかったのに、別の種類の面倒を自分で増やしてしまったわけだ。
分担を細かくする時は、「同じ種類の修正はまとめる」がコツになる。表記ゆれ、ファイル名の整理、不要なキャッシュの削除、説明文の整形。このへんは一緒に扱いやすい。逆に、構造変更と文面調整は分ける。中身を動かす作業と、見た目を整える作業を混ぜると、後から見て何をしたのかが曖昧になるからだ。
非エンジニアの用途でも同じだ。たとえばフォルダ整理や文書作成で Claude Code を使うなら、「案件ごとのフォルダは触るが、共通テンプレートは触らない」と決めるだけでだいぶ違う。複数の請求書、提案書、議事録を一度に整理したいなら、案件単位で分ける。似た名前のファイルを横断してまとめていじるのは危ない。後でどれがどれだか分からなくなる。
このディレクトリでは、案件Aの書類だけを整理してください。
案件Bのファイルは触らないでください。
共通テンプレートは変更しないでください。
重複ファイルが見つかっても、削除はせず候補を列挙してください。
ここで「削除はせず候補を列挙」と書くのも大事だ。削除まで自動で進めると、戻すときに面倒が増える。コンフリクトを増やさない進め方は、実は「戻しやすさ」を確保する進め方でもある。
もう一つ、意外と効くのが、作業の前に「終わった形」を一文で書かせることだ。Claude Code に先に方針を固定させると、途中で別の修正を挟みにくくなる。
まず、今回の作業で触るファイルと触らないファイルを列挙してください。
そのうえで、変更を3つ以内の小さい単位に分けて進めてください。
各単位ごとに、変更理由を短く説明してください。
このやり方は、派手さはないが効く。作業の境界が見えるので、並行させるべきものと、順番にやるべきものが分かる。コンフリクトは、だいたい境界が曖昧なときに増える。逆に言えば、境界をはっきりさせればいい。
最後に、少しだけ身もふたもない話をすると、コンフリクトをゼロにする必要はない。大事なのは、増やさないことだ。小さく切って、同じファイルを同時に触らせず、危ないところは先に止める。これだけで Claude Code の扱いやすさはかなり変わる。大きい作業を一気に押し込まない。そこがいちばん効く。