Pular para o conteúdo principal

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.

Esta página cobre problemas de desempenho, estabilidade e pesquisa uma vez que Claude Code está em execução. Para outros problemas, comece com a página que corresponde ao local onde você está preso:
SintomaIr para
command not found, falha na instalação, problemas de PATH, EACCES, erros de TLSTroubleshoot installation and login
Loops de login, erros OAuth, 403 Forbidden, “organization disabled”, credenciais Bedrock/Vertex/FoundryTroubleshoot installation and login
Configurações não aplicadas, hooks não disparando, servidores MCP não carregandoDebug your configuration
API Error: 5xx, 529 Overloaded, 429, erros de validação de solicitaçãoError reference
model not found ou you may not have access to itError reference
Extensão VS Code não conectando ou detectando ClaudeVS Code integration
Plugin JetBrains ou IDE não detectadoJetBrains integration
Alto uso de CPU ou memória, respostas lentas, travamentos, pesquisa não encontrando arquivosPerformance and stability abaixo
Se você não tem certeza qual se aplica, execute /doctor dentro do Claude Code para uma verificação automatizada de sua instalação, configurações, servidores MCP e uso de contexto. Se claude não iniciar completamente, execute claude doctor do seu shell em vez disso.

​
Performance and stability

Essas seções cobrem problemas relacionados ao uso de recursos, responsividade e comportamento de pesquisa.

​
Alto uso de CPU ou memória

Claude Code é projetado para funcionar com a maioria dos ambientes de desenvolvimento, mas pode consumir recursos significativos ao processar grandes bases de código. Se você está experimentando problemas de desempenho:
  1. Use /compact regularmente para reduzir o tamanho do contexto
  2. Feche e reinicie Claude Code entre tarefas principais
  3. Considere adicionar grandes diretórios de compilação ao seu arquivo .gitignore
Se o uso de memória permanecer alto após essas etapas, execute /heapdump para escrever um snapshot de heap JavaScript e um detalhamento de memória para ~/Desktop. No Linux sem uma pasta Desktop, os arquivos são escritos em seu diretório home. O detalhamento mostra resident set size, JS heap, array buffers e memória nativa não contabilizada, o que ajuda a identificar se o crescimento está em objetos JavaScript ou em código nativo. Para inspecionar retentores, abra o arquivo .heapsnapshot no Chrome DevTools em Memory → Load. Anexe ambos os arquivos ao relatar um problema de memória no GitHub.

​
Auto-compactação para com erro de thrashing

Se você vir Autocompact is thrashing: the context refilled to the limit..., a compactação automática foi bem-sucedida mas um arquivo ou saída de ferramenta imediatamente refilled a janela de contexto várias vezes seguidas. Claude Code para de tentar novamente para evitar desperdiçar chamadas de API em um loop que não está fazendo progresso. Para recuperar:
  1. Peça ao Claude para ler o arquivo oversized em pedaços menores, como um intervalo de linha específico ou função, em vez do arquivo inteiro
  2. Execute /compact com um foco que descarta a saída grande, por exemplo /compact keep only the plan and the diff
  3. Mova o trabalho de arquivo grande para um subagent para que ele execute em uma janela de contexto separada
  4. Execute /clear se a conversa anterior não for mais necessária

​
Comando trava ou congela

Se Claude Code parece não responsivo:
  1. Pressione Ctrl+C para tentar cancelar a operação atual
  2. Se não responsivo, você pode precisar fechar o terminal e reiniciar
Reiniciar não perde sua conversa. Execute claude --resume no mesmo diretório para retomar a sessão.

​
Problemas de pesquisa e descoberta

Se a ferramenta Search, menções @file, agentes personalizados ou skills personalizados não estão encontrando arquivos, o binário ripgrep incluído pode não ser executado em seu sistema. Instale o pacote ripgrep da sua plataforma e diga ao Claude Code para usá-lo em vez disso: 
brew install ripgrep
Depois defina USE_BUILTIN_RIPGREP=0 em seu environment.

​
Resultados de pesquisa lentos ou incompletos em WSL

Penalidades de desempenho de leitura de disco ao trabalhar entre sistemas de arquivos em WSL podem resultar em menos correspondências do que o esperado ao usar Claude Code em WSL. A pesquisa ainda funciona, mas retorna menos resultados do que em um sistema de arquivos nativo.
/doctor mostrará Search como OK neste caso.
Soluções:
  1. Envie pesquisas mais específicas: reduza o número de arquivos pesquisados especificando diretórios ou tipos de arquivo: “Search for JWT validation logic in the auth-service package” ou “Find use of md5 hash in JS files”.
  2. Mova o projeto para o sistema de arquivos Linux: se possível, certifique-se de que seu projeto está localizado no sistema de arquivos Linux (/home/) em vez do sistema de arquivos do Windows (/mnt/c/).
  3. Use Windows nativo em vez disso: considere executar Claude Code nativamente no Windows em vez de através de WSL, para melhor desempenho do sistema de arquivos.

​
Get more help

Se você está experimentando problemas não cobertos aqui:
  1. Execute /doctor para verificar a saúde da instalação, validade das configurações, configuração de MCP e uso de contexto em uma única passagem
  2. Use o comando /feedback dentro do Claude Code para relatar problemas diretamente à Anthropic
  3. Verifique o repositório GitHub para problemas conhecidos
  4. Pergunte ao Claude diretamente sobre suas capacidades e recursos. Claude tem acesso integrado à sua documentação.