Explore o diretório .claude

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. O resto do diretório é opcional: adicione skills, rules ou subagents 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 você não pode substituir. Veja configurações gerenciadas pelo servidor.
`CLAUDE.local.md`	Raiz do projeto	Suas preferências privadas para este projeto, carregadas junto com CLAUDE.md. Crie manualmente e adicione a `.gitignore`.
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.

~/.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 cada arquivo que o explorador cobre. Arquivos de escopo de projeto vivem em seu repositório sob .claude/ (ou na raiz para CLAUDE.md, .mcp.json e .worktreeinclude). Arquivos de escopo global vivem em ~/.claude/ e se aplicam em todos os projetos.

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

Configurações gerenciadas implantadas por sua organização têm precedência sobre tudo
Flags CLI como --permission-mode ou --settings substituem settings.json para essa sessão
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 para cada uma

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

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

Arquivo	Escopo	Confirmar	O que faz	Referência
`CLAUDE.md`	Projeto e global	✓	Instruções carregadas a cada sessão	Memory
`rules/*.md`	Projeto e global	✓	Instruções com escopo de tópico, opcionalmente com gate de caminho	Rules
`settings.json`	Projeto e global	✓	Permissões, hooks, variáveis de env, padrões de modelo	Settings
`settings.local.json`	Apenas projeto		Suas substituições pessoais, auto-gitignored	Escopos de configurações
`.mcp.json`	Apenas projeto	✓	Servidores MCP compartilhados pela equipe	Escopos MCP
`.worktreeinclude`	Apenas projeto	✓	Arquivos gitignored para copiar em novos worktrees	Worktrees
`skills/<name>/SKILL.md`	Projeto e global	✓	Prompts reutilizáveis invocados com `/name` ou auto-invocados	Skills
`commands/*.md`	Projeto e global	✓	Prompts de arquivo único; mesmo mecanismo que skills	Skills
`output-styles/*.md`	Projeto e global	✓	Seções de prompt do sistema personalizadas	Output styles
`agents/*.md`	Projeto e global	✓	Definições de subagents com seu próprio prompt e ferramentas	Subagents
`workflows/*.js`	Projeto e global	✓	Scripts de workflow dinâmicos escritos por Claude e salvos de `/workflows`; cada arquivo se torna um comando `/<name>`	Dynamic workflows
`agent-memory/<name>/`	Projeto e global	✓	Memória persistente para subagents	Memória persistente
`~/.claude.json`	Apenas global		Estado da aplicação, OAuth, toggles de UI, servidores MCP pessoais	Configuração global
`projects/<project>/memory/`	Apenas global		Auto memory: notas de Claude para si mesmo entre sessões	Auto memory
`keybindings.json`	Apenas global		Atalhos de teclado personalizados	Keybindings
`themes/*.json`	Apenas global		Temas de cores personalizados	Temas personalizados

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 sessões. Esses arquivos são texto simples. Qualquer coisa que passa por uma ferramenta aterrissa em uma transcrição no disco: conteúdo de arquivos, saída de comando, texto colado.

Limpos automaticamente

Arquivos nos caminhos abaixo são deletados na inicialização uma vez que têm mais de cleanupPeriodDays. O padrão é 30 dias.

Caminho sob `~/.claude/`	Conteúdo
`projects/<project>/<session>.jsonl`	Transcrição de conversa completa: cada mensagem, chamada de ferramenta e resultado de ferramenta
`projects/<project>/<session>/subagents/`	Transcrições de conversa de subagent, removidas com a transcrição de sessão pai quando envelhecem
`projects/<project>/<session>/tool-results/`	Grandes saídas de ferramentas derramadas em arquivos separados
`file-history/<session>/`	Snapshots pré-edição de arquivos que Claude alterou, usados para restauração de checkpoint. 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
`plans/`	Arquivos de plano escritos durante plan mode
`debug/`	Logs de debug por sessão, escritos apenas quando você inicia com `--debug` ou executa `/debug`
`paste-cache/`, `image-cache/`	Conteúdo de pastes grandes e imagens anexadas
`session-env/`	Metadados de ambiente por sessão
`tasks/`	Listas de tarefas por sessão escritas pelas ferramentas de tarefa
`shell-snapshots/`	Aliases, funções e opções de shell capturadas na inicialização e aplicadas pela ferramenta Bash a cada comando. Removido na saída limpa. A limpeza remove qualquer um deixado após um crash.
`backups/`	Cópias com timestamp de `~/.claude.json` tiradas antes de migrações de configuração
`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
`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.

Mantidos até você deletá-los

Os caminhos a seguir não são cobertos pela limpeza automática e persistem indefinidamente.

Caminho sob `~/.claude/`	Conteúdo
`history.jsonl`	Cada prompt que você digitou, com timestamp e caminho do projeto. Usado para recall de seta para cima.
`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. Presente apenas quando sua organização as configurou. Atualizado em cada inicialização.

Outros arquivos pequenos de cache e lock aparecem dependendo de quais recursos você usa e são seguros para deletar.

Armazenamento em texto simples

Transcriçõ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:

Diminua cleanupPeriodDays para encurtar quanto tempo as transcrições são mantidas
Defina a variável de ambiente CLAUDE_CODE_SKIP_PROMPT_HISTORY 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.
Use regras de permissão para negar leituras de arquivos de credencial

Limpar dados locais

Execute claude project purge para deletar o estado que Claude Code mantém para um projeto. O comando requer Claude Code v2.1.124 ou posterior. Ele deleta:

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

O comando imprime o plano de exclusão completo e pede confirmação antes de remover qualquer coisa. Visualize o plano sem deletar nada:

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

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

claude project purge ~/work/my-repo

Omita o caminho para escolher um projeto de uma lista interativa. Pule o prompt de confirmação para uso em scripts:

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

Passe --all em vez de um caminho para limpar o estado de todos os projetos 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 esses não têm escopo de projeto, e avisa sobre eles na saída do plano. Ele sai com status 1 se nenhum estado corresponder ao caminho fornecido. Você também pode deletar qualquer um dos caminhos de dados da aplicação acima manualmente. Novas sessões não são afetadas. A tabela abaixo mostra o que você perde para sessões passadas.

Deletar	Você perde
`~/.claude/projects/`	Resume, continue e rewind para sessões passadas
`~/.claude/history.jsonl`	Recall de prompt de seta para cima
`~/.claude/file-history/`	Restauração de checkpoint para sessões passadas
`~/.claude/stats-cache.json`	Totais históricos mostrados por `/usage`
`~/.claude/remote-settings.json`	Nada. Re-buscado na próxima inicialização.
`~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/paste-cache/`, `~/.claude/image-cache/`, `~/.claude/session-env/`, `~/.claude/tasks/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/`	Nada voltado para o usuário
`~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/`	Nada. Diretórios legados não escritos por versões atuais.

Não delete ~/.claude.json, ~/.claude/settings.json ou ~/.claude/plugins/: esses contêm sua autenticação, preferências e plugins instalados.

Gerenciar memória de Claude: escrever e organizar CLAUDE.md, rules e auto memory
Configurar configurações: definir permissões, hooks, variáveis de ambiente e padrões de modelo
Criar skills: construir prompts e workflows reutilizáveis
Configurar subagents: definir agentes especializados com seu próprio contexto

Primeiros passos

Conceitos principais

Usar Claude Code

Plataformas e integrações