SpyBara
Go Premium

claude-directory.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 85 additions and 84 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Sun 4 23:58 Mon 5 23:58 Tue 6 23:59 Wed 7 23:59 Wed 14 22:58 Fri 16 22:59 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Mon 26 22:57 Thu 29 23:57

Explore o diretório .claude

Onde Claude Code lê CLAUDE.md, settings.json, hooks, skills, commands, subagents, workflows, rules e auto memory. Explore o diretório .claude em seu projeto e ~/.claude em seu diretório home.

Claude 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.

No Windows, ~/.claude é resolvido para %USERPROFILE%\.claude. Se você definir CLAUDE_CONFIG_DIR, cada caminho ~/.claude nesta página fica sob esse diretório.

A maioria dos usuários apenas edita CLAUDE.md e settings.json. Se seu repositório já tiver um AGENTS.md para outros agentes de codificação, Claude Code pode lê-lo no lugar de um CLAUDE.md. O resto do diretório é opcional: adicione skills, regras ou subagentes conforme necessário.

Explore o diretório

Clique em arquivos na árvore para ver o que cada um faz, quando carrega e um exemplo.

O que não é mostrado

O explorador cobre arquivos que você cria e edita. Alguns arquivos relacionados vivem em outro lugar:

Arquivo Localização Propósito
managed-settings.json Nível do sistema, varia por SO Configurações impostas pela empresa que seus próprios arquivos de configuração e valores de --settings não podem sobrescrever, exceto por exceções limitadas. Veja onde salvar o arquivo e qual fonte gerenciada Claude Code usa.
CLAUDE.local.md Raiz do projeto Suas preferências privadas para este projeto, carregadas junto com CLAUDE.md. Crie manualmente e adicione a .gitignore.
AGENTS.md Raiz do projeto, .claude/, ou qualquer diretório Instruções do projeto que você escreve para agentes de codificação de IA. Claude Code pode carregá-lo no lugar de um CLAUDE.md.
Plugins instalados ~/.claude/plugins Marketplaces clonados, versões de plugins instalados, o registro de instalação installed_plugins.json e dados por plugin, gerenciados por comandos claude plugin. Plugins sincronizados da sua conta claude.ai são baixados em ~/.claude/plugins/synced/. Para um plugin instalado de um marketplace com fonte command em modo de link, Claude Code armazena links aqui em vez de uma cópia, e os arquivos do plugin permanecem no diretório que o comando imprime. Uma fonte command requer Claude Code v2.1.229 ou posterior. Um plugin listado por caminho relativo em um marketplace que você adicionou a partir de um caminho local também carrega no local a partir de seu diretório de origem, em vez de a partir de uma cópia em cache. Veja cache de plugins para saber como versões órfãs são limpas.

~/.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 abaixo.

Escolha o arquivo certo

Diferentes tipos de personalização vivem em arquivos diferentes. Use esta tabela para encontrar onde uma mudança pertence.

