Documentation — Spybara

claude-directory.md +57 −57

Details

20 background: 'var(--ce-surface)',20 background: 'var(--ce-surface)',

21 border: '0.5px solid var(--ce-border-subtle)'21 border: '0.5px solid var(--ce-border-subtle)'

22 }}>{children}</code>, []);22 }}>{children}</code>, []);

23 const commandsNote = useMemo(() => <>Commands and skills are now the same mechanism. For new workflows, use <A href="/en/skills">skills/</A> instead: same <C>/name</C> invocation, plus you can bundle supporting files.</>, []);23 const commandsNote = useMemo(() => <>Commands and skills are now the same mechanism. For new workflows, use <A href="/docs/en/skills">skills/</A> instead: same <C>/name</C> invocation, plus you can bundle supporting files.</>, []);

24 const FILE_TREE = useMemo(() => ({24 const FILE_TREE = useMemo(() => ({

25 project: {25 project: {

26 label: 'your-project/',26 label: 'your-project/',

34 oneLiner: 'Project instructions Claude reads every session',34 oneLiner: 'Project instructions Claude reads every session',

35 when: 'Loaded into context at the start of every session',35 when: 'Loaded into context at the start of every session',

36 description: 'Project-specific instructions that shape how Claude works in this repository. Put your conventions, common commands, and architectural context here so Claude operates with the same assumptions your team does.',36 description: 'Project-specific instructions that shape how Claude works in this repository. Put your conventions, common commands, and architectural context here so Claude operates with the same assumptions your team does.',

37 tips: ['Target under 200 lines. Longer files still load in full but may reduce adherence', <>CLAUDE.md loads into every session. If something only matters for specific tasks, move it to a <A href="/en/skills">skill</A> or a path-scoped <A href="/en/memory#organize-rules-with-claude/rules/">rule</A> so it loads only when needed</>, 'List the commands you run most, like build, test, and format, so Claude knows them without you spelling them out each time', <>Run <C>/memory</C> to open and edit CLAUDE.md from within a session</>, <>Also works at <C>.claude/CLAUDE.md</C> if you prefer to keep the project root clean</>],37 tips: ['Target under 200 lines. Longer files still load in full but may reduce adherence', <>CLAUDE.md loads into every session. If something only matters for specific tasks, move it to a <A href="/docs/en/skills">skill</A> or a path-scoped <A href="/docs/en/memory#organize-rules-with-claude/rules/">rule</A> so it loads only when needed</>, 'List the commands you run most, like build, test, and format, so Claude knows them without you spelling them out each time', <>Run <C>/memory</C> to open and edit CLAUDE.md from within a session</>, <>Also works at <C>.claude/CLAUDE.md</C> if you prefer to keep the project root clean</>],

38 exampleIntro: 'This example is for a TypeScript and React project. It lists the build and test commands, the framework conventions Claude should follow, and project-specific rules like export style and file layout.',38 exampleIntro: 'This example is for a TypeScript and React project. It lists the build and test commands, the framework conventions Claude should follow, and project-specific rules like export style and file layout.',

39 example: `# Project conventions39 example: `# Project conventions

40 40

60 color: '#9B7BC4',60 color: '#9B7BC4',

61 badge: 'committed',61 badge: 'committed',

62 oneLiner: 'Project-scoped MCP servers, shared with your team',62 oneLiner: 'Project-scoped MCP servers, shared with your team',

~~63 when: <>Servers connect when the session begins. Tool schemas are deferred by default and load on demand via <A href="/en/mcp#scale-with-mcp-tool-search">tool search</A></>,~~63 when: <>Servers connect when the session begins. Tool schemas are deferred by default and load on demand via <A href="/docs/en/mcp#scale-with-mcp-tool-search">tool search</A></>,

64 description: <>Configures Model Context Protocol (MCP) servers that give Claude access to external tools: databases, APIs, browsers, and more. This file holds the project-scoped servers your whole team uses. Personal servers you want to keep to yourself go in <C>~/.claude.json</C> instead.</>,64 description: <>Configures Model Context Protocol (MCP) servers that give Claude access to external tools: databases, APIs, browsers, and more. This file holds the project-scoped servers your whole team uses. Personal servers you want to keep to yourself go in <C>~/.claude.json</C> instead.</>,

65 tips: [<>Use environment variable references for secrets: <C>{'${NOTION_TOKEN}'}</C></>, <>Lives at the project root, not inside <C>.claude/</C></>, <>For servers only you need, run <C>claude mcp add --scope user</C>. This writes to <C>~/.claude.json</C> instead of <C>.mcp.json</C></>],65 tips: [<>Use environment variable references for secrets: <C>{'${NOTION_TOKEN}'}</C></>, <>Lives at the project root, not inside <C>.claude/</C></>, <>For servers only you need, run <C>claude mcp add --scope user</C>. This writes to <C>~/.claude.json</C> instead of <C>.mcp.json</C></>],

66 exampleIntro: <>This example configures the Notion MCP server so Claude can read and update pages in your workspace. The <C>{'${NOTION_TOKEN}'}</C> reference is read from your shell environment when Claude Code starts the server, so the token never lands in the file.</>,66 exampleIntro: <>This example configures the Notion MCP server so Claude can read and update pages in your workspace. The <C>{'${NOTION_TOKEN}'}</C> reference is read from your shell environment when Claude Code starts the server, so the token never lands in the file.</>,

86 oneLiner: 'Gitignored files to copy into new worktrees',86 oneLiner: 'Gitignored files to copy into new worktrees',

87 when: <>Read when Claude creates a git worktree via <C>--worktree</C>, the <C>EnterWorktree</C> tool, or subagent <C>isolation: worktree</C></>,87 when: <>Read when Claude creates a git worktree via <C>--worktree</C>, the <C>EnterWorktree</C> tool, or subagent <C>isolation: worktree</C></>,

88 description: <>Lists gitignored files to copy from your main repository into each new worktree. Worktrees are fresh checkouts, so untracked files like <C>.env</C> are missing by default. Patterns here use <C>.gitignore</C> syntax. Only files that match a pattern and are also gitignored get copied, so tracked files are never duplicated.</>,88 description: <>Lists gitignored files to copy from your main repository into each new worktree. Worktrees are fresh checkouts, so untracked files like <C>.env</C> are missing by default. Patterns here use <C>.gitignore</C> syntax. Only files that match a pattern and are also gitignored get copied, so tracked files are never duplicated.</>,

89 tips: [<>Lives at the project root, not inside <C>.claude/</C></>, <>Git-only: if you configure a <A href="/en/hooks#worktreecreate">WorktreeCreate hook</A> for a different VCS, this file is not read. Copy files inside your hook script instead</>, <>Also applies to parallel sessions in the <A href="/en/desktop#work-in-parallel-with-sessions">desktop app</A></>],89 tips: [<>Lives at the project root, not inside <C>.claude/</C></>, <>Git-only: if you configure a <A href="/docs/en/hooks#worktreecreate">WorktreeCreate hook</A> for a different VCS, this file is not read. Copy files inside your hook script instead</>, <>Also applies to parallel sessions in the <A href="/docs/en/desktop#work-in-parallel-with-sessions">desktop app</A></>],

90 exampleIntro: 'This example copies your local environment files and a secrets config into every worktree Claude creates. Comments start with # and blank lines are ignored, same as .gitignore.',90 exampleIntro: 'This example copies your local environment files and a secrets config into every worktree Claude creates. Comments start with # and blank lines are ignored, same as .gitignore.',

91 example: `# Local environment91 example: `# Local environment

92.env92.env

102 icon: 'folder',102 icon: 'folder',

103 color: 'var(--ce-accent)',103 color: 'var(--ce-accent)',

104 oneLiner: 'Project-level configuration, rules, and extensions',104 oneLiner: 'Project-level configuration, rules, and extensions',

105 description: 'Everything Claude Code reads that is specific to this project. If you use git, commit most files here so your team shares them; a few, like settings.local.json, are automatically gitignored. Each file badge shows which.',105 description: 'Everything Claude Code reads that is specific to this project. If you use git, commit most files here so your team shares them; a few, like settings.local.json, are gitignored when Claude Code saves settings to them. Each file badge shows which.',

106 children: [{106 children: [{

107 id: 'settings-json',107 id: 'settings-json',

108 label: 'settings.json',108 label: 'settings.json',

113 oneLiner: 'Permissions, hooks, and configuration',113 oneLiner: 'Permissions, hooks, and configuration',

114 when: <>Overrides global <C>~/.claude/settings.json</C>. Local settings, CLI flags, and managed settings override this</>,114 when: <>Overrides global <C>~/.claude/settings.json</C>. Local settings, CLI flags, and managed settings override this</>,

115 description: 'Settings that Claude Code applies directly. Permissions control which commands and tools Claude can use; hooks run your scripts at specific points in a session. Unlike CLAUDE.md, which Claude reads as guidance, these are enforced whether Claude follows them or not.',115 description: 'Settings that Claude Code applies directly. Permissions control which commands and tools Claude can use; hooks run your scripts at specific points in a session. Unlike CLAUDE.md, which Claude reads as guidance, these are enforced whether Claude follows them or not.',

116 contains: [<><A href="/en/permissions">permissions</A>: allow, deny, or prompt before Claude uses specific tools or commands</>, <><A href="/en/hooks">hooks</A>: run your own scripts on events like before a tool call or after a file edit</>, <><A href="/en/statusline">statusLine</A>: customize the line shown at the bottom while Claude works</>, <><A href="/en/settings#available-settings">model</A>: pick a default model for this project</>, <><A href="/en/settings#environment-variables">env</A>: environment variables set in every session</>, <><A href="/en/output-styles">outputStyle</A>: select a custom system-prompt style from output-styles/</>],116 contains: [<><A href="/docs/en/permissions">permissions</A>: allow, deny, or prompt before Claude uses specific tools or commands</>, <><A href="/docs/en/hooks">hooks</A>: run your own scripts on events like before a tool call or after a file edit</>, <><A href="/docs/en/statusline">statusLine</A>: customize the line shown at the bottom while Claude works</>, <><A href="/docs/en/settings#available-settings">model</A>: pick a default model for this project</>, <><A href="/docs/en/settings#environment-variables">env</A>: environment variables set in every session</>, <><A href="/docs/en/output-styles">outputStyle</A>: select a custom system-prompt style from output-styles/</>],

117 tips: [<>Bash permission patterns support wildcards: <C>Bash(npm test *)</C> matches any command starting with <C>npm test</C></>, <>Array settings like <C>permissions.allow</C> combine across all scopes; scalar settings like <C>model</C> use the most specific value</>],117 tips: [<>Bash permission patterns support wildcards: <C>Bash(npm test *)</C> matches any command starting with <C>npm test</C></>, <>Array settings like <C>permissions.allow</C> combine across all scopes; scalar settings like <C>model</C> use the most specific value</>],

118 exampleIntro: <>This example allows <C>npm test</C> and <C>npm run</C> commands without prompting, blocks <C>rm -rf</C>, and runs Prettier on files after Claude edits or writes them.</>,118 exampleIntro: <>This example allows <C>npm test</C> and <C>npm run</C> commands without prompting, blocks <C>rm -rf</C>, and runs Prettier on files after Claude edits or writes them.</>,

119 example: `{119 example: `{

146 badge: 'gitignored',146 badge: 'gitignored',

147 oneLiner: 'Your personal settings overrides for this project',147 oneLiner: 'Your personal settings overrides for this project',

148 when: 'Highest of the user-editable settings files; CLI flags and managed settings still take precedence',148 when: 'Highest of the user-editable settings files; CLI flags and managed settings still take precedence',

149 description: 'Personal settings that take precedence over the project defaults. Same JSON format as settings.json, but not committed. Use this when you need different permissions or defaults than the team config.',149 description: 'Personal settings that take precedence over the project defaults. Same JSON format as settings.json, gitignored when Claude Code saves a setting to it. Use this when you need different permissions or defaults than the team config.',

150 tips: [<>Same schema as settings.json. Array settings like <C>permissions.allow</C> combine across scopes; scalar settings like <C>model</C> use the local value</>, <>Claude Code adds this file to <C>~/.config/git/ignore</C> the first time it writes one. If you use a custom <C>core.excludesFile</C>, add the pattern there too. To share the ignore rule with your team, also add it to the project <C>.gitignore</C></>],150 tips: [<>Same schema as settings.json. Array settings like <C>permissions.allow</C> combine across scopes; scalar settings like <C>model</C> use the local value</>, <>When Claude Code saves a setting to this file in a repository that doesn't already ignore it, it adds <C>**/.claude/settings.local.json</C> to your global git excludes file: <C>core.excludesFile</C> from your global git config when it's set to an absolute or <C>~</C>-prefixed path, otherwise <C>$XDG_CONFIG_HOME/git/ignore</C>, or <C>~/.config/git/ignore</C>. To share the ignore rule with your team, also add it to the project <C>.gitignore</C></>],

151 exampleIntro: 'This example adds Docker permissions on top of whatever the team settings.json allows.',151 exampleIntro: 'This example adds Docker permissions on top of whatever the team settings.json allows.',

152 example: `{152 example: `{

153 "permissions": {153 "permissions": {

165 color: '#9B7BC4',165 color: '#9B7BC4',

166 oneLiner: 'Topic-scoped instructions, optionally gated by file paths',166 oneLiner: 'Topic-scoped instructions, optionally gated by file paths',

167 when: <>Rules without <C>paths:</C> load at session start. Rules with <C>paths:</C> load when a matching file enters context</>,167 when: <>Rules without <C>paths:</C> load at session start. Rules with <C>paths:</C> load when a matching file enters context</>,

168 description: [<>Project instructions split into topic files that can load conditionally based on file paths. A rule without <C>paths:</C> frontmatter loads at session start like CLAUDE.md; a rule with <C>paths:</C> loads only when Claude reads a matching file.</>, <>Like CLAUDE.md, rules are guidance Claude reads, not configuration Claude Code enforces. For guaranteed behavior use <A href="/en/hooks">hooks</A> or <A href="/en/permissions">permissions</A>.</>],168 description: [<>Project instructions split into topic files that can load conditionally based on file paths. A rule without <C>paths:</C> frontmatter loads at session start like CLAUDE.md; a rule with <C>paths:</C> loads only when Claude reads a matching file.</>, <>Like CLAUDE.md, rules are guidance Claude reads, not configuration Claude Code enforces. For guaranteed behavior use <A href="/docs/en/hooks">hooks</A> or <A href="/docs/en/permissions">permissions</A>.</>],

169 tips: [<>Use <C>paths:</C> frontmatter with globs to scope rules to directories or file types</>, <>Subdirectories work: <C>.claude/rules/frontend/react.md</C> is discovered automatically</>, 'When CLAUDE.md approaches 200 lines, start splitting into rules'],169 tips: [<>Use <C>paths:</C> frontmatter with globs to scope rules to directories or file types</>, <>Subdirectories work: <C>.claude/rules/frontend/react.md</C> is discovered automatically</>, 'When CLAUDE.md approaches 200 lines, start splitting into rules'],

170 docsLink: '/en/memory#organize-rules-with-claude/rules/',170 docsLink: '/en/memory#organize-rules-with-claude/rules/',

171 children: [{171 children: [{

369 color: '#C46686',369 color: '#C46686',

370 oneLiner: 'Dynamic workflow scripts that orchestrate many subagents',370 oneLiner: 'Dynamic workflow scripts that orchestrate many subagents',

371 when: 'Loaded at startup; each file becomes a /<name> command',371 when: 'Loaded at startup; each file becomes a /<name> command',

372 description: <>Each <C>.js</C> file is a <A href="/en/workflows">dynamic workflow</A>: a script the runtime executes to spawn and coordinate many subagents. Workflows are written by Claude and saved here from <C>/workflows</C> rather than authored from scratch.</>,372 description: <>Each <C>.js</C> file is a <A href="/docs/en/workflows">dynamic workflow</A>: a script the runtime executes to spawn and coordinate many subagents. Workflows are written by Claude and saved here from <C>/workflows</C> rather than authored from scratch.</>,

373 tips: [<>Save a run from <C>/workflows</C> with <C>s</C> to create one of these</>, <>A project workflow takes precedence over a personal one in <C>~/.claude/workflows/</C> with the same name</>],373 tips: [<>Save a run from <C>/workflows</C> with <C>s</C> to create one of these</>, <>A project workflow takes precedence over a personal one in <C>~/.claude/workflows/</C> with the same name</>],

374 docsLink: '/en/workflows'374 docsLink: '/en/workflows'

375 }, {375 }, {

382 autogen: true,382 autogen: true,

383 oneLiner: 'Subagent persistent memory, separate from your main session auto memory',383 oneLiner: 'Subagent persistent memory, separate from your main session auto memory',

384 when: 'First 200 lines (capped at 25KB) of MEMORY.md loaded into the subagent system prompt when it runs',384 when: 'First 200 lines (capped at 25KB) of MEMORY.md loaded into the subagent system prompt when it runs',

385 description: <>Subagents with <C>memory: project</C> in their frontmatter get a dedicated memory directory here. This is distinct from your <A href="/en/memory#auto-memory">main session auto memory</A> at <C>~/.claude/projects/</C>: each subagent reads and writes its own MEMORY.md, not yours.</>,385 description: <>Subagents with <C>memory: project</C> in their frontmatter get a dedicated memory directory here. This is distinct from your <A href="/docs/en/memory#auto-memory">main session auto memory</A> at <C>~/.claude/projects/</C>: each subagent reads and writes its own MEMORY.md, not yours.</>,

386 tips: [<>Only created for subagents that set the <C>memory:</C> frontmatter field</>, <>This directory holds project-scoped subagent memory, meant to be shared with your team. To keep memory out of version control use <C>memory: local</C>, which writes to <C>.claude/agent-memory-local/</C> instead. For cross-project memory use <C>memory: user</C>, which writes to <C>~/.claude/agent-memory/</C></>, <>The main session auto memory is a different feature; see <C>~/.claude/projects/</C> in the Global tab</>],386 tips: [<>Only created for subagents that set the <C>memory:</C> frontmatter field</>, <>This directory holds project-scoped subagent memory, meant to be shared with your team. To keep memory out of version control use <C>memory: local</C>, which writes to <C>.claude/agent-memory-local/</C> instead. For cross-project memory use <C>memory: user</C>, which writes to <C>~/.claude/agent-memory/</C></>, <>The main session auto memory is a different feature; see <C>~/.claude/projects/</C> in the Global tab</>],

387 docsLink: '/en/sub-agents#enable-persistent-memory',387 docsLink: '/en/sub-agents#enable-persistent-memory',

388 children: [{388 children: [{

402 autogen: true,402 autogen: true,

403 oneLiner: 'The subagent writes and maintains this file automatically',403 oneLiner: 'The subagent writes and maintains this file automatically',

404 when: 'Loaded into the subagent system prompt when the subagent starts',404 when: 'Loaded into the subagent system prompt when the subagent starts',

405 description: <>Works the same as your <A href="/en/memory#auto-memory">main auto memory</A>: the subagent creates and updates this file itself. You do not write it. The subagent reads it at the start of each task and writes back what it learns.</>,405 description: <>Works the same as your <A href="/docs/en/memory#auto-memory">main auto memory</A>: the subagent creates and updates this file itself. You do not write it. The subagent reads it at the start of each task and writes back what it learns.</>,

406 example: `# code-reviewer memory406 example: `# code-reviewer memory

407 407

408## Patterns seen408## Patterns seen

1432 1432

1433Claude Code liest Anweisungen, Einstellungen, Skills, Subagents und Memory aus Ihrem Projektverzeichnis und aus `~/.claude` in Ihrem Home-Verzeichnis. Committen Sie Projektdateien zu git, um sie mit Ihrem Team zu teilen; Dateien in `~/.claude` sind persönliche Konfiguration, die für alle Ihre Projekte gilt.1433Claude Code liest Anweisungen, Einstellungen, Skills, Subagents und Memory aus Ihrem Projektverzeichnis und aus `~/.claude` in Ihrem Home-Verzeichnis. Committen Sie Projektdateien zu git, um sie mit Ihrem Team zu teilen; Dateien in `~/.claude` sind persönliche Konfiguration, die für alle Ihre Projekte gilt.

1434 1434

1435Unter Windows wird `~/.claude` zu `%USERPROFILE%\.claude` aufgelöst. Wenn Sie [`CLAUDE_CONFIG_DIR`](/de/env-vars) setzen, lebt jeder `~/.claude`-Pfad auf dieser Seite stattdessen unter diesem Verzeichnis.1435Unter Windows wird `~/.claude` zu `%USERPROFILE%\.claude` aufgelöst. Wenn Sie [`CLAUDE_CONFIG_DIR`](/docs/de/env-vars) setzen, lebt jeder `~/.claude`-Pfad auf dieser Seite stattdessen unter diesem Verzeichnis.

1436 1436

1437Die meisten Benutzer bearbeiten nur `CLAUDE.md` und `settings.json`. Der Rest des Verzeichnisses ist optional: Fügen Sie Skills, Rules oder Subagents hinzu, wenn Sie sie benötigen.1437Die meisten Benutzer bearbeiten nur `CLAUDE.md` und `settings.json`. Der Rest des Verzeichnisses ist optional: Fügen Sie Skills, Rules oder Subagents hinzu, wenn Sie sie benötigen.

1438 1438

1452 1452

1453| Datei | Ort | Zweck |1453| Datei | Ort | Zweck |

1454| ----------------------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1454| ----------------------- | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1455| `managed-settings.json` | Systemebene, variiert je nach Betriebssystem | Von Unternehmen erzwungene Einstellungen, die Sie nicht überschreiben können. Siehe [servergesteuerte Einstellungen](/de/server-managed-settings). |1455| `managed-settings.json` | Systemebene, variiert je nach Betriebssystem | Von Unternehmen erzwungene Einstellungen, die Sie nicht überschreiben können. Siehe [servergesteuerte Einstellungen](/docs/de/server-managed-settings). |

1456| `CLAUDE.local.md` | Projektstammverzeichnis | Ihre privaten Voreinstellungen für dieses Projekt, geladen zusammen mit CLAUDE.md. Erstellen Sie es manuell und fügen Sie es zu `.gitignore` hinzu. |1456| `CLAUDE.local.md` | Projektstammverzeichnis | Ihre privaten Voreinstellungen für dieses Projekt, geladen zusammen mit CLAUDE.md. Erstellen Sie es manuell und fügen Sie es zu `.gitignore` hinzu. |

1457| Installierte Plugins | `~/.claude/plugins` | Geklonte Marketplaces, installierte Plugin-Versionen und Pro-Plugin-Daten, verwaltet durch `claude plugin`-Befehle. Verwaiste Versionen werden 7 Tage nach einem Plugin-Update oder einer Deinstallation gelöscht. Siehe [Plugin-Caching](/de/plugins-reference#plugin-caching-and-file-resolution). |1457| Installierte Plugins | `~/.claude/plugins` | Geklonte Marketplaces, installierte Plugin-Versionen und Pro-Plugin-Daten, verwaltet durch `claude plugin`-Befehle. Verwaiste Versionen werden 7 Tage nach einem Plugin-Update oder einer Deinstallation gelöscht. Siehe [Plugin-Caching](/docs/de/plugins-reference#plugin-caching-and-file-resolution). |

1458 1458

1459`~/.claude` enthält auch Daten, die Claude Code während der Arbeit schreibt: Transkripte, Prompt-Verlauf, Datei-Snapshots, Caches und Logs. Siehe [Anwendungsdaten](#application-data) unten.1459`~/.claude` enthält auch Daten, die Claude Code während der Arbeit schreibt: Transkripte, Prompt-Verlauf, Datei-Snapshots, Caches und Logs. Siehe [Anwendungsdaten](#application-data) unten.

1460 1460

1466 1466

1468| :------------------------------------------------------------------------ | :----------------------------------------- | :------------------ | :---------------------------------------------------- |1468| :------------------------------------------------------------------------ | :----------------------------------------- | :------------------ | :---------------------------------------------------- |

1475| Einen spezialisierten Subagent mit seinen eigenen Tools definieren | `agents/*.md` | Projekt oder global | [Subagents](/de/sub-agents) |1475| Einen spezialisierten Subagent mit seinen eigenen Tools definieren | `agents/*.md` | Projekt oder global | [Subagents](/docs/de/sub-agents) |

1476| Orchestrieren Sie viele Subagents aus einem Skript | `workflows/*.js` | Projekt oder global | [Dynamische Workflows](/de/workflows) |1476| Orchestrieren Sie viele Subagents aus einem Skript | `workflows/*.js` | Projekt oder global | [Dynamische Workflows](/docs/de/workflows) |

1478| Ändern Sie, wie Claude Antworten formatiert | `output-styles/*.md` | Projekt oder global | [Ausgabestile](/de/output-styles) |1478| Ändern Sie, wie Claude Antworten formatiert | `output-styles/*.md` | Projekt oder global | [Ausgabestile](/docs/de/output-styles) |

1479 1479

1480<h2 id="file-reference">1480<h2 id="file-reference">

1481 Dateireferenz1481 Dateireferenz

1486<Note>1486<Note>

1487 Mehrere Dinge können das überschreiben, was Sie in diese Dateien eingeben:1487 Mehrere Dinge können das überschreiben, was Sie in diese Dateien eingeben:

1488 1488

1489 * [Verwaltete Einstellungen](/de/server-managed-settings), die von Ihrer Organisation bereitgestellt werden, haben Vorrang vor allem anderen1489 * [Verwaltete Einstellungen](/docs/de/server-managed-settings), die von Ihrer Organisation bereitgestellt werden, haben Vorrang vor allem anderen

1490 * CLI-Flags wie `--permission-mode` oder `--settings` überschreiben `settings.json` für diese Sitzung1490 * CLI-Flags wie `--permission-mode` oder `--settings` überschreiben `settings.json` für diese Sitzung

1491 * Einige Umgebungsvariablen haben Vorrang vor ihrer entsprechenden Einstellung, aber dies variiert: Überprüfen Sie die [Umgebungsvariablenreferenz](/de/env-vars) für jede einzelne1491 * Einige Umgebungsvariablen haben Vorrang vor ihrer entsprechenden Einstellung, aber dies variiert: Überprüfen Sie die [Umgebungsvariablenreferenz](/docs/de/env-vars) für jede einzelne

1492 1492

1493 Siehe [Einstellungspriorität](/de/settings#settings-precedence) für die vollständige Reihenfolge.1493 Siehe [Einstellungspriorität](/docs/de/settings#settings-precedence) für die vollständige Reihenfolge.

1494</Note>1494</Note>

1495 1495

1496Klicken Sie auf einen Dateinamen, um diesen Knoten im Explorer oben zu öffnen.1496Klicken Sie auf einen Dateinamen, um diesen Knoten im Explorer oben zu öffnen.

1497 1497

1499| --------------------------------------------------- | ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |1499| --------------------------------------------------- | ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |

1501| [`rules/*.md`](#ce-rules) | Projekt und global | ✓ | Themenbezogene Anweisungen, optional pfadgesteuert | [Rules](/de/memory#organize-rules-with-claude/rules/) |1501| [`rules/*.md`](#ce-rules) | Projekt und global | ✓ | Themenbezogene Anweisungen, optional pfadgesteuert | [Rules](/docs/de/memory#organize-rules-with-claude/rules/) |

1507| [`commands/*.md`](#ce-commands) | Projekt und global | ✓ | Einzeldatei-Prompts; gleicher Mechanismus wie Skills | [Skills](/de/skills) |1507| [`commands/*.md`](#ce-commands) | Projekt und global | ✓ | Einzeldatei-Prompts; gleicher Mechanismus wie Skills | [Skills](/docs/de/skills) |

1508| [`output-styles/*.md`](#ce-output-styles) | Projekt und global | ✓ | Benutzerdefinierte System-Prompt-Abschnitte | [Ausgabestile](/de/output-styles) |1508| [`output-styles/*.md`](#ce-output-styles) | Projekt und global | ✓ | Benutzerdefinierte System-Prompt-Abschnitte | [Ausgabestile](/docs/de/output-styles) |

1509| [`agents/*.md`](#ce-agents) | Projekt und global | ✓ | Subagent-Definitionen mit eigenem Prompt und Tools | [Subagents](/de/sub-agents) |1509| [`agents/*.md`](#ce-agents) | Projekt und global | ✓ | Subagent-Definitionen mit eigenem Prompt und Tools | [Subagents](/docs/de/sub-agents) |

1510| [`workflows/*.js`](#ce-workflows) | Projekt und global | ✓ | Dynamische Workflow-Skripte, geschrieben von Claude und gespeichert von `/workflows`; jede Datei wird zu einem `/<name>`-Befehl | [Dynamische Workflows](/de/workflows) |1510| [`workflows/*.js`](#ce-workflows) | Projekt und global | ✓ | Dynamische Workflow-Skripte, geschrieben von Claude und gespeichert von `/workflows`; jede Datei wird zu einem `/<name>`-Befehl | [Dynamische Workflows](/docs/de/workflows) |

1515| [`themes/*.json`](#ce-themes) | Nur global | | Benutzerdefinierte Farbthemen | [Benutzerdefinierte Designs](/de/terminal-config#create-a-custom-theme) |1515| [`themes/*.json`](#ce-themes) | Nur global | | Benutzerdefinierte Farbthemen | [Benutzerdefinierte Designs](/docs/de/terminal-config#create-a-custom-theme) |

1516 1516

1517<h2 id="troubleshoot-configuration">1517<h2 id="troubleshoot-configuration">

1518 Fehlerbehebung bei der Konfiguration1518 Fehlerbehebung bei der Konfiguration

1519</h2>1519</h2>

1520 1520

1521Wenn eine Einstellung, ein Hook oder eine Datei nicht wirksam wird, siehe [Debuggen Sie Ihre Konfiguration](/de/debug-your-config) für die Inspektionsbefehle und eine Symptom-erste Nachschlagetabelle.1521Wenn eine Einstellung, ein Hook oder eine Datei nicht wirksam wird, siehe [Debuggen Sie Ihre Konfiguration](/docs/de/debug-your-config) für die Inspektionsbefehle und eine Symptom-erste Nachschlagetabelle.

1522 1522

1523<h2 id="application-data">1523<h2 id="application-data">

1524 Anwendungsdaten1524 Anwendungsdaten

1530 Automatisch bereinigt1530 Automatisch bereinigt

1531</h3>1531</h3>

1532 1532

1533Dateien in den folgenden Pfaden werden beim Start gelöscht, sobald sie älter als [`cleanupPeriodDays`](/de/settings#available-settings) sind. Der Standard ist 30 Tage.1533Dateien in den folgenden Pfaden werden beim Start gelöscht, sobald sie älter als [`cleanupPeriodDays`](/docs/de/settings#available-settings) sind. Der Standard ist 30 Tage.

1534 1534

1536| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1536| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1537| `projects/<project>/<session>.jsonl` | Vollständiges Gesprächstranskript: jede Nachricht, jeder Tool-Aufruf und jedes Tool-Ergebnis |1537| `projects/<project>/<session>.jsonl` | Vollständiges Gesprächstranskript: jede Nachricht, jeder Tool-Aufruf und jedes Tool-Ergebnis |

1538| `projects/<project>/<session>/subagents/` | [Subagent](/de/sub-agents) Gesprächstranskripte, entfernt mit dem übergeordneten Sitzungstranskript, wenn es veraltet |1538| `projects/<project>/<session>/subagents/` | [Subagent](/docs/de/sub-agents) Gesprächstranskripte, entfernt mit dem übergeordneten Sitzungstranskript, wenn es veraltet |

1540| `file-history/<session>/` | Vor-Bearbeitungs-Snapshots von Dateien, die Claude geändert hat, verwendet für [Checkpoint-Wiederherstellung](/de/checkpointing). Enthält Snapshots für die 100 neuesten Checkpoints; Snapshot-Dateien, auf die kein beibehaltener Checkpoint verweist, werden gelöscht, außer dem ersten Snapshot jeder Datei |1540| `file-history/<session>/` | Vor-Bearbeitungs-Snapshots von Dateien, die Claude geändert hat, verwendet für [Checkpoint-Wiederherstellung](/docs/de/checkpointing). Enthält Snapshots für die 100 neuesten Checkpoints; Snapshot-Dateien, auf die kein beibehaltener Checkpoint verweist, werden gelöscht, außer dem ersten Snapshot jeder Datei |

1541| `plans/` | Plan-Dateien, die während des [Plan-Modus](/de/permission-modes#analyze-before-you-edit-with-plan-mode) geschrieben werden |1541| `plans/` | Plan-Dateien, die während des [Plan-Modus](/docs/de/permission-modes#analyze-before-you-edit-with-plan-mode) geschrieben werden |

1546| `shell-snapshots/` | Aliase, Funktionen und Shell-Optionen, die beim Start erfasst und vom [Bash-Tool](/de/tools-reference#bash-tool-behavior) auf jeden Befehl angewendet werden. Wird bei sauberer Beendigung entfernt. Die Bereinigung löscht alle, die nach einem Absturz übrig bleiben. |1546| `shell-snapshots/` | Aliase, Funktionen und Shell-Optionen, die beim Start erfasst und vom [Bash-Tool](/docs/de/tools-reference#bash-tool-behavior) auf jeden Befehl angewendet werden. Wird bei sauberer Beendigung entfernt. Die Bereinigung löscht alle, die nach einem Absturz übrig bleiben. |

1548| `feedback-bundles/` | Redigierte Transkript-Archive, die von `/feedback` auf Drittanbieter-Plattformen oder wenn keine Anthropic-Anmeldedaten konfiguriert sind geschrieben werden, um an Ihr Anthropic-Kontoteam gesendet zu werden |1548| `feedback-bundles/` | Redigierte Transkript-Archive, die von `/feedback` auf Drittanbieter-Plattformen oder wenn keine Anthropic-Anmeldedaten konfiguriert sind geschrieben werden, um an Ihr Anthropic-Kontoteam gesendet zu werden |

1549| `todos/`, `statsig/`, `logs/` | Legacy-Verzeichnisse aus älteren Versionen. Nicht mehr geschrieben. Die Bereinigung entfernt deren Inhalte und dann das leere Verzeichnis. |1549| `todos/`, `statsig/`, `logs/` | Legacy-Verzeichnisse aus älteren Versionen. Nicht mehr geschrieben. Die Bereinigung entfernt deren Inhalte und dann das leere Verzeichnis. |

1558| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1558| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1559| `history.jsonl` | Jeder Prompt, den Sie eingegeben haben, mit Zeitstempel und Projektpfad. Verwendet für Up-Arrow-Abruf. |1559| `history.jsonl` | Jeder Prompt, den Sie eingegeben haben, mit Zeitstempel und Projektpfad. Verwendet für Up-Arrow-Abruf. |

1561| `remote-settings.json` | Zwischengespeicherte Kopie von [servergesteuerten Einstellungen](/de/server-managed-settings) für Ihre Organisation. Nur vorhanden, wenn Ihre Organisation diese konfiguriert hat. Wird bei jedem Start aktualisiert. |1561| `remote-settings.json` | Zwischengespeicherte Kopie von [servergesteuerten Einstellungen](/docs/de/server-managed-settings) für Ihre Organisation. Nur vorhanden, wenn Ihre Organisation diese konfiguriert hat. Wird bei jedem Start aktualisiert. |

1562 1562

1563Andere kleine Cache- und Lock-Dateien erscheinen je nachdem, welche Funktionen Sie verwenden, und sind sicher zu löschen.1563Andere kleine Cache- und Lock-Dateien erscheinen je nachdem, welche Funktionen Sie verwenden, und sind sicher zu löschen.

1564 1564

1569Transkripte und Verlauf sind nicht verschlüsselt im Ruhezustand. OS-Dateiberechtigungen sind der einzige Schutz. Wenn ein Tool eine `.env`-Datei liest oder ein Befehl eine Anmeldeinformation ausgibt, wird dieser Wert in `projects/<project>/<session>.jsonl` geschrieben. Um die Exposition zu reduzieren:1569Transkripte und Verlauf sind nicht verschlüsselt im Ruhezustand. OS-Dateiberechtigungen sind der einzige Schutz. Wenn ein Tool eine `.env`-Datei liest oder ein Befehl eine Anmeldeinformation ausgibt, wird dieser Wert in `projects/<project>/<session>.jsonl` geschrieben. Um die Exposition zu reduzieren:

1570 1570

1571* Senken Sie `cleanupPeriodDays`, um zu verkürzen, wie lange Transkripte aufbewahrt werden1571* Senken Sie `cleanupPeriodDays`, um zu verkürzen, wie lange Transkripte aufbewahrt werden

1572* Setzen Sie die Umgebungsvariable [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/de/env-vars), um das Schreiben von Transkripten und Prompt-Verlauf in jedem Modus zu überspringen. Im nicht-interaktiven Modus können Sie stattdessen `--no-session-persistence` zusammen mit `-p` übergeben oder `persistSession: false` im Agent SDK setzen.1572* Setzen Sie die Umgebungsvariable [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/de/env-vars), um das Schreiben von Transkripten und Prompt-Verlauf in jedem Modus zu überspringen. Im nicht-interaktiven Modus können Sie stattdessen `--no-session-persistence` zusammen mit `-p` übergeben oder `persistSession: false` im Agent SDK setzen.

1573* Verwenden Sie [Berechtigungsregeln](/de/permissions), um Lesevorgänge von Anmeldeinformationsdateien zu verweigern1573* Verwenden Sie [Berechtigungsregeln](/docs/de/permissions), um Lesevorgänge von Anmeldeinformationsdateien zu verweigern

1574 1574

1575<h3 id="clear-local-data">1575<h3 id="clear-local-data">

1576 Lokale Daten löschen1576 Lokale Daten löschen

1627 Verwandte Ressourcen1627 Verwandte Ressourcen

1628</h2>1628</h2>

1629 1629

1630* [Verwalten Sie Claudes Memory](/de/memory): Schreiben und organisieren Sie CLAUDE.md, Rules und Auto Memory1630* [Verwalten Sie Claudes Memory](/docs/de/memory): Schreiben und organisieren Sie CLAUDE.md, Rules und Auto Memory

1631* [Konfigurieren Sie Einstellungen](/de/settings): Setzen Sie Berechtigungen, Hooks, Umgebungsvariablen und Modellstandards1631* [Konfigurieren Sie Einstellungen](/docs/de/settings): Setzen Sie Berechtigungen, Hooks, Umgebungsvariablen und Modellstandards

1632* [Erstellen Sie Skills](/de/skills): Bauen Sie wiederverwendbare Prompts und Workflows1632* [Erstellen Sie Skills](/docs/de/skills): Bauen Sie wiederverwendbare Prompts und Workflows

1633* [Konfigurieren Sie Subagents](/de/sub-agents): Definieren Sie spezialisierte Agenten mit eigenem Kontext1633* [Konfigurieren Sie Subagents](/docs/de/sub-agents): Definieren Sie spezialisierte Agenten mit eigenem Kontext

hooks.md +1 −1

Details

39| `UserPromptSubmit` | When you submit a prompt, before Claude processes it |39| `UserPromptSubmit` | When you submit a prompt, before Claude processes it |

40| `UserPromptExpansion` | When a user-typed command expands into a prompt, before it reaches Claude. Can block the expansion |40| `UserPromptExpansion` | When a user-typed command expands into a prompt, before it reaches Claude. Can block the expansion |

41| `PreToolUse` | Before a tool call executes. Can block it |41| `PreToolUse` | Before a tool call executes. Can block it |

43| `PermissionDenied` | When a tool call is denied by the auto mode classifier. Return `{retry: true}` to tell the model it may retry the denied tool call |43| `PermissionDenied` | When a tool call is denied by the auto mode classifier. Return `{retry: true}` to tell the model it may retry the denied tool call |

44| `PostToolUse` | After a tool call succeeds |44| `PostToolUse` | After a tool call succeeds |

45| `PostToolUseFailure` | After a tool call fails |45| `PostToolUseFailure` | After a tool call fails |

hooks-guide.md +1 −1

Details

466| `UserPromptExpansion` | When a user-typed command expands into a prompt, before it reaches Claude. Can block the expansion |466| `UserPromptExpansion` | When a user-typed command expands into a prompt, before it reaches Claude. Can block the expansion |

469| `PermissionDenied` | When a tool call is denied by the auto mode classifier. Return `{retry: true}` to tell the model it may retry the denied tool call |469| `PermissionDenied` | When a tool call is denied by the auto mode classifier. Return `{retry: true}` to tell the model it may retry the denied tool call |

plugins-reference.md +1 −1

Details

126| `UserPromptExpansion` | When a user-typed command expands into a prompt, before it reaches Claude. Can block the expansion |126| `UserPromptExpansion` | When a user-typed command expands into a prompt, before it reaches Claude. Can block the expansion |

129| `PermissionDenied` | When a tool call is denied by the auto mode classifier. Return `{retry: true}` to tell the model it may retry the denied tool call |129| `PermissionDenied` | When a tool call is denied by the auto mode classifier. Return `{retry: true}` to tell the model it may retry the denied tool call |

Documentation 2026-07-27 21:02 UTC to 2026-07-28 23:57 UTC