claude-directory.md +57 −57
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>, []);
2323 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.</>, []); 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.',
3737 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</>], 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',
6363 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></>, 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.</>,
8989 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></>], 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',
105105 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.', 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.',
116116 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/</>], 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',
149149 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.', 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.',
150150 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></>], 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</>,
168168 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>.</>], 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',
372372 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.</>, 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',
385385 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.</>, 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',
405405 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.</>, 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 legge istruzioni, impostazioni, skills, subagents e memoria dalla tua directory di progetto e da `~/.claude` nella tua home directory. Esegui il commit dei file di progetto su git per condividerli con il tuo team; i file in `~/.claude` sono configurazioni personali che si applicano a tutti i tuoi progetti.1433Claude Code legge istruzioni, impostazioni, skills, subagents e memoria dalla tua directory di progetto e da `~/.claude` nella tua home directory. Esegui il commit dei file di progetto su git per condividerli con il tuo team; i file in `~/.claude` sono configurazioni personali che si applicano a tutti i tuoi progetti.
1434 1434
14351435Su Windows, `~/.claude` si risolve in `%USERPROFILE%\.claude`. Se imposti [`CLAUDE_CONFIG_DIR`](/it/env-vars), ogni percorso `~/.claude` in questa pagina si trova invece in quella directory.Su Windows, `~/.claude` si risolve in `%USERPROFILE%\.claude`. Se imposti [`CLAUDE_CONFIG_DIR`](/docs/it/env-vars), ogni percorso `~/.claude` in questa pagina si trova invece in quella directory.
1436 1436
1437La maggior parte degli utenti modifica solo `CLAUDE.md` e `settings.json`. Il resto della directory è facoltativo: aggiungi skills, rules o subagents secondo le tue necessità.1437La maggior parte degli utenti modifica solo `CLAUDE.md` e `settings.json`. Il resto della directory è facoltativo: aggiungi skills, rules o subagents secondo le tue necessità.
1438 1438
1452 1452
1453| File | Posizione | Scopo |1453| File | Posizione | Scopo |
1454| ----------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1454| ----------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
14551455| `managed-settings.json` | A livello di sistema, varia in base al sistema operativo | Impostazioni applicate dall'azienda che non puoi ignorare. Vedi [impostazioni gestite dal server](/it/server-managed-settings). || `managed-settings.json` | A livello di sistema, varia in base al sistema operativo | Impostazioni applicate dall'azienda che non puoi ignorare. Vedi [impostazioni gestite dal server](/docs/it/server-managed-settings). |
1456| `CLAUDE.local.md` | Radice del progetto | Le tue preferenze private per questo progetto, caricate insieme a CLAUDE.md. Crealo manualmente e aggiungilo a `.gitignore`. |1456| `CLAUDE.local.md` | Radice del progetto | Le tue preferenze private per questo progetto, caricate insieme a CLAUDE.md. Crealo manualmente e aggiungilo a `.gitignore`. |
14571457| Plugin installati | `~/.claude/plugins` | Marketplace clonati, versioni plugin installate e dati per plugin, gestiti dai comandi `claude plugin`. Le versioni orfane vengono eliminate 7 giorni dopo un aggiornamento o disinstallazione del plugin. Vedi [plugin caching](/it/plugins-reference#plugin-caching-and-file-resolution). || Plugin installati | `~/.claude/plugins` | Marketplace clonati, versioni plugin installate e dati per plugin, gestiti dai comandi `claude plugin`. Le versioni orfane vengono eliminate 7 giorni dopo un aggiornamento o disinstallazione del plugin. Vedi [plugin caching](/docs/it/plugins-reference#plugin-caching-and-file-resolution). |
1458 1458
1459`~/.claude` contiene anche dati che Claude Code scrive mentre lavori: trascrizioni, cronologia dei prompt, snapshot dei file, cache e log. Vedi [dati dell'applicazione](#application-data) di seguito.1459`~/.claude` contiene anche dati che Claude Code scrive mentre lavori: trascrizioni, cronologia dei prompt, snapshot dei file, cache e log. Vedi [dati dell'applicazione](#application-data) di seguito.
1460 1460
1466 1466
1467| Vuoi | Modifica | Ambito | Riferimento |1467| Vuoi | Modifica | Ambito | Riferimento |
1468| :---------------------------------------------------------- | :-------------------------------------- | :----------------- | :------------------------------------------------- |1468| :---------------------------------------------------------- | :-------------------------------------- | :----------------- | :------------------------------------------------- |
14691469| Dare a Claude il contesto del progetto e le convenzioni | `CLAUDE.md` | progetto o globale | [Memory](/it/memory) || Dare a Claude il contesto del progetto e le convenzioni | `CLAUDE.md` | progetto o globale | [Memory](/docs/it/memory) |
14701470| Consentire o bloccare specifiche chiamate di strumenti | `settings.json` `permissions` o `hooks` | progetto o globale | [Permissions](/it/permissions), [Hooks](/it/hooks) || Consentire o bloccare specifiche chiamate di strumenti | `settings.json` `permissions` o `hooks` | progetto o globale | [Permissions](/docs/it/permissions), [Hooks](/docs/it/hooks) |
14711471| Eseguire uno script prima o dopo le chiamate di strumenti | `settings.json` `hooks` | progetto o globale | [Hooks](/it/hooks) || Eseguire uno script prima o dopo le chiamate di strumenti | `settings.json` `hooks` | progetto o globale | [Hooks](/docs/it/hooks) |
14721472| Impostare variabili di ambiente per la sessione | `settings.json` `env` | progetto o globale | [Settings](/it/settings#available-settings) || Impostare variabili di ambiente per la sessione | `settings.json` `env` | progetto o globale | [Settings](/docs/it/settings#available-settings) |
14731473| Mantenere gli override personali fuori da git | `settings.local.json` | solo progetto | [Settings scopes](/it/settings#settings-files) || Mantenere gli override personali fuori da git | `settings.local.json` | solo progetto | [Settings scopes](/docs/it/settings#settings-files) |
14741474| Aggiungere un prompt o una capacità che invochi con `/name` | `skills/<name>/SKILL.md` | progetto o globale | [Skills](/it/skills) || Aggiungere un prompt o una capacità che invochi con `/name` | `skills/<name>/SKILL.md` | progetto o globale | [Skills](/docs/it/skills) |
14751475| Definire un subagent specializzato con i suoi strumenti | `agents/*.md` | progetto o globale | [Subagents](/it/sub-agents) || Definire un subagent specializzato con i suoi strumenti | `agents/*.md` | progetto o globale | [Subagents](/docs/it/sub-agents) |
14761476| Orchestrare molti subagent da uno script | `workflows/*.js` | progetto o globale | [Dynamic workflows](/it/workflows) || Orchestrare molti subagent da uno script | `workflows/*.js` | progetto o globale | [Dynamic workflows](/docs/it/workflows) |
14771477| Connettere strumenti esterni su MCP | `.mcp.json` | solo progetto | [MCP](/it/mcp) || Connettere strumenti esterni su MCP | `.mcp.json` | solo progetto | [MCP](/docs/it/mcp) |
14781478| Cambiare il modo in cui Claude formatta le risposte | `output-styles/*.md` | progetto o globale | [Output styles](/it/output-styles) || Cambiare il modo in cui Claude formatta le risposte | `output-styles/*.md` | progetto o globale | [Output styles](/docs/it/output-styles) |
1479 1479
1480<h2 id="file-reference">1480<h2 id="file-reference">
1481 Riferimento dei file1481 Riferimento dei file
1486<Note>1486<Note>
1487 Diverse cose possono ignorare quello che metti in questi file:1487 Diverse cose possono ignorare quello che metti in questi file:
1488 1488
14891489 * Le [impostazioni gestite](/it/server-managed-settings) distribuite dalla tua organizzazione hanno la precedenza su tutto * Le [impostazioni gestite](/docs/it/server-managed-settings) distribuite dalla tua organizzazione hanno la precedenza su tutto
1490 * I flag CLI come `--permission-mode` o `--settings` ignorano `settings.json` per quella sessione1490 * I flag CLI come `--permission-mode` o `--settings` ignorano `settings.json` per quella sessione
14911491 * Alcune variabili di ambiente hanno la precedenza sulla loro impostazione equivalente, ma questo varia: controlla il [riferimento delle variabili di ambiente](/it/env-vars) per ciascuna * Alcune variabili di ambiente hanno la precedenza sulla loro impostazione equivalente, ma questo varia: controlla il [riferimento delle variabili di ambiente](/docs/it/env-vars) per ciascuna
1492 1492
14931493 Vedi [precedenza delle impostazioni](/it/settings#settings-precedence) per l'ordine completo. Vedi [precedenza delle impostazioni](/docs/it/settings#settings-precedence) per l'ordine completo.
1494</Note>1494</Note>
1495 1495
1496Fai clic su un nome di file per aprire quel nodo nell'explorer sopra.1496Fai clic su un nome di file per aprire quel nodo nell'explorer sopra.
1497 1497
1498| File | Ambito | Commit | Cosa fa | Riferimento |1498| File | Ambito | Commit | Cosa fa | Riferimento |
1499| --------------------------------------------------- | ------------------ | ------ | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |1499| --------------------------------------------------- | ------------------ | ------ | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
15001500| [`CLAUDE.md`](#ce-claude-md) | Progetto e globale | ✓ | Istruzioni caricate ogni sessione | [Memory](/it/memory) || [`CLAUDE.md`](#ce-claude-md) | Progetto e globale | ✓ | Istruzioni caricate ogni sessione | [Memory](/docs/it/memory) |
15011501| [`rules/*.md`](#ce-rules) | Progetto e globale | ✓ | Istruzioni con ambito di argomento, facoltativamente controllate dal percorso | [Rules](/it/memory#organize-rules-with-claude/rules/) || [`rules/*.md`](#ce-rules) | Progetto e globale | ✓ | Istruzioni con ambito di argomento, facoltativamente controllate dal percorso | [Rules](/docs/it/memory#organize-rules-with-claude/rules/) |
15021502| [`settings.json`](#ce-settings-json) | Progetto e globale | ✓ | Permessi, hooks, variabili di ambiente, impostazioni predefinite del modello | [Settings](/it/settings) || [`settings.json`](#ce-settings-json) | Progetto e globale | ✓ | Permessi, hooks, variabili di ambiente, impostazioni predefinite del modello | [Settings](/docs/it/settings) |
15031503| [`settings.local.json`](#ce-settings-local-json) | Solo progetto | | I tuoi override personali, auto-gitignored | [Settings scopes](/it/settings#settings-files) || [`settings.local.json`](#ce-settings-local-json) | Solo progetto | | I tuoi override personali, auto-gitignored | [Settings scopes](/docs/it/settings#settings-files) |
15041504| [`.mcp.json`](#ce-mcp-json) | Solo progetto | ✓ | Server MCP condivisi dal team | [MCP scopes](/it/mcp#mcp-installation-scopes) || [`.mcp.json`](#ce-mcp-json) | Solo progetto | ✓ | Server MCP condivisi dal team | [MCP scopes](/docs/it/mcp#mcp-installation-scopes) |
15051505| [`.worktreeinclude`](#ce-worktreeinclude) | Solo progetto | ✓ | File ignorati da git da copiare nei nuovi worktrees | [Worktrees](/it/worktrees#copy-gitignored-files-into-worktrees) || [`.worktreeinclude`](#ce-worktreeinclude) | Solo progetto | ✓ | File ignorati da git da copiare nei nuovi worktrees | [Worktrees](/docs/it/worktrees#copy-gitignored-files-into-worktrees) |
15061506| [`skills/<name>/SKILL.md`](#ce-skills) | Progetto e globale | ✓ | Prompt riutilizzabili invocati con `/name` o auto-invocati | [Skills](/it/skills) || [`skills/<name>/SKILL.md`](#ce-skills) | Progetto e globale | ✓ | Prompt riutilizzabili invocati con `/name` o auto-invocati | [Skills](/docs/it/skills) |
15071507| [`commands/*.md`](#ce-commands) | Progetto e globale | ✓ | Prompt a file singolo; stesso meccanismo delle skills | [Skills](/it/skills) || [`commands/*.md`](#ce-commands) | Progetto e globale | ✓ | Prompt a file singolo; stesso meccanismo delle skills | [Skills](/docs/it/skills) |
15081508| [`output-styles/*.md`](#ce-output-styles) | Progetto e globale | ✓ | Sezioni di prompt di sistema personalizzate | [Output styles](/it/output-styles) || [`output-styles/*.md`](#ce-output-styles) | Progetto e globale | ✓ | Sezioni di prompt di sistema personalizzate | [Output styles](/docs/it/output-styles) |
15091509| [`agents/*.md`](#ce-agents) | Progetto e globale | ✓ | Definizioni di subagent con il loro prompt e strumenti | [Subagents](/it/sub-agents) || [`agents/*.md`](#ce-agents) | Progetto e globale | ✓ | Definizioni di subagent con il loro prompt e strumenti | [Subagents](/docs/it/sub-agents) |
15101510| [`workflows/*.js`](#ce-workflows) | Progetto e globale | ✓ | Script di workflow dinamici scritti da Claude e salvati da `/workflows`; ogni file diventa un comando `/<name>` | [Dynamic workflows](/it/workflows) || [`workflows/*.js`](#ce-workflows) | Progetto e globale | ✓ | Script di workflow dinamici scritti da Claude e salvati da `/workflows`; ogni file diventa un comando `/<name>` | [Dynamic workflows](/docs/it/workflows) |
15111511| [`agent-memory/<name>/`](#ce-agent-memory) | Progetto e globale | ✓ | Memoria persistente per i subagents | [Persistent memory](/it/sub-agents#enable-persistent-memory) || [`agent-memory/<name>/`](#ce-agent-memory) | Progetto e globale | ✓ | Memoria persistente per i subagents | [Persistent memory](/docs/it/sub-agents#enable-persistent-memory) |
15121512| [`~/.claude.json`](#ce-claude-json) | Solo globale | | Stato dell'app, OAuth, toggle dell'interfaccia utente, server MCP personali | [Global config](/it/settings#global-config-settings) || [`~/.claude.json`](#ce-claude-json) | Solo globale | | Stato dell'app, OAuth, toggle dell'interfaccia utente, server MCP personali | [Global config](/docs/it/settings#global-config-settings) |
15131513| [`projects/<project>/memory/`](#ce-global-projects) | Solo globale | | Auto memory: note di Claude a se stesso tra le sessioni | [Auto memory](/it/memory#auto-memory) || [`projects/<project>/memory/`](#ce-global-projects) | Solo globale | | Auto memory: note di Claude a se stesso tra le sessioni | [Auto memory](/docs/it/memory#auto-memory) |
15141514| [`keybindings.json`](#ce-keybindings) | Solo globale | | Scorciatoie da tastiera personalizzate | [Keybindings](/it/keybindings) || [`keybindings.json`](#ce-keybindings) | Solo globale | | Scorciatoie da tastiera personalizzate | [Keybindings](/docs/it/keybindings) |
15151515| [`themes/*.json`](#ce-themes) | Solo globale | | Temi di colore personalizzati | [Custom themes](/it/terminal-config#create-a-custom-theme) || [`themes/*.json`](#ce-themes) | Solo globale | | Temi di colore personalizzati | [Custom themes](/docs/it/terminal-config#create-a-custom-theme) |
1516 1516
1517<h2 id="troubleshoot-configuration">1517<h2 id="troubleshoot-configuration">
1518 Risolvi i problemi di configurazione1518 Risolvi i problemi di configurazione
1519</h2>1519</h2>
1520 1520
15211521Se un'impostazione, un hook o un file non sta avendo effetto, vedi [Debug della tua configurazione](/it/debug-your-config) per i comandi di ispezione e una tabella di ricerca per sintomi.Se un'impostazione, un hook o un file non sta avendo effetto, vedi [Debug della tua configurazione](/docs/it/debug-your-config) per i comandi di ispezione e una tabella di ricerca per sintomi.
1522 1522
1523<h2 id="application-data">1523<h2 id="application-data">
1524 Dati dell'applicazione1524 Dati dell'applicazione
1530 Puliti automaticamente1530 Puliti automaticamente
1531</h3>1531</h3>
1532 1532
15331533I file nei percorsi di seguito vengono eliminati all'avvio una volta che sono più vecchi di [`cleanupPeriodDays`](/it/settings#available-settings). L'impostazione predefinita è 30 giorni.I file nei percorsi di seguito vengono eliminati all'avvio una volta che sono più vecchi di [`cleanupPeriodDays`](/docs/it/settings#available-settings). L'impostazione predefinita è 30 giorni.
1534 1534
1535| Percorso sotto `~/.claude/` | Contenuti |1535| Percorso sotto `~/.claude/` | Contenuti |
1536| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1536| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1537| `projects/<project>/<session>.jsonl` | Trascrizione della conversazione completa: ogni messaggio, chiamata di strumento e risultato dello strumento |1537| `projects/<project>/<session>.jsonl` | Trascrizione della conversazione completa: ogni messaggio, chiamata di strumento e risultato dello strumento |
15381538| `projects/<project>/<session>/subagents/` | Trascrizioni di conversazione [Subagent](/it/sub-agents), rimosse con la trascrizione della sessione padre quando scade || `projects/<project>/<session>/subagents/` | Trascrizioni di conversazione [Subagent](/docs/it/sub-agents), rimosse con la trascrizione della sessione padre quando scade |
1539| `projects/<project>/<session>/tool-results/` | Output di strumenti di grandi dimensioni versati in file separati |1539| `projects/<project>/<session>/tool-results/` | Output di strumenti di grandi dimensioni versati in file separati |
15401540| `file-history/<session>/` | Snapshot pre-modifica dei file che Claude ha modificato, utilizzati per il [ripristino del checkpoint](/it/checkpointing). Contiene snapshot per i 100 checkpoint più recenti; i file snapshot a cui nessun checkpoint conservato fa riferimento vengono eliminati, tranne il primo snapshot di ogni file || `file-history/<session>/` | Snapshot pre-modifica dei file che Claude ha modificato, utilizzati per il [ripristino del checkpoint](/docs/it/checkpointing). Contiene snapshot per i 100 checkpoint più recenti; i file snapshot a cui nessun checkpoint conservato fa riferimento vengono eliminati, tranne il primo snapshot di ogni file |
15411541| `plans/` | File di piano scritti durante la [Plan Mode](/it/permission-modes#analyze-before-you-edit-with-plan-mode) || `plans/` | File di piano scritti durante la [Plan Mode](/docs/it/permission-modes#analyze-before-you-edit-with-plan-mode) |
1542| `debug/` | Log di debug per sessione, scritti solo quando inizi con `--debug` o esegui `/debug` |1542| `debug/` | Log di debug per sessione, scritti solo quando inizi con `--debug` o esegui `/debug` |
1543| `paste-cache/`, `image-cache/` | Contenuti di incollamenti di grandi dimensioni e immagini allegate |1543| `paste-cache/`, `image-cache/` | Contenuti di incollamenti di grandi dimensioni e immagini allegate |
1544| `session-env/` | Metadati di ambiente per sessione |1544| `session-env/` | Metadati di ambiente per sessione |
1545| `tasks/` | Elenchi di attività per sessione scritti dagli strumenti di attività |1545| `tasks/` | Elenchi di attività per sessione scritti dagli strumenti di attività |
15461546| `shell-snapshots/` | Alias, funzioni e opzioni shell acquisiti all'avvio e applicati dallo [strumento Bash](/it/tools-reference#bash-tool-behavior) a ogni comando. Rimosso all'uscita pulita. La pulizia cancella qualsiasi cosa rimasta dopo un arresto anomalo. || `shell-snapshots/` | Alias, funzioni e opzioni shell acquisiti all'avvio e applicati dallo [strumento Bash](/docs/it/tools-reference#bash-tool-behavior) a ogni comando. Rimosso all'uscita pulita. La pulizia cancella qualsiasi cosa rimasta dopo un arresto anomalo. |
1547| `backups/` | Copie con timestamp di `~/.claude.json` prese prima delle migrazioni di configurazione |1547| `backups/` | Copie con timestamp di `~/.claude.json` prese prima delle migrazioni di configurazione |
1548| `feedback-bundles/` | Archivi di trascrizione redatti scritti da `/feedback` su provider di terze parti o quando nessuna credenziale Anthropic è configurata, per l'invio al tuo team di account Anthropic |1548| `feedback-bundles/` | Archivi di trascrizione redatti scritti da `/feedback` su provider di terze parti o quando nessuna credenziale Anthropic è configurata, per l'invio al tuo team di account Anthropic |
1549| `todos/`, `statsig/`, `logs/` | Directory legacy da versioni precedenti. Non più scritte. La pulizia rimuove i loro contenuti e poi la directory vuota. |1549| `todos/`, `statsig/`, `logs/` | Directory legacy da versioni precedenti. Non più scritte. La pulizia rimuove i loro contenuti e poi la directory vuota. |
1558| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1558| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1559| `history.jsonl` | Ogni prompt che hai digitato, con timestamp e percorso del progetto. Utilizzato per il richiamo con freccia su. |1559| `history.jsonl` | Ogni prompt che hai digitato, con timestamp e percorso del progetto. Utilizzato per il richiamo con freccia su. |
1560| `stats-cache.json` | Conteggi aggregati di token e costi mostrati da `/usage` |1560| `stats-cache.json` | Conteggi aggregati di token e costi mostrati da `/usage` |
15611561| `remote-settings.json` | Copia memorizzata nella cache delle [impostazioni gestite dal server](/it/server-managed-settings) per la tua organizzazione. Presente solo quando la tua organizzazione le ha configurate. Aggiornato ad ogni avvio. || `remote-settings.json` | Copia memorizzata nella cache delle [impostazioni gestite dal server](/docs/it/server-managed-settings) per la tua organizzazione. Presente solo quando la tua organizzazione le ha configurate. Aggiornato ad ogni avvio. |
1562 1562
1563Altri piccoli file di cache e lock appaiono a seconda delle funzioni che utilizzi e sono sicuri da eliminare.1563Altri piccoli file di cache e lock appaiono a seconda delle funzioni che utilizzi e sono sicuri da eliminare.
1564 1564
1569Le trascrizioni e la cronologia non sono crittografate a riposo. I permessi dei file del sistema operativo sono l'unica protezione. Se uno strumento legge un file `.env` o un comando stampa una credenziale, quel valore viene scritto in `projects/<project>/<session>.jsonl`. Per ridurre l'esposizione:1569Le trascrizioni e la cronologia non sono crittografate a riposo. I permessi dei file del sistema operativo sono l'unica protezione. Se uno strumento legge un file `.env` o un comando stampa una credenziale, quel valore viene scritto in `projects/<project>/<session>.jsonl`. Per ridurre l'esposizione:
1570 1570
1571* Abbassa `cleanupPeriodDays` per accorciare il tempo in cui le trascrizioni vengono conservate1571* Abbassa `cleanupPeriodDays` per accorciare il tempo in cui le trascrizioni vengono conservate
15721572* Imposta la variabile di ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/it/env-vars) per saltare la scrittura di trascrizioni e cronologia dei prompt in qualsiasi modalità. In modalità non interattiva, puoi invece passare `--no-session-persistence` insieme a `-p`, o impostare `persistSession: false` in Agent SDK.* Imposta la variabile di ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/it/env-vars) per saltare la scrittura di trascrizioni e cronologia dei prompt in qualsiasi modalità. In modalità non interattiva, puoi invece passare `--no-session-persistence` insieme a `-p`, o impostare `persistSession: false` in Agent SDK.
15731573* Usa le [regole di permesso](/it/permissions) per negare le letture dei file di credenziali* Usa le [regole di permesso](/docs/it/permissions) per negare le letture dei file di credenziali
1574 1574
1575<h3 id="clear-local-data">1575<h3 id="clear-local-data">
1576 Cancella dati locali1576 Cancella dati locali
1627 Risorse correlate1627 Risorse correlate
1628</h2>1628</h2>
1629 1629
16301630* [Gestisci la memoria di Claude](/it/memory): scrivi e organizza CLAUDE.md, rules e auto memory* [Gestisci la memoria di Claude](/docs/it/memory): scrivi e organizza CLAUDE.md, rules e auto memory
16311631* [Configura le impostazioni](/it/settings): imposta permessi, hooks, variabili di ambiente e impostazioni predefinite del modello* [Configura le impostazioni](/docs/it/settings): imposta permessi, hooks, variabili di ambiente e impostazioni predefinite del modello
16321632* [Crea skills](/it/skills): costruisci prompt e flussi di lavoro riutilizzabili* [Crea skills](/docs/it/skills): costruisci prompt e flussi di lavoro riutilizzabili
16331633* [Configura i subagents](/it/sub-agents): definisci agenti specializzati con il loro contesto* [Configura i subagents](/docs/it/sub-agents): definisci agenti specializzati con il loro contesto