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 lê instruções, configurações, skills, subagents e memória do seu diretório de projeto e de `~/.claude` em seu diretório home. Confirme arquivos de projeto no git para compartilhá-los com sua equipe; arquivos em `~/.claude` são configuração pessoal que se aplica em todos os seus projetos.1433Claude Code lê instruções, configurações, skills, subagents e memória do seu diretório de projeto e de `~/.claude` em seu diretório home. Confirme arquivos de projeto no git para compartilhá-los com sua equipe; arquivos em `~/.claude` são configuração pessoal que se aplica em todos os seus projetos.
1434 1434
14351435No Windows, `~/.claude` é resolvido para `%USERPROFILE%\.claude`. Se você definir [`CLAUDE_CONFIG_DIR`](/pt/env-vars), cada caminho `~/.claude` nesta página fica sob esse diretório.No Windows, `~/.claude` é resolvido para `%USERPROFILE%\.claude`. Se você definir [`CLAUDE_CONFIG_DIR`](/docs/pt/env-vars), cada caminho `~/.claude` nesta página fica sob esse diretório.
1436 1436
1437A maioria dos usuários apenas edita `CLAUDE.md` e `settings.json`. O resto do diretório é opcional: adicione skills, rules ou subagents conforme necessário.1437A maioria dos usuários apenas edita `CLAUDE.md` e `settings.json`. O resto do diretório é opcional: adicione skills, rules ou subagents conforme necessário.
1438 1438
1452 1452
1453| Arquivo | Localização | Propósito |1453| Arquivo | Localização | Propósito |
1454| ----------------------- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1454| ----------------------- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
14551455| `managed-settings.json` | Nível do sistema, varia por SO | Configurações impostas pela empresa que você não pode substituir. Veja [configurações gerenciadas pelo servidor](/pt/server-managed-settings). || `managed-settings.json` | Nível do sistema, varia por SO | Configurações impostas pela empresa que você não pode substituir. Veja [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings). |
1456| `CLAUDE.local.md` | Raiz do projeto | Suas preferências privadas para este projeto, carregadas junto com CLAUDE.md. Crie manualmente e adicione a `.gitignore`. |1456| `CLAUDE.local.md` | Raiz do projeto | Suas preferências privadas para este projeto, carregadas junto com CLAUDE.md. Crie manualmente e adicione a `.gitignore`. |
14571457| Plugins instalados | `~/.claude/plugins` | Marketplaces clonados, versões de plugins instalados e dados por plugin, gerenciados por comandos `claude plugin`. Versões órfãs são deletadas 7 dias após uma atualização ou desinstalação de plugin. Veja [cache de plugins](/pt/plugins-reference#plugin-caching-and-file-resolution). || Plugins instalados | `~/.claude/plugins` | Marketplaces clonados, versões de plugins instalados e dados por plugin, gerenciados por comandos `claude plugin`. Versões órfãs são deletadas 7 dias após uma atualização ou desinstalação de plugin. Veja [cache de plugins](/docs/pt/plugins-reference#plugin-caching-and-file-resolution). |
1458 1458
1459`~/.claude` também contém dados que Claude Code escreve conforme você trabalha: transcrições, histórico de prompts, snapshots de arquivos, caches e logs. Veja [dados da aplicação](#application-data) abaixo.1459`~/.claude` também contém dados que Claude Code escreve conforme você trabalha: transcrições, histórico de prompts, snapshots de arquivos, caches e logs. Veja [dados da aplicação](#application-data) abaixo.
1460 1460
1466 1466
1467| Você quer | Editar | Escopo | Referência |1467| Você quer | Editar | Escopo | Referência |
1468| :-------------------------------------------------------------- | :--------------------------------------- | :---------------- | :------------------------------------------------------ |1468| :-------------------------------------------------------------- | :--------------------------------------- | :---------------- | :------------------------------------------------------ |
14691469| Dar a Claude contexto e convenções do projeto | `CLAUDE.md` | projeto ou global | [Memory](/pt/memory) || Dar a Claude contexto e convenções do projeto | `CLAUDE.md` | projeto ou global | [Memory](/docs/pt/memory) |
14701470| Permitir ou bloquear chamadas de ferramentas específicas | `settings.json` `permissions` ou `hooks` | projeto ou global | [Permissions](/pt/permissions), [Hooks](/pt/hooks) || Permitir ou bloquear chamadas de ferramentas específicas | `settings.json` `permissions` ou `hooks` | projeto ou global | [Permissions](/docs/pt/permissions), [Hooks](/docs/pt/hooks) |
14711471| Executar um script antes ou depois de chamadas de ferramentas | `settings.json` `hooks` | projeto ou global | [Hooks](/pt/hooks) || Executar um script antes ou depois de chamadas de ferramentas | `settings.json` `hooks` | projeto ou global | [Hooks](/docs/pt/hooks) |
14721472| Definir variáveis de ambiente para a sessão | `settings.json` `env` | projeto ou global | [Settings](/pt/settings#available-settings) || Definir variáveis de ambiente para a sessão | `settings.json` `env` | projeto ou global | [Settings](/docs/pt/settings#available-settings) |
14731473| Manter substituições pessoais fora do git | `settings.local.json` | apenas projeto | [Escopos de configurações](/pt/settings#settings-files) || Manter substituições pessoais fora do git | `settings.local.json` | apenas projeto | [Escopos de configurações](/docs/pt/settings#settings-files) |
14741474| Adicionar um prompt ou capacidade que você invoca com `/name` | `skills/<name>/SKILL.md` | projeto ou global | [Skills](/pt/skills) || Adicionar um prompt ou capacidade que você invoca com `/name` | `skills/<name>/SKILL.md` | projeto ou global | [Skills](/docs/pt/skills) |
14751475| Definir um subagent especializado com suas próprias ferramentas | `agents/*.md` | projeto ou global | [Subagents](/pt/sub-agents) || Definir um subagent especializado com suas próprias ferramentas | `agents/*.md` | projeto ou global | [Subagents](/docs/pt/sub-agents) |
14761476| Orquestrar muitos subagents a partir de um script | `workflows/*.js` | projeto ou global | [Dynamic workflows](/pt/workflows) || Orquestrar muitos subagents a partir de um script | `workflows/*.js` | projeto ou global | [Dynamic workflows](/docs/pt/workflows) |
14771477| Conectar ferramentas externas sobre MCP | `.mcp.json` | apenas projeto | [MCP](/pt/mcp) || Conectar ferramentas externas sobre MCP | `.mcp.json` | apenas projeto | [MCP](/docs/pt/mcp) |
14781478| Mudar como Claude formata respostas | `output-styles/*.md` | projeto ou global | [Output styles](/pt/output-styles) || Mudar como Claude formata respostas | `output-styles/*.md` | projeto ou global | [Output styles](/docs/pt/output-styles) |
1479 1479
1480<h2 id="file-reference">1480<h2 id="file-reference">
1481 Referência de arquivos1481 Referência de arquivos
1486<Note>1486<Note>
1487 Várias coisas podem substituir o que você coloca nesses arquivos:1487 Várias coisas podem substituir o que você coloca nesses arquivos:
1488 1488
14891489 * [Configurações gerenciadas](/pt/server-managed-settings) implantadas por sua organização têm precedência sobre tudo * [Configurações gerenciadas](/docs/pt/server-managed-settings) implantadas por sua organização têm precedência sobre tudo
1490 * Flags CLI como `--permission-mode` ou `--settings` substituem `settings.json` para essa sessão1490 * Flags CLI como `--permission-mode` ou `--settings` substituem `settings.json` para essa sessão
14911491 * Algumas variáveis de ambiente têm precedência sobre sua configuração equivalente, mas isso varia: verifique a [referência de variáveis de ambiente](/pt/env-vars) para cada uma * Algumas variáveis de ambiente têm precedência sobre sua configuração equivalente, mas isso varia: verifique a [referência de variáveis de ambiente](/docs/pt/env-vars) para cada uma
1492 1492
14931493 Veja [precedência de configurações](/pt/settings#settings-precedence) para a ordem completa. Veja [precedência de configurações](/docs/pt/settings#settings-precedence) para a ordem completa.
1494</Note>1494</Note>
1495 1495
1496Clique em um nome de arquivo para abrir esse nó no explorador acima.1496Clique em um nome de arquivo para abrir esse nó no explorador acima.
1497 1497
1498| Arquivo | Escopo | Confirmar | O que faz | Referência |1498| Arquivo | Escopo | Confirmar | O que faz | Referência |
1499| --------------------------------------------------- | ---------------- | --------- | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |1499| --------------------------------------------------- | ---------------- | --------- | ---------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
15001500| [`CLAUDE.md`](#ce-claude-md) | Projeto e global | ✓ | Instruções carregadas a cada sessão | [Memory](/pt/memory) || [`CLAUDE.md`](#ce-claude-md) | Projeto e global | ✓ | Instruções carregadas a cada sessão | [Memory](/docs/pt/memory) |
15011501| [`rules/*.md`](#ce-rules) | Projeto e global | ✓ | Instruções com escopo de tópico, opcionalmente com gate de caminho | [Rules](/pt/memory#organize-rules-with-claude/rules/) || [`rules/*.md`](#ce-rules) | Projeto e global | ✓ | Instruções com escopo de tópico, opcionalmente com gate de caminho | [Rules](/docs/pt/memory#organize-rules-with-claude/rules/) |
15021502| [`settings.json`](#ce-settings-json) | Projeto e global | ✓ | Permissões, hooks, variáveis de env, padrões de modelo | [Settings](/pt/settings) || [`settings.json`](#ce-settings-json) | Projeto e global | ✓ | Permissões, hooks, variáveis de env, padrões de modelo | [Settings](/docs/pt/settings) |
15031503| [`settings.local.json`](#ce-settings-local-json) | Apenas projeto | | Suas substituições pessoais, auto-gitignored | [Escopos de configurações](/pt/settings#settings-files) || [`settings.local.json`](#ce-settings-local-json) | Apenas projeto | | Suas substituições pessoais, auto-gitignored | [Escopos de configurações](/docs/pt/settings#settings-files) |
15041504| [`.mcp.json`](#ce-mcp-json) | Apenas projeto | ✓ | Servidores MCP compartilhados pela equipe | [Escopos MCP](/pt/mcp#mcp-installation-scopes) || [`.mcp.json`](#ce-mcp-json) | Apenas projeto | ✓ | Servidores MCP compartilhados pela equipe | [Escopos MCP](/docs/pt/mcp#mcp-installation-scopes) |
15051505| [`.worktreeinclude`](#ce-worktreeinclude) | Apenas projeto | ✓ | Arquivos gitignored para copiar em novos worktrees | [Worktrees](/pt/worktrees#copy-gitignored-files-into-worktrees) || [`.worktreeinclude`](#ce-worktreeinclude) | Apenas projeto | ✓ | Arquivos gitignored para copiar em novos worktrees | [Worktrees](/docs/pt/worktrees#copy-gitignored-files-into-worktrees) |
15061506| [`skills/<name>/SKILL.md`](#ce-skills) | Projeto e global | ✓ | Prompts reutilizáveis invocados com `/name` ou auto-invocados | [Skills](/pt/skills) || [`skills/<name>/SKILL.md`](#ce-skills) | Projeto e global | ✓ | Prompts reutilizáveis invocados com `/name` ou auto-invocados | [Skills](/docs/pt/skills) |
15071507| [`commands/*.md`](#ce-commands) | Projeto e global | ✓ | Prompts de arquivo único; mesmo mecanismo que skills | [Skills](/pt/skills) || [`commands/*.md`](#ce-commands) | Projeto e global | ✓ | Prompts de arquivo único; mesmo mecanismo que skills | [Skills](/docs/pt/skills) |
15081508| [`output-styles/*.md`](#ce-output-styles) | Projeto e global | ✓ | Seções de prompt do sistema personalizadas | [Output styles](/pt/output-styles) || [`output-styles/*.md`](#ce-output-styles) | Projeto e global | ✓ | Seções de prompt do sistema personalizadas | [Output styles](/docs/pt/output-styles) |
15091509| [`agents/*.md`](#ce-agents) | Projeto e global | ✓ | Definições de subagents com seu próprio prompt e ferramentas | [Subagents](/pt/sub-agents) || [`agents/*.md`](#ce-agents) | Projeto e global | ✓ | Definições de subagents com seu próprio prompt e ferramentas | [Subagents](/docs/pt/sub-agents) |
15101510| [`workflows/*.js`](#ce-workflows) | Projeto e global | ✓ | Scripts de workflow dinâmicos escritos por Claude e salvos de `/workflows`; cada arquivo se torna um comando `/<name>` | [Dynamic workflows](/pt/workflows) || [`workflows/*.js`](#ce-workflows) | Projeto e global | ✓ | Scripts de workflow dinâmicos escritos por Claude e salvos de `/workflows`; cada arquivo se torna um comando `/<name>` | [Dynamic workflows](/docs/pt/workflows) |
15111511| [`agent-memory/<name>/`](#ce-agent-memory) | Projeto e global | ✓ | Memória persistente para subagents | [Memória persistente](/pt/sub-agents#enable-persistent-memory) || [`agent-memory/<name>/`](#ce-agent-memory) | Projeto e global | ✓ | Memória persistente para subagents | [Memória persistente](/docs/pt/sub-agents#enable-persistent-memory) |
15121512| [`~/.claude.json`](#ce-claude-json) | Apenas global | | Estado da aplicação, OAuth, toggles de UI, servidores MCP pessoais | [Configuração global](/pt/settings#global-config-settings) || [`~/.claude.json`](#ce-claude-json) | Apenas global | | Estado da aplicação, OAuth, toggles de UI, servidores MCP pessoais | [Configuração global](/docs/pt/settings#global-config-settings) |
15131513| [`projects/<project>/memory/`](#ce-global-projects) | Apenas global | | Auto memory: notas de Claude para si mesmo entre sessões | [Auto memory](/pt/memory#auto-memory) || [`projects/<project>/memory/`](#ce-global-projects) | Apenas global | | Auto memory: notas de Claude para si mesmo entre sessões | [Auto memory](/docs/pt/memory#auto-memory) |
15141514| [`keybindings.json`](#ce-keybindings) | Apenas global | | Atalhos de teclado personalizados | [Keybindings](/pt/keybindings) || [`keybindings.json`](#ce-keybindings) | Apenas global | | Atalhos de teclado personalizados | [Keybindings](/docs/pt/keybindings) |
15151515| [`themes/*.json`](#ce-themes) | Apenas global | | Temas de cores personalizados | [Temas personalizados](/pt/terminal-config#create-a-custom-theme) || [`themes/*.json`](#ce-themes) | Apenas global | | Temas de cores personalizados | [Temas personalizados](/docs/pt/terminal-config#create-a-custom-theme) |
1516 1516
1517<h2 id="troubleshoot-configuration">1517<h2 id="troubleshoot-configuration">
1518 Solucione problemas de configuração1518 Solucione problemas de configuração
1519</h2>1519</h2>
1520 1520
15211521Se uma configuração, hook ou arquivo não está tendo efeito, veja [Debug your configuration](/pt/debug-your-config) para os comandos de inspeção e uma tabela de busca por sintoma.Se uma configuração, hook ou arquivo não está tendo efeito, veja [Debug your configuration](/docs/pt/debug-your-config) para os comandos de inspeção e uma tabela de busca por sintoma.
1522 1522
1523<h2 id="application-data">1523<h2 id="application-data">
1524 Dados da aplicação1524 Dados da aplicação
1530 Limpos automaticamente1530 Limpos automaticamente
1531</h3>1531</h3>
1532 1532
15331533Arquivos nos caminhos abaixo são deletados na inicialização uma vez que têm mais de [`cleanupPeriodDays`](/pt/settings#available-settings). O padrão é 30 dias.Arquivos nos caminhos abaixo são deletados na inicialização uma vez que têm mais de [`cleanupPeriodDays`](/docs/pt/settings#available-settings). O padrão é 30 dias.
1534 1534
1535| Caminho sob `~/.claude/` | Conteúdo |1535| Caminho sob `~/.claude/` | Conteúdo |
1536| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1536| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1537| `projects/<project>/<session>.jsonl` | Transcrição de conversa completa: cada mensagem, chamada de ferramenta e resultado de ferramenta |1537| `projects/<project>/<session>.jsonl` | Transcrição de conversa completa: cada mensagem, chamada de ferramenta e resultado de ferramenta |
15381538| `projects/<project>/<session>/subagents/` | Transcrições de conversa de [subagent](/pt/sub-agents), removidas com a transcrição de sessão pai quando envelhecem || `projects/<project>/<session>/subagents/` | Transcrições de conversa de [subagent](/docs/pt/sub-agents), removidas com a transcrição de sessão pai quando envelhecem |
1539| `projects/<project>/<session>/tool-results/` | Grandes saídas de ferramentas derramadas em arquivos separados |1539| `projects/<project>/<session>/tool-results/` | Grandes saídas de ferramentas derramadas em arquivos separados |
15401540| `file-history/<session>/` | Snapshots pré-edição de arquivos que Claude alterou, usados para [restauração de checkpoint](/pt/checkpointing). Mantém snapshots para os 100 checkpoints mais recentes; arquivos de snapshot que nenhum checkpoint retido referencia são deletados, exceto o primeiro snapshot de cada arquivo || `file-history/<session>/` | Snapshots pré-edição de arquivos que Claude alterou, usados para [restauração de checkpoint](/docs/pt/checkpointing). Mantém snapshots para os 100 checkpoints mais recentes; arquivos de snapshot que nenhum checkpoint retido referencia são deletados, exceto o primeiro snapshot de cada arquivo |
15411541| `plans/` | Arquivos de plano escritos durante [plan mode](/pt/permission-modes#analyze-before-you-edit-with-plan-mode) || `plans/` | Arquivos de plano escritos durante [plan mode](/docs/pt/permission-modes#analyze-before-you-edit-with-plan-mode) |
1542| `debug/` | Logs de debug por sessão, escritos apenas quando você inicia com `--debug` ou executa `/debug` |1542| `debug/` | Logs de debug por sessão, escritos apenas quando você inicia com `--debug` ou executa `/debug` |
1543| `paste-cache/`, `image-cache/` | Conteúdo de pastes grandes e imagens anexadas |1543| `paste-cache/`, `image-cache/` | Conteúdo de pastes grandes e imagens anexadas |
1544| `session-env/` | Metadados de ambiente por sessão |1544| `session-env/` | Metadados de ambiente por sessão |
1545| `tasks/` | Listas de tarefas por sessão escritas pelas ferramentas de tarefa |1545| `tasks/` | Listas de tarefas por sessão escritas pelas ferramentas de tarefa |
15461546| `shell-snapshots/` | Aliases, funções e opções de shell capturadas na inicialização e aplicadas pela [ferramenta Bash](/pt/tools-reference#bash-tool-behavior) a cada comando. Removido na saída limpa. A limpeza remove qualquer um deixado após um crash. || `shell-snapshots/` | Aliases, funções e opções de shell capturadas na inicialização e aplicadas pela [ferramenta Bash](/docs/pt/tools-reference#bash-tool-behavior) a cada comando. Removido na saída limpa. A limpeza remove qualquer um deixado após um crash. |
1547| `backups/` | Cópias com timestamp de `~/.claude.json` tiradas antes de migrações de configuração |1547| `backups/` | Cópias com timestamp de `~/.claude.json` tiradas antes de migrações de configuração |
1548| `feedback-bundles/` | Arquivos de transcrição reduzidos escritos por `/feedback` em provedores de terceiros ou quando nenhuma credencial Anthropic está configurada, para enviar à sua equipe de conta Anthropic |1548| `feedback-bundles/` | Arquivos de transcrição reduzidos escritos por `/feedback` em provedores de terceiros ou quando nenhuma credencial Anthropic está configurada, para enviar à sua equipe de conta Anthropic |
1549| `todos/`, `statsig/`, `logs/` | Diretórios legados de versões mais antigas. Não mais escritos. A limpeza remove seu conteúdo e depois o diretório vazio. |1549| `todos/`, `statsig/`, `logs/` | Diretórios legados de versões mais antigas. Não mais escritos. A limpeza remove seu conteúdo e depois o diretório vazio. |
1558| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1558| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
1559| `history.jsonl` | Cada prompt que você digitou, com timestamp e caminho do projeto. Usado para recall de seta para cima. |1559| `history.jsonl` | Cada prompt que você digitou, com timestamp e caminho do projeto. Usado para recall de seta para cima. |
1560| `stats-cache.json` | Contagens agregadas de token e custo mostradas por `/usage` |1560| `stats-cache.json` | Contagens agregadas de token e custo mostradas por `/usage` |
15611561| `remote-settings.json` | Cópia em cache de [configurações gerenciadas pelo servidor](/pt/server-managed-settings) para sua organização. Presente apenas quando sua organização as configurou. Atualizado em cada inicialização. || `remote-settings.json` | Cópia em cache de [configurações gerenciadas pelo servidor](/docs/pt/server-managed-settings) para sua organização. Presente apenas quando sua organização as configurou. Atualizado em cada inicialização. |
1562 1562
1563Outros arquivos pequenos de cache e lock aparecem dependendo de quais recursos você usa e são seguros para deletar.1563Outros arquivos pequenos de cache e lock aparecem dependendo de quais recursos você usa e são seguros para deletar.
1564 1564
1569Transcrições e histórico não são criptografados em repouso. Permissões de arquivo do SO são a única proteção. Se uma ferramenta lê um arquivo `.env` ou um comando imprime uma credencial, esse valor é escrito em `projects/<project>/<session>.jsonl`. Para reduzir exposição:1569Transcrições e histórico não são criptografados em repouso. Permissões de arquivo do SO são a única proteção. Se uma ferramenta lê um arquivo `.env` ou um comando imprime uma credencial, esse valor é escrito em `projects/<project>/<session>.jsonl`. Para reduzir exposição:
1570 1570
1571* Diminua `cleanupPeriodDays` para encurtar quanto tempo as transcrições são mantidas1571* Diminua `cleanupPeriodDays` para encurtar quanto tempo as transcrições são mantidas
15721572* Defina a variável de ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/pt/env-vars) para pular a escrita de transcrições e histórico de prompts em qualquer modo. Em modo não-interativo, você pode passar `--no-session-persistence` junto com `-p`, ou definir `persistSession: false` no Agent SDK.* Defina a variável de ambiente [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/pt/env-vars) para pular a escrita de transcrições e histórico de prompts em qualquer modo. Em modo não-interativo, você pode passar `--no-session-persistence` junto com `-p`, ou definir `persistSession: false` no Agent SDK.
15731573* Use [regras de permissão](/pt/permissions) para negar leituras de arquivos de credencial* Use [regras de permissão](/docs/pt/permissions) para negar leituras de arquivos de credencial
1574 1574
1575<h3 id="clear-local-data">1575<h3 id="clear-local-data">
1576 Limpar dados locais1576 Limpar dados locais
1627 Recursos relacionados1627 Recursos relacionados
1628</h2>1628</h2>
1629 1629
16301630* [Gerenciar memória de Claude](/pt/memory): escrever e organizar CLAUDE.md, rules e auto memory* [Gerenciar memória de Claude](/docs/pt/memory): escrever e organizar CLAUDE.md, rules e auto memory
16311631* [Configurar configurações](/pt/settings): definir permissões, hooks, variáveis de ambiente e padrões de modelo* [Configurar configurações](/docs/pt/settings): definir permissões, hooks, variáveis de ambiente e padrões de modelo
16321632* [Criar skills](/pt/skills): construir prompts e workflows reutilizáveis* [Criar skills](/docs/pt/skills): construir prompts e workflows reutilizáveis
16331633* [Configurar subagents](/pt/sub-agents): definir agentes especializados com seu próprio contexto* [Configurar subagents](/docs/pt/sub-agents): definir agentes especializados com seu próprio contexto