Claude Codeを使い始めると、毎回同じことをチャットで説明していることに気づきます。
「このプロジェクトはWordPressテーマです」
「コメントは日本語で書いてください」
こういった前提条件を、毎回チャットに打ち込むのは少し手間ですよね。
この記事では、そんな手間を省くための設定ファイルの作り方を紹介します。一度設定しておくだけで、Claude Codeが毎回読み込んでくれるので、チャットがぐっとシンプルになります。
Claude Codeの設定ファイルとは
Claude Code設定ファイルの種類
Claude Codeは、あらかじめ決められているファイルを使って動作をカスタマイズできます。
設定ファイルを作成することで、条件やルールなどの設定を毎回説明する手間を省くことができます。
代表的な初期設定ファイルとして、以下の２種類があります。
◆ CLAUDE.md
プロジェクトの説明などを記載した、Claudeへの指示書です。
イメージは、「Claudeに何をしてほしいか」を伝えるためのファイルです。
Claude Codeは作業を始めるとき、このファイルを自動で読み込みます。
「このプロジェクトはWordPressテーマです」「コメントは日本語で書いてください」といったことを一度書いておけば、毎回チャットで説明しなくて済みます。
◆ settings.json
Claude Codeの動作について技術的な設定を行うファイルです。
イメージは、「Claude Codeをどう動かすか」を設定するファイルです。
使用するAIモデルの切り替えや、Claudeに許可・禁止するコマンドの設定ができます。
普段VSCodeで使っているsettings.jsonとは別のファイルで、置き場所も役割も違うので注意してください。
設定ファイルはどこに置く？
これらの設定ファイルは、置く場所によって効く範囲が変わります。
公式ドキュメント では4パターン紹介されていますが、まずは以下の２つを確認しましょう。
パソコン全体に効く場所（グローバル設定）
Windows: C:\Users\ユーザー名\.claude\
Mac: /Users/ユーザー名/.claude/
├── CLAUDE.md ← 全プロジェクト共通の指示
└── settings.json ← 全プロジェクト共通の動作設定
プロジェクトの中だけに効く場所（ローカル設定）
wpedbase_2/
├── CLAUDE.md ← このプロジェクト専用の指示
└── .claude/
└── settings.json ← このプロジェクト専用の動作設定
グローバルの設定はすべてのプロジェクトに効き、ローカルの設定はそのプロジェクトの中だけに効きます。両方ある場合は、プロジェクト内の設定が優先されます。
まずはプロジェクトの中だけに効く設定から試してみましょう。
どのプロジェクトにも効いてしまうグローバル設定は、使い方に慣れてから「これはデフォルト設定として入れておきたいな」というものを追加して、少しずつ育てていくのがおすすめです。
.claudeフォルダについて
.claudeはドット（.）で始まる隠しフォルダです。
Windowsのエクスプローラー、Macのfinderでは表示されない場合があります。
「ファイルが見当たらない」と感じたら隠しファイルの表示をオンにしてみてください。
CLAUDE.mdを作る
CLAUDE.mdとは
Claude Codeは作業を始めるとき、プロジェクト内のCLAUDE.mdを自動で読み込みます。
ここに書いた内容は、毎回説明しなくてもClaudeが最初から把握している情報になります。
「このプロジェクトはWordPressテーマです」
「jQueryは使わないでください」
「コメントは日本語で書いてください」
こういった説明を毎回チャットに書かなくて済むのが最大のメリットです。
CLAUDE.mdを作ってみよう
CLAUDE.mdの作成・編集
VSCodeでテーマフォルダを開いた状態で、Claude Codeに頼みましょう。
このプロジェクト用のCLAUDE.mdを作ってください。
日本語でお願いします。
Claudeがプロジェクトの内容を確認して、たたき台を作ってくれます。
Edit automaticallyで動かしている方は、何度か確認が出るので許可してください。
作成されたファイルを開いて、内容を確認してみましょう。
Claudeが読み取ったプロジェクトの概要・ルールがまとめられています。
作成されたのは、今あるファイルからClaudeが読み取って作った下書きのようなものです。
内容は自由に書き換えてOKです。 このプロジェクトでClaudeに毎回伝えていること、もしくは生成されたファイルを見て「そこは違うよ」「こうしてほしい」という部分があれば編集・追記していきましょう。
なお、ファイル内では#CLAUDE.mdや`**js/main.js**`などのように記号が使われていると思いますが、これはマークダウンの書き方（記法）になります。
#は見出しで、数が見出しのレベルです。（#の数が1つならh1、2つならh2）`はコードやファイル名を囲むときに使用します。
書き方がよくわからない、という場合はチャットでClaude Codeに指示すると書いてくれます。
例えば、以下はコーディング時のルール追加をお願いした場合です。
CLAUDE.mdに、コーディング時に守って欲しいルールを加えてください。
・インデントはスペース2つ分。
・コメントを入れる時は日本語でわかりやすく書く。
設定ファイルは、最初から完璧に作成する必要はありません。
作業をしていく中で、これは前提条件として設定しておくと便利かも…というものがあれば追記していくイメージです。必要に応じてCLAUDE.mdの中身を追加していきましょう。
CLAUDE.mdが読み込まれているか確認する
Claude Codeのチャット欄で尋ねると、CLAUDE.mdを確認して答えてくれます。
今このプロジェクトのCLAUDE.mdを読み込んでいますか？内容を確認して、概要を教えてください。
settings.json（Claude Code用）を作る
settings.jsonとは
Claude Codeの動作そのものを設定するファイルです。
どのモデルを使うか、どのコマンドを許可するかといった設定を書きます。
普段VSCodeの設定でsettings.jsonを使っている方もいると思いますが、これとは別のファイルです。
紛らわしいですが、置き場所も役割も違うので、混同しないようにしてください。
フォルダとファイルの作成
テーマフォルダの中に.claudeというフォルダを作り、その中にsettings.jsonを置きます。
自分で作成しても良いですし、以下のようにClaude Codeに頼んでも作ってくれます。
このプロジェクト内に.claudeフォルダを作って、settings.jsonを作成してください。
次のレッスンで実際に中身を入れますので、今は空のファイルが作れていればOKです。
settings.jsonでどんなことが設定できるか
Claudeに許可・禁止するコマンドの設定
「gitコマンドは許可するけど、ファイルの強制削除は禁止」といった細かい制御ができます。
チームで使うときに役立ちますので、設定の必要性を感じた際にClaudeに相談してみてください。
{
"allowedTools": ["Read", "Write", "Bash(git *)"],
"disallowedTools": ["Bash(rm -rf *)"]
}
モデルの設定について
settings.jsonに記述することで、Claude Codeが使用するモデルも指定することができます。
VSCode版Claude CodeのUI（パネル）と基本操作で、モードとモデルの切り替え方をご紹介しました。モードに合わせてモデルを切り替えることで効率とコスパが良くなりますが…ちょっと面倒。
そこで登場したopusplan が話題になっています。
opusplan モデルエイリアスは、自動化されたハイブリッドアプローチを提供します。
opusplan を使用すると、通常の作業はSonnet（速くて効率的）、プランモードならOpus（じっくり考える）、とモードに合わせてモデルを自動で使い分けてくれるようになるので、設定すると毎回手動で切り替える手間がなくなります。
ただし本記事作成時点では、CLI版（ターミナルで使うタイプ）では動作が確認されているものの、VSCode拡張機能では対応中の機能です。VSCode拡張機能版で設定しようとすると正しく動作しない場合がありますので、モデル選択にopusplanが追加されたタイミングで試してみてください。
ちなみにopusplanを設定するのは、settings.jsonにこの一行を書くだけで完了します。
{
"model": "opusplan"
}
まとめ
今回は２つの設定ファイルを作成しました。
- CLAUDE.md：Claudeへの指示書
- .claude/settings.json：Claude Codeの動作設定
設定ファイルは最初から完璧に作る必要はありません。
作業を続けるなかで「これは毎回説明しているな」と感じたことをCLAUDE.mdに追記したり、「この設定があると便利だな」と思ったらsettings.jsonに加えたりと、少しずつ育てていくイメージで使ってみてください。
次のレッスンでは、Git管理時にこうしたファイルをどうするかを解説します。