#claude-code-workspace-hygiene

「差分が悪い」のではない。たいていは、同じ場所を同時に触らせた運用が雑だ。 Claude Code でコンフリクトを減らしたいなら、まずやることは派手な自動化ではない。同じファイルを同時に触らせない。これだけでかなり効く。別名でいうなら、コンフリクトの芽を摘む、あるいは編集箇所の分離だ。 筆者も最初は、1 つの大きい指示にまとめて投げていた。すると Claude Code はちゃんと仕事をするのに、最後に差分を合わせる段階で疲れる。README、設定ファイル、サンプル、文書本文を一気にいじると、修正の意図は合っていても、競合の処理だけで手戻りが出る。そこで分けた。すると、見た目は地味だが、衝突は目に見えて減った。 要は、Claude Code に「何を直すか」だけでなく、「何を同時に直さないか」まで渡すのがコツだ。 この話は開発だけでなく、ファイル整理や文書作成にもそのまま使える。たとえば案件ごとのフォルダを分けて書面を作る、原稿本文と参考資料を切り分ける、不要ファイルを掃除するときに対象を一塊にしない。そういう地味な分離が、あとで効いてくる。 --- まず、C

同じ作業場に案を2つ3つ重ねると、だいたいどこかでぶつかる。ファイルが上書きされる、差分が汚れる、どの変更がどの案のものか分からなくなる。ここを雑にやると、Claude Code はむしろ便利さより手戻りを増やす。 だから先に作業場所を分ける。複数案を別作業場所で進める、要するに並走作業の整理だ。これだけで衝突の大半は消える。 Claude Code で複数案を同じリポジトリに並べたいとき、まずやるべきなのは「同じ場所で頑張ること」ではない。案ごとに作業ディレクトリを分けることだ。Git の worktree を使うのが一番きれいで、次点で単純に別ディレクトリへ複製するやり方でも足りる。 筆者は最初、ひとつの作業ディレクトリで「案Aを少し直して、戻して、案Bを試す」をやって、diff がぐちゃぐちゃになった。Claude Code 自体が悪いのではなく、作業場の切り分けが甘いだけだった。後から見ても、どの変更がどの案だったか判別しづらい。あれは本当にだるい。 Git を使っているなら、`git worktree` が本命だ。同じリポジトリを、別のディレクトリとして複数開ける。しかも履歴

それ、いきなり本番の場所で試すから詰まるのだ。Claude Code は手早く頼めるぶん、雑に使うと変更が広がる。下書きと確定版を分離する、試作品を別場所に逃がす。たったこれだけで、あとから直すときの面倒さがかなり減る。 ここで言っている「分ける」は大げさな話ではない。たとえば、文章なら本番の原稿とは別に `draft/` を作る。ファイル整理なら、いきなり元フォルダを触らず、まず `sandbox/` や `tmp/` に複製を置く。コードなら、既存ブランチや本番ディレクトリを汚す前に、作業用の場所を切る。Claude Code はその場で手を動かす道具なので、まず逃がし先を作るのが正解だ。 一番わかりやすい使い方は、Claude Code に「試作品はここで作って、確定したら本体に反映して」と最初に言い切ることだ。依頼文は、あいまいにするとすぐ散る。たとえば文書整理ならこうだ。 ```text このフォルダは本番用です。直接は触らず、別の作業用フォルダに試作品を作ってください。 まずは下書きを `draft/` にまとめ、その内容を見てから確定版へ反映します。 本番のファイル名や配

Claude Code に雑に「これ直して」と投げて、そのまま広い場所を触らせる。これがいちばん危ない。 事故の多くは、モデルの頭の良し悪しではなく、触らせる範囲が広すぎることから起きる。だから先にやるべきは、作業場所を固定することだ。別名で言えば、触らせる範囲を狭める、だ。 筆者はこれを甘く見て、ホームディレクトリや巨大なプロジェクトの根っこで作業を始めて、余計なファイルまで読ませてしまったことがある。結果、コンテキストが無駄に膨らみ、返ってくる修正案もぼやけた。小さな修正のはずが、確認のための往復だけで疲れる。Claude Code は優秀だが、何でも見せれば賢くなるわけではない。むしろ逆だ。 作業フォルダを先に決める、とは要するに「今回の仕事はここだけ」と最初に囲うことだ。これだけで、誤爆、読みすぎ、書きすぎが一気に減る。ファイル整理でも文書作成でも同じで、対象を絞ったほうが、指示も結果もシャープになる。 たとえば、案件ごとの書面を作るなら、案件フォルダを先に切って、その中だけを相手にする。重複ファイルや不要キャッシュを掃除するなら、対象のディレクトリを決めてから走らせる

終わったディレクトリをそのまま放置していると、次の Claude Code が地味に鈍る。これ、かなりありがちな落とし穴だ。 使い終わった作業場所の整理、要するに後片付けをしておくと、次回は「何を見ればいいか」が明確になり、探し回る時間も、余計な差分に引っ張られる手間も減る。 Claude Code は賢いが、魔法のように自動で「これはもう不要」と見抜いてくれるわけではない。作業用のフォルダに古い試行錯誤、半端な生成物、使い終わったメモが残っていると、次の依頼でまたそれらを読みに行く。人間でも気が散るが、こういう散らかり方はエージェントにも効く。筆者は以前、同じ案件フォルダに古い出力と新しい出力を混在させたまま進めて、Claude Code に「どっちを正にするのか」を毎回説明し直す羽目になった。あれは本当にだるい。 なので、作業が終わったら「片付け」を一回入れる。大げさな話ではない。次の仕事が始まる前に、古い依頼の残骸を減らしておく。それだけで十分効く。 まずやることは単純だ。作業が終わったら、その案件のフォルダを見直して、次回に要らないものを外に出す。たとえば、実験中のファイル、途