Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
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 |
| 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. | 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 |
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 |
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/ | Ambiente shell capturado usado pela ferramenta Bash. 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, para enviar à sua equipe de conta Anthropic |
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. |
todos/ | Listas de tarefas por sessão legadas. Não mais escritas por versões atuais; seguro 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:
- 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
claude project purge ~/work/my-repo
claude project purge ~/work/my-repo --yes
--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/ | Nada. Diretório legado não escrito por versões atuais. |
~/.claude.json, ~/.claude/settings.json ou ~/.claude/plugins/: esses contêm sua autenticação, preferências e plugins instalados.
Recursos relacionados
