Claude Code em Escala: Como a Busca Agentiva Evita Modos de Falha do RAG em Grandes Bases de Código

O Claude Code está rodando em produção em monorepos com milhões de linhas, sistemas legados de décadas (C, C++, C#, Java, PHP) e arquiteturas distribuídas com milhares de desenvolvedores. Em vez de depender de recuperação baseada em RAG — que falha porque os pipelines de embedding não acompanham equipes ativas, retornando funções renomeadas há duas semanas ou módulos deletados — o Claude Code navega em bases de código como um engenheiro de software: ele percorre o sistema de arquivos, lê arquivos, usa grep e segue referências localmente sem exigir que um índice centralizado seja construído, mantido ou enviado para um servidor.

O harness importa mais que o modelo

O desempenho do Claude Code é determinado menos pelos benchmarks de modelo e mais pelo harness — cinco pontos de extensão que se complementam:

• Arquivos CLAUDE.md — arquivos de contexto carregados automaticamente a cada início de sessão: um arquivo raiz para a visão geral, arquivos de subdiretório para convenções locais. Mantê-los focados em informações de aplicação geral evita desperdício de janela de contexto.
• Hooks — não detalhados além de serem listados como ponto de extensão.
• Skills — não detalhados além de serem listados como ponto de extensão.
• Plugins — não detalhados além de serem listados como ponto de extensão.
• Servidores MCP — não detalhados além de serem listados como ponto de extensão.

Duas capacidades adicionais — integrações LSP e subagentes — completam a configuração. O artigo recomenda construir essas camadas na ordem listada, pois cada camada se baseia na anterior.

Tradeoff: qualidade do contexto inicial

A busca baseada em agente funciona melhor quando Claude tem contexto inicial suficiente para saber onde procurar. Pedir para encontrar todas as instâncias de um padrão vago em uma base de código de bilhões de linhas atingirá os limites da janela de contexto antes mesmo do trabalho começar. Equipes que investem na configuração da base de código por meio de arquivos CLAUDE.md obtêm melhores resultados.