Skip to main content
Claude Code は、プロジェクトディレクトリとホームディレクトリの ~/.claude から、指示、設定、skills、subagents、メモリを読み込みます。プロジェクトファイルを git にコミットしてチームと共有します。~/.claude 内のファイルは、すべてのプロジェクトに適用される個人設定です。 Windows では、~/.claude%USERPROFILE%\.claude に解決されます。CLAUDE_CONFIG_DIR を設定した場合、このページのすべての ~/.claude パスはそのディレクトリの下に存在します。 ほとんどのユーザーは CLAUDE.mdsettings.json のみを編集します。ディレクトリの残りはオプションです。必要に応じて skills、rules、または subagents を追加してください。

ディレクトリを探索する

ツリー内のファイルをクリックして、各ファイルの機能、読み込みタイミング、および例を確認してください。

表示されていないもの

エクスプローラーは、作成および編集するファイルをカバーしています。関連するいくつかのファイルは他の場所に存在します。 ~/.claude は、作業中に Claude Code が書き込むデータも保持します。トランスクリプト、プロンプト履歴、ファイルスナップショット、キャッシュ、ログです。以下のアプリケーションデータを参照してください。

適切なファイルを選択する

異なる種類のカスタマイズは異なるファイルに存在します。このテーブルを使用して、変更がどこに属するかを見つけてください。

ファイルリファレンス

このテーブルは、エクスプローラーがカバーするすべてのファイルをリストしています。プロジェクトスコープのファイルはリポジトリの .claude/ の下に存在します(CLAUDE.md.mcp.json.worktreeinclude はルートにあります)。グローバルスコープのファイルは ~/.claude/ に存在し、すべてのプロジェクトに適用されます。
これらのファイルに入れたものをオーバーライドできるいくつかのことがあります。
  • 組織によってデプロイされた管理設定はすべてに優先します
  • --permission-mode--settings などの CLI フラグはそのセッションの settings.json をオーバーライドします
  • 一部の環境変数は同等の設定に優先しますが、これは異なります。各設定について環境変数リファレンスを確認してください
完全な順序については設定の優先順位を参照してください。
ファイル名をクリックして、上記のエクスプローラーでそのノードを開きます。

設定をトラブルシューティングする

設定、hook、またはファイルが有効になっていない場合は、設定をデバッグするを参照して、検査コマンドと症状優先ルックアップテーブルを確認してください。

アプリケーションデータ

作成する設定を超えて、~/.claude はセッション中に Claude Code が書き込むデータを保持します。これらのファイルはプレーンテキストです。ツールを通過するすべてのものはディスク上のトランスクリプトに記録されます。ファイルコンテンツ、コマンド出力、貼り付けられたテキスト。

自動的にクリーンアップされる

以下のパス内のファイルは、cleanupPeriodDays より古い場合、起動時に削除されます。デフォルトは 30 日です。

削除するまで保持される

以下のパスは自動クリーンアップの対象ではなく、無期限に保持されます。 その他の小さなキャッシュおよびロックファイルは、使用する機能に応じて表示され、削除しても安全です。

プレーンテキストストレージ

トランスクリプトと履歴は保存時に暗号化されません。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 のプロジェクトエントリ
このコマンドは完全な削除計画を出力し、何かを削除する前に確認を求めます。 削除せずに計画をプレビューします:
単一の確認プロンプトで削除します:
パスを省略して、対話型リストからプロジェクトを選択します。 スクリプトで使用するために確認プロンプトをスキップします:
パスの代わりに --all を渡して、すべてのプロジェクトの状態を一度にパージします。これは history.jsonl をフィルタリングするのではなく完全に削除します。-i を渡して削除計画を一度に 1 つずつステップスルーします。 このコマンドは shell-snapshots/backups/ をそのままにしておきます。これらはプロジェクトスコープではないため、計画出力で警告します。指定されたパスに一致する状態がない場合、ステータス 1 で終了します。 上記のアプリケーションデータパスのいずれかを手動で削除することもできます。新しいセッションは影響を受けません。以下のテーブルは、過去のセッションで失うものを示しています。 ~/.claude.json~/.claude/settings.json、または ~/.claude/plugins/ は削除しないでください。これらは認証、設定、インストール済みプラグインを保持しています。