PaPoo
cover

触らせる範囲を狭めるだけで、余計な事故はかなり減る

Claude Code に大きなフォルダを丸ごと渡して、「あとはよろしく」はかなり危ない。
余計なファイルまで見に行かせると、コンテキストを食うし、意図しない場所まで修正しやすい。対象フォルダを限定する、作業範囲の制御を先にやる、巻き込み事故を防ぐ。これだけで、手戻りは目に見えて減る。

特に、ファイル整理、ディスク削減、文書作成みたいな用途では効き目が大きい。開発者でも非エンジニアでも同じだ。触らせる場所を狭めると、Claude Code は雑になりにくい。

たとえば、案件ごとにフォルダを分けているなら、その案件の中だけを見せればいい。
古い書類の整理をしたいなら、家全体ではなく「この年の請求書フォルダだけ」に絞る。
これをやらずに全体を渡すと、関係ないドラフトや一時ファイルまで拾ってしまい、出力がぼやける。実務ではそれがいちばんだるい。

まずは「ここだけ触る」を先に決める

Claude Code を使う前に、作業対象を言葉で固定するのが先だ。
「このフォルダの中だけ」「この案件の書面だけ」「この掃除対象の範囲だけ」とはっきり切る。曖昧にすると、AI はいい感じに広く見に行く。人間が見れば不要な範囲まで、平気で拾う。

たとえば文書整理なら、こういう頼み方が効く。

このフォルダ内のファイルだけを見て、重複している下書きと不要な一時ファイルを洗い出してください。
他のフォルダには触らないでください。
削除候補は一覧だけ出して、削除は私の確認後にしてください。

この言い方の肝は、作業範囲と操作範囲を分けている点だ。
「見る範囲」と「変更していい範囲」は同じではない。ここを分けないと事故る。

Claude Code は、プロジェクト内の情報を広く参照できると便利だが、そのぶん視界も広がる。広すぎる視界は雑さに直結する。人間の目でも、机の上が散らかると判断が鈍るのと同じだ。

対象フォルダを限定するやり方を、最初から癖にする

実用上は、Claude Code を起動する場所を狭くするのが一番わかりやすい。
つまり、余計なものが入っている親フォルダではなく、目的のフォルダそのものを作業場所にする。案件単位、顧客単位、書類単位で分けておくと楽になる。

たとえばこんな構成だ。

work/
  client-a/
    draft/
    contract/
    notes/
  client-b/
    draft/
    contract/

このとき、work/ で全部まとめて扱うより、client-a/ だけを対象にするほうが安全だ。
似た名前のファイルが別案件にあるだけで、うっかり混ぜる。そういう事故は本当に起きる。筆者も昔、同名の「final」を複数案件で扱っていて、確認のつもりが別フォルダの下書きをいじりかけたことがある。差分を見る前に気づいたが、あれは冷や汗ものだった。

ファイル整理やディスク削減でも同じだ。
「全部の写真」ではなく「2022年の不要キャッシュだけ」。
「全書類」ではなく「この案件の旧版だけ」。
範囲を切るだけで、判断の精度が上がる。

依頼文には、対象外をはっきり書く

範囲を狭めるとき、意外と効くのが「何をしないか」を書くことだ。
Claude Code は、やってほしいことだけでなく、やるなもちゃんと伝えたほうがいい。

たとえばコード修正なら、こんな感じになる。

このリポジトリの src/components だけを確認してください。
他のディレクトリは参照しないでください。
変更はこのフォルダ内に限定してください。
テストの追加も、この範囲に関係するものだけにしてください。

文書作成ならこうだ。

この案件フォルダ内のメモだけを使って、報告書の下書きを作ってください。
別案件のメモ、過去のテンプレート、関係ない参考資料は使わないでください。
必要なら不足点を質問してください。

ここで大事なのは、Claude Code に「全部見ていい」と思わせないことだ。
AI は親切なので、関連しそうなものを拾いに行く。その親切が、時に巻き込み事故になる。だから先に門を閉める。

よくある失敗は、広い場所で小さな作業をさせることだ

事故が起きるパターンはだいたい決まっている。
広いフォルダを開いたまま、名前の似たファイルを複数置いたまま、曖昧な指示で頼む。すると、余計な参照、余計な修正、余計な差分が出る。

Claude Code は万能なロボットではない。雑に渡した情報を、雑に広く扱うことがある。
それで「なんでここまで触った?」となる。人間側の設計ミスだ。

筆者が手戻りしたときも、原因は単純だった。作業フォルダを分けずに、古い草案と新しい草案を同じ場所に置いていたのだ。Claude Code が悪いというより、見せ方が悪かった。どれが現行か分からない状態は、AI にとっても地雷原だ。

だから、次のどれかは先にやっておくといい。

このへんは地味だが、効き方は派手だ。事故の大半は、作業前の片付けで消える。

変更していい場所と、読んでいい場所を分ける

Claude Code を使うときは、「見てよいが、変えてはいけない場所」も決めるといい。
これをやると、調査や下書きは広めに、編集は狭めにできる。

たとえばこんな運用だ。

このフォルダ内の資料は読んでよいですが、編集してよいのは draft/ のみです。
final/ と archive/ は参照だけにしてください。

この切り分けがあると、誤編集の確率が落ちる。
特に、提出直前の文書や、保存版のファイルがある運用では効く。ひとつのフォルダに「作業中」と「完成版」を混ぜるのは、わざわざ事故を呼ぶやり方だ。

開発用途でも同じで、設定ファイルや生成物、実験用のコードが同居していると危ない。見ていい場所、変えていい場所、触るなを分ける。これが作業範囲の制御の基本になる。

ひとまずこれだけ守ればいい、という実戦ルール

細かい理屈より、まず運用で効かせるなら次の順で十分だ。

  1. 対象フォルダを先に切る
  2. 触っていい場所と参照だけの場所を分ける
  3. 変更前に「この範囲だけ」と明記する
  4. 削除や上書きは確認後に回す
  5. 似た名前のファイルを同居させない

この5つだけで、巻き込み事故はかなり減る。
Claude Code は雑に広く使うほど危ないが、狭く切るほど頼れる。これはかなり単純な話だ。

もし迷ったら、こう考えればいい。
「全部見せる」より「必要なものだけ見せる」。
そのほうが、速いし、静かだし、あとで痛い目を見にくい。

そして、より大きな作業に広げたくなったら、そのときに範囲を一段ずつ広げればいい。最初から全部を触らせる必要はない。
Claude Code は、狭い作業場で使うほうがうまい。広い倉庫を一気に任せる発想は捨てたほうがいい。

関連 TIPS

同じ著者の記事