8 8
9Claude Code は、プロジェクトディレクトリとホームディレクトリの `~/.claude` から、指示、設定、skills、subagents、メモリを読み込みます。プロジェクトファイルを git にコミットしてチームと共有します。`~/.claude` 内のファイルは、すべてのプロジェクトに適用される個人設定です。9Claude Code は、プロジェクトディレクトリとホームディレクトリの `~/.claude` から、指示、設定、skills、subagents、メモリを読み込みます。プロジェクトファイルを git にコミットしてチームと共有します。`~/.claude` 内のファイルは、すべてのプロジェクトに適用される個人設定です。
10 10
11Windows では、`~/.claude` は `%USERPROFILE%\.claude` に解決されます。[`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars) を設定した場合、このページのすべての `~/.claude` パスはそのディレクトリの下に存在します。11Windows では、`~/.claude` は `%USERPROFILE%\.claude` に解決されます。[`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) を設定した場合、このページのすべての `~/.claude` パスはそのディレクトリの下に存在します。
12 12
13ほとんどのユーザーは `CLAUDE.md` と `settings.json` のみを編集します。リポジトリに他のコーディングエージェント用の `AGENTS.md` が既にある場合、Claude Code は `CLAUDE.md` の代わりに[それを読み込むことができます](/docs/ja/memory.md#agents-md)。ディレクトリの残りはオプションです。必要に応じてスキル、ルール、またはサブエージェントを追加してください。13ほとんどのユーザーは `CLAUDE.md` と `settings.json` のみを編集します。リポジトリに他のコーディングエージェント用の `AGENTS.md` が既にある場合、Claude Code は `CLAUDE.md` の代わりに[それを読み込むことができます](https://code.claude.com/docs/ja/memory.md#agents-md)。ディレクトリの残りはオプションです。必要に応じてスキル、ルール、またはサブエージェントを追加してください。
14 14
15## ディレクトリを探索する15## ディレクトリを探索する
16 16
22 22
23| ファイル | 場所 | 目的 |23| ファイル | 場所 | 目的 |
24| - | - | - |24| - | - | - |
25| `managed-settings.json` | システムレベル、OS によって異なる | エンタープライズが強制する設定で、[限定的な例外](/docs/ja/settings.md#exceptions-to-managed-settings-precedence)を除き、自身の設定ファイルや `--settings` の値で上書きすることはできません。[ファイルの保存場所](/docs/ja/managed-settings.md#deploy-a-managed-settings-file)と [Claude Code が使用する管理ソース](/docs/ja/managed-settings.md#precedence-within-the-managed-tier)を参照してください。 |25| `managed-settings.json` | システムレベル、OS によって異なる | エンタープライズが強制する設定で、[限定的な例外](https://code.claude.com/docs/ja/settings.md#exceptions-to-managed-settings-precedence)を除き、自身の設定ファイルや `--settings` の値で上書きすることはできません。[ファイルの保存場所](https://code.claude.com/docs/ja/managed-settings.md#deploy-a-managed-settings-file)と [Claude Code が使用する管理ソース](https://code.claude.com/docs/ja/managed-settings.md#precedence-within-the-managed-tier)を参照してください。 |
26| `CLAUDE.local.md` | プロジェクトルート | このプロジェクトの個人的な設定で、CLAUDE.md と一緒に読み込まれます。手動で作成し、`.gitignore` に追加してください。 |26| `CLAUDE.local.md` | プロジェクトルート | このプロジェクトの個人的な設定で、CLAUDE.md と一緒に読み込まれます。手動で作成し、`.gitignore` に追加してください。 |
27| `AGENTS.md` | プロジェクトルート、`.claude/`、または任意のディレクトリ | AI コーディングエージェント向けに作成するプロジェクト指示。Claude Code は `CLAUDE.md` の代わりに[これを読み込む](/docs/ja/memory.md#agents-md)ことができます。 |27| `AGENTS.md` | プロジェクトルート、`.claude/`、または任意のディレクトリ | AI コーディングエージェント向けに作成するプロジェクト指示。Claude Code は `CLAUDE.md` の代わりに[これを読み込む](https://code.claude.com/docs/ja/memory.md#agents-md)ことができます。 |
28| インストール済みプラグイン | `~/.claude/plugins` | クローンされたマーケットプレイス、インストール済みプラグインバージョン、`installed_plugins.json` インストール記録、およびプラグインごとのデータで、`claude plugin` コマンドで管理されます。[claude.ai アカウントから同期された](/docs/ja/plugins/loading.md#synced-plugins)プラグインは `~/.claude/plugins/synced/` にダウンロードされます。リンクモードでマーケットプレイス [`command` ソース](/docs/ja/plugins/marketplace-reference#command-plugin-source)からインストールされたプラグインの場合、Claude Code はコピーの代わりにここにリンクを保存し、プラグインのファイルはコマンドが出力するディレクトリに留まります。`command` ソースには Claude Code v2.1.229 以降が必要です。ローカルパスから追加したマーケットプレイスで相対パスによってリストされているプラグインも、キャッシュコピーではなく、ソースディレクトリから[その場で読み込まれます](/docs/ja/plugins/loading.md#find-plugins-on-disk)。[プラグインキャッシング](/docs/ja/plugins/loading.md#find-plugins-on-disk)を参照して、孤立したバージョンがどのようにクリーンアップされるかを確認してください。 |28| インストール済みプラグイン | `~/.claude/plugins` | クローンされたマーケットプレイス、インストール済みプラグインバージョン、`installed_plugins.json` インストール記録、およびプラグインごとのデータで、`claude plugin` コマンドで管理されます。[claude.ai アカウントから同期された](https://code.claude.com/docs/ja/plugins/loading.md#synced-plugins)プラグインは `~/.claude/plugins/synced/` にダウンロードされます。リンクモードでマーケットプレイス [`command` ソース](https://code.claude.com/docs/ja/plugins/marketplace-reference#command-plugin-source)からインストールされたプラグインの場合、Claude Code はコピーの代わりにここにリンクを保存し、プラグインのファイルはコマンドが出力するディレクトリに留まります。`command` ソースには Claude Code v2.1.229 以降が必要です。ローカルパスから追加したマーケットプレイスで相対パスによってリストされているプラグインも、キャッシュコピーではなく、ソースディレクトリから[その場で読み込まれます](https://code.claude.com/docs/ja/plugins/loading.md#find-plugins-on-disk)。[プラグインキャッシング](https://code.claude.com/docs/ja/plugins/loading.md#find-plugins-on-disk)を参照して、孤立したバージョンがどのようにクリーンアップされるかを確認してください。 |
29 29
30`~/.claude` はまた、Claude Code があなたが作業する際に書き込むデータも保持しています。トランスクリプト、プロンプト履歴、ファイルスナップショット、キャッシュ、およびログです。下記の[アプリケーションデータ](#application-data)を参照してください。30`~/.claude` はまた、Claude Code があなたが作業する際に書き込むデータも保持しています。トランスクリプト、プロンプト履歴、ファイルスナップショット、キャッシュ、およびログです。下記の[アプリケーションデータ](#application-data)を参照してください。
31 31
35 35
36| 実行したいこと | 編集 | スコープ | リファレンス |36| 実行したいこと | 編集 | スコープ | リファレンス |
37| :- | :- | :- | :- |37| :- | :- | :- | :- |
38| Claude にプロジェクトコンテキストと規約を提供する | `CLAUDE.md` | プロジェクトまたはグローバル | [メモリ](/docs/ja/memory.md) |38| Claude にプロジェクトコンテキストと規約を提供する | `CLAUDE.md` | プロジェクトまたはグローバル | [メモリ](https://code.claude.com/docs/ja/memory.md) |
39| 特定のツール呼び出しを許可またはブロックする | `settings.json` `permissions` または `hooks` | プロジェクトまたはグローバル | [パーミッション](/docs/ja/permissions.md)、[Hooks](/docs/ja/hooks.md) |39| 特定のツール呼び出しを許可またはブロックする | `settings.json` `permissions` または `hooks` | プロジェクトまたはグローバル | [パーミッション](https://code.claude.com/docs/ja/permissions.md)、[Hooks](https://code.claude.com/docs/ja/hooks.md) |
40| ツール呼び出しの前後にスクリプトを実行する | `settings.json` `hooks` | プロジェクトまたはグローバル | [Hooks](/docs/ja/hooks.md) |40| ツール呼び出しの前後にスクリプトを実行する | `settings.json` `hooks` | プロジェクトまたはグローバル | [Hooks](https://code.claude.com/docs/ja/hooks.md) |
41| セッションの環境変数を設定する | `settings.json` `env` | プロジェクトまたはグローバル | [設定](/docs/ja/settings-reference.md#all-settings) |41| セッションの環境変数を設定する | `settings.json` `env` | プロジェクトまたはグローバル | [設定](https://code.claude.com/docs/ja/settings-reference.md#all-settings) |
42| 個人的なオーバーライドを git から除外する | `settings.local.json` | プロジェクトのみ | [設定スコープ](/docs/ja/settings.md#where-settings-live) |42| 個人的なオーバーライドを git から除外する | `settings.local.json` | プロジェクトのみ | [設定スコープ](https://code.claude.com/docs/ja/settings.md#where-settings-live) |
43| `/name` で呼び出すプロンプトまたは機能を追加する | `skills/<name>/SKILL.md` | プロジェクトまたはグローバル | [Skills](/docs/ja/skills.md) |43| `/name` で呼び出すプロンプトまたは機能を追加する | `skills/<name>/SKILL.md` | プロジェクトまたはグローバル | [Skills](https://code.claude.com/docs/ja/skills.md) |
44| 独自のツールを持つ特化した subagent を定義する | `agents/*.md` | プロジェクトまたはグローバル | [Subagents](/docs/ja/sub-agents.md) |44| 独自のツールを持つ特化した subagent を定義する | `agents/*.md` | プロジェクトまたはグローバル | [Subagents](https://code.claude.com/docs/ja/sub-agents.md) |
45| スクリプトから多くの subagent をオーケストレーションする | `workflows/*.js` | プロジェクトまたはグローバル | [動的ワークフロー](/docs/ja/workflows.md) |45| スクリプトから多くの subagent をオーケストレーションする | `workflows/*.js` | プロジェクトまたはグローバル | [動的ワークフロー](https://code.claude.com/docs/ja/workflows.md) |
46| MCP 経由で外部ツールを接続する | `.mcp.json` | プロジェクトのみ | [MCP](/docs/ja/mcp.md) |46| MCP 経由で外部ツールを接続する | `.mcp.json` | プロジェクトのみ | [MCP](https://code.claude.com/docs/ja/mcp.md) |
47| Claude がレスポンスをフォーマットする方法を変更する | `output-styles/*.md` | プロジェクトまたはグローバル | [出力スタイル](/docs/ja/output-styles.md) |47| Claude がレスポンスをフォーマットする方法を変更する | `output-styles/*.md` | プロジェクトまたはグローバル | [出力スタイル](https://code.claude.com/docs/ja/output-styles.md) |
48 48
49## ファイルリファレンス49## ファイルリファレンス
50 50
54>54>
55> これらのファイルに入れたものをオーバーライドできるいくつかのことがあります。55> これらのファイルに入れたものをオーバーライドできるいくつかのことがあります。
56>56>
57> * 組織によってデプロイされた[管理設定](/docs/ja/server-managed-settings.md)は、[設定の優先順位における例外](/docs/ja/settings.md#exceptions-to-managed-settings-precedence)を除き、すべての設定ファイルおよび `--settings` の値に優先します57> * 組織によってデプロイされた[管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)は、[設定の優先順位における例外](https://code.claude.com/docs/ja/settings.md#exceptions-to-managed-settings-precedence)を除き、すべての設定ファイルおよび `--settings` の値に優先します
58> * `--permission-mode` や `--settings` などの CLI フラグはそのセッションの `settings.json` をオーバーライドします58> * `--permission-mode` や `--settings` などの CLI フラグはそのセッションの `settings.json` をオーバーライドします
59> * 一部の環境変数は同等の設定に優先しますが、これは異なります。各設定について[環境変数リファレンス](/docs/ja/env-vars.md)を確認してください59> * 一部の環境変数は同等の設定に優先しますが、これは異なります。各設定について[環境変数リファレンス](https://code.claude.com/docs/ja/env-vars.md)を確認してください
60>60>
61> 完全な順序については[設定の優先順位](/docs/ja/settings.md#settings-precedence)を参照してください。61> 完全な順序については[設定の優先順位](https://code.claude.com/docs/ja/settings.md#settings-precedence)を参照してください。
62 62
63ファイル名をクリックして、上記のエクスプローラーでそのノードを開きます。63ファイル名をクリックして、上記のエクスプローラーでそのノードを開きます。
64 64
65| ファイル | スコープ | コミット | 機能 | リファレンス |65| ファイル | スコープ | コミット | 機能 | リファレンス |
66| - | - | - | - | - |66| - | - | - | - | - |
67| [`CLAUDE.md`](#ce-claude-md) | プロジェクトおよびグローバル | ✓ | 毎セッション読み込まれる指示 | [メモリ](/docs/ja/memory.md) |67| [`CLAUDE.md`](#ce-claude-md) | プロジェクトおよびグローバル | ✓ | 毎セッション読み込まれる指示 | [メモリ](https://code.claude.com/docs/ja/memory.md) |
68| [`rules/*.md`](#ce-rules) | プロジェクトおよびグローバル | ✓ | トピックスコープの指示、オプションでパスゲート | [ルール](/docs/ja/memory.md#organize-rules-with-claude/rules/) |68| [`rules/*.md`](#ce-rules) | プロジェクトおよびグローバル | ✓ | トピックスコープの指示、オプションでパスゲート | [ルール](https://code.claude.com/docs/ja/memory.md#organize-rules-with-claude/rules/) |
69| [`settings.json`](#ce-settings-json) | プロジェクトおよびグローバル | ✓ | 権限、hooks、環境変数、モデルデフォルト | [設定](/docs/ja/settings.md) |69| [`settings.json`](#ce-settings-json) | プロジェクトおよびグローバル | ✓ | 権限、hooks、環境変数、モデルデフォルト | [設定](https://code.claude.com/docs/ja/settings.md) |
70| [`settings.local.json`](#ce-settings-local-json) | プロジェクトのみ | | 個人的なオーバーライド、Claude Code が設定を保存するときに gitignore | [設定スコープ](/docs/ja/settings.md#where-settings-live) |70| [`settings.local.json`](#ce-settings-local-json) | プロジェクトのみ | | 個人的なオーバーライド、Claude Code が設定を保存するときに gitignore | [設定スコープ](https://code.claude.com/docs/ja/settings.md#where-settings-live) |
71| [`.mcp.json`](#ce-mcp-json) | プロジェクトのみ | ✓ | チーム共有 MCP サーバー | [MCP スコープ](/docs/ja/mcp.md#mcp-installation-scopes) |71| [`.mcp.json`](#ce-mcp-json) | プロジェクトのみ | ✓ | チーム共有 MCP サーバー | [MCP スコープ](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes) |
72| [`.worktreeinclude`](#ce-worktreeinclude) | プロジェクトのみ | ✓ | 新しい worktrees にコピーする gitignore ファイル | [Worktrees](/docs/ja/worktrees.md#copy-gitignored-files-into-worktrees) |72| [`.worktreeinclude`](#ce-worktreeinclude) | プロジェクトのみ | ✓ | 新しい worktrees にコピーする gitignore ファイル | [Worktrees](https://code.claude.com/docs/ja/worktrees.md#copy-gitignored-files-into-worktrees) |
73| [`skills/<name>/SKILL.md`](#ce-skills) | プロジェクトおよびグローバル | ✓ | `/name` で呼び出される、または自動呼び出される再利用可能なプロンプト | [Skills](/docs/ja/skills.md) |73| [`skills/<name>/SKILL.md`](#ce-skills) | プロジェクトおよびグローバル | ✓ | `/name` で呼び出される、または自動呼び出される再利用可能なプロンプト | [Skills](https://code.claude.com/docs/ja/skills.md) |
74| [`commands/*.md`](#ce-commands) | プロジェクトおよびグローバル | ✓ | シングルファイルプロンプト。skills と同じメカニズム | [Skills](/docs/ja/skills.md) |74| [`commands/*.md`](#ce-commands) | プロジェクトおよびグローバル | ✓ | シングルファイルプロンプト。skills と同じメカニズム | [Skills](https://code.claude.com/docs/ja/skills.md) |
75| [`output-styles/*.md`](#ce-output-styles) | プロジェクトおよびグローバル | ✓ | Claude の動作方法を調整するカスタム指示セット | [出力スタイル](/docs/ja/output-styles.md) |75| [`output-styles/*.md`](#ce-output-styles) | プロジェクトおよびグローバル | ✓ | Claude の動作方法を調整するカスタム指示セット | [出力スタイル](https://code.claude.com/docs/ja/output-styles.md) |
76| [`agents/*.md`](#ce-agents) | プロジェクトおよびグローバル | ✓ | 独自のプロンプトとツールを持つ subagent 定義 | [Subagents](/docs/ja/sub-agents.md) |76| [`agents/*.md`](#ce-agents) | プロジェクトおよびグローバル | ✓ | 独自のプロンプトとツールを持つ subagent 定義 | [Subagents](https://code.claude.com/docs/ja/sub-agents.md) |
77| [`workflows/*.js`](#ce-workflows) | プロジェクトおよびグローバル | ✓ | Claude によって書かれた動的ワークフロースクリプト、`/workflows` から保存。各ファイルは `/<name>` コマンドになります | [動的ワークフロー](/docs/ja/workflows.md) |77| [`workflows/*.js`](#ce-workflows) | プロジェクトおよびグローバル | ✓ | Claude によって書かれた動的ワークフロースクリプト、`/workflows` から保存。各ファイルは `/<name>` コマンドになります | [動的ワークフロー](https://code.claude.com/docs/ja/workflows.md) |
78| [`agent-memory/<name>/`](#ce-agent-memory) | プロジェクトおよびグローバル | ✓ | subagents の永続メモリ | [永続メモリ](/docs/ja/sub-agents.md#enable-persistent-memory) |78| [`agent-memory/<name>/`](#ce-agent-memory) | プロジェクトおよびグローバル | ✓ | subagents の永続メモリ | [永続メモリ](https://code.claude.com/docs/ja/sub-agents.md#enable-persistent-memory) |
79| [`~/.claude.json`](#ce-claude-json) | グローバルのみ | | アプリ状態、アカウント詳細、UI トグル、個人 MCP サーバー | [グローバル設定](/docs/ja/settings-reference.md#global-config-settings) |79| [`~/.claude.json`](#ce-claude-json) | グローバルのみ | | アプリ状態、アカウント詳細、UI トグル、個人 MCP サーバー | [グローバル設定](https://code.claude.com/docs/ja/settings-reference.md#global-config-settings) |
80| [`projects/<project>/memory/`](#ce-global-projects) | グローバルのみ | | Auto memory:Claude のセッション間のメモ | [Auto memory](/docs/ja/memory.md#auto-memory) |80| [`projects/<project>/memory/`](#ce-global-projects) | グローバルのみ | | Auto memory:Claude のセッション間のメモ | [Auto memory](https://code.claude.com/docs/ja/memory.md#auto-memory) |
81| [`keybindings.json`](#ce-keybindings) | グローバルのみ | | カスタムキーボードショートカット | [キーバインディング](/docs/ja/keybindings.md) |81| [`keybindings.json`](#ce-keybindings) | グローバルのみ | | カスタムキーボードショートカット | [キーバインディング](https://code.claude.com/docs/ja/keybindings.md) |
82| [`themes/*.json`](#ce-themes) | グローバルのみ | | カスタムカラーテーマ | [カスタムテーマ](/docs/ja/terminal-config.md#create-a-custom-theme) |82| [`themes/*.json`](#ce-themes) | グローバルのみ | | カスタムカラーテーマ | [カスタムテーマ](https://code.claude.com/docs/ja/terminal-config.md#create-a-custom-theme) |
83 83
84## ファイル別フロントマターフィールド84## ファイル別フロントマターフィールド
85 85
86スキル、コマンドファイル、サブエージェント、出力スタイル、およびルールは、ファイルの上部にある YAML [フロントマター](/docs/ja/glossary.md#frontmatter)から設定を読み込み、それぞれが独自のフィールドセットを受け入れます。このテーブルは、各ファイルのフィールド名をリストアップし、それらを説明するリファレンスへのリンクを提供します。86スキル、コマンドファイル、サブエージェント、出力スタイル、およびルールは、ファイルの上部にある YAML [フロントマター](https://code.claude.com/docs/ja/glossary.md#frontmatter)から設定を読み込み、それぞれが独自のフィールドセットを受け入れます。このテーブルは、各ファイルのフィールド名をリストアップし、それらを説明するリファレンスへのリンクを提供します。
87 87
88| ファイル | フロントマターフィールド | リファレンス |88| ファイル | フロントマターフィールド | リファレンス |
89| - | - | - |89| - | - | - |
90| `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`, `compatibility` | [スキルフロントマター](/docs/ja/skills.md#frontmatter-reference) |90| `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`, `compatibility` | [スキルフロントマター](https://code.claude.com/docs/ja/skills.md#frontmatter-reference) |
91| `commands/*.md` | `name` と `paths` を除くスキルフィールド | [スキルフロントマター](/docs/ja/skills.md#frontmatter-reference) |91| `commands/*.md` | `name` と `paths` を除くスキルフィールド | [スキルフロントマター](https://code.claude.com/docs/ja/skills.md#frontmatter-reference) |
92| `agents/*.md` | `name`, `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `maxTurns`, `autoCompactWindow`, `skills`, `mcpServers`, `hooks`, `memory`, `background`, `effort`, `isolation`, `color`, `initialPrompt`, `omitClaudeMd`, `experimental` | [サブエージェントフロントマター](/docs/ja/sub-agents.md#supported-frontmatter-fields) |92| `agents/*.md` | `name`, `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `maxTurns`, `autoCompactWindow`, `skills`, `mcpServers`, `hooks`, `memory`, `background`, `effort`, `isolation`, `color`, `initialPrompt`, `omitClaudeMd`, `experimental` | [サブエージェントフロントマター](https://code.claude.com/docs/ja/sub-agents.md#supported-frontmatter-fields) |
93| `output-styles/*.md` | `name`, `description`, `keep-coding-instructions`, `force-for-plugin` | [出力スタイルフロントマター](/docs/ja/output-styles.md#frontmatter) |93| `output-styles/*.md` | `name`, `description`, `keep-coding-instructions`, `force-for-plugin` | [出力スタイルフロントマター](https://code.claude.com/docs/ja/output-styles.md#frontmatter) |
94| `rules/*.md` | `paths` | [ルールフロントマター](/docs/ja/memory.md#rules-frontmatter-reference) |94| `rules/*.md` | `paths` | [ルールフロントマター](https://code.claude.com/docs/ja/memory.md#rules-frontmatter-reference) |
95 95
96[プラグイン](/docs/ja/plugins/components.md#agents)に含まれるエージェントは、サブエージェントフィールドのサブセットに対応しています。96[プラグイン](https://code.claude.com/docs/ja/plugins/components.md#agents)に含まれるエージェントは、サブエージェントフィールドのサブセットに対応しています。
97 97
98## 設定をトラブルシューティングする98## 設定をトラブルシューティングする
99 99
100設定、hook、またはファイルが有効になっていない場合は、[設定をデバッグする](/docs/ja/debug-your-config.md)を参照して、検査コマンドと症状優先ルックアップテーブルを確認してください。100設定、hook、またはファイルが有効になっていない場合は、[設定をデバッグする](https://code.claude.com/docs/ja/debug-your-config.md)を参照して、検査コマンドと症状優先ルックアップテーブルを確認してください。
101 101
102## アプリケーションデータ102## アプリケーションデータ
103 103
105 105
106### 自動的にクリーンアップされるファイル106### 自動的にクリーンアップされるファイル
107 107
108Claude Code は、[`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) より古いファイルを以下のパスから削除します。ただし、保持期間を安全に判定できる場合に限ります。デフォルトは 30 日で、最小値は 1 です。`0` に設定するとバリデーションエラーが発生します。同じ経過日数の閾値が、[孤立した worktrees の自動削除](/docs/ja/worktrees.md#clean-up-subagent-and-background-session-worktrees)にも適用されます。108Claude Code は、[`cleanupPeriodDays`](https://code.claude.com/docs/ja/settings-reference#cleanupperioddays) より古いファイルを以下のパスから削除します。ただし、保持期間を安全に判定できる場合に限ります。デフォルトは 30 日で、最小値は 1 です。`0` に設定するとバリデーションエラーが発生します。同じ経過日数の閾値が、[孤立した worktrees の自動削除](https://code.claude.com/docs/ja/worktrees.md#clean-up-subagent-and-background-session-worktrees)にも適用されます。
109 109
110| `~/.claude/` 下のパス | 内容 |110| `~/.claude/` 下のパス | 内容 |
111| - | - |111| - | - |
112| `projects/<project>/<session>.jsonl` | 完全な会話トランスクリプト:すべてのメッセージ、ツール呼び出し、ツール結果 |112| `projects/<project>/<session>.jsonl` | 完全な会話トランスクリプト:すべてのメッセージ、ツール呼び出し、ツール結果 |
113| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`、`projects/<project>/<session>.jsonl.superseded-<timestamp>` | Claude Code が上書きまたは削除する代わりに脇に置いたセッションの前のトランスクリプト。セッションピッカーには表示されません |113| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`、`projects/<project>/<session>.jsonl.superseded-<timestamp>` | Claude Code が上書きまたは削除する代わりに脇に置いたセッションの前のトランスクリプト。セッションピッカーには表示されません |
114| `projects/<project>/<session>/subagents/` | [サブエージェント](/docs/ja/sub-agents.md)の会話トランスクリプト。親セッションのトランスクリプトが経過時間で削除されるときに削除されます |114| `projects/<project>/<session>/subagents/` | [サブエージェント](https://code.claude.com/docs/ja/sub-agents.md)の会話トランスクリプト。親セッションのトランスクリプトが経過時間で削除されるときに削除されます |
115| `projects/<project>/<session>/tool-results/` | 別ファイルにこぼれた大きなツール出力、および [MCP ツールが返す画像](/docs/ja/mcp.md#images-in-tool-results)のフルサイズコピー |115| `projects/<project>/<session>/tool-results/` | 別ファイルにこぼれた大きなツール出力、および [MCP ツールが返す画像](https://code.claude.com/docs/ja/mcp.md#images-in-tool-results)のフルサイズコピー |
116| `file-history/<session>/` | Claude が変更したファイルの編集前スナップショット。[チェックポイント復元](/docs/ja/checkpointing.md)に使用されます。最新 100 個のチェックポイントのスナップショットを保持します。保持されたチェックポイントが参照していないスナップショットファイルは削除されます。ただし、各ファイルの最初のスナップショットは除きます |116| `projects/<project>/<session>/mcp-tasks/` | 再開したセッションが実行中の [MCP タスク](https://code.claude.com/docs/ja/mcp.md#mcp-tasks-that-run-on-the-server)を再び追跡するために必要な情報、および Claude がまだ読み取っていない完了済みタスクの結果 |
117| `plans/` | [プランモード](/docs/ja/permission-modes.md#analyze-before-you-edit-with-plan-mode)中に書き込まれたプランファイル |117| `file-history/<session>/` | Claude が変更したファイルの編集前スナップショット。[チェックポイント復元](https://code.claude.com/docs/ja/checkpointing.md)に使用されます。最新 100 個のチェックポイントのスナップショットを保持します。保持されたチェックポイントが参照していないスナップショットファイルは削除されます。ただし、各ファイルの最初のスナップショットは除きます |
118| `debug/` | セッションごとのデバッグログ。デバッグログが有効な場合に書き込まれます。例えば、[`--debug`](/docs/ja/cli-reference#cli-flags)で起動した場合や `/debug` を実行した場合 |118| `plans/` | [プランモード](https://code.claude.com/docs/ja/permission-modes.md#analyze-before-you-edit-with-plan-mode)中に書き込まれたプランファイル |
119| `debug/` | セッションごとのデバッグログ。デバッグログが有効な場合に書き込まれます。例えば、[`--debug`](https://code.claude.com/docs/ja/cli-reference#cli-flags)で起動した場合や `/debug` を実行した場合 |
119| `paste-cache/` | 大きな貼り付けの内容 |120| `paste-cache/` | 大きな貼り付けの内容 |
120| `image-cache/<session>/` | Claude Code v2.1.274 以前で保存された添付画像。それ以降のバージョンでは、貼り付けた画像と添付画像は `~/.claude` の外に保存されます。[`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars)が制御する一時ディレクトリの下の各セッションの `images/` ディレクトリに保存されます。スイープは、年齢に関係なく、ここにある他のセッションの残されたディレクトリを削除します |121| `image-cache/<session>/` | Claude Code v2.1.274 以前で保存された添付画像。それ以降のバージョンでは、貼り付けた画像と添付画像は `~/.claude` の外に保存されます。[`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars)が制御する一時ディレクトリの下の各セッションの `images/` ディレクトリに保存されます。スイープは、年齢に関係なく、ここにある他のセッションの残されたディレクトリを削除します |
121| `uploads/<session>/` | Web またはモバイルアプリから添付したファイル、およびモバイルアプリから添付した写真。[リモートコントロール](/docs/ja/remote-control.md)セッションにメッセージを送信する場合。[クラウドセッション](/docs/ja/claude-code-on-the-web.md)への添付は、代わりにそのセッション自身のクラウド環境に保存され、マシン上には保存されません |122| `uploads/<session>/` | Web またはモバイルアプリから添付したファイル、およびモバイルアプリから添付した写真。[リモートコントロール](https://code.claude.com/docs/ja/remote-control.md)セッションにメッセージを送信する場合。[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)への添付は、代わりにそのセッション自身のクラウド環境に保存され、マシン上には保存されません |
122| `dev-mods/<session>/` | [Claude が作成した Mods](/docs/ja/plugins/mods/create.md#ask-claude-for-a-mod)。セッション中に作成されたもの |123| `dev-mods/<session>/` | [Claude が作成した Mods](https://code.claude.com/docs/ja/plugins/mods/create.md#ask-claude-for-a-mod)。セッション中に作成されたもの |
123| `session-env/` | セッションごとの環境メタデータ |124| `session-env/` | セッションごとの環境メタデータ |
124| `tasks/` | タスクツールで書き込まれたタスクリスト。リストごとに 1 つのディレクトリ |125| `tasks/` | タスクツールで書き込まれたタスクリスト。リストごとに 1 つのディレクトリ |
125| `shell-snapshots/` | 起動時にキャプチャされたエイリアス、関数、シェルオプション。[Bash ツール](/docs/ja/tools-reference.md#bash-tool-behavior)によって各コマンドに適用されます。クリーンな終了時に削除されます。スイープはクラッシュ後に残されたものをクリアします |126| `shell-snapshots/` | 起動時にキャプチャされたエイリアス、関数、シェルオプション。[Bash ツール](https://code.claude.com/docs/ja/tools-reference.md#bash-tool-behavior)によって各コマンドに適用されます。クリーンな終了時に削除されます。スイープはクラッシュ後に残されたものをクリアします |
126| `backups/` | `~/.claude.json` の以前のバージョン。Claude Code がファイルを書き直すときにコピーされます。Claude Code は最新の 5 つと、解析できなかったバージョンのコピーを保持します |127| `backups/` | `~/.claude.json` の以前のバージョン。Claude Code がファイルを書き直すときにコピーされます。Claude Code は最新の 5 つと、解析できなかったバージョンのコピーを保持します |
127| `feedback-bundles/` | `/feedback` でサードパーティプロバイダーに書き込まれた、または Anthropic 認証情報が設定されていない場合に書き込まれた、編集済みトランスクリプトアーカイブ。Anthropic アカウントチームに送信するため |128| `feedback-bundles/` | `/feedback` でサードパーティプロバイダーに書き込まれた、または Anthropic 認証情報が設定されていない場合に書き込まれた、編集済みトランスクリプトアーカイブ。Anthropic アカウントチームに送信するため |
128| `feedback/drafts/` | キューに入った [Claude が作成したフィードバック](/docs/ja/tools-reference.md#sendfeedback-tool-behavior)。`/feedback` でのレビューを待機中です。`cleanupPeriodDays` または 30 日のいずれか短い方の後にスイープされます。キューが 10 ドラフトの上限に達すると、Claude Code は最も古いドラフトを削除して空き容量を作ります |129| `feedback/drafts/` | キューに入った [Claude が作成したフィードバック](https://code.claude.com/docs/ja/tools-reference.md#sendfeedback-tool-behavior)。`/feedback` でのレビューを待機中です。`cleanupPeriodDays` または 30 日のいずれか短い方の後にスイープされます。キューが 10 ドラフトの上限に達すると、Claude Code は最も古いドラフトを削除して空き容量を作ります |
129| `usage-data/` | `report.html` と [`/insights`](/docs/ja/costs#analyze-your-usage-patterns)で書き込まれたタイムスタンプ付きレポートコピー。それらを構築するために使用されるキャッシュされたセッションごとの分析データ |130| `usage-data/` | `report.html` と [`/insights`](https://code.claude.com/docs/ja/costs#analyze-your-usage-patterns)で書き込まれたタイムスタンプ付きレポートコピー。それらを構築するために使用されるキャッシュされたセッションごとの分析データ |
130| `skills/.trash/`、`plugins/.trash/` | [スキル](/docs/ja/skills.md#how-synced-skills-behave)と [プラグイン](/docs/ja/plugins/loading.md#synced-plugins)。claude.ai 同期で削除されたもの。例えば、claude.ai でオフにした後、または同期を停止した後。ファイルはここに残るため、スイープが削除するまで復元できます |131| `skills/.trash/`、`plugins/.trash/` | [スキル](https://code.claude.com/docs/ja/skills.md#how-synced-skills-behave)と [プラグイン](https://code.claude.com/docs/ja/plugins/loading.md#synced-plugins)。claude.ai 同期で削除されたもの。例えば、claude.ai でオフにした後、または同期を停止した後。ファイルはここに残るため、スイープが削除するまで復元できます |
131| `plugins/installed_plugins.set-aside.<date>.<hash>.json`、`plugins/installed_plugins.unreadable.<date>.<hash>.kept` | 日付付きコピー。Claude Code が [`installed_plugins.json`](/docs/ja/plugins/loading#find-plugins-on-disk) を書き直す前に作成します。削除したインストールレコード、および読み込めなかったファイルの内容 |132| `plugins/installed_plugins.set-aside.<date>.<hash>.json`、`plugins/installed_plugins.unreadable.<date>.<hash>.kept` | 日付付きコピー。Claude Code が [`installed_plugins.json`](https://code.claude.com/docs/ja/plugins/loading#find-plugins-on-disk) を書き直す前に作成します。削除したインストールレコード、および読み込めなかったファイルの内容 |
132| `todos/`、`statsig/`、`logs/` | 古いバージョンのレガシーディレクトリ。現在は書き込まれていません。スイープはその内容を削除してから、空のディレクトリを削除します |133| `todos/`、`statsig/`、`logs/` | 古いバージョンのレガシーディレクトリ。現在は書き込まれていません。スイープはその内容を削除してから、空のディレクトリを削除します |
133 134
134`sessions/` のセッションファイル、自動メモリ、Claude Desktop および Cowork トランスクリプトは、それぞれ独自の保持ルールに従います:135`sessions/` のセッションファイル、自動メモリ、Claude Desktop および Cowork トランスクリプトは、それぞれ独自の保持ルールに従います:
135 136
136* **`sessions/`**:実行中の各セッションに 1 つの小さいファイルを保持します。同時実行セッションとクラッシュを検出するために使用されます。年齢ベースのスイープの一部ではありません。Claude Code は、セッションが終了するときに各ファイルを削除し、次の起動時にクラッシュの残りをクリアします。137* **`sessions/`**:実行中の各セッションに 1 つの小さいファイルを保持します。同時実行セッションとクラッシュを検出するために使用されます。年齢ベースのスイープの一部ではありません。Claude Code は、セッションが終了するときに各ファイルを削除し、次の起動時にクラッシュの残りをクリアします。
137* **自動メモリ**:スイープは、プロジェクトの[自動メモリ](/docs/ja/memory.md#auto-memory)ディレクトリ `projects/<project>/memory/` 内のメモリファイルを削除しません。Claude Code は、保持期間全体が空だった場合にのみそのディレクトリを削除します。v2.1.228 より前では、スイープはメモリディレクトリ内のフォルダをセッションデータとして扱い、その下の古いファイルを削除できました。138* **自動メモリ**:スイープは、プロジェクトの[自動メモリ](https://code.claude.com/docs/ja/memory.md#auto-memory)ディレクトリ `projects/<project>/memory/` 内のメモリファイルを削除しません。Claude Code は、保持期間全体が空だった場合にのみそのディレクトリを削除します。v2.1.228 より前では、スイープはメモリディレクトリ内のフォルダをセッションデータとして扱い、その下の古いファイルを削除できました。
138* **Claude Desktop および Cowork トランスクリプト**:Claude Code は、Claude Desktop または Cowork で開始または最後に続行したセッションのトランスクリプトを任意の年齢で保持します。これらのトランスクリプトに年齢制限を与えるには、[`desktopSessionCleanupPeriodDays`](/docs/ja/settings-reference#desktopsessioncleanupperioddays) を設定します。Claude Code v2.1.248 以降が必要です。それより前のバージョンでは、`cleanupPeriodDays` の後に削除します。139* **Claude Desktop および Cowork トランスクリプト**:Claude Code は、Claude Desktop または Cowork で開始または最後に続行したセッションのトランスクリプトを任意の年齢で保持します。これらのトランスクリプトに年齢制限を与えるには、[`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/ja/settings-reference#desktopsessioncleanupperioddays) を設定します。Claude Code v2.1.248 以降が必要です。それより前のバージョンでは、`cleanupPeriodDays` の後に削除します。
139 140
140 次のいずれかの場合、Claude Code は代わりに `cleanupPeriodDays` の後にこれらのトランスクリプトを削除します:141 次のいずれかの場合、Claude Code は代わりに `cleanupPeriodDays` の後にこれらのトランスクリプトを削除します:
141 142
142 * [管理設定](/docs/ja/managed-settings.md)が `cleanupPeriodDays` を設定している143 * [管理設定](https://code.claude.com/docs/ja/managed-settings.md)が `cleanupPeriodDays` を設定している
143 * [HIPAA 設定がセッションに適用されている](/docs/ja/hipaa-setup.md#check-how-developers-sign-in-and-connect)144 * [HIPAA 設定がセッションに適用されている](https://code.claude.com/docs/ja/hipaa-setup.md#check-how-developers-sign-in-and-connect)
144 145
145Claude Code は、以下の場合に年齢ベースのスイープをスキップします:146Claude Code は、以下の場合に年齢ベースのスイープをスキップします:
146 147
147* **ベアモード**:[`--bare`](/docs/ja/headless#start-faster-with-bare-mode)で `claude -p` を実行する場合、Claude Code はそのセッションでスイープを実行しません。148* **ベアモード**:[`--bare`](https://code.claude.com/docs/ja/headless#start-faster-with-bare-mode)で `claude -p` を実行する場合、Claude Code はそのセッションでスイープを実行しません。
148* **一時停止されたスイープ**:Claude Code が保持期間を安全に判定できない場合、保持クリーンアップスイープを一時停止します。[`retention_sweep` イベント](/docs/ja/monitoring-usage#retention-sweep-event)は、それを一時停止する各設定をリストします。原因が読み込みまたは解析できない設定ファイル、または `cleanupPeriodDays` または `desktopSessionCleanupPeriodDays` が明示的に設定された設定エラーの場合、Claude Code は設定エラーを修正するまで `/status` に警告も表示します。[管理設定](/docs/ja/server-managed-settings.md)が `cleanupPeriodDays` を提供する場合、Claude Code はどちらの場合でも管理値でスイープを実行します。149* **一時停止されたスイープ**:Claude Code が保持期間を安全に判定できない場合、保持クリーンアップスイープを一時停止します。[`retention_sweep` イベント](https://code.claude.com/docs/ja/monitoring-usage#retention-sweep-event)は、それを一時停止する各設定をリストします。原因が読み込みまたは解析できない設定ファイル、または `cleanupPeriodDays` または `desktopSessionCleanupPeriodDays` が明示的に設定された設定エラーの場合、Claude Code は設定エラーを修正するまで `/status` に警告も表示します。[管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)が `cleanupPeriodDays` を提供する場合、Claude Code はどちらの場合でも管理値でスイープを実行します。
149 150
150組織内のマシンが設定した保持期間でスイープを実行していることを確認するには、[保持スイープを確認する](/docs/ja/monitoring-usage.md#check-the-retention-sweep)を参照してください。151組織内のマシンが設定した保持期間でスイープを実行していることを確認するには、[保持スイープを確認する](https://code.claude.com/docs/ja/monitoring-usage.md#check-the-retention-sweep)を参照してください。
151 152
152### セッションスクラッチパッドディレクトリ153### セッションスクラッチパッドディレクトリ
153 154
159* **Linux**:`/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`、またはシステムが設定する場合は `$TMPDIR` の下の同じ形状160* **Linux**:`/tmp/claude-<uid>/<project>/<session-id>/scratchpad/`、またはシステムが設定する場合は `$TMPDIR` の下の同じ形状
160* **Windows**:`%TEMP%\claude\<project>\<session-id>\scratchpad\`161* **Windows**:`%TEMP%\claude\<project>\<session-id>\scratchpad\`
161 162
162`<project>` は、文字と数字以外のすべての文字が `-` に置き換えられた作業ディレクトリパスです。例えば、`-Users-you-my-project`。[`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars)を設定する場合、ツリーはそのディレクトリの下に移動します。フックは現在のセッションのパスを [`scratchpad_dir`](/docs/ja/hooks#common-input-fields)として受け取ります。163`<project>` は、文字と数字以外のすべての文字が `-` に置き換えられた作業ディレクトリパスです。例えば、`-Users-you-my-project`。[`CLAUDE_CODE_TMPDIR`](https://code.claude.com/docs/ja/env-vars)を設定する場合、ツリーはそのディレクトリの下に移動します。フックは現在のセッションのパスを [`scratchpad_dir`](https://code.claude.com/docs/ja/hooks#common-input-fields)として受け取ります。
163 164
164スクラッチパッドファイルはセッションのトランスクリプトと同じ期間続きます。[保持スイープ](#cleaned-up-automatically)はトランスクリプトを削除するときにディレクトリを削除し、[`claude purge`](#clear-local-data)は一時ディレクトリに触れません。ディレクトリはシステムの一時場所の下にあるため、オペレーティングシステムもそれをクリアできます。例えば、再起動時。Claude がそこに書き込んだものを保持するには、Claude にそれをプロジェクトに移動するよう依頼します。165スクラッチパッドファイルはセッションのトランスクリプトと同じ期間続きます。[保持スイープ](#cleaned-up-automatically)はトランスクリプトを削除するときにディレクトリを削除し、[`claude purge`](#clear-local-data)は一時ディレクトリに触れません。ディレクトリはシステムの一時場所の下にあるため、オペレーティングシステムもそれをクリアできます。例えば、再起動時。Claude がそこに書き込んだものを保持するには、Claude にそれをプロジェクトに移動するよう依頼します。
165 166
167 168
168* API キーではなく claude.ai アカウントでサインインしている169* API キーではなく claude.ai アカウントでサインインしている
169* セッションが Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry ではなく Anthropic API を使用している170* セッションが Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry ではなく Anthropic API を使用している
170* [`enableArtifact`](/docs/ja/settings-reference#enableartifact)が `false` に設定されていない171* [`enableArtifact`](https://code.claude.com/docs/ja/settings-reference#enableartifact)が `false` に設定されていない
171 172
172### 削除するまで保持されるファイル173### 削除するまで保持されるファイル
173 174
175 176
176| `~/.claude/` 下のパス | 内容 |177| `~/.claude/` 下のパス | 内容 |
177| - | - |178| - | - |
178| `history.jsonl` | 入力したプロンプトが、タイムスタンプとプロジェクトパスとともに記録されます。上矢印キーによる呼び出し、`Ctrl+R` による履歴検索、`!` によるシェルコマンドの補完に使用されます。[HIPAA 設定がセッションに適用される](/docs/ja/hipaa-setup.md#check-how-developers-sign-in-and-connect)場合、各クリーンアップ処理で `cleanupPeriodDays` より古いエントリが削除されます。 |179| `history.jsonl` | 入力したプロンプトが、タイムスタンプとプロジェクトパスとともに記録されます。上矢印キーによる呼び出し、`Ctrl+R` による履歴検索、`!` によるシェルコマンドの補完に使用されます。[HIPAA 設定がセッションに適用される](https://code.claude.com/docs/ja/hipaa-setup.md#check-how-developers-sign-in-and-connect)場合、各クリーンアップ処理で `cleanupPeriodDays` より古いエントリが削除されます。 |
179| `stats-cache.json` | `/usage` で表示される集計トークンとコスト数 |180| `stats-cache.json` | `/usage` で表示される集計トークンとコスト数 |
180| `remote-settings.json` | 組織の[サーバー管理設定](/docs/ja/server-managed-settings.md)のキャッシュコピー。組織が何も設定していない場合は `{}`。セッションが[それらを取得](/docs/ja/server-managed-settings.md#platform-availability)する場合にのみ存在します。Claude Code は起動時と、セッション中は 1 時間ごとに更新を確認します。ログアウト時に削除されます |181| `remote-settings.json` | 組織の[サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)のキャッシュコピー。組織が何も設定していない場合は `{}`。セッションが[それらを取得](https://code.claude.com/docs/ja/server-managed-settings.md#platform-availability)する場合にのみ存在します。Claude Code は起動時と、セッション中は 1 時間ごとに更新を確認します。ログアウト時に削除されます |
181| `cache/changelog.md` | Claude Code チェンジログのキャッシュコピー。`/release-notes` で表示されます。バックグラウンドで更新されます |182| `cache/changelog.md` | Claude Code チェンジログのキャッシュコピー。`/release-notes` で表示されます。バックグラウンドで更新されます |
182| `policy-limits.json` | 組織のキャッシュされた機能ポリシー設定。一部のアカウントタイプにのみ存在します。自動的に更新されます。`policy-limits.json.stamp.json` サイドカーは、キャッシュが属するアカウントまたは API キーを記録します。Claude Code はログアウト時に両方のファイルを削除します |183| `policy-limits.json` | 組織のキャッシュされた機能ポリシー設定。一部のアカウントタイプにのみ存在します。自動的に更新されます。`policy-limits.json.stamp.json` サイドカーは、キャッシュが属するアカウントまたは API キーを記録します。Claude Code はログアウト時に両方のファイルを削除します |
183 184
185 186
186使用する機能に応じて、`~/.claude/` には [アプリケーションデータ](#application-data)の表に記載されていないファイルも保存されます。そのうち、キャッシュとロックファイルは削除しても安全です。以下の状態ファイルは保持してください:187使用する機能に応じて、`~/.claude/` には [アプリケーションデータ](#application-data)の表に記載されていないファイルも保存されます。そのうち、キャッシュとロックファイルは削除しても安全です。以下の状態ファイルは保持してください:
187 188
188* `.credentials.json`:[ログイン認証情報](/docs/ja/authentication.md#credential-management)189* `.credentials.json`:[ログイン認証情報](https://code.claude.com/docs/ja/authentication.md#credential-management)
189* `agent-memory/`:[サブエージェントメモリ](/docs/ja/sub-agents.md#enable-persistent-memory)190* `agent-memory/`:[サブエージェントメモリ](https://code.claude.com/docs/ja/sub-agents.md#enable-persistent-memory)
190* `jobs/` と `daemon/`:[バックグラウンドセッション](/docs/ja/agent-view.md#where-state-is-stored)の状態191* `jobs/` と `daemon/`:[バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#where-state-is-stored)の状態
191 192
192### プレーンテキストストレージ193### プレーンテキストストレージ
193 194
194トランスクリプトと履歴は保存時に暗号化されません。OS ファイル権限が唯一の保護です。ツールが `.env` ファイルを読み込むか、コマンドが認証情報を出力する場合、その値は `projects/<project>/<session>.jsonl` に書き込まれます。露出を減らすには:195トランスクリプトと履歴は保存時に暗号化されません。OS ファイル権限が唯一の保護です。ツールが `.env` ファイルを読み込むか、コマンドが認証情報を出力する場合、その値は `projects/<project>/<session>.jsonl` に書き込まれます。露出を減らすには:
195 196
196* `cleanupPeriodDays` を低くして、Claude Code がトランスクリプトを保持する期間を短縮します197* `cleanupPeriodDays` を低くして、Claude Code がトランスクリプトを保持する期間を短縮します
197* [`desktopSessionCleanupPeriodDays`](/docs/ja/settings-reference#desktopsessioncleanupperioddays)を設定して、Claude Desktop および Cowork トランスクリプトにも年齢制限を与えます198* [`desktopSessionCleanupPeriodDays`](https://code.claude.com/docs/ja/settings-reference#desktopsessioncleanupperioddays)を設定して、Claude Desktop および Cowork トランスクリプトにも年齢制限を与えます
198* [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ja/env-vars)環境変数を設定して、任意のモードでトランスクリプトとプロンプト履歴の書き込みをスキップします。非対話モードでは、代わりに `-p` と一緒に `--no-session-persistence` を渡すか、TypeScript Agent SDK で `persistSession: false` を設定できます。Python SDK には同等のオプションがありません。199* [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](https://code.claude.com/docs/ja/env-vars)環境変数を設定して、任意のモードでトランスクリプトとプロンプト履歴の書き込みをスキップします。非対話モードでは、代わりに `-p` と一緒に `--no-session-persistence` を渡すか、TypeScript Agent SDK で `persistSession: false` を設定できます。Python SDK には同等のオプションがありません。
199* [権限ルール](/docs/ja/permissions.md)を使用して、認証情報ファイルの読み取りを拒否します200* [権限ルール](https://code.claude.com/docs/ja/permissions.md)を使用して、認証情報ファイルの読み取りを拒否します
200 201
201### ローカルデータをクリアする202### ローカルデータをクリアする
202 203
259* パスの代わりに `--all` を渡して、すべてのプロジェクトの状態を一度にパージします。これは `history.jsonl` をフィルタリングするのではなく、完全に削除します。260* パスの代わりに `--all` を渡して、すべてのプロジェクトの状態を一度にパージします。これは `history.jsonl` をフィルタリングするのではなく、完全に削除します。
260* `-i` を渡して、削除計画を 1 つずつステップスルーします。261* `-i` を渡して、削除計画を 1 つずつステップスルーします。
261 262
262コマンドは `shell-snapshots/` と `backups/` をそのままにしておきます。これらはプロジェクトスコープではないため、計画出力で警告します。マシン上で誰かが [`/heapdump`](/docs/ja/troubleshooting#high-cpu-or-memory-usage) を実行した場合は、それが書き込んだ `.heapsnapshot` ファイルも削除してください。ヒープスナップショットには会話全体とプロセスが保持していた認証情報が含まれており、保持スイープもパージもそれには触れません。263コマンドは `shell-snapshots/` と `backups/` をそのままにしておきます。これらはプロジェクトスコープではないため、計画出力で警告します。マシン上で誰かが [`/heapdump`](https://code.claude.com/docs/ja/troubleshooting#high-cpu-or-memory-usage) を実行した場合は、それが書き込んだ `.heapsnapshot` ファイルも削除してください。ヒープスナップショットには会話全体とプロセスが保持していた認証情報が含まれており、保持スイープもパージもそれには触れません。
263 264
264[保持するべき状態ファイル](#state-files-to-keep)を除き、上記のアプリケーションデータパスのいずれかを手動で削除することもできます。265[保持するべき状態ファイル](#state-files-to-keep)を除き、上記のアプリケーションデータパスのいずれかを手動で削除することもできます。
265 266
267| - | - |268| - | - |
268| `~/.claude/projects/` | 過去のセッションの再開、続行、巻き戻し、およびすべてのプロジェクトの自動メモリ |269| `~/.claude/projects/` | 過去のセッションの再開、続行、巻き戻し、およびすべてのプロジェクトの自動メモリ |
269| `~/.claude/history.jsonl` | 上矢印プロンプトリコール、`Ctrl+R` 履歴検索、`!` シェルコマンド補完 |270| `~/.claude/history.jsonl` | 上矢印プロンプトリコール、`Ctrl+R` 履歴検索、`!` シェルコマンド補完 |
270| `~/.claude/paste-cache/` | リコールされたプロンプトで貼り付けたテキスト。[大きなコンテンツを貼り付ける](/docs/ja/terminal-config.md#paste-large-content)を参照 |271| `~/.claude/paste-cache/` | リコールされたプロンプトで貼り付けたテキスト。[大きなコンテンツを貼り付ける](https://code.claude.com/docs/ja/terminal-config.md#paste-large-content)を参照 |
271| `~/.claude/uploads/` | 過去の[リモートコントロール](/docs/ja/remote-control.md)セッションがパスで参照する添付ファイル |272| `~/.claude/uploads/` | 過去の[リモートコントロール](https://code.claude.com/docs/ja/remote-control.md)セッションがパスで参照する添付ファイル |
272| `~/.claude/file-history/` | 過去のセッションのチェックポイント復元 |273| `~/.claude/file-history/` | 過去のセッションのチェックポイント復元 |
273| `~/.claude/stats-cache.json` | `/usage` で表示される履歴合計 |274| `~/.claude/stats-cache.json` | `/usage` で表示される履歴合計 |
274| `~/.claude/usage-data/` | 過去の [`/insights`](/docs/ja/costs#analyze-your-usage-patterns) レポートと、それらを構築するために使用されるキャッシュされた分析データ |275| `~/.claude/usage-data/` | 過去の [`/insights`](https://code.claude.com/docs/ja/costs#analyze-your-usage-patterns) レポートと、それらを構築するために使用されるキャッシュされた分析データ |
275| `~/.claude/feedback-bundles/` | Anthropic アカウントチームにまだ送信していないフィードバックとバグレポートアーカイブ |276| `~/.claude/feedback-bundles/` | Anthropic アカウントチームにまだ送信していないフィードバックとバグレポートアーカイブ |
276| `~/.claude/feedback/drafts/` | 送信していない [Claude が作成したフィードバック](/docs/ja/tools-reference.md#sendfeedback-tool-behavior) |277| `~/.claude/feedback/drafts/` | 送信していない [Claude が作成したフィードバック](https://code.claude.com/docs/ja/tools-reference.md#sendfeedback-tool-behavior) |
277| `~/.claude/remote-settings.json` | なし。次の起動時に再取得されます |278| `~/.claude/remote-settings.json` | なし。次の起動時に再取得されます |
278| `~/.claude/cache/changelog.md` | なし。バックグラウンドで更新されます |279| `~/.claude/cache/changelog.md` | なし。バックグラウンドで更新されます |
279| `~/.claude/policy-limits.json` | なし。自動的に更新されます |280| `~/.claude/policy-limits.json` | なし。自動的に更新されます |
280| `~/.claude/tasks/` | まだ使用中のものを含む[タスクリスト](/docs/ja/interactive-mode.md#task-list) |281| `~/.claude/tasks/` | まだ使用中のものを含む[タスクリスト](https://code.claude.com/docs/ja/interactive-mode.md#task-list) |
281| `~/.claude/skills/.trash/`、`~/.claude/plugins/.trash/` | Claude Code が削除した[同期されたスキル](/docs/ja/skills.md#how-synced-skills-behave)と[同期されたプラグイン](/docs/ja/plugins/loading.md#synced-plugins)を復元する機会 |282| `~/.claude/skills/.trash/`、`~/.claude/plugins/.trash/` | Claude Code が削除した[同期されたスキル](https://code.claude.com/docs/ja/skills.md#how-synced-skills-behave)と[同期されたプラグイン](https://code.claude.com/docs/ja/plugins/loading.md#synced-plugins)を復元する機会 |
282| `~/.claude/plugins/installed_plugins.set-aside.<date>.<hash>.json`、`~/.claude/plugins/installed_plugins.unreadable.<date>.<hash>.kept` | Claude Code が削除したプラグインインストールレコード、または読み込めなかったファイルのコピー。何もそれらを読み込み直しません |283| `~/.claude/plugins/installed_plugins.set-aside.<date>.<hash>.json`、`~/.claude/plugins/installed_plugins.unreadable.<date>.<hash>.kept` | Claude Code が削除したプラグインインストールレコード、または読み込めなかったファイルのコピー。何もそれらを読み込み直しません |
283| `~/.claude/debug/`、`~/.claude/plans/`、`~/.claude/session-env/`、`~/.claude/shell-snapshots/`、`~/.claude/backups/` | ユーザーに見える何もなし |284| `~/.claude/debug/`、`~/.claude/plans/`、`~/.claude/session-env/`、`~/.claude/shell-snapshots/`、`~/.claude/backups/` | ユーザーに見える何もなし |
284| `~/.claude/todos/`、`~/.claude/statsig/`、`~/.claude/logs/`、`~/.claude/image-cache/` | なし。現在のバージョンで書き込まれていないレガシーディレクトリ |285| `~/.claude/todos/`、`~/.claude/statsig/`、`~/.claude/logs/`、`~/.claude/image-cache/` | なし。現在のバージョンで書き込まれていないレガシーディレクトリ |
287 288
288## 関連リソース289## 関連リソース
289 290
290* [Claude のメモリを管理する](/docs/ja/memory.md):CLAUDE.md、rules、auto memory を書き込んで整理します291* [Claude のメモリを管理する](https://code.claude.com/docs/ja/memory.md):CLAUDE.md、rules、auto memory を書き込んで整理します
291* [設定を構成する](/docs/ja/settings.md):パーミッション、hooks、環境変数、モデルデフォルトを設定します292* [設定を構成する](https://code.claude.com/docs/ja/settings.md):パーミッション、hooks、環境変数、モデルデフォルトを設定します
292* [Skills を作成する](/docs/ja/skills.md):再利用可能なプロンプトとワークフローを構築します293* [Skills を作成する](https://code.claude.com/docs/ja/skills.md):再利用可能なプロンプトとワークフローを構築します
293* [Subagents を構成する](/docs/ja/sub-agents.md):独自のコンテキストを持つ特化したエージェントを定義します294* [Subagents を構成する](https://code.claude.com/docs/ja/sub-agents.md):独自のコンテキストを持つ特化したエージェントを定義します