Claude Code は、指示・設定・スキル・サブエージェント・メモリをプロジェクトのディレクトリとホームディレクトリの ~/.claude から読み込みます。本記事は公式ドキュメント「Explore the .claude directory」と「Settings files and precedence」に基づき、どのファイルを何のために置くのか、git にコミットするものとしないもの、~/.claude に自動で溜まるデータとその消し方を日本語で整理します。
公式によれば、ほとんどのユーザーが編集するのは CLAUDE.md と settings.json だけです。それ以外は必要になったときに足していけば十分です。
.claude ディレクトリの全体像
Claude Code の設定ファイルは、置き場所によって誰に効くかが変わります。
- プロジェクト: リポジトリ内の
.claude/(CLAUDE.md・.mcp.json・.worktreeincludeはリポジトリ直下)。git にコミットすればチーム全員に共有されます - グローバル(個人): ホームディレクトリの
~/.claude/。自分のすべてのプロジェクトに効く個人設定です
Windows では ~/.claude は %USERPROFILE%\.claude を指します。環境変数 CLAUDE_CONFIG_DIR を設定すると、~/.claude 配下のパスはすべてそのディレクトリに移ります。通常は ~/.claude.json にある .claude.json も同様です。
リポジトリにほかのコーディングエージェント向けの AGENTS.md がすでにある場合、Claude Code は CLAUDE.md の代わりにそれを読み込めます。
エクスプローラーの外にあるファイル
公式ページのツリー表示は自分で書いて編集するファイルが対象です。関連するファイルのうち、次のものは別の場所にあります。
| ファイル | 場所 | 用途 |
|---|---|---|
managed-settings.json | システムレベル(OS ごとに異なる) | 組織が強制する設定。自分の設定ファイルや --settings では上書きできない(一部例外あり) |
CLAUDE.local.md | プロジェクト直下 | そのプロジェクトでの個人的な好み。CLAUDE.md と一緒に読み込まれる。手動で作り、.gitignore に追加する |
AGENTS.md | プロジェクト直下・.claude/・任意のディレクトリ | AI コーディングエージェント向けの指示。CLAUDE.md の代わりに読み込める |
| インストール済みプラグイン | ~/.claude/plugins | clone したマーケットプレイス、プラグインの各バージョン、installed_plugins.json など。claude plugin コマンドが管理する |
目的別にファイルを選ぶ
やりたいことからファイルを引くための対応表です。「プロジェクト/グローバル」はどちらにも置けることを表します。
| やりたいこと | 編集するファイル | スコープ |
|---|---|---|
| プロジェクトの前提や規約を伝える | CLAUDE.md | プロジェクト/グローバル |
| 特定のツール呼び出しを許可・禁止する | settings.json の permissions または hooks | プロジェクト/グローバル |
| ツール呼び出しの前後にスクリプトを動かす | settings.json の hooks | プロジェクト/グローバル |
| セッションの環境変数を設定する | settings.json の env | プロジェクト/グローバル |
| 個人的な上書きを git に入れない | settings.local.json | プロジェクトのみ |
/name で呼び出すプロンプトや機能を足す | skills/<name>/SKILL.md | プロジェクト/グローバル |
| 専用のツールを持つサブエージェントを定義する | agents/*.md | プロジェクト/グローバル |
| スクリプトから多数のサブエージェントを動かす | workflows/*.js | プロジェクト/グローバル |
| MCP で外部ツールをつなぐ | .mcp.json | プロジェクトのみ |
| 応答の書き方を変える | output-styles/*.md | プロジェクト/グローバル |
設定ファイルの優先順位
同じキーが複数の場所にあるときは、上位のものが使われます。「Settings files and precedence」が示す順番は、上から次のとおりです。
- 管理設定(managed settings): 組織が配布する設定。自分のファイルや
--settingsでは上書きできない - コマンドライン: 起動時に
--settingsで渡した JSON(そのセッションだけ) - プロジェクトのローカル設定:
.claude/settings.local.json - 共有プロジェクト設定:
.claude/settings.json - ユーザー設定:
~/.claude/settings.json
ただし permissions.allow のようなリストは上書きではなく各ファイルの内容が結合されます。環境変数はこの階層には入らず、キーごとにどちらが優先されるかが決まっています。どのファイルが読み込まれたかは /status の Setting sources 行で確認できます。設定が効かないときの調べ方は 設定が効かないときの確認方法も参照してください。
.claude/settings.local.json は、Claude Code が git リポジトリ内で初めて書き込むときに、グローバルな git の除外ファイルへ **/.claude/settings.local.json を追加します。自分で手作りした場合は自動では除外されないので、.gitignore に追加します。
ファイル一覧と frontmatter
公式のファイルリファレンスにある各ファイルを、コミットするかどうかとあわせてまとめます。
| ファイル | スコープ | コミット | 役割 |
|---|---|---|---|
CLAUDE.md | プロジェクト/グローバル | する | 毎セッション読み込まれる指示 |
rules/*.md | プロジェクト/グローバル | する | トピック別の指示。パスで適用範囲を絞れる |
settings.json | プロジェクト/グローバル | する | 権限・フック・環境変数・モデルの既定値 |
settings.local.json | プロジェクトのみ | しない | 個人的な上書き |
.mcp.json | プロジェクトのみ | する | チームで共有する MCP サーバー |
.worktreeinclude | プロジェクトのみ | する | 新しい worktree にコピーする gitignore 済みファイル |
skills/<name>/SKILL.md | プロジェクト/グローバル | する | /name で呼ぶか自動で呼ばれる再利用プロンプト |
commands/*.md | プロジェクト/グローバル | する | 1ファイルのプロンプト。仕組みはスキルと同じ |
output-styles/*.md | プロジェクト/グローバル | する | Claude の動き方を調整する指示セット |
agents/*.md | プロジェクト/グローバル | する | 独自のプロンプトとツールを持つサブエージェント定義 |
workflows/*.js | プロジェクト/グローバル | する | /workflows から保存する動的ワークフロー。各ファイルが /<name> コマンドになる |
agent-memory/<name>/ | プロジェクト/グローバル | する | サブエージェントの永続メモリ |
~/.claude.json | グローバルのみ | - | アプリの状態、アカウント情報、UI の切り替え、個人の MCP サーバー |
projects/<project>/memory/ | グローバルのみ | - | 自動メモリ(Claude がセッションをまたいで残すメモ) |
keybindings.json | グローバルのみ | - | キーボードショートカットのカスタマイズ |
themes/*.json | グローバルのみ | - | 独自のカラーテーマ |
~/.claude.json がない場合は、セッションの開始時や claude auth status などのサブコマンド実行時に自動で作られます(--version と --help では作られません)。なお、これらのファイルの内容は、組織の管理設定、--permission-mode や --settings などの CLI フラグ、一部の環境変数によって上書きされることがあります。
ファイルごとの frontmatter
スキル・コマンド・サブエージェント・出力スタイル・ルールは、先頭の YAML frontmatter で設定を読みます。使えるフィールドはファイルの種類ごとに異なります。
skills/<name>/SKILL.md:name・description・when_to_use・argument-hint・arguments・disable-model-invocation・user-invocable・allowed-tools・disallowed-tools・model・effort・context・agent・background・hooks・paths・shell・metadata・license・compatibilitycommands/*.md: スキルのフィールドからnameとpathsを除いたものagents/*.md:name・description・tools・disallowedTools・model・permissionMode・maxTurns・skills・mcpServers・hooks・memory・background・effort・isolation・color・initialPromptなどoutput-styles/*.md:name・description・keep-coding-instructions・force-for-pluginrules/*.md:paths
プラグインに同梱されたエージェントは、サブエージェントのフィールドの一部だけに対応します。各ファイルの書き方は はじめてのスキル作成や サブエージェントの使い方で解説しています。
~/.claude に溜まるアプリケーションデータ
自分で書く設定とは別に、~/.claude には Claude Code が作業中に書き込むデータも置かれます。トランスクリプト、プロンプト履歴、ファイルのスナップショット、キャッシュ、ログなどです。
重要なのは、これらが平文で保存される点です。ツールを通ったもの(ファイルの内容、コマンドの出力、貼り付けたテキスト)はトランスクリプトに書かれ、システムプロンプト、ツール定義、リクエストのパラメータ、読み込んだ CLAUDE.md などの指示ファイルも含まれることがあります。
自動で削除されるもの
次のパスのファイルは、cleanupPeriodDays より古くなると削除されます。既定は30日、最小は1で、0 を設定すると検証エラーになります。
projects/<project>/<session>.jsonl: 会話のトランスクリプト(メッセージ、ツール呼び出しと結果など)projects/<project>/<session>/subagents/・tool-results/: サブエージェントのトランスクリプト、大きなツール出力file-history/<session>/: チェックポイントの復元に使う編集前のスナップショットplans/: プランモードで書かれたプランファイルdebug/:--debugや/debugでデバッグログを有効にしたときのログpaste-cache/・session-env/・tasks/・shell-snapshots/・backups/など
backups/ には書き換え前の ~/.claude.json が保存され、新しい5つと読み込めなかった版のコピーが残ります。
別のルールで扱われるもの
- 自動メモリ:
projects/<project>/memory/のメモリファイルは自動削除の対象外です。ディレクトリが保持期間中ずっと空だった場合にだけ削除されます - Claude Desktop と Cowork のトランスクリプト: デスクトップアプリや Cowork で開始または最後に続けたセッションのトランスクリプトは期間に関係なく残ります。期限を付けたいときは
desktopSessionCleanupPeriodDaysを設定します - 削除されず残るもの:
history.jsonl(入力したプロンプトの履歴。上矢印での呼び出しやCtrl+R検索に使う)、stats-cache.json(/usageの集計)など
claude -p を --bare 付きで実行したセッションでは、この自動削除は走りません。
機密情報を残しにくくする
トランスクリプトや履歴は保存時に暗号化されず、OS のファイル権限だけが保護です。.env を読んだりコマンドが認証情報を表示したりすると、その値はトランスクリプトに書かれます。公式は次の対策を挙げています。
cleanupPeriodDaysを短くして保存期間を縮める- 環境変数
CLAUDE_CODE_SKIP_PROMPT_HISTORYを設定して、トランスクリプトとプロンプト履歴を書かないようにする。非対話モードなら-pと一緒に--no-session-persistenceを渡す方法もある - 権限ルールで認証情報ファイルの読み取りを禁止する
ローカルデータの整理と claude purge
あるプロジェクトについて Claude Code が持っている状態をまとめて消すには、claude purge を使います(v2.1.288 より前は claude project purge)。削除されるのは次のものです。
projects/配下のトランスクリプトと自動メモリ- セッションごとの
tasks/・debug/・file-history/ history.jsonlのうち該当するプロンプト行~/.claude.json内のそのプロジェクトのエントリ
実行すると削除計画を表示し、確認してから消します。まずは --dry-run で何が消えるかを確かめるのが安全です。
# 削除せずに計画だけ表示する
claude purge ~/work/my-repo --dry-run
# 確認プロンプトを1回出してから削除する
claude purge ~/work/my-repo
# スクリプト用に確認を省く
claude purge ~/work/my-repo --yes
~/work/my-repo は公式の例のパスなので、自分のプロジェクトのパスに置き換えます。パスを省くと対話的な一覧からプロジェクトを選べます。--all を付けるとすべてのプロジェクトが対象になり、history.jsonl は絞り込みではなく丸ごと削除されます。-i を付けると削除計画を1件ずつ確認できます。
shell-snapshots/ と backups/ はプロジェクト単位ではないため claude purge では消えず、計画の出力で注意が表示されます。貼り付けた画像やセッションのスクラッチパッドは ~/.claude ではなく一時ディレクトリにあるので、これも対象外です。
手で消すときの注意
アプリケーションデータは手で削除しても構いませんが、失うものを把握しておきます。
~/.claude/projects/: 過去セッションの再開・続行・巻き戻しと、全プロジェクトの自動メモリ~/.claude/history.jsonl: 上矢印でのプロンプト呼び出しとCtrl+R検索~/.claude/file-history/: 過去セッションのチェックポイント復元~/.claude/debug/・plans/・session-env/・shell-snapshots/: 利用者から見て失うものはない
一方で、~/.claude.json・~/.claude/settings.json・~/.claude/plugins/ は削除しないよう公式は明記しています。アカウント情報、設定、インストール済みプラグインが入っているためです。ログイン情報の .credentials.json、サブエージェントのメモリ agent-memory/、バックグラウンドセッションの状態 jobs/・daemon/ も残しておくべき状態ファイルとして挙げられています。
関連記事: CLAUDE.md でプロジェクトを覚えさせる / Claude Code の設定と権限
本記事は Anthropic 公式ドキュメント「Explore the .claude directory」と「Settings files and precedence」に基づく非公式の日本語解説です(確認日 2026-11-12)。仕様は更新される場合があるため、利用前に公式ドキュメントをご確認ください。