PaPoo
cover

プロジェクトを開いて最初にやるべき3つの設定

Claude Code は、ただ「作業を始める道具」ではなく、​そのプロジェクトで何をしてよくて、どこまで触ってよいかを最初に整える道具でもあります。
この最初のひと手間を入れるだけで、あとからの指示が通りやすくなり、余計なやり直しも減ります。開発案件でも、文書整理でも、フォルダの掃除でも効きます。

最初にやるべきことは、むずかしくありません。
「作業範囲を決める」「ルールを置く」「確認のしかたを決める」。この3つです。

まず、触っていい場所をはっきりさせる

Claude Code を開いたら、最初にやるべきなのは作業場所の確認です。
これはエンジニア向けの話に見えますが、非エンジニアにも重要です。たとえば、案件ごとにフォルダを分けて書面を作る、写真整理で年ごとのフォルダだけを対象にする、不要キャッシュを消す対象をひとつの作業用フォルダに閉じる。こういうとき、最初の境界が曖昧だと事故が起きやすいです。

Claude Code では、基本的にいま開いているプロジェクトの中で作業する前提を作ります。
だから、まずはターミナルで目的のフォルダに入ってから起動するのが大事です。

cd /path/to/your/project
claude

ここで確認したいのは、「このフォルダが本当に今回の対象か」です。
似た名前のフォルダが並んでいると、うっかり別案件を開いたまま進めてしまいます。特に、次のようなケースは要注意です。

Claude Code に最初にこう伝えると、あとが楽です。

このプロジェクトでは、docs/ 配下だけを編集対象にしてください。archive/ は触らないでください。

これは案件Aの作業フォルダです。外部のファイルは参照しないで、いまのフォルダの中だけで進めてください。

こうしておくと、指示のたびに「どこまで見ていいか」を毎回説明し直さずに済みます。

次に、守ってほしい作業ルールを1枚にまとめる

Claude Code は、プロジェクトごとの事情を言葉で渡すと、かなり扱いやすくなります。
ここでいう「設定」は、難しい画面操作の話ではなく、​この案件での約束事をテキストで置くことです。

おすすめは、プロジェクトのルートに簡単な説明ファイルを置くやり方です。
たとえば、Claude に渡したいルールを書いたファイルを作ります。名前は .claude/ 配下でも、普通の README.md の一部でもかまいません。運用しやすい形でよいですが、​あとから見返して意味が分かることが大切です。

たとえば、こんな内容です。

このフォルダは請求書関連の文書をまとめた作業用ディレクトリです。

作業ルール:
- 既存ファイルの文体はできるだけ維持する
- 事実が不明な箇所は勝手に補完しない
- PDF化前の原稿のみ編集する
- 仕上げの前に変更点を要約する

Claude Code には、こういうふうに頼むと素直です。

このプロジェクトのルールを前提にして作業してください。
不明な点があれば、先に質問してください。
既存文書の文体は極力変えず、最小限の修正で整えてください。

開発案件なら、ここにもう少し具体的な約束を足します。

- 生成したコードは、既存の命名規則に合わせる
- 変更は必要最小限にする
- テストや確認が必要なら、先に実施手順を示す
- 依存関係の追加は、理由が明確なときだけ

文書作成やファイル整理なら、こうしたルールが役立ちます。

- ファイル名は日付_内容_版数の順にそろえる
- 重複ファイルは、残す基準を先に提示する
- 元ファイルは消さず、移動先を提案してから実行する

Claude Code は「なんでも自由にやっていい」状態より、​少し縛ったほうが結果が安定しやすいです。
とくに長めの作業では、この一枚が効いてきます。

最後に、確認のしかたを先に決めておく

最初のうちに決めておくべきなのが、​どういう形で結果を確認するかです。
ここを曖昧にすると、作業は進んだのに「思っていたのと違う」が起こりやすいです。

たとえば、コードなら「変更前後の差分を見せてから進める」、文書なら「先に要約を出す」、整理作業なら「削除候補を一覧で出してから実行する」。この順番を固定しておくと安心です。

Claude Code への指示は、こんな形が使いやすいです。

実行前に、まず方針を短く説明してください。
そのあと、変更するファイルの一覧を出してください。
最後に作業を進めて、完了したら変更点をまとめてください。

削除は勝手に確定しないでください。
まず削除候補を挙げ、理由を示し、私の確認後に実行してください。

文章の修正は、完成版をいきなり上書きせず、差分が分かる形で示してください。

この「確認のしかた」を最初に決めておくと、非エンジニアの人ほど安心して使えます。
フォルダ整理でも、古い写真や重複ファイルを消す前に候補を出してもらえるだけで、判断しやすさがまったく違います。弁護士や事務職のように、案件ごとの記録を丁寧に扱いたい仕事でも相性がいいやり方です。

ひとつだけ注意しておきたいこと

最初の3つを整えると便利ですが、​Claude Code に全部を丸投げしないことも大切です。
特に次の点は、毎回その場で確認したほうが安全です。

まず、削除や上書き。
これは自動で進めるより、対象を見せてもらってから判断するほうが失敗しません。

次に、元データの扱い。
原本、バックアップ、作業コピーが混ざると取り返しがつきにくいので、最初に役割を分けます。

最後に、仕様があいまいなもの。
たとえば「この文書を読みやすくして」と頼んでも、どこまで直すかは人によって違います。曖昧な依頼ほど、先に見本や基準を置いたほうがうまくいきます。

Claude Code の細かな挙動や、プロジェクトごとの設定方法は、環境や版によって説明のされ方が変わることがあります。仕様が気になる場合は、公式ドキュメント(docs.claude.com)で確認するのが確実です。

少し進めるなら、最初の設定を「使い回せる形」にする

一度うまくいったら、その3つを毎回コピーして使える形にしておくとさらに楽になります。
たとえば、案件ごとの共通ルールをテンプレート化しておく、確認の順番を定型文にしておく、作業対象フォルダの決め方をメモしておく。これだけで、次のプロジェクト開始がかなり速くなります。

新しい案件を開くたびにやることは、実は多くありません。
「ここだけ触る」「このルールで動く」「この順番で確認する」。この3点を先に置く。
それだけで、Claude Code は急に扱いやすくなります。

関連 TIPS

同じ著者の記事