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 lit les instructions, les paramètres, les skills, les subagents et la mémoire à partir de votre répertoire de projet et de `~/.claude` dans votre répertoire personnel. Validez les fichiers du projet dans git pour les partager avec votre équipe ; les fichiers dans `~/.claude` sont une configuration personnelle qui s'applique à tous vos projets.1433Claude Code lit les instructions, les paramètres, les skills, les subagents et la mémoire à partir de votre répertoire de projet et de `~/.claude` dans votre répertoire personnel. Validez les fichiers du projet dans git pour les partager avec votre équipe ; les fichiers dans `~/.claude` sont une configuration personnelle qui s'applique à tous vos projets.
1434 1434
14351435Sur Windows, `~/.claude` se résout en `%USERPROFILE%\.claude`. Si vous définissez [`CLAUDE_CONFIG_DIR`](/fr/env-vars), chaque chemin `~/.claude` sur cette page se trouve sous ce répertoire à la place.Sur Windows, `~/.claude` se résout en `%USERPROFILE%\.claude`. Si vous définissez [`CLAUDE_CONFIG_DIR`](/docs/fr/env-vars), chaque chemin `~/.claude` sur cette page se trouve sous ce répertoire à la place.
1436 1436
1437La plupart des utilisateurs ne modifient que `CLAUDE.md` et `settings.json`. Le reste du répertoire est optionnel : ajoutez des skills, des rules ou des subagents selon vos besoins.1437La plupart des utilisateurs ne modifient que `CLAUDE.md` et `settings.json`. Le reste du répertoire est optionnel : ajoutez des skills, des rules ou des subagents selon vos besoins.
1438 1438
1452 1452
1453| Fichier | Emplacement | Objectif |1453| Fichier | Emplacement | Objectif |
1454| ----------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1454| ----------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
14551455| `managed-settings.json` | Au niveau du système, varie selon le système d'exploitation | Paramètres appliqués par l'entreprise que vous ne pouvez pas remplacer. Consultez [paramètres gérés par le serveur](/fr/server-managed-settings). || `managed-settings.json` | Au niveau du système, varie selon le système d'exploitation | Paramètres appliqués par l'entreprise que vous ne pouvez pas remplacer. Consultez [paramètres gérés par le serveur](/docs/fr/server-managed-settings). |
1456| `CLAUDE.local.md` | Racine du projet | Vos préférences privées pour ce projet, chargées aux côtés de CLAUDE.md. Créez-le manuellement et ajoutez-le à `.gitignore`. |1456| `CLAUDE.local.md` | Racine du projet | Vos préférences privées pour ce projet, chargées aux côtés de CLAUDE.md. Créez-le manuellement et ajoutez-le à `.gitignore`. |
14571457| Plugins installés | `~/.claude/plugins` | Marchés clonés, versions de plugins installées et données par plugin, gérées par les commandes `claude plugin`. Les versions orphelines sont supprimées 7 jours après une mise à jour ou une désinstallation de plugin. Consultez [mise en cache des plugins](/fr/plugins-reference#plugin-caching-and-file-resolution). || Plugins installés | `~/.claude/plugins` | Marchés clonés, versions de plugins installées et données par plugin, gérées par les commandes `claude plugin`. Les versions orphelines sont supprimées 7 jours après une mise à jour ou une désinstallation de plugin. Consultez [mise en cache des plugins](/docs/fr/plugins-reference#plugin-caching-and-file-resolution). |
1458 1458
1459`~/.claude` contient également les données que Claude Code écrit au fur et à mesure que vous travaillez : transcriptions, historique des invites, instantanés de fichiers, caches et journaux. Consultez [données d'application](#application-data) ci-dessous.1459`~/.claude` contient également les données que Claude Code écrit au fur et à mesure que vous travaillez : transcriptions, historique des invites, instantanés de fichiers, caches et journaux. Consultez [données d'application](#application-data) ci-dessous.
1460 1460
1466 1466
1467| Vous voulez | Modifier | Portée | Référence |1467| Vous voulez | Modifier | Portée | Référence |
1468| :---------------------------------------------------------------- | :--------------------------------------- | :---------------- | :---------------------------------------------------- |1468| :---------------------------------------------------------------- | :--------------------------------------- | :---------------- | :---------------------------------------------------- |
14691469| Donner à Claude le contexte et les conventions du projet | `CLAUDE.md` | projet ou global | [Mémoire](/fr/memory) || Donner à Claude le contexte et les conventions du projet | `CLAUDE.md` | projet ou global | [Mémoire](/docs/fr/memory) |
14701470| Autoriser ou bloquer des appels d'outils spécifiques | `settings.json` `permissions` ou `hooks` | projet ou global | [Permissions](/fr/permissions), [Hooks](/fr/hooks) || Autoriser ou bloquer des appels d'outils spécifiques | `settings.json` `permissions` ou `hooks` | projet ou global | [Permissions](/docs/fr/permissions), [Hooks](/docs/fr/hooks) |
14711471| Exécuter un script avant ou après les appels d'outils | `settings.json` `hooks` | projet ou global | [Hooks](/fr/hooks) || Exécuter un script avant ou après les appels d'outils | `settings.json` `hooks` | projet ou global | [Hooks](/docs/fr/hooks) |
14721472| Définir les variables d'environnement pour la session | `settings.json` `env` | projet ou global | [Paramètres](/fr/settings#available-settings) || Définir les variables d'environnement pour la session | `settings.json` `env` | projet ou global | [Paramètres](/docs/fr/settings#available-settings) |
14731473| Garder les remplacements personnels hors de git | `settings.local.json` | projet uniquement | [Portées des paramètres](/fr/settings#settings-files) || Garder les remplacements personnels hors de git | `settings.local.json` | projet uniquement | [Portées des paramètres](/docs/fr/settings#settings-files) |
14741474| Ajouter une invite ou une capacité que vous invoquez avec `/name` | `skills/<name>/SKILL.md` | projet ou global | [Skills](/fr/skills) || Ajouter une invite ou une capacité que vous invoquez avec `/name` | `skills/<name>/SKILL.md` | projet ou global | [Skills](/docs/fr/skills) |
14751475| Définir un subagent spécialisé avec ses propres outils | `agents/*.md` | projet ou global | [Subagents](/fr/sub-agents) || Définir un subagent spécialisé avec ses propres outils | `agents/*.md` | projet ou global | [Subagents](/docs/fr/sub-agents) |
14761476| Orchestrer de nombreux subagents à partir d'un script | `workflows/*.js` | projet ou global | [Workflows dynamiques](/fr/workflows) || Orchestrer de nombreux subagents à partir d'un script | `workflows/*.js` | projet ou global | [Workflows dynamiques](/docs/fr/workflows) |
14771477| Connecter des outils externes via MCP | `.mcp.json` | projet uniquement | [MCP](/fr/mcp) || Connecter des outils externes via MCP | `.mcp.json` | projet uniquement | [MCP](/docs/fr/mcp) |
14781478| Modifier la façon dont Claude formate les réponses | `output-styles/*.md` | projet ou global | [Styles de sortie](/fr/output-styles) || Modifier la façon dont Claude formate les réponses | `output-styles/*.md` | projet ou global | [Styles de sortie](/docs/fr/output-styles) |
1479 1479
1480<h2 id="file-reference">1480<h2 id="file-reference">
1481 Référence des fichiers1481 Référence des fichiers
1486<Note>1486<Note>
1487 Plusieurs choses peuvent remplacer ce que vous mettez dans ces fichiers :1487 Plusieurs choses peuvent remplacer ce que vous mettez dans ces fichiers :
1488 1488
14891489 * [Les paramètres gérés](/fr/server-managed-settings) déployés par votre organisation ont la priorité sur tout * [Les paramètres gérés](/docs/fr/server-managed-settings) déployés par votre organisation ont la priorité sur tout
1490 * Les flags CLI comme `--permission-mode` ou `--settings` remplacent `settings.json` pour cette session1490 * Les flags CLI comme `--permission-mode` ou `--settings` remplacent `settings.json` pour cette session
14911491 * Certaines variables d'environnement ont la priorité sur leur paramètre équivalent, mais cela varie : consultez la [référence des variables d'environnement](/fr/env-vars) pour chacune * Certaines variables d'environnement ont la priorité sur leur paramètre équivalent, mais cela varie : consultez la [référence des variables d'environnement](/docs/fr/env-vars) pour chacune
1492 1492
14931493 Consultez [précédence des paramètres](/fr/settings#settings-precedence) pour l'ordre complet. Consultez [précédence des paramètres](/docs/fr/settings#settings-precedence) pour l'ordre complet.
1494</Note>1494</Note>
1495 1495
1496Cliquez sur un nom de fichier pour ouvrir ce nœud dans l'explorateur ci-dessus.1496Cliquez sur un nom de fichier pour ouvrir ce nœud dans l'explorateur ci-dessus.
1497 1497
1498| Fichier | Portée | Valider | Ce qu'il fait | Référence |1498| Fichier | Portée | Valider | Ce qu'il fait | Référence |
1499| --------------------------------------------------- | ----------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |1499| --------------------------------------------------- | ----------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
15001500| [`CLAUDE.md`](#ce-claude-md) | Projet et global | ✓ | Instructions chargées à chaque session | [Mémoire](/fr/memory) || [`CLAUDE.md`](#ce-claude-md) | Projet et global | ✓ | Instructions chargées à chaque session | [Mémoire](/docs/fr/memory) |
15011501| [`rules/*.md`](#ce-rules) | Projet et global | ✓ | Instructions limitées à un sujet, optionnellement limitées par chemin | [Rules](/fr/memory#organize-rules-with-claude/rules/) || [`rules/*.md`](#ce-rules) | Projet et global | ✓ | Instructions limitées à un sujet, optionnellement limitées par chemin | [Rules](/docs/fr/memory#organize-rules-with-claude/rules/) |
15021502| [`settings.json`](#ce-settings-json) | Projet et global | ✓ | Permissions, hooks, variables d'environnement, paramètres par défaut du modèle | [Paramètres](/fr/settings) || [`settings.json`](#ce-settings-json) | Projet et global | ✓ | Permissions, hooks, variables d'environnement, paramètres par défaut du modèle | [Paramètres](/docs/fr/settings) |
15031503| [`settings.local.json`](#ce-settings-local-json) | Projet uniquement | | Vos remplacements personnels, auto-gitignorés | [Portées des paramètres](/fr/settings#settings-files) || [`settings.local.json`](#ce-settings-local-json) | Projet uniquement | | Vos remplacements personnels, auto-gitignorés | [Portées des paramètres](/docs/fr/settings#settings-files) |
15041504| [`.mcp.json`](#ce-mcp-json) | Projet uniquement | ✓ | Serveurs MCP partagés par l'équipe | [Portées MCP](/fr/mcp#mcp-installation-scopes) || [`.mcp.json`](#ce-mcp-json) | Projet uniquement | ✓ | Serveurs MCP partagés par l'équipe | [Portées MCP](/docs/fr/mcp#mcp-installation-scopes) |
15051505| [`.worktreeinclude`](#ce-worktreeinclude) | Projet uniquement | ✓ | Fichiers gitignorés à copier dans les nouveaux worktrees | [Worktrees](/fr/worktrees#copy-gitignored-files-into-worktrees) || [`.worktreeinclude`](#ce-worktreeinclude) | Projet uniquement | ✓ | Fichiers gitignorés à copier dans les nouveaux worktrees | [Worktrees](/docs/fr/worktrees#copy-gitignored-files-into-worktrees) |
15061506| [`skills/<name>/SKILL.md`](#ce-skills) | Projet et global | ✓ | Invites réutilisables invoquées avec `/name` ou auto-invoquées | [Skills](/fr/skills) || [`skills/<name>/SKILL.md`](#ce-skills) | Projet et global | ✓ | Invites réutilisables invoquées avec `/name` ou auto-invoquées | [Skills](/docs/fr/skills) |
15071507| [`commands/*.md`](#ce-commands) | Projet et global | ✓ | Invites sur un seul fichier ; même mécanisme que les skills | [Skills](/fr/skills) || [`commands/*.md`](#ce-commands) | Projet et global | ✓ | Invites sur un seul fichier ; même mécanisme que les skills | [Skills](/docs/fr/skills) |
15081508| [`output-styles/*.md`](#ce-output-styles) | Projet et global | ✓ | Sections de système-prompt personnalisées | [Styles de sortie](/fr/output-styles) || [`output-styles/*.md`](#ce-output-styles) | Projet et global | ✓ | Sections de système-prompt personnalisées | [Styles de sortie](/docs/fr/output-styles) |
15091509| [`agents/*.md`](#ce-agents) | Projet et global | ✓ | Définitions de subagents avec leur propre invite et outils | [Subagents](/fr/sub-agents) || [`agents/*.md`](#ce-agents) | Projet et global | ✓ | Définitions de subagents avec leur propre invite et outils | [Subagents](/docs/fr/sub-agents) |
15101510| [`workflows/*.js`](#ce-workflows) | Projet et global | ✓ | Scripts de flux de travail dynamiques écrits par Claude et enregistrés à partir de `/workflows` ; chaque fichier devient une commande `/<name>` | [Flux de travail dynamiques](/fr/workflows) || [`workflows/*.js`](#ce-workflows) | Projet et global | ✓ | Scripts de flux de travail dynamiques écrits par Claude et enregistrés à partir de `/workflows` ; chaque fichier devient une commande `/<name>` | [Flux de travail dynamiques](/docs/fr/workflows) |
15111511| [`agent-memory/<name>/`](#ce-agent-memory) | Projet et global | ✓ | Mémoire persistante pour les subagents | [Mémoire persistante](/fr/sub-agents#enable-persistent-memory) || [`agent-memory/<name>/`](#ce-agent-memory) | Projet et global | ✓ | Mémoire persistante pour les subagents | [Mémoire persistante](/docs/fr/sub-agents#enable-persistent-memory) |
15121512| [`~/.claude.json`](#ce-claude-json) | Global uniquement | | État de l'application, OAuth, bascules d'interface utilisateur, serveurs MCP personnels | [Configuration globale](/fr/settings#global-config-settings) || [`~/.claude.json`](#ce-claude-json) | Global uniquement | | État de l'application, OAuth, bascules d'interface utilisateur, serveurs MCP personnels | [Configuration globale](/docs/fr/settings#global-config-settings) |
15131513| [`projects/<project>/memory/`](#ce-global-projects) | Global uniquement | | Auto memory : notes de Claude à lui-même entre les sessions | [Auto memory](/fr/memory#auto-memory) || [`projects/<project>/memory/`](#ce-global-projects) | Global uniquement | | Auto memory : notes de Claude à lui-même entre les sessions | [Auto memory](/docs/fr/memory#auto-memory) |
15141514| [`keybindings.json`](#ce-keybindings) | Global uniquement | | Raccourcis clavier personnalisés | [Keybindings](/fr/keybindings) || [`keybindings.json`](#ce-keybindings) | Global uniquement | | Raccourcis clavier personnalisés | [Keybindings](/docs/fr/keybindings) |
15151515| [`themes/*.json`](#ce-themes) | Global uniquement | | Thèmes de couleurs personnalisés | [Thèmes personnalisés](/fr/terminal-config#create-a-custom-theme) || [`themes/*.json`](#ce-themes) | Global uniquement | | Thèmes de couleurs personnalisés | [Thèmes personnalisés](/docs/fr/terminal-config#create-a-custom-theme) |
1516 1516
1517<h2 id="troubleshoot-configuration">1517<h2 id="troubleshoot-configuration">
1518 Dépannez votre configuration1518 Dépannez votre configuration
1519</h2>1519</h2>
1520 1520
15211521Si un paramètre, un hook ou un fichier ne prend pas effet, consultez [Déboguez votre configuration](/fr/debug-your-config) pour les commandes d'inspection et un tableau de recherche basé sur les symptômes.Si un paramètre, un hook ou un fichier ne prend pas effet, consultez [Déboguez votre configuration](/docs/fr/debug-your-config) pour les commandes d'inspection et un tableau de recherche basé sur les symptômes.
1522 1522
1523<h2 id="application-data">1523<h2 id="application-data">
1524 Données d'application1524 Données d'application
1530 Nettoyés automatiquement1530 Nettoyés automatiquement
1531</h3>1531</h3>
1532 1532
15331533Les fichiers dans les chemins ci-dessous sont supprimés au démarrage une fois qu'ils sont plus anciens que [`cleanupPeriodDays`](/fr/settings#available-settings). La valeur par défaut est 30 jours.Les fichiers dans les chemins ci-dessous sont supprimés au démarrage une fois qu'ils sont plus anciens que [`cleanupPeriodDays`](/docs/fr/settings#available-settings). La valeur par défaut est 30 jours.
1534 1534
1535| Chemin sous `~/.claude/` | Contenu |1535| Chemin sous `~/.claude/` | Contenu |
1536| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1536| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1537| `projects/<project>/<session>.jsonl` | Transcription complète de la conversation : chaque message, appel d'outil et résultat d'outil |1537| `projects/<project>/<session>.jsonl` | Transcription complète de la conversation : chaque message, appel d'outil et résultat d'outil |
15381538| `projects/<project>/<session>/subagents/` | Transcriptions de conversation des [sous-agents](/fr/sub-agents), supprimées avec la transcription de session parente lorsqu'elle expire || `projects/<project>/<session>/subagents/` | Transcriptions de conversation des [sous-agents](/docs/fr/sub-agents), supprimées avec la transcription de session parente lorsqu'elle expire |
1539| `projects/<project>/<session>/tool-results/` | Les grandes sorties d'outils sont versées dans des fichiers séparés |1539| `projects/<project>/<session>/tool-results/` | Les grandes sorties d'outils sont versées dans des fichiers séparés |
15401540| `file-history/<session>/` | Instantanés pré-édition des fichiers que Claude a modifiés, utilisés pour [restauration de checkpoint](/fr/checkpointing). Contient des instantanés pour les 100 checkpoints les plus récents ; les fichiers d'instantanés auxquels aucun checkpoint conservé ne fait référence sont supprimés, sauf le premier instantané de chaque fichier || `file-history/<session>/` | Instantanés pré-édition des fichiers que Claude a modifiés, utilisés pour [restauration de checkpoint](/docs/fr/checkpointing). Contient des instantanés pour les 100 checkpoints les plus récents ; les fichiers d'instantanés auxquels aucun checkpoint conservé ne fait référence sont supprimés, sauf le premier instantané de chaque fichier |
15411541| `plans/` | Fichiers de plan écrits pendant le [mode plan](/fr/permission-modes#analyze-before-you-edit-with-plan-mode) || `plans/` | Fichiers de plan écrits pendant le [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode) |
1542| `debug/` | Journaux de débogage par session, écrits uniquement lorsque vous démarrez avec `--debug` ou exécutez `/debug` |1542| `debug/` | Journaux de débogage par session, écrits uniquement lorsque vous démarrez avec `--debug` ou exécutez `/debug` |
1543| `paste-cache/`, `image-cache/` | Contenu des grands collages et images jointes |1543| `paste-cache/`, `image-cache/` | Contenu des grands collages et images jointes |
1544| `session-env/` | Métadonnées d'environnement par session |1544| `session-env/` | Métadonnées d'environnement par session |
1545| `tasks/` | Listes de tâches par session écrites par les outils de tâche |1545| `tasks/` | Listes de tâches par session écrites par les outils de tâche |
15461546| `shell-snapshots/` | Alias, fonctions et options shell capturés au démarrage et appliqués par l'[outil Bash](/fr/tools-reference#bash-tool-behavior) à chaque commande. Supprimé à la fermeture correcte. Le balayage efface tout ce qui reste après un crash. || `shell-snapshots/` | Alias, fonctions et options shell capturés au démarrage et appliqués par l'[outil Bash](/docs/fr/tools-reference#bash-tool-behavior) à chaque commande. Supprimé à la fermeture correcte. Le balayage efface tout ce qui reste après un crash. |
1547| `backups/` | Copies horodatées de `~/.claude.json` prises avant les migrations de configuration |1547| `backups/` | Copies horodatées de `~/.claude.json` prises avant les migrations de configuration |
1548| `feedback-bundles/` | Archives de transcription expurgées écrites par `/feedback` sur les fournisseurs tiers ou lorsqu'aucune credential Anthropic n'est configurée, pour envoi à votre équipe de compte Anthropic |1548| `feedback-bundles/` | Archives de transcription expurgées écrites par `/feedback` sur les fournisseurs tiers ou lorsqu'aucune credential Anthropic n'est configurée, pour envoi à votre équipe de compte Anthropic |
1549| `todos/`, `statsig/`, `logs/` | Répertoires hérités des versions plus anciennes. Ne sont plus écrits. Le balayage supprime leur contenu puis le répertoire vide. |1549| `todos/`, `statsig/`, `logs/` | Répertoires hérités des versions plus anciennes. Ne sont plus écrits. Le balayage supprime leur contenu puis le répertoire vide. |
1558| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1558| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1559| `history.jsonl` | Chaque invite que vous avez tapée, avec horodatage et chemin du projet. Utilisé pour le rappel de la flèche vers le haut. |1559| `history.jsonl` | Chaque invite que vous avez tapée, avec horodatage et chemin du projet. Utilisé pour le rappel de la flèche vers le haut. |
1560| `stats-cache.json` | Nombres de tokens et de coûts agrégés affichés par `/usage` |1560| `stats-cache.json` | Nombres de tokens et de coûts agrégés affichés par `/usage` |
15611561| `remote-settings.json` | Copie en cache des [paramètres gérés par le serveur](/fr/server-managed-settings) pour votre organisation. Présent uniquement lorsque votre organisation les a configurés. Actualisé à chaque lancement. || `remote-settings.json` | Copie en cache des [paramètres gérés par le serveur](/docs/fr/server-managed-settings) pour votre organisation. Présent uniquement lorsque votre organisation les a configurés. Actualisé à chaque lancement. |
1562 1562
1563D'autres petits fichiers de cache et de verrouillage apparaissent selon les fonctionnalités que vous utilisez et peuvent être supprimés en toute sécurité.1563D'autres petits fichiers de cache et de verrouillage apparaissent selon les fonctionnalités que vous utilisez et peuvent être supprimés en toute sécurité.
1564 1564
1569Les transcriptions et l'historique ne sont pas chiffrés au repos. Les permissions de fichiers du système d'exploitation sont la seule protection. Si un outil lit un fichier `.env` ou qu'une commande imprime une credential, cette valeur est écrite dans `projects/<project>/<session>.jsonl`. Pour réduire l'exposition :1569Les transcriptions et l'historique ne sont pas chiffrés au repos. Les permissions de fichiers du système d'exploitation sont la seule protection. Si un outil lit un fichier `.env` ou qu'une commande imprime une credential, cette valeur est écrite dans `projects/<project>/<session>.jsonl`. Pour réduire l'exposition :
1570 1570
1571* Réduisez `cleanupPeriodDays` pour raccourcir la durée de conservation des transcriptions1571* Réduisez `cleanupPeriodDays` pour raccourcir la durée de conservation des transcriptions
15721572* Définissez la variable d'environnement [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/fr/env-vars) pour ignorer l'écriture des transcriptions et de l'historique des invites dans n'importe quel mode. En mode non interactif, vous pouvez à la place passer `--no-session-persistence` aux côtés de `-p`, ou définir `persistSession: false` dans le SDK Agent.* Définissez la variable d'environnement [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/fr/env-vars) pour ignorer l'écriture des transcriptions et de l'historique des invites dans n'importe quel mode. En mode non interactif, vous pouvez à la place passer `--no-session-persistence` aux côtés de `-p`, ou définir `persistSession: false` dans le SDK Agent.
15731573* Utilisez les [règles de permissions](/fr/permissions) pour refuser les lectures des fichiers de credentials* Utilisez les [règles de permissions](/docs/fr/permissions) pour refuser les lectures des fichiers de credentials
1574 1574
1575<h3 id="clear-local-data">1575<h3 id="clear-local-data">
1576 Effacer les données locales1576 Effacer les données locales
1627 Ressources connexes1627 Ressources connexes
1628</h2>1628</h2>
1629 1629
16301630* [Gérez la mémoire de Claude](/fr/memory) : écrivez et organisez CLAUDE.md, rules et auto memory* [Gérez la mémoire de Claude](/docs/fr/memory) : écrivez et organisez CLAUDE.md, rules et auto memory
16311631* [Configurez les paramètres](/fr/settings) : définissez les permissions, hooks, variables d'environnement et paramètres par défaut du modèle* [Configurez les paramètres](/docs/fr/settings) : définissez les permissions, hooks, variables d'environnement et paramètres par défaut du modèle
16321632* [Créez des skills](/fr/skills) : créez des invites et des workflows réutilisables* [Créez des skills](/docs/fr/skills) : créez des invites et des workflows réutilisables
16331633* [Configurez les subagents](/fr/sub-agents) : définissez des agents spécialisés avec leur propre contexte* [Configurez les subagents](/docs/fr/sub-agents) : définissez des agents spécialisés avec leur propre contexte