Claude Codeを使い込むと、設定ファイルやスキルが増えてきて、「これ、どこに置くのが正解だっけ」と迷うようになります。私も最初は適当に置いて、あとで散らかりました。この記事は、置き場所の地図を整理したものです。
全体像 — 2つの置き場所がある
まず大枠から。Claude Codeの設定の置き場所は、大きく2つあります。
ひとつは、ユーザー全体の設定。自分のパソコンのホーム(自分用の基点となる場所)にある ~/.claude/ フォルダで、どのプロジェクトでも共通で効きます。先頭の ~ は、このホームを指す記号です。
もうひとつは、プロジェクト個別の設定。作業しているプロジェクト(ひとつの制作物をまとめた作業フォルダ)の中に作る .claude/ フォルダで、そのプロジェクトでだけ効きます。なお名前がドットで始まるフォルダは、ふだん画面に隠れていることがあるので、見当たらないときは隠しファイルの表示を切り替えてください。
「全員・全プロジェクト共通にしたいもの」はユーザー側、「このプロジェクト専用」はプロジェクト側、と置き分けるのが基本です。
プロジェクト直下に置くもの
プロジェクトのいちばん上(直下)に置くのが、CLAUDE.mdです。
CLAUDE.mdは、そのプロジェクトの前提や約束ごとを書いておくファイル。Claude Codeは起動時にこれを読んで、毎回の判断に反映します。プロジェクトの顔のような存在なので、直下に置くのが定番です。
.claudeフォルダの中身
.claude/ フォルダの中には、いくつかの決まった置き場所があります。代表的なものを並べます。
場所 | 役割 |
|---|---|
| そのプロジェクトの設定(操作の許可範囲や、使うAIの種類など) |
| スキル(覚えさせた作業手順)を置く |
| 自分で作ったスラッシュコマンドを置く |
.claude/skills/ は、最近フォルダに置くだけで自動読み込みされるようになりました。
設定ファイル(settings.json)の中身そのものは、別記事に整理しています。
ユーザー全体とプロジェクト個別の使い分け
迷いやすいのが、ユーザー側に置くか、プロジェクト側に置くか、です。
私の基準はシンプルです。「自分がどのプロジェクトでも使いたい」ものはユーザー側(~/.claude/)、「このプロジェクトの人みんなで共有したい」ものはプロジェクト側(.claude/)。
たとえば、自分の口調の好みやよく使う個人的なスキルはユーザー側へ。チームで揃えたいコード規約や、プロジェクト専用のスキルはプロジェクト側へ。プロジェクト側はGitで共有すれば、全員に同じ設定が行き渡ります。
チームで共有するときの注意
プロジェクトの .claude/ をGitで共有するとき、ひとつ注意があります。
個人のAPIキー(サービスを使うための自分専用のパスワードのような文字列)や、秘密にすべき情報は、共有される設定ファイルに書かないこと。これらは環境変数(設定ファイルとは別に、外から値を渡す仕組み)など、共有されない形で渡すのが安全です。権限まわりの考え方は別記事に。
私は一度、共有設定にうっかり個人的な値を書いてしまい、チームに見えてしまったことがあります。共有されるフォルダには「人に見られて困るものは置かない」を必ず守るようにしています。
迷ったらシンプルに始める
最後に。最初から凝った構成を作る必要はありません。
まずはプロジェクト直下にCLAUDE.mdを1つ置くだけ。それで十分回ります。スキルやコマンドが増えてきたら、.claude/ の中に整理していく。使いながら育てる、で問題ありません。
まとめ
- 設定の置き場所はユーザー全体(
~/.claude/)とプロジェクト個別(.claude/)の2つ - CLAUDE.mdはプロジェクト直下に置くのが定番
.claude/の中に settings.json / skills/ / commands/ を役割ごとに置く- 全プロジェクト共通はユーザー側、チーム共有はプロジェクト側に置き分ける
- 共有される設定ファイルにAPIキーなど秘密の情報を書かない
- 最初はCLAUDE.md 1つから。使いながら構成を育てればよい