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

ディレクトリを探索する

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

表示されないもの

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

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

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

ファイルリファレンス

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

ファイル別フロントマターフィールド

スキル、コマンドファイル、サブエージェント、出力スタイル、およびルールは、ファイルの上部にある YAML フロントマターから設定を読み込み、それぞれが独自のフィールドセットを受け入れます。このテーブルは、各ファイルのフィールド名をリストアップし、それらを説明するリファレンスへのリンクを提供します。 プラグインに含まれるエージェントは、サブエージェントフィールドのサブセットに対応しています。

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

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

アプリケーションデータ

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

自動的にクリーンアップされるファイル

Claude Code は、cleanupPeriodDays より古いファイルを以下のパスから削除します。ただし、保持期間を安全に判定できる場合に限ります。デフォルトは 30 日で、最小値は 1 です。0 に設定するとバリデーションエラーが発生します。同じ経過日数の閾値が、孤立した worktrees の自動削除にも適用されます。 sessions/ のセッションファイル、自動メモリ、Claude Desktop および Cowork トランスクリプトは、それぞれ独自の保持ルールに従います:
  • sessions/:実行中の各セッションに 1 つの小さいファイルを保持します。同時実行セッションとクラッシュを検出するために使用されます。年齢ベースのスイープの一部ではありません。Claude Code は、セッションが終了するときに各ファイルを削除し、次の起動時にクラッシュの残りをクリアします。
  • 自動メモリ:スイープは、プロジェクトの自動メモリディレクトリ projects/<project>/memory/ 内のメモリファイルを削除しません。Claude Code は、保持期間全体が空だった場合にのみそのディレクトリを削除します。v2.1.228 より前では、スイープはメモリディレクトリ内のフォルダをセッションデータとして扱い、その下の古いファイルを削除できました。
  • Claude Desktop および Cowork トランスクリプト:Claude Code は、Claude Desktop または Cowork で開始または最後に続行したセッションのトランスクリプトを任意の年齢で保持します。これらのトランスクリプトに年齢制限を与えるには、desktopSessionCleanupPeriodDaysを設定します。管理設定が cleanupPeriodDays を設定する場合、Claude Code はその期間の後にこれらのトランスクリプトを削除します。Claude Code v2.1.248 以降が必要です。それより前のバージョンでは、cleanupPeriodDays の後に削除します。
Claude Code は、以下の場合に年齢ベースのスイープをスキップします:
  • ベアモード:--bareで claude -p を実行する場合、Claude Code はそのセッションでスイープを実行しません。
  • 一時停止されたスイープ:Claude Code が保持期間を安全に判定できない場合、保持クリーンアップスイープを一時停止します。retention_sweep イベントは、それを一時停止する各設定をリストします。原因が読み込みまたは解析できない設定ファイル、または cleanupPeriodDays または desktopSessionCleanupPeriodDays が明示的に設定された設定エラーの場合、Claude Code は設定エラーを修正するまで /status に警告も表示します。管理設定が cleanupPeriodDays を提供する場合、Claude Code はどちらの場合でも管理値でスイープを実行します。

セッションスクラッチパッドディレクトリ

スクラッチパッドは、Claude Code が Claude に一時ファイル用に提供するセッションごとのディレクトリです。中間結果、ヘルパースクリプト、プロジェクトに属さないドラフトです。Claude が「スクラッチパッドに保存した」と言う場合、ファイルはそこにあります。Claude は /tmp の代わりにそれを使用し、権限プロンプトなしでそれ内のファイルを作成、編集、読み取ることができます。 スクラッチパッドは ~/.claude ではなく Claude Code の一時ディレクトリの下に存在します。プラットフォームの現在のセッションのパスを見つけます:
  • macOS:/private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/
  • Linux:/tmp/claude-<uid>/<project>/<session-id>/scratchpad/、またはシステムが設定する場合は $TMPDIR の下の同じ形状
  • Windows:%TEMP%\claude\<project>\<session-id>\scratchpad\
<project> は、文字と数字以外のすべての文字が - に置き換えられた作業ディレクトリパスです。例えば、-Users-you-my-project。CLAUDE_CODE_TMPDIRを設定する場合、ツリーはそのディレクトリの下に移動します。フックは現在のセッションのパスを scratchpad_dirとして受け取ります。 スクラッチパッドファイルはセッションのトランスクリプトと同じ期間続きます。保持スイープはトランスクリプトを削除するときにディレクトリを削除し、claude project purgeは一時ディレクトリに触れません。ディレクトリはシステムの一時場所の下にあるため、オペレーティングシステムもそれをクリアできます。例えば、再起動時。Claude がそこに書き込んだものを保持するには、Claude にそれをプロジェクトに移動するよう依頼します。 セッションがスクラッチパッドを持つのは、以下のすべてが成り立つ場合のみです:
  • API キーではなく claude.ai アカウントでサインインしている
  • セッションが Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry ではなく Anthropic API を使用している
  • enableArtifactが false に設定されていない

削除するまで保持されるファイル

保持クリーンアップスイープは以下のパスを削除しません。Claude Code はそれらを削除するまで保持します。ただし、ログアウト時に削除する 2 つのキャッシュは除きます。 使用する機能に応じて、他のファイルが表示されます。キャッシュとロックファイルは削除しても安全です。これらの状態ファイルを保持します:

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

トランスクリプトと履歴は保存時に暗号化されません。OS ファイル権限が唯一の保護です。ツールが .env ファイルを読み込むか、コマンドが認証情報を出力する場合、その値は projects/<project>/<session>.jsonl に書き込まれます。露出を減らすには:
  • cleanupPeriodDays を低くして、Claude Code がトランスクリプトを保持する期間を短縮します
  • desktopSessionCleanupPeriodDaysを設定して、Claude Desktop および Cowork トランスクリプトにも年齢制限を与えます
  • CLAUDE_CODE_SKIP_PROMPT_HISTORY環境変数を設定して、任意のモードでトランスクリプトとプロンプト履歴の書き込みをスキップします。非対話モードでは、代わりに -p と一緒に --no-session-persistence を渡すか、TypeScript Agent SDK で persistSession: false を設定できます。Python SDK には同等のオプションがありません。
  • 権限ルールを使用して、認証情報ファイルの読み取りを拒否します

ローカルデータをクリアする

claude project purge を実行して、1 つのプロジェクトに対して Claude Code が保持する状態を削除します。削除されるもの:
  • projects/ の下のトランスクリプトと自動メモリ
  • セッションごとの tasks/、debug/、file-history/ エントリ
  • history.jsonl の一致するプロンプト行
  • ~/.claude.json のプロジェクトエントリ
プロジェクトのセッションで貼り付けた、または添付した画像、および各セッションのスクラッチパッドは、~/.claude ではなく Claude Code の一時ディレクトリの下に保存されるため、パージは削除しません。保持スイープは、cleanupPeriodDays より古くなると画像を削除します。パージされたセッションのスクラッチパッドは、削除するか、オペレーティングシステムが一時ディレクトリをクリアするまで残ります。 コマンドは完全な削除計画を出力し、何かを削除する前に確認を求めます。 以下の例では、~/work/my-repo をプレースホルダーとして使用します。プロジェクトへのパスに置き換えます。パスに一致する状態がない場合、コマンドはエラーを出力し、ステータス 1 で終了します。 削除せずに計画をプレビューします:
計画は各一致するアイテムと、それが含まれる理由をリストします:
単一の確認プロンプトで削除します:
コマンドは同じ計画を出力してから、Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N] と尋ね、y と答えた場合のみ削除します。 パスを省略して、対話的なリストからプロジェクトを選択します。 スクリプトで使用するために確認プロンプトをスキップします:
パスの代わりに --all を渡して、すべてのプロジェクトの状態を一度にパージします。これは history.jsonl をフィルタリングするのではなく、完全に削除します。-i を渡して、削除計画を 1 つずつステップスルーします。 コマンドは shell-snapshots/ と backups/ をそのままにしておきます。これらはプロジェクトスコープではないため、計画出力で警告します。 保持するべき状態ファイルを除き、上記のアプリケーションデータパスのいずれかを手動で削除することもできます。新しいセッションは影響を受けません。以下の表は、過去のセッションで失うものを示しています。 ~/.claude.json、~/.claude/settings.json、~/.claude/plugins/ は削除しないでください。これらは認証、設定、インストール済みプラグインを保持しています。