Você quer Editar Escopo Referência
Dar a Claude contexto e convenções do projeto CLAUDE.md projeto ou global Memory
Permitir ou bloquear chamadas de ferramentas específicas settings.json permissions ou hooks projeto ou global Permissions, Hooks
Executar um script antes ou depois de chamadas de ferramentas settings.json hooks projeto ou global Hooks
Definir variáveis de ambiente para a sessão settings.json env projeto ou global Settings
Manter substituições pessoais fora do git settings.local.json apenas projeto Escopos de configurações
Adicionar um prompt ou capacidade que você invoca com /name skills/<name>/SKILL.md projeto ou global Skills
Definir um subagent especializado com suas próprias ferramentas agents/*.md projeto ou global Subagents
Orquestrar muitos subagents a partir de um script workflows/*.js projeto ou global Dynamic workflows
Conectar ferramentas externas sobre MCP .mcp.json apenas projeto MCP
Mudar como Claude formata respostas output-styles/*.md projeto ou global Output styles

Referência de arquivos

Esta tabela lista todos os arquivos que o explorador abrange. Os arquivos de escopo de projeto ficam no seu repositório em .claude/ (ou na raiz, no caso de CLAUDE.md, .mcp.json e .worktreeinclude). Os arquivos de escopo global ficam em ~/.claude/ e se aplicam a todos os projetos.

[!NOTE]

Várias coisas podem sobrescrever o que você coloca nesses arquivos:

Consulte precedência de configurações para ver a ordem completa.

Clique no nome de um arquivo para abrir esse nó no explorador acima.

Arquivo Escopo Commit O que faz Referência
CLAUDE.md Projeto e global ✓ Instruções carregadas em todas as sessões Memória
rules/*.md Projeto e global ✓ Instruções restritas a um tópico, opcionalmente condicionadas a caminhos Regras
settings.json Projeto e global ✓ Permissões, hooks, variáveis de ambiente, padrões de modelo Configurações
settings.local.json Somente projeto Suas substituições pessoais, incluídas no gitignore quando o Claude Code salva uma configuração nele Escopos de configurações
.mcp.json Somente projeto ✓ Servidores MCP compartilhados pela equipe Escopos do MCP
.worktreeinclude Somente projeto ✓ Arquivos do gitignore a serem copiados para novos worktrees Worktrees
skills/<name>/SKILL.md Projeto e global ✓ Prompts reutilizáveis invocados com /name ou invocados automaticamente Skills
commands/*.md Projeto e global ✓ Prompts de arquivo único; mesmo mecanismo das skills Skills
output-styles/*.md Projeto e global ✓ Conjuntos de instruções personalizadas que ajustam a forma como o Claude trabalha Estilos de saída
agents/*.md Projeto e global ✓ Definições de subagentes com seu próprio prompt e suas próprias ferramentas Subagentes
workflows/*.js Projeto e global ✓ Scripts de fluxo de trabalho dinâmico escritos pelo Claude e salvos a partir de /workflows; cada arquivo se torna um comando /<name> Fluxos de trabalho dinâmicos
agent-memory/<name>/ Projeto e global ✓ Memória persistente para subagentes Memória persistente
~/.claude.json Somente global Estado do aplicativo, detalhes da conta, alternâncias de interface, servidores MCP pessoais Configuração global
projects/<project>/memory/ Somente global Memória automática: as anotações do Claude para si mesmo entre sessões Memória automática
keybindings.json Somente global Atalhos de teclado personalizados Atalhos de teclado
themes/*.json Somente global Temas de cores personalizados Temas personalizados

Campos de frontmatter por arquivo

Skills, arquivos de comando, subagentes, estilos de saída e regras leem sua configuração do YAML frontmatter no topo do arquivo, e cada um aceita seu próprio conjunto de campos. Esta tabela lista os nomes dos campos para cada arquivo e vincula à referência que os descreve.

Arquivo Campos de frontmatter Referência
skills/<name>/SKILL.md name, description, when_to_use, argument-hint, arguments, disable-model-invocation, user-invocable, allowed-tools, disallowed-tools, model, effort, context, agent, background, hooks, paths, shell, metadata, license, compatibility Frontmatter de skill
commands/*.md Os campos de skill exceto name e paths Frontmatter de skill
agents/*.md name, description, tools, disallowedTools, model, permissionMode, maxTurns, autoCompactWindow, skills, mcpServers, hooks, memory, background, effort, isolation, color, initialPrompt, omitClaudeMd, experimental Frontmatter de subagente
output-styles/*.md name, description, keep-coding-instructions, force-for-plugin Frontmatter de estilo de saída
rules/*.md paths Frontmatter de regra

Agentes fornecidos em um plugin honram um subconjunto dos campos de subagente.

Solucione problemas de configuração

Se uma configuração, hook ou arquivo não está tendo efeito, veja Debug your configuration para os comandos de inspeção e uma tabela de busca por sintoma.

Dados da aplicação

Além da configuração que você cria, ~/.claude contém dados que Claude Code escreve durante as sessões. Esses arquivos são texto simples. Qualquer coisa que passa por uma ferramenta é escrita em uma transcrição no disco: conteúdo de arquivos, saída de comandos, texto colado.

Limpeza automática

Claude Code deleta os arquivos nos caminhos abaixo uma vez que tenham mais de cleanupPeriodDays de idade, desde que possa determinar com segurança o período de retenção. O padrão é 30 dias e o mínimo é 1; definir 0 falha com um erro de validação. O mesmo limite de idade se aplica à remoção automática de worktrees órfãs.

Caminho sob ~/.claude/ Conteúdo
projects/<project>/<session>.jsonl Transcrição completa da conversa: cada mensagem, chamada de ferramenta e resultado de ferramenta
projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl, projects/<project>/<session>.jsonl.superseded-<timestamp> Uma transcrição anterior da sessão que Claude Code separou em vez de sobrescrever ou deletar. Não aparece no seletor de sessão
projects/<project>/<session>/subagents/ Transcrições de conversa de Subagent, removidas com a transcrição da sessão pai quando envelhece
projects/<project>/<session>/tool-results/ Grandes saídas de ferramentas derramadas em arquivos separados, e cópias em tamanho completo de imagens que ferramentas MCP retornam
projects/<project>/<session>/mcp-tasks/ O que uma sessão retomada precisa para acompanhar novamente suas tarefas MCP em execução, e os resultados de tarefas concluídas que Claude ainda não leu
file-history/<session>/ Snapshots pré-edição de arquivos que Claude alterou, usados para restauração de checkpoint. Contém snapshots dos 100 checkpoints mais recentes; arquivos de snapshot que nenhum checkpoint retido referencia são deletados, exceto o primeiro snapshot de cada arquivo
plans/ Arquivos de plano escritos durante plan mode
debug/ Logs de debug por sessão, escritos enquanto o debug logging está ativado, como quando você inicia com --debug ou executa /debug
paste-cache/ Conteúdo de grandes colagens
image-cache/<session>/ Imagens anexadas salvas por Claude Code v2.1.274 e anteriores. Versões posteriores salvam imagens coladas e anexadas fora de ~/.claude, em um diretório images/ para cada sessão sob o diretório temporário que CLAUDE_CODE_TMPDIR controla. A varredura remove diretórios restantes de outras sessões aqui, independentemente da idade.
uploads/<session>/ Arquivos que você anexa da web ou do aplicativo móvel, e fotos que você anexa do aplicativo móvel, ao enviar mensagens para uma sessão de Remote Control. Um anexo a uma sessão em nuvem é salvo no próprio ambiente em nuvem dessa sessão, não na sua máquina.
dev-mods/<session>/ Mods que Claude escreveu durante a sessão
session-env/ Metadados de ambiente por sessão
tasks/ Listas de tarefas escritas pelas ferramentas de tarefa, um diretório por lista
shell-snapshots/ Aliases, funções e opções de shell capturadas na inicialização e aplicadas pela ferramenta Bash a cada comando. Removidas na saída limpa. A varredura limpa qualquer uma deixada após um crash.
backups/ Versões anteriores de ~/.claude.json, copiadas quando Claude Code reescreve o arquivo. Claude Code mantém as cinco mais novas, mais uma cópia de qualquer versão que não conseguiu analisar.
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
feedback/drafts/ Feedback redigido por Claude enfileirado aguardando sua revisão em /feedback. Varrido após cleanupPeriodDays ou 30 dias, o que for menor. Quando a fila está no seu limite de 10 rascunhos, Claude Code deleta o rascunho mais antigo para liberar espaço.
usage-data/ report.html e cópias de relatório com timestamp escritas por /insights, mais dados de análise em cache por sessão usados para construí-los
skills/.trash/, plugins/.trash/ Skills e plugins que a sincronização de claude.ai removeu, como depois que você desativa um em claude.ai ou para de sincronizar. Os arquivos ficam aqui para que você possa recuperá-los até a varredura deletá-los
plugins/installed_plugins.set-aside.<date>.<hash>.json, plugins/installed_plugins.unreadable.<date>.<hash>.kept Cópias datadas que Claude Code faz antes de reescrever installed_plugins.json: registros de instalação que ele descartou, e o conteúdo de um arquivo que não conseguiu ler.
todos/, statsig/, logs/ Diretórios legados de versões mais antigas. Não são mais escritos. A varredura remove seu conteúdo e depois o diretório vazio.

Arquivos de sessão em sessions/, memória automática, e transcrições de Claude Desktop e Cowork seguem cada uma sua própria regra de retenção:

  • sessions/: contém um pequeno arquivo por sessão em execução, usado para detectar sessões simultâneas e crashes. Não faz parte da varredura baseada em idade: Claude Code remove cada arquivo quando sua sessão sai e limpa resíduos de crash no próximo lançamento.

  • Memória automática: a varredura não deleta os arquivos de memória no diretório de memória automática de um projeto, projects/<project>/memory/. Claude Code remove esse diretório apenas se ele esteve vazio durante todo o período de retenção. Antes da v2.1.228, a varredura tratava pastas dentro do diretório de memória como dados de sessão e podia deletar arquivos antigos sob ele.

  • Transcrições de Claude Desktop e Cowork: Claude Code mantém a transcrição de uma sessão que você iniciou ou continuou mais recentemente em Claude Desktop ou Cowork em qualquer idade. Para dar a essas transcrições um limite de idade, defina desktopSessionCleanupPeriodDays. Requer Claude Code v2.1.248 ou posterior; versões anteriores as deletam após cleanupPeriodDays.

    Em vez disso, Claude Code deleta essas transcrições após cleanupPeriodDays em qualquer um destes casos:

Claude Code pula a varredura baseada em idade nestes casos:

  • Modo bare: quando você executa claude -p com --bare, Claude Code não executa a varredura nessa sessão.
  • Varredura pausada: se Claude Code não conseguir determinar com segurança o período de retenção, ele pausa a varredura de limpeza de retenção; o evento retention_sweep lista cada configuração que a pausa. Quando a causa é um arquivo de configurações que não pode ser lido ou analisado, ou erros de configurações com cleanupPeriodDays ou desktopSessionCleanupPeriodDays explicitamente definidos, Claude Code também mostra um aviso em /status até você corrigir os erros de configurações. Quando configurações gerenciadas fornecem cleanupPeriodDays, Claude Code executa a varredura no valor gerenciado em qualquer caso.

Para verificar se as máquinas da sua organização executam a varredura com o período de retenção que você definiu, consulte Verificar a varredura de retenção.

Diretório de bloco de notas por sessão

O bloco de notas é um diretório por sessão que Claude Code fornece a Claude para arquivos temporários: resultados intermediários, scripts auxiliares e rascunhos que não pertencem ao seu projeto. Quando Claude diz que salvou algo "no bloco de notas", o arquivo está lá. Claude o usa em vez de /tmp, e pode criar, editar e ler arquivos nele sem um prompt de permissão.

O bloco de notas fica sob o diretório temporário de Claude Code em vez de ~/.claude. Encontre o caminho da sessão atual para sua plataforma:

  • macOS: /private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/
  • Linux: /tmp/claude-<uid>/<project>/<session-id>/scratchpad/, ou a mesma forma sob $TMPDIR quando seu sistema define um
  • Windows: %TEMP%\claude\<project>\<session-id>\scratchpad\

<project> é o caminho do seu diretório de trabalho com cada caractere que não seja letra ou dígito substituído por -, como -Users-you-my-project. Se você definir CLAUDE_CODE_TMPDIR, a árvore se move sob esse diretório em vez disso. Hooks recebem o caminho da sessão atual como scratchpad_dir.

Arquivos do bloco de notas duram enquanto a transcrição da sessão: a varredura de retenção deleta o diretório quando deleta a transcrição, e claude purge não toca no diretório temporário. Como o diretório fica sob a localização temporária do sistema, seu sistema operacional também pode limpá-lo, como na reinicialização. Para manter algo que Claude escreveu lá, peça a Claude para movê-lo para seu projeto.

Uma sessão tem um bloco de notas apenas quando todos estes se aplicam:

  • Você está conectado com uma conta claude.ai em vez de uma chave de API
  • A sessão usa a API Anthropic, não Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry
  • enableArtifact não está definido como false

Mantido até você deletar

Exceto pelas linhas que indicam o contrário, a varredura de limpeza de retenção não remove os caminhos abaixo, e Claude Code os mantém até você deletá-los.

Caminho sob ~/.claude/ Conteúdo
history.jsonl Prompts que você digitou, com timestamp e caminho do projeto. Usado para recall de seta para cima, busca de histórico Ctrl+R e conclusão de comando shell !. Cada varredura remove as entradas mais antigas que cleanupPeriodDays quando a configuração HIPAA se aplica às suas sessões.
stats-cache.json Contagens agregadas de token e custo mostradas por /usage
remote-settings.json Cópia em cache de configurações gerenciadas pelo servidor para sua organização, ou {} quando sua organização não configurou nenhuma. Presente apenas quando a sessão as busca. Claude Code verifica atualizações na inicialização e a cada hora durante uma sessão. Claude Code a deleta quando você faz logout.
cache/changelog.md Cópia em cache do changelog de Claude Code, mostrada por /release-notes. Atualizada em segundo plano.
policy-limits.json Configurações de política de recursos em cache para sua organização. Presente apenas para alguns tipos de conta. Atualizada automaticamente. Um sidecar policy-limits.json.stamp.json registra qual conta ou chave de API o cache pertence. Claude Code deleta ambos os arquivos quando você faz logout.

Arquivos de estado para manter

Dependendo de quais recursos você usa, ~/.claude/ também contém arquivos que as tabelas em Dados da aplicação não listam. Desses, caches e arquivos de lock são seguros para deletar. Mantenha esses arquivos de estado:

Armazenamento em texto simples

Transcrições e histórico não são criptografados em repouso. As permissões de arquivo do SO são a única proteção. Se uma ferramenta ler um arquivo .env ou um comando imprimir uma credencial, esse valor é escrito em projects/<project>/<session>.jsonl. Para reduzir a exposição:

  • Reduza cleanupPeriodDays para encurtar quanto tempo Claude Code mantém transcrições
  • Defina desktopSessionCleanupPeriodDays para dar também um limite de idade às transcrições de Claude Desktop e Cowork
  • Defina a variável de ambiente CLAUDE_CODE_SKIP_PROMPT_HISTORY para pular a escrita de transcrições e histórico de prompt em qualquer modo. Em modo não interativo, você pode passar --no-session-persistence junto com -p, ou definir persistSession: false no TypeScript Agent SDK; o Python SDK não tem opção equivalente.
  • Use regras de permissão para negar leituras de arquivos de credenciais

Limpar dados locais

Execute claude purge para deletar o estado que Claude Code mantém para um projeto. Deleta:

  • Transcrições e memória automática sob projects/
  • Entradas de tasks/, debug/ e file-history/ por sessão
  • Linhas de prompt correspondentes em history.jsonl
  • A entrada do projeto em ~/.claude.json

Imagens que você colou ou anexou nas sessões do projeto e o bloco de notas de cada sessão são armazenados sob o diretório temporário de Claude Code em vez de ~/.claude, então a limpeza não as remove. A varredura de retenção ainda deleta as imagens uma vez que tenham mais de cleanupPeriodDays de idade; o bloco de notas de uma sessão purgada permanece até você deletá-lo ou seu sistema operacional limpar o diretório temporário.

O comando imprime o plano completo de exclusão e pede confirmação antes de remover qualquer coisa.

Antes da v2.1.288, o comando era claude project purge.

Os exemplos abaixo usam ~/work/my-repo como um espaço reservado. Substitua-o pelo caminho para seu projeto. Se nenhum estado corresponder ao caminho, o comando imprime um erro e sai com status 1.

Visualize o plano sem deletar nada:

claude purge ~/work/my-repo --dry-run

O plano lista cada item correspondente e por que está incluído:

Purge plan for /home/user/work/my-repo:

  dir:    /home/user/.claude/projects/-home-user-work-my-repo
           project transcripts (.jsonl) and memory/
  config: projects["/home/user/work/my-repo"]
           project entry in ~/.claude.json (trust, history, MCP servers)
  filter: /home/user/.claude/history.jsonl
           12 prompt(s) typed in this project

shell-snapshots/ are not project-scoped and will not be touched
backups/ may still contain this project entry in old .claude.json snapshots (/home/user/.claude/backups); at most 5 are kept and they rotate out automatically
Dry run: 3 item(s) would be deleted.

Delete com um único prompt de confirmação:

claude purge ~/work/my-repo

O comando imprime o mesmo plano, depois pergunta Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N] e deleta apenas se você responder y.

Omita o caminho para escolher um projeto de uma lista interativa.

Pule o prompt de confirmação para uso em scripts:

claude purge ~/work/my-repo --yes

Outras opções:

  • Passe --all em vez de um caminho para limpar o estado de cada projeto de uma vez, o que deleta history.jsonl completamente em vez de filtrá-lo.
  • Passe -i para percorrer o plano de exclusão um item por vez.

O comando deixa shell-snapshots/ e backups/ sozinhos porque não têm escopo de projeto, e avisa sobre eles na saída do plano. Se alguém executou /heapdump na máquina, delete também os arquivos .heapsnapshot que ele escreveu. Um heap snapshot contém a conversa completa e quaisquer credenciais que o processo mantinha, e nem a varredura de retenção nem a limpeza o tocam.

Você também pode deletar qualquer um dos caminhos de dados da aplicação acima manualmente, exceto os arquivos de estado para manter.

Deletar Você perde
~/.claude/projects/ Retomar, continuar e retroceder para sessões passadas, e memória automática para cada projeto
~/.claude/history.jsonl Recall de prompt com seta para cima, busca de histórico Ctrl+R e conclusão de comando shell !
~/.claude/paste-cache/ Texto colado em prompts recuperados; veja colar conteúdo grande
~/.claude/uploads/ Anexos que sessões passadas de Remote Control referem por caminho
~/.claude/file-history/ Restauração de checkpoint para sessões passadas
~/.claude/stats-cache.json Totais históricos mostrados por /usage
~/.claude/usage-data/ Relatórios passados de /insights e os dados de análise em cache usados para construí-los
~/.claude/feedback-bundles/ Feedback e arquivos de relatório de bug que você ainda não enviou à sua equipe de conta Anthropic
~/.claude/feedback/drafts/ Feedback redigido por Claude que você não enviou
~/.claude/remote-settings.json Nada. Re-buscado no próximo lançamento.
~/.claude/cache/changelog.md Nada. Atualizado em segundo plano.
~/.claude/policy-limits.json Nada. Atualizado automaticamente.
~/.claude/tasks/ Suas listas de tarefas, incluindo as que ainda estão em uso
~/.claude/skills/.trash/, ~/.claude/plugins/.trash/ A chance de recuperar skills sincronizadas e plugins sincronizados que Claude Code removeu
~/.claude/plugins/installed_plugins.set-aside.<date>.<hash>.json, ~/.claude/plugins/installed_plugins.unreadable.<date>.<hash>.kept As cópias dos registros de instalação de plugin que Claude Code descartou ou não conseguiu ler. Nada as lê de volta
~/.claude/debug/, ~/.claude/plans/, ~/.claude/session-env/, ~/.claude/shell-snapshots/, ~/.claude/backups/ Nada voltado para o usuário
~/.claude/todos/, ~/.claude/statsig/, ~/.claude/logs/, ~/.claude/image-cache/ Nada. Diretórios legados não escritos pelas versões atuais.

Não delete ~/.claude.json, ~/.claude/settings.json ou ~/.claude/plugins/: esses mantêm os detalhes da sua conta, preferências e plugins instalados.

Recursos relacionados