A Anthropic enviou mais de 125 chaves para o settings.json do Claude Code. A documentação oficial cobre cerca de 40.
14 das que faltam estão a 3 cliques de profundidade na interface do Claude.ai. 4 delas não aparecem em nenhuma documentação. Você as encontra lendo issues no GitHub, vendo engenheiros vazarem informações no Discord, ou pesquisando no binário do Claude Code às 3 da manhã.
A maioria dos usuários do Claude roda com o que a Anthropic enviou há seis meses. A conta deles aumenta aos poucos. O resultado do trabalho deles se desvia. Eles culpam o modelo.
Abaixo: 18 configurações que realmente controlam seu Claude.
8 no Claude dot ai.
7 no Claude Code.
3 na API e no Console.
Para cada uma: onde está, o que faz, a correção em uma linha.
Seção 1: Claude (8 configurações)
1. Memória: escopo, exclusões e o comando "esqueça isso"
Onde: Configurações -> Capacidades -> Memória
O que faz: A Memória foi lançada para os planos Free e Pro em março de 2026. Por padrão, ela armazena tudo que o Claude decide que vale a pena armazenar. Três controles que a maioria das pessoas perde: escopo por projeto, lista de exclusão e o comando de esquecimento instantâneo.
Por que importa: a memória padrão se desvia. Após 4-6 semanas, ela está cheia de correções pontuais ("Eu prefiro tabs em Python" que você disse uma vez sobre um arquivo), fatos específicos de projetos que vazam para chats não relacionados e contexto de função desatualizado. A qualidade da saída se degrada porque o Claude agora está otimizando para o "você" errado.
A correção:
- Ative a memória com escopo de projeto: Configurações -> Capacidades -> Memória -> Escopo por Projeto. Memórias de dentro de um Projeto permanecem naquele Projeto. Isso sozinho corrige a maioria dos desvios.
- Adicione à lista de exclusão qualquer tópico que você não queira que apareça em chats não relacionados. Exemplos: divórcio, questões médicas, valores salariais, nomes de clientes. Eles persistem independentemente do contexto, a menos que sejam excluídos.
- Use o comando de esquecimento inline em qualquer chat: esqueça o que você lembrou sobre [tópico]
O Claude interpreta isso em relação ao seu armazenamento de memória e confirma o que foi removido. Sem menu, sem página de configurações.
2. Pensamento Estendido: alternância por chat
Onde: entrada do chat -> menu suspenso do seletor de modelo -> Pensamento Estendido: Desligado / Leve / Completo
O que faz: O Pensamento Estendido adiciona uma passada de raciocínio <thinking> antes da resposta. A Anthropic o envia ativado por padrão para o Opus. A alternância entre três estados é por chat e substitui a configuração global.
Por que importa: O Pensamento Estendido é ótimo para matemática, depuração, planejamento de várias etapas. É desperdiçado em resumos, tradução, formatação, reescritas e consultas rápidas. Nessas tarefas, adiciona 3-12 segundos de latência e 20-40% mais tokens para a mesma resposta.
A correção: defina o padrão como Leve (usa o pensamento apenas quando o modelo julga útil) e mude explicitamente para Completo para trabalhos difíceis. A maioria dos usuários que mostro isso reduz seus gastos com tokens do Opus em 18-25% na primeira semana.
3. Estilos Personalizados: não é "tom", mas contratos de saída reais
Onde: entrada do chat -> seletor de estilo -> Criar Novo Estilo
O que faz: Os Estilos começaram como uma alternância de tom ("Formal / Conciso / Explicativo"). Os Estilos Personalizados são, na verdade, um contrato de saída. Você cola um arquivo de instrução de 200-1500 palavras. Cada resposta naquele estilo o aplica antes da geração.
Por que importa: a maioria das pessoas usa Estilos para "deixar mais curto". O verdadeiro uso é aplicar regras estruturais em todas as respostas sem ter que colá-las novamente. Formato de citação. Palavras proibidas. Seções obrigatórias. Linguagens de bloco de código. Limites de tamanho. Se deve fazer perguntas de acompanhamento.
A correção: crie um Estilo por fluxo de trabalho. Os meus:
Três deles em rotação (Rascunho para X, Revisão de código, Resumir PDF) substituem 80% dos meus prompts salvos.
4. Projetos: o campo "instruções" que a maioria das pessoas deixa vazio
Onde: qualquer Projeto -> ⋯ no canto superior direito -> Editar instruções do projeto
O que faz: Os Projetos são espaços de trabalho persistentes. O campo de instruções é um equivalente a um prompt de sistema injetado em cada chat naquele Projeto. A Anthropic apresenta os Projetos com o recurso de upload de conhecimento, que é o que as pessoas lembram. O campo de instruções está na mesma página e 70% dos Projetos que vejo por aí estão em branco.
Por que importa: cada chat em um Projeto começa frio sem ele. Com ele, você para de restabelecer contexto. ("Este é um fluxo de trabalho de pesquisa do Polymarket. Padrão cético. Sempre mostre a matemática da probabilidade. Nunca recomende uma negociação — apenas enquadre o EV.")
A correção: trate-o como um CLAUDE.md para o Claude. Mantenha-o abaixo de 400 palavras. Especifique a função, o nível de ceticismo padrão, as regras de formatação, o que nunca fazer. Releia uma vez por mês e pode.
5. Pesquisar chats passados (Pro+) e como pesquisar de verdade
Onde: Configurações → Perfil → Pesquisar chats passados (deve estar ativado)
O que faz: permite que o Claude pesquise seu histórico de conversas quando relevante. Apenas Pro+.
Por que importa: desativado por padrão para novas contas, mesmo no Pro. Depois de ativado, o truque é saber que ele faz correspondência de palavras-chave, não semântica. "O que discutimos sobre robôs chineses ontem" não retorna nada, a menos que seu chat passado contenha literalmente "robôs chineses" ou "China" e "robôs".
A correção: ative-o. Em seguida, aprenda a forma real da consulta. Substantivos de conteúdo, não meta-palavras. "Polymarket Irã" funciona. "Aquela coisa que conversamos semana passada" não funciona.
6. Pesquisa na web: alternância por conversa e o comportamento de citação
Onde: entrada do chat -> + -> Pesquisa na web: Ativada / Desativada
O que faz: a alternância da pesquisa na web é por conversa, mas o comportamento muda com base em uma configuração menos conhecida em Configurações -> Capacidades -> Citações da pesquisa na web: Em linha / Notas de rodapé / Ocultas.
Por que importa: o padrão é Em linha. Citações Em linha quebram copiar e colar. Quando você copia a resposta do Claude para outro lugar, copia marcadores que não apontam para lugar nenhum. O modo Notas de rodapé mantém a resposta limpa e lista as fontes no final.
A correção: mude para Notas de rodapé se você costuma copiar as respostas da pesquisa na web do Claude para outro documento, e-mail ou mensagem. Mantenha Em linha apenas se você lê tudo dentro do Claude.
7. Conectores: a armadilha "confiar nesta pasta" no Cowork
Onde: Configurações -> Conectores -> Cowork -> Pastas confiáveis
O que faz: O Cowork (GA abril de 2026) dá ao Claude acesso a uma pasta na sua máquina. Por padrão, a Anthropic pergunta antes de cada sessão se deve confiar na pasta. A lista de pastas confiáveis é a maneira de ignorar isso.
Por que importa: uma vez que uma pasta está na lista de confiáveis, o Claude lê dela em toda sessão do Cowork sem avisar. Se você adicionou uma pasta durante um teste em março e esqueceu, o Claude está lendo silenciosamente dela em todas as sessões desde então.
A correção: abra as pastas confiáveis. Remova qualquer coisa que não seja um projeto ativo atual. A lista cresce mais rápido do que você espera.
8. Modo Incógnito e o que ele realmente pula
Onde: barra lateral -> Novo chat incógnito (ou Cmd/Ctrl + Shift + N)
O que faz: um chat Incógnito não é salvo, não é memorizado, não é pesquisável, não é usado para melhorias do modelo. O chat é excluído quando você o fecha.
Por que importa: as pessoas assumem que o Incógnito apenas esconde o chat da barra lateral. Na verdade, ele pula quatro sistemas: gravação de memória, histórico de chat, índice de pesquisa de chats passados, aceitação de dados de treinamento (se você a tiver ativada).
A correção: use-o deliberadamente para qualquer coisa com dados confidenciais: salário, questões médicas, família, rascunhos legais, nomes de clientes. Três teclas, sem pensar.
Seção 2: Claude Code (7 configurações)
Elas ficam em ~/.claude/settings.json (nível de usuário) ou .claude/settings.json (nível de projeto). Este último tem precedência.
Há mais de 125 chaves no total no binário v2.1.105. As sete abaixo são as que realmente fazem diferença.
9. enabledPlugins - desabilite, não desinstale
Onde: ~/.claude/settings.json -> enabledPlugins
O que faz: define quais plugins instalados são carregados no início da sessão. O marketplace de Plugins torna a instalação fácil. A desinstalação é mais difícil e desnecessária se você apenas definir o valor como false.
Por que importa: cada plugin ativo carrega seus hooks, conteúdo de SKILL.md e esquemas de ferramentas no seu orçamento de contexto. Três plugins que você esqueceu = 3-8 mil tokens de carga prévia antes de você digitar qualquer coisa.
Eu tinha 14 plugins ativados quando comecei esta auditoria. 4 estão ativos agora.
A correção:
false mantém o plugin instalado, mas descarregado. Reative por sessão com /plugin enable nome@marketplace quando você realmente precisar dele.
10. permissions.deny - o que saber sobre o bug
Onde: ~/.claude/settings.json -> permissions.deny
O que faz: impede que o Claude execute ferramentas específicas ou acesse arquivos específicos. A intenção: impedir rm -rf, impedir a leitura de .env, impedir a escrita fora do projeto.
Por que importa: há um bug conhecido. As regras de negação às vezes não bloqueiam. Várias issues do GitHub foram abertas. A mais citada (anthropics/claude-code#11544) documenta hooks que não carregam apesar da configuração válida; um padrão semelhante afeta a aplicação da negação. A regra está na sua configuração. O log de depuração mostra "0 matchers encontrados." O Claude lê o arquivo de qualquer maneira.
A correção:
Adicione uma segunda camada no nível do sistema de arquivos. chmod 600 .env para que, mesmo se o Claude tentar lê-lo, o SO recuse. Não confie apenas na lista de negação. Verifique com /permissions dentro do Claude Code. Se suas regras não aparecerem, reinicie a sessão.
11. hooks.SessionStart - as 4 linhas que reduziram meu inchaço de contexto em 30%
Onde: ~/.claude/settings.json -> hooks.SessionStart
O que faz: O SessionStart é acionado quando você abre o Claude Code em um diretório. Você pode executar qualquer coisa: imprimir informações de ambiente, verificar o estado do git, injetar um arquivo de contexto, aquecer o cache.
Por que importa: a maioria das pessoas injeta demais. O CLAUDE.md cresce para 5 mil tokens porque toda regra do projeto foi colocada lá. O SessionStart permite que você carregue apenas as regras relevantes para o branch ou diretório atual.
A correção:
Seu branch principal carrega context-main.md. Seu branch feat/auth carrega context-feat-auth.md. Cada arquivo permanece pequeno. O orçamento de contexto para de sangrar.
12. disableAllHooks - o interruptor de pânico
Onde: ~/.claude/settings.json -> disableAllHooks: true
O que faz: desabilita todos os hooks em uma única alternância. Lançado na atualização de março de 2026. A maioria das pessoas não sabe que existe.
Por que importa: quando o Claude Code começa a se comportar de forma estranha (comandos fantasmas sendo executados, sessões travando na inicialização, gravações misteriosas de arquivos), 80% das vezes é um hook com mau funcionamento. Desabilitar hooks um por um é lento. Isso os elimina todos de uma vez para que você possa isolar.
A correção: mantenha-o como false. Quando algo quebrar, mude para true, reinicie, veja se o problema desaparece. Se sim, reative os hooks um por um. Se não, o bug está em outro lugar.
13. model por projeto (substituição)
Onde: .claude/settings.json (raiz do projeto) -> model
O que faz: define o modelo padrão para aquele projeto. Substitui sua configuração global.
Por que importa: a maioria das pessoas define Opus globalmente porque o quer para trabalhos difíceis. Então elas abrem um projeto que é principalmente edição de markdown ou scripts de shell. Elas pagam taxas do Opus para tarefas que o Haiku faz por 1/20 do custo.
A correção:
As substituições em nível de projeto vencem. Abra o projeto, obtenha o modelo certo. Siga em frente.
14. mcpServers com o sinalizador enabled
Onde: ~/.claude/settings.json -> mcpServers
O que faz: Os servidores MCP conectam o Claude a ferramentas externas. Cada servidor conectado carrega seu esquema de ferramentas completo no seu contexto. De 800 a 6.000 tokens por servidor.
Por que importa: as pessoas conectam servidores MCP para testar, e nunca desconectam. Depois de três meses, você tem 12 conectados, dos quais usa ativamente 3. Os 9 servidores não utilizados custam a você ~25-40 mil tokens de esquema de contexto em cada início de sessão.
A correção: use o sinalizador enabled para manter a conexão configurada, mas descarregada.
Alterne para true por sessão quando você realmente precisar deles. Na maioria dos dias, tenho 2-3 ativos. Em dias de planejamento, 6.
15. cleanupPeriodDays - o cache que ninguém menciona
Onde: ~/.claude/settings.json -> cleanupPeriodDays
O que faz: define por quantos dias o Claude Code mantém transcrições, logs de depuração e dados de sessão intermediários. O padrão é 30.
Por que importa: Tanto o Dreaming quanto a pesquisa de chats passados dependem dessas transcrições. Com a janela padrão de 30 dias, o Dreaming só pode aprender a partir de um mês de trabalho. Seis meses dão a ele 6× o sinal. Custo de disco: aproximadamente 200 MB.
A correção:
180 dias de histórico de sessão disponíveis para o Dreaming, para consolidação de memória e para seu próprio grep quando você estiver procurando "o que eu disse ao Claude sobre aquele bug de autenticação em março."
O artefato do Claude Code: um settings.json com todas as 7 configurações aplicadas
Copie isto para ~/.claude/settings.json. Ajuste os caminhos e nomes de plugins para os seus. Reinicie o Claude Code. Execute /permissions e /hooks novamente para verificar se tudo foi carregado.
As substituições em nível de projeto vão em .claude/settings.json na raiz do projeto. A mais útil para definir lá:
Seção 3: API e Console (3 configurações)
Elas estão no código ou no Console da Anthropic. São as configurações com maior impacto de custo no artigo. Cada uma pode mudar sua fatura em 30-90%.
16. breakpoints cache_control: onde colocá-los
Onde: Corpo da requisição da API, campo cache_control em qualquer bloco de conteúdo
O que faz: marca um prefixo do seu prompt como armazenável em cache. Requisições subsequentes com o mesmo prefixo são cobradas a aproximadamente 10% da taxa de entrada em vez da taxa total.
Por que importa: esta é a maior alavanca de custo na API. As pessoas sabem que existe. A maioria coloca o breakpoint no lugar errado e obtém economia parcial em vez de total. Na minha própria configuração, corrigir o breakpoint reduziu uma conta de $340/mês para $87.
A correção: o breakpoint vai na fronteira entre conteúdo estático e dinâmico. Qualquer coisa antes do breakpoint é armazenada em cache. Qualquer coisa depois é recalculada.
Dois TTLs estão disponíveis: 5 minutos efêmero (padrão) e 1 hora. Use 1 hora para prompts de sistema que não mudam entre sessões:
As gravações em cache custam 25% a mais do que a entrada base. As leituras em cache custam 10% da entrada base. O ponto de equilíbrio: um prefixo em cache se paga se você o ler 2+ vezes dentro da janela de TTL.
17. inference_geo e o imposto de residência de dados
Onde: Requisição da API -> parâmetro inference_geo
O que faz: roteia a inferência para uma região geográfica específica. Residência apenas nos EUA, apenas na UE, etc.
Por que importa: A residência de dados apenas nos EUA adiciona um prêmio de 10% no Opus 4.7 e superior. Não está no cartão de preços padrão. Você o vê na fatura.
A correção: se seu regime de conformidade não exige realmente residência regional, não defina inference_geo. A maioria dos aplicativos o define por padrão "para garantir" porque alguém do jurídico disse "certifique-se de que os dados permaneçam nos EUA." Verifique se o requisito é contratual ou aspiracional. Se aspiracional, omita o parâmetro e economize 10% em cada chamada do Opus.
Se você precisar dele, considere os 10% na seleção do modelo. O Sonnet a $3 base torna-se efetivamente $3,30, o que desloca o ponto de equilíbrio Opus-vs-Sonnet.
18. Limite de taxa em nível de workspace (aquele que evita a interrupção das 3 da manhã)
Onde: Console -> Configurações -> Workspaces -> [seu workspace] -> Limites de taxa por recurso
O que faz: define um limite de taxa por workspace, por recurso, separado dos limites de nível de conta.
Por que importa: um limite de nível de conta protege você de falir. Um limite de nível de workspace protege seu produto interativo quando um job em lote descontrolado tenta consumir toda a sua cota de ITPM. Você lança um novo recurso, ele buga, ele entra em loop, ele consome tudo, seu chat voltado ao cliente começa a retornar 429s. Os limites de workspace impedem que um recurso esgote outro.
A correção: crie um workspace por superfície (chat interativo, processamento em lote, ferramentas internas, experimental). Defina o limite de taxa de cada workspace para 60-70% do seu nível de conta. Reserve 30% para o workspace que precisar de pico.
A quarta configuração não documentada neste artigo: há um limite em nível de recurso dentro de cada workspace que só é visível se você clicar em um cartão de recurso específico, não na visão geral do workspace. Padrão = ilimitado.
Se você tem três recursos em um workspace, um deles pode esgotar os outros dois e o limite de nível de workspace não o detectará. Defina limites por recurso para qualquer coisa que faça trabalho em lote.
Seção 4: A lista de verificação de 18 pontos
Percorra-a uma vez. 20 minutos. Qualquer coisa que você não tocar em 12 meses, provavelmente nunca o fará.
Seção 5: O script de auditoria (execute-o semanalmente)
Coloque isto em ~/bin/claude-audit.sh. Execute semanalmente. Ele sinaliza a metade do checklist do Claude Code mais o lado cache_control da metade da API.
Salve, chmod +x ~/bin/claude-audit.sh, execute semanalmente até que cada linha esteja no alvo.
Seção 6: O que não entrou no corte
Removi quatro candidatos antes de publicar. Vale a pena nomeá-los para que você não perca tempo perseguindo-os.
Alternância de Raciocínio Adaptativo. A Anthropic enviou isso ativado por padrão. A substituição existe em Configurações → Capacidades → Modo de raciocínio. Em 30 dias de comparação, não consegui encontrar um fluxo de trabalho onde substituí-lo mudasse os resultados de forma significativa. Confie no padrão. Siga em frente.
Auto-ativação de Skill. Você pode alternar se o Claude carrega automaticamente skills com base na detecção de relevância versus exigir invocação explícita. Eu esperava que isso importasse. Não importou. A auto-ativação com divulgação progressiva (carregando apenas metadados de SKILL.md até ser necessário) é bem ajustada. Deixe ligado.
Controle de despacho mobile para desktop. Recurso útil, não é um item de auditoria de configurações. Ou você tem um fluxo de trabalho onde isso se encaixa ou não. Nenhuma alternância oculta muda o resultado.
Teto de max_tokens por workspace. Você pode forçar cada resposta a truncar em 800, 2000 ou 4000. Economiza dinheiro real em fluxos de trabalho verbosos, mas corrompe a geração de código que precisa de saídas longas. Vale a pena testar por workspace. Não vale a pena recomendar como padrão.
F I M
Percorra a lista de verificação hoje à noite. A maioria de vocês corrigirá de 6 a 8 coisas. Alguns corrigirão 14 ou mais. Os números no seu painel de faturamento e no seu gráfico de uso dirão se valeram os 20 minutos.
Marque e percorra a lista de verificação hoje à noite. Se isso te poupar um mês de frustração com o "Claude ficou mais burro", republique. Telegram para dicas diárias de IA: https://t.me/+_ZWrQN7GuDA3ZDEy
