.claude ディレクトリを探索する
Claude Code が CLAUDE.md、settings.json、hooks、skills、commands、subagents、workflows、rules、auto memory を読み込む場所。プロジェクト内の .claude ディレクトリとホームディレクトリの ~/.claude を探索します。
Claude Code は、プロジェクトディレクトリとホームディレクトリの ~/.claude から、指示、設定、skills、subagents、メモリを読み込みます。プロジェクトファイルを git にコミットしてチームと共有します。~/.claude 内のファイルは、すべてのプロジェクトに適用される個人設定です。
Windows では、~/.claude は %USERPROFILE%\.claude に解決されます。CLAUDE_CONFIG_DIR を設定した場合、このページのすべての ~/.claude パスはそのディレクトリの下に存在します。
ほとんどのユーザーは CLAUDE.md と settings.json のみを編集します。ディレクトリの残りはオプションです。必要に応じて skills、rules、または subagents を追加してください。
ディレクトリを探索する
ツリー内のファイルをクリックして、各ファイルの機能、読み込みタイミング、および例を確認してください。
表示されていないもの
エクスプローラーは、作成および編集するファイルをカバーしています。関連するいくつかのファイルは他の場所に存在します。
| ファイル | 場所 | 目的 |
|---|---|---|
managed-settings.json |
システムレベル、OS によって異なる | オーバーライドできないエンタープライズが強制する設定。サーバー管理設定を参照してください。 |
CLAUDE.local.md |
プロジェクトルート | このプロジェクトの個人的な設定。CLAUDE.md と一緒に読み込まれます。手動で作成し、.gitignore に追加してください。 |
| インストール済みプラグイン | ~/.claude/plugins/ |
クローンされたマーケットプレイス、インストール済みプラグインバージョン、およびプラグインごとのデータ。claude plugin コマンドで管理されます。孤立したバージョンはプラグインの更新またはアンインストール後 7 日で削除されます。プラグインキャッシングを参照してください。 |
~/.claude は、作業中に Claude Code が書き込むデータも保持します。トランスクリプト、プロンプト履歴、ファイルスナップショット、キャッシュ、ログです。以下のアプリケーションデータを参照してください。
適切なファイルを選択する
異なる種類のカスタマイズは異なるファイルに存在します。このテーブルを使用して、変更がどこに属するかを見つけてください。
| 実行したいこと | 編集 | スコープ | リファレンス |
|---|---|---|---|
| Claude にプロジェクトコンテキストと規約を提供する | CLAUDE.md |
プロジェクトまたはグローバル | メモリ |
| 特定のツール呼び出しを許可またはブロックする | settings.json permissions または hooks |
プロジェクトまたはグローバル | パーミッション、Hooks |
| ツール呼び出しの前後にスクリプトを実行する | settings.json hooks |
プロジェクトまたはグローバル | Hooks |
| セッションの環境変数を設定する | settings.json env |
プロジェクトまたはグローバル | 設定 |
| 個人的なオーバーライドを git から除外する | settings.local.json |
プロジェクトのみ | 設定スコープ |
/name で呼び出すプロンプトまたは機能を追加する |
skills/<name>/SKILL.md |
プロジェクトまたはグローバル | Skills |
| 独自のツールを持つ特化した subagent を定義する | agents/*.md |
プロジェクトまたはグローバル | Subagents |
| スクリプトから多くの subagent をオーケストレーションする | workflows/*.js |
プロジェクトまたはグローバル | 動的ワークフロー |
| MCP 経由で外部ツールを接続する | .mcp.json |
プロジェクトのみ | MCP |
| Claude がレスポンスをフォーマットする方法を変更する | output-styles/*.md |
プロジェクトまたはグローバル | 出力スタイル |
ファイルリファレンス
このテーブルは、エクスプローラーがカバーするすべてのファイルをリストしています。プロジェクトスコープのファイルはリポジトリの .claude/ の下に存在します（CLAUDE.md、.mcp.json、.worktreeinclude はルートにあります）。グローバルスコープのファイルは ~/.claude/ に存在し、すべてのプロジェクトに適用されます。
ファイル名をクリックして、上記のエクスプローラーでそのノードを開きます。
| ファイル | スコープ | コミット | 機能 | リファレンス |
|---|---|---|---|---|
CLAUDE.md |
プロジェクトおよびグローバル | ✓ | 毎セッション読み込まれる指示 | メモリ |
rules/*.md |
プロジェクトおよびグローバル | ✓ | トピックスコープの指示、オプションでパスゲート | ルール |
settings.json |
プロジェクトおよびグローバル | ✓ | パーミッション、hooks、環境変数、モデルデフォルト | 設定 |
settings.local.json |
プロジェクトのみ | 個人的なオーバーライド、自動 gitignore | 設定スコープ | |
.mcp.json |
プロジェクトのみ | ✓ | チーム共有 MCP サーバー | MCP スコープ |
.worktreeinclude |
プロジェクトのみ | ✓ | 新しい worktrees にコピーする gitignore ファイル | Worktrees |
skills/<name>/SKILL.md |
プロジェクトおよびグローバル | ✓ | /name で呼び出される、または自動呼び出される再利用可能なプロンプト |
Skills |
commands/*.md |
プロジェクトおよびグローバル | ✓ | シングルファイルプロンプト。skills と同じメカニズム | Skills |
output-styles/*.md |
プロジェクトおよびグローバル | ✓ | カスタムシステムプロンプトセクション | 出力スタイル |
agents/*.md |
プロジェクトおよびグローバル | ✓ | 独自のプロンプトとツールを持つ subagent 定義 | Subagents |
workflows/*.js |
プロジェクトおよびグローバル | ✓ | Claude によって書かれた動的ワークフロースクリプト、/workflows から保存。各ファイルは /<name> コマンドになります |
動的ワークフロー |
agent-memory/<name>/ |
プロジェクトおよびグローバル | ✓ | subagents の永続メモリ | 永続メモリ |
~/.claude.json |
グローバルのみ | アプリ状態、OAuth、UI トグル、個人 MCP サーバー | グローバル設定 | |
projects/<project>/memory/ |
グローバルのみ | Auto memory：Claude のセッション間のメモ | Auto memory | |
keybindings.json |
グローバルのみ | カスタムキーボードショートカット | キーバインディング | |
themes/*.json |
グローバルのみ | カスタムカラーテーマ | カスタムテーマ |
設定をトラブルシューティングする
設定、hook、またはファイルが有効になっていない場合は、設定をデバッグするを参照して、検査コマンドと症状優先ルックアップテーブルを確認してください。
アプリケーションデータ
作成する設定を超えて、~/.claude はセッション中に Claude Code が書き込むデータを保持します。これらのファイルはプレーンテキストです。ツールを通過するすべてのものはディスク上のトランスクリプトに記録されます。ファイルコンテンツ、コマンド出力、貼り付けられたテキスト。
自動的にクリーンアップされる
以下のパス内のファイルは、cleanupPeriodDays より古い場合、起動時に削除されます。デフォルトは 30 日です。
~/.claude/ の下のパス |
コンテンツ |
|---|---|
projects/<project>/<session>.jsonl |
完全な会話トランスクリプト：すべてのメッセージ、ツール呼び出し、ツール結果 |
projects/<project>/<session>/subagents/ |
Subagent 会話トランスクリプト。親セッショントランスクリプトが古くなると一緒に削除されます |
projects/<project>/<session>/tool-results/ |
大きなツール出力を別ファイルにこぼしたもの |
file-history/<session>/ |
Claude が変更したファイルの編集前スナップショット。チェックポイント復元に使用 |
plans/ |
プランモード中に書き込まれたプランファイル |
debug/ |
セッションごとのデバッグログ。--debug で開始するか /debug を実行した場合のみ書き込まれます |
paste-cache/、image-cache/ |
大きな貼り付けと添付画像のコンテンツ |
session-env/ |
セッションごとの環境メタデータ |
tasks/ |
タスクツールによって書き込まれたセッションごとのタスクリスト |
shell-snapshots/ |
Bash ツールによって使用されるキャプチャされたシェル環境。正常な終了時に削除されます。スイープはクラッシュ後に残されたものをクリアします。 |
backups/ |
設定マイグレーション前に取得された ~/.claude.json のタイムスタンプ付きコピー |
feedback-bundles/ |
/feedback によってサードパーティプロバイダーに書き込まれた編集済みトランスクリプトアーカイブ。Anthropic アカウントチームに送信するため |
todos/、statsig/、logs/ |
古いバージョンのレガシーディレクトリ。現在は書き込まれません。スイープはコンテンツを削除してから空のディレクトリを削除します。 |
削除するまで保持される
以下のパスは自動クリーンアップの対象ではなく、無期限に保持されます。
~/.claude/ の下のパス |
コンテンツ |
|---|---|
history.jsonl |
入力したすべてのプロンプト（タイムスタンプとプロジェクトパス付き）。上矢印リコール用に使用 |
stats-cache.json |
/usage で表示される集計トークンおよびコスト数 |
remote-settings.json |
組織のサーバー管理設定のキャッシュコピー。組織が設定を構成している場合のみ存在します。各起動時に更新されます。 |
その他の小さなキャッシュおよびロックファイルは、使用する機能に応じて表示され、削除しても安全です。
プレーンテキストストレージ
トランスクリプトと履歴は保存時に暗号化されません。OS ファイルパーミッションのみが保護です。ツールが .env ファイルを読み込むか、コマンドが認証情報を出力する場合、その値は projects/<project>/<session>.jsonl に書き込まれます。露出を減らすには：
cleanupPeriodDaysを低くしてトランスクリプトの保持期間を短縮しますCLAUDE_CODE_SKIP_PROMPT_HISTORY環境変数を設定して、任意のモードでトランスクリプトとプロンプト履歴の書き込みをスキップします。非対話型モードでは、代わりに-pと一緒に--no-session-persistenceを渡すか、Agent SDK でpersistSession: falseを設定できます。- パーミッションルールを使用して認証情報ファイルの読み込みを拒否します
ローカルデータをクリアする
claude project purge を実行して、1 つのプロジェクトに対して Claude Code が保持する状態を削除します。このコマンドには Claude Code v2.1.124 以降が必要です。以下を削除します：
projects/の下のトランスクリプトと自動メモリ- セッションごとの
tasks/、debug/、file-history/エントリ history.jsonlの一致するプロンプト行~/.claude.jsonのプロジェクトエントリ
このコマンドは完全な削除計画を出力し、何かを削除する前に確認を求めます。
削除せずに計画をプレビューします：
claude project purge ~/work/my-repo --dry-run
単一の確認プロンプトで削除します：
claude project purge ~/work/my-repo
パスを省略して、対話型リストからプロジェクトを選択します。
スクリプトで使用するために確認プロンプトをスキップします：
claude project purge ~/work/my-repo --yes
パスの代わりに --all を渡して、すべてのプロジェクトの状態を一度にパージします。これは history.jsonl をフィルタリングするのではなく完全に削除します。-i を渡して削除計画を一度に 1 つずつステップスルーします。
このコマンドは shell-snapshots/ と backups/ をそのままにしておきます。これらはプロジェクトスコープではないため、計画出力で警告します。指定されたパスに一致する状態がない場合、ステータス 1 で終了します。
上記のアプリケーションデータパスのいずれかを手動で削除することもできます。新しいセッションは影響を受けません。以下のテーブルは、過去のセッションで失うものを示しています。
| 削除 | 失うもの |
|---|---|
~/.claude/projects/ |
過去のセッションの再開、続行、巻き戻し |
~/.claude/history.jsonl |
上矢印プロンプトリコール |
~/.claude/file-history/ |
過去のセッションのチェックポイント復元 |
~/.claude/stats-cache.json |
/usage で表示される履歴合計 |
~/.claude/remote-settings.json |
なし。次の起動時に再取得されます。 |
~/.claude/debug/、~/.claude/plans/、~/.claude/paste-cache/、~/.claude/image-cache/、~/.claude/session-env/、~/.claude/tasks/、~/.claude/shell-snapshots/、~/.claude/backups/ |
ユーザー向けのもの |
~/.claude/todos/、~/.claude/statsig/、~/.claude/logs/ |
なし。現在のバージョンでは書き込まれないレガシーディレクトリ。 |
~/.claude.json、~/.claude/settings.json、または ~/.claude/plugins/ は削除しないでください。これらは認証、設定、インストール済みプラグインを保持しています。
関連リソース
- Claude のメモリを管理する：CLAUDE.md、rules、auto memory を書き込んで整理します
- 設定を構成する：パーミッション、hooks、環境変数、モデルデフォルトを設定します
- Skills を作成する：再利用可能なプロンプトとワークフローを構築します
- Subagents を構成する：独自のコンテキストを持つ特化したエージェントを定義します