Claude CodeのProject設定についてお探しですね。

広告

Claude Codeを使いこなそう！コストを抑えて快適に開発する方法

Claude Codeを使い始めて「すごく便利！」と感動したものの、「思ったよりAPI料金がかかってる…」「なんだか動作が遅い気がする」と悩んでいませんか？実はその原因、プロジェクトの中にある不要なファイルまでAIに読み込ませてしまっているせいかもしれません。

この記事では、Claude Codeをもっと賢く、お得に使うための設定方法をわかりやすく解説していきます。

なぜ不要なファイルを読み込ませちゃダメなの？

Claude Codeはとても賢いツールですが、何も設定しないと、プロジェクト内のあらゆるファイルを読み込もうとしてしまいます。

特に困るのが、`node_modules`みたいな巨大なフォルダや、自動で作られる`package-lock.json`、それに画像ファイルやログファイルなど。

これらを全部読み込ませると、3つの大きな問題が起きます。

**1. お金がかかりすぎる**
AIが読み込む情報量（トークン）が増えるほど、API利用料が高くなります。

必要ないファイルまで読み込ませるのは、お金をドブに捨てているようなものです。

**2. AIの回答が的外れになる**
ノイズみたいな情報が増えると、AIは本当に大事なコードの内容を見失ってしまいます。

結果として、「え、そうじゃないんだけど…」という回答が増えてしまうんです。

**3. セキュリティの危険性**
一番怖いのがこれ。

`.env`ファイルに書いてあるAPIキーやパスワードなど、絶対に外に出しちゃいけない情報まで読み込んでしまう可能性があります。

これらはクラウドに送信されるので、情報漏洩のリスクが高まります。

だからこそ、「何を読み込ませて、何を読み込ませないか」をきちんと設定することが超重要なんです。

CLAUDE.mdって何？プロジェクトのルールをAIに教えよう

Claude Codeには、「このプロジェクトではこんなルールで開発してね」とAIに教えるための`CLAUDE.md`というファイルがあります。

これは、プロジェクトの説明書みたいなもの。

たとえば、
– 「うちのプロジェクトではこういうコーディング規約を使ってます」
– 「フォルダ構成はこうなってます」
– 「テストはこのコマンドで実行してね」

といった内容を普通の文章で書いておくと、Claude Codeがそれを読んで、ちゃんとルールに従って動いてくれるようになります。

このファイルはプロジェクトのルートフォルダ（一番上のフォルダ）に置いておけばOK。

チームで開発している場合は、Gitで共有すれば、みんなが同じ基準でAIを使えるようになって便利です。

個人的な設定は別ファイルで管理しよう

一方で、「自分だけの好み」や「自分のパソコンの環境に関する設定」は、`CLAUDE.local.md`（または`.claude/settings.local.json`）に書くのがおすすめです。

たとえば、
– 「日本語で答えてほしい」
– 「自分のパソコンのこのパスを使って」

みたいな内容は、他の人には関係ないですよね。

だから、ローカル設定として分けて管理します。

**大事なポイント：**このローカル設定ファイルは`.gitignore`に追加して、Gitにはアップしないようにしましょう。

そうすれば、チーム全体のルールと個人の設定がごちゃ混ぜにならず、スッキリ管理できます。

読み込ませたくないファイルを指定する方法

Gitで使う`.gitignore`みたいに、`.claudeignore`というファイルを作りたくなりますよね。

実は、Claude Codeでは`settings.json`（または`settings.local.json`）という設定ファイルの中で、読み込ませたくないファイルを指定する方法が確実です。

具体的には、`permissions`という項目の中にある`deny`（拒否リスト）に、読み込ませたくないファイルのパターンを書いていきます。

設定例：こんなファイルは除外しよう

“`json

{
  "permissions": {
    "deny": [
      "node_modules/**",
      "vendor/**",
      ".git/**",
      ".env",
      "config/secrets.yml",
      "*.pem",
      "*.lock",
      "*.log",
      "assets/images/**"
    ]
  }
}

“`

**除外すべきファイルの例：**
– **自動生成されるフォルダ：** `node_modules`、`vendor`、`.git`など
– **秘密の情報が入ってるファイル：** `.env`、`secrets.yml`、証明書ファイル（`.pem`）など
– **巨大なファイル：** `package-lock.json`、ログファイル、画像フォルダなど

こうやって「これは読まないで！」とハッキリ指定しておけば、AIが誤って機密情報を読み込んだり、巨大なファイルで処理が遅くなったりするのを防げます。

特に大きなプロジェクトや古いコードを扱うときは、関係ないフォルダを全部除外設定にしておくと、AIの動作がびっくりするほど速くなりますよ。

長時間使うときの注意点：コンテキストをこまめにリセットしよう

設定ファイルで不要なファイルを除外するだけじゃなく、日々の使い方も大事です。

Claude Codeを使っていると、ついつい一つのセッション（会話）で色んな作業を続けてやってしまいがち。

でも、これはあまりおすすめしません。

なぜかというと、前にやった作業の内容やエラーメッセージがAIの記憶に残ったままだと、次の作業で古い情報を参照してしまって、的確な答えが返ってこなくなるからです。

おすすめの使い方

**基本ルール：「1つの作業が終わったらリセット」**
– `/reset`コマンドを使ってセッションをリセットする
– または、新しいターミナルを開いて作業を始める

こうすることで、AIの「記憶」をリフレッシュして、いつもクリアな状態で作業できます。

長時間作業が必要なときは

どうしても長時間作業しないといけないときは、`/compact`コマンドを使いましょう。

これを使うと、今までの会話の要点だけを残して、無駄な部分を圧縮してくれます。

トークンの消費を抑えながら、大事な文脈は維持できるので便利です。

また、作業が終わって不要になったファイルは、明示的にコンテキストから削除（remove）する習慣をつけましょう。

机の上を片付けるのと同じで、AIの「作業スペース」も整理整頓することで、今やるべきことに集中しやすくなります。

まとめ：設定と運用の両方が大事！

Claude Codeを快適に使うためのポイントをおさらいしましょう。

1. **CLAUDE.mdでプロジェクトのルールを共有**
– チーム全体で使う設定はここに書く
– 個人的な設定は`.local`ファイルで分ける

2. **settings.jsonで読み込み対象外を指定**
– `deny`リストで不要なファイルをブロック
– 機密情報、巨大ファイル、自動生成ファイルは必ず除外

3. **こまめにコンテキストをリセット**
– 1タスク1セッションを心がける
– 長時間作業では`/compact`を活用
– 不要なファイルは削除する

これらの設定と運用ルールを守れば、API料金を抑えながら、AIから的確な回答を引き出せるようになります。

最初は少し面倒に感じるかもしれませんが、慣れてしまえば自然にできるようになりますよ。

快適なClaude Code生活を楽しんでくださいね！

広告