A busca na web do Claude Code não funciona? 4 correções e a alternativa confiável

A busca na web do Claude Code mostra “Permission denied”, “Did 0 searches” ou simplesmente não funciona? Veja 4 correções — além da alternativa externa de busca que não quebra.

by AnyCap

Ícone de busca quebrado com efeitos de glitch e indicadores vermelhos de erro — estética de terminal cyberpunk escuro

A busca na web do Claude Code não funciona? Você não está sozinho. Entre recusas de permissão, resultados como “Did 0 searches” e falhas silenciosas, a ferramenta WebSearch integrada da Anthropic tem sido uma fonte constante de frustração para desenvolvedores. Este guia cobre as quatro causas mais comuns — e a correção para cada uma, incluindo a alternativa que nunca quebra.

Por que a Web Search do Claude Code quebra

A ferramenta WebSearch nativa do Claude Code (web_search) é integrada ao próprio modelo Claude — não é uma integração externa. Isso significa que, quando ela quebra, o problema acontece dentro da camada de raciocínio do Claude, o que dificulta mais o debug do que uma falha comum de ferramenta.

Os quatro modos de falha mais comuns:

Problema O que você vê Causa raiz
Permission denied Pop-up “Permission denied”, até mesmo no modo --permissionless Conflito no settings.json ou override de Edit(*)
Falha silenciosa “Did 0 searches” sem resultados Bug de API ou requisição malformada com blocked_domains: []
Ferramenta ausente Ferramenta web_search não encontrada / erro 422 Incompatibilidade de versão do modelo ou da API
Ferramenta errada usada Claude tenta usar o Chrome connector ou web_fetch no lugar Problema de roteamento do modelo

Nada disso é culpa sua. São bugs documentados — alguns estão abertos no GitHub há meses.

Correção 1: Verifique sua configuração de permissões

Problema mais comum: o bloco permissions no seu settings.json está bloqueando a WebSearch sem que você perceba.

Etapa 1: Encontre seu arquivo de configuração

cat ~/.claude/settings.json

Etapa 2: Procure estes padrões

Problemático — Edit(*) bloqueia a WebSearch:

{
  "permissions": {
    "allow": ["Edit(*)"],
    "deny": []
  }
}

O wildcard Edit(*) na lista allow pode fazer o Claude Code pedir permissão em toda chamada de WebSearch — e, em algumas versões, negar isso silenciosamente.

Correção:

{
  "permissions": {
    "allow": [
      "Edit(*)",
      "WebSearch(*)",
      "WebFetch(*)"
    ],
    "deny": []
  }
}

Etapa 3: Verifique regras de deny conflitantes

Se você tiver WebSearch(**) ou WebFetch(**) no bloco deny, remova:

// ❌ Isso bloqueia a busca na web E quebra o carregamento de plugins
{
  "permissions": {
    "deny": ["WebSearch(**)", "WebFetch(**)"]
  }
}

Bug conhecido no GitHub (#11812): adicionar WebFetch/WebSearch a permissions.deny faz todos os plugins falharem no carregamento. Se seus plugins quebraram depois de uma mudança nas configurações, provavelmente esse é o motivo.

Etapa 4: Recarregue as configurações

# Reinicie sua sessão do Claude Code para aplicar as mudanças
# Não existe hot-reload para alterações em settings.json

Correção 2: Tente o modo permissionless (com uma ressalva)

Se a configuração de permissões não for o problema, execute o Claude Code no modo permissionless:

claude --permissionless

Mas atenção ao issue #21091 no GitHub: mesmo no modo permissionless, a WebSearch pode ser negada. Esse é um bug confirmado que afeta assinantes Claude Max. Se isso estiver acontecendo com você, o contorno é:

# Ignore completamente a WebSearch integrada e use um servidor MCP
# (veja a Correção 3)

Correção 3: Use um servidor MCP para busca na web

Quando a WebSearch integrada está quebrada, a correção mais confiável dentro do Claude Code é usar um servidor MCP que faça a busca na web externamente:

Opção A: Brave Search MCP Server

# Instale o Brave Search MCP server
claude mcp add brave-search -- npx -y @anthropic/mcp-server-brave-search \
  --env BRAVE_API_KEY=your_brave_api_key_here

O Brave Search MCP server é mantido pela Anthropic e é o mais próximo de uma ferramenta “oficial” de busca na web. Ele retorna resultados estruturados que o Claude Code pode interpretar e citar.

Prós:

  • Mantido pela Anthropic
  • Resultados estruturados e prontos para citação
  • Tier gratuito disponível (2.000 consultas/mês)

Contras:

  • Exige uma Brave API key separada
  • Fornece apenas snippets de busca — sem conteúdo completo das páginas
  • Cada chamada adiciona cerca de 4.000 tokens de overhead de descrição da ferramenta

Opção B: Tavily Search MCP Server

claude mcp add tavily -- npx -y @tavily/mcp-server \
  --env TAVILY_API_KEY=your_tavily_key_here

O Tavily foi criado especificamente para busca de agentes de IA — ele retorna conteúdo completo das páginas além dos snippets.

Opção C: SerpAPI MCP Server

claude mcp add serpapi -- npx -y @serpapi/mcp-server \
  --env SERPAPI_API_KEY=your_serpapi_key_here

O SerpAPI fornece resultados de busca do Google. É a opção mais flexível, mas também a mais cara.

Correção 4: A alternativa confiável — AnyCap Web Search (sem MCP, sem permissões)

Melhor para: desenvolvedores que só querem que a busca na web funcione — sempre, sem debug.

O problema real da WebSearch integrada do Claude Code não são só os bugs. É a arquitetura subjacente: como a busca na web funciona como uma ferramenta interna do modelo, ela compartilha a janela de contexto, o modelo de permissões e os rate limits do Claude. Quando qualquer um deles falha, a busca na web falha também.

A AnyCap segue outro caminho: a busca na web roda como uma capacidade externa, fora do contexto do Claude Code — com seu próprio motor, suas próprias API keys e seu próprio formato de saída. O Claude Code só a chama como qualquer outra ferramenta CLI.

Configuração (30 segundos — a mesma instalação da geração de imagens)

# Se você já instalou a AnyCap para geração de imagens, pule esta etapa
npx -y skills add anycap-ai/anycap -a claude-code -y
curl -fsSL https://anycap.ai/install.sh | sh
anycap login

Pesquise na web a partir do Claude Code

Busca básica na web:

anycap web search \
  --query "Claude Code web search permission denied fix" \
  --results 5

Saída:

Searching for: Claude Code web search permission denied fix...
Found 5 results:

1. GitHub Issue #21091 — WebSearch Tool Blocked Despite Permissionless Mode
   https://github.com/anthropics/claude-code/issues/21091
   Relevant: Confirmed bug — WebSearch denied even with --permissionless flag

2. Reddit r/ClaudeCode — How to grant Claude Code web search permission
   https://reddit.com/r/ClaudeCode/comments/1kouc2z/
   Relevant: Edit(*) in settings.json blocks WebSearch

3-5. [additional results]

O Claude Code pode ler e citar esses resultados diretamente — sem pop-up de permissão, sem “Did 0 searches”, sem debug de settings.json.

Pesquisa aprofundada com múltiplas fontes:

anycap web deep-research \
  --topic "State of AI coding agents 2026" \
  --depth 3 \
  --output research.md

Isso executa múltiplas consultas, segue links, extrai conteúdo e compila um documento de pesquisa com citações — tudo fora da janela de contexto do Claude Code.

Rastreamento web ao vivo com conteúdo completo da página:

anycap web crawl \
  --url "https://docs.anthropic.com/en/docs/claude-code/web-search" \
  --format markdown

Retorna a página inteira em markdown para que o Claude Code possa interpretar e referenciar.

Por que essa abordagem não quebra

WebSearch integrada do Claude Code AnyCap Web Search
Modelo de permissões Permissões do Claude Code (com bugs) Externo — sem permissões do Claude
Roteamento de API Interno ao modelo (sujeito a bugs de roteamento) Motor de busca dedicado
Rate limits Compartilha os rate limits do Claude Code API separada, limites independentes
Formato de saída Texto formatado pelo Claude JSON estruturado com URLs de origem
Conteúdo completo da página Não (apenas snippets) Sim (via web crawl)
Pesquisa aprofundada Não Sim (múltiplas consultas, múltiplas fontes)
Overhead de contexto Variável (depende do modelo) ~1.000 tokens por chamada
Credencial API key da Anthropic Um login da AnyCap

Comparação: qual correção você deve usar?

Correção Funciona quando Tempo de configuração Confiabilidade
Correção 1: Configuração de permissões O problema está no settings.json 5 min Média (pode quebrar de novo)
Correção 2: Modo permissionless O problema é o modelo de permissões 1 min Baixa (bug conhecido #21091)
Correção 3: Servidor MCP Você tem API keys e paciência 15–30 min Alta (motor externo)
Correção 4: AnyCap CLI Você quer que a busca simplesmente funcione 2 min A mais alta (motor dedicado)

FAQ

Por que o Claude Code mostra “Did 0 searches”?

Esse é um bug conhecido em que a ferramenta interna WebSearch do Claude Code é executada, mas não retorna resultados — até mesmo para consultas que retornariam resultados no navegador. Isso é causado por um parâmetro blocked_domains: [] malformado na requisição da API. A única correção realmente confiável é usar uma ferramenta de busca externa (Correção 3 ou Correção 4).

A busca na web do Claude Code é gratuita?

Sim, a WebSearch integrada do Claude Code está incluída na sua assinatura Claude (Pro, Max ou Team). No entanto, alternativas baseadas em MCP (Correção 3) normalmente exigem API keys separadas com sua própria cobrança. A busca na web da AnyCap é pay-as-you-go, começando com US$ 5 em crédito grátis.

Posso usar Google Search a partir do Claude Code?

Não com a WebSearch integrada — ela usa o backend de busca da própria Anthropic. Para resultados do Google especificamente, use o SerpAPI MCP server (Correção 3, Opção C) ou o anycap web search da AnyCap, que retorna resultados agregados de múltiplas fontes.

Por que a busca na web funciona no claude.ai, mas não no Claude Code?

Claude Code e claude.ai usam implementações diferentes de busca na web. A interface web do claude.ai tem uma integração de busca mais madura; a WebSearch baseada em terminal do Claude Code é uma ferramenta mais nova e ainda tem bugs conhecidos. Se a busca funciona na web, mas não no seu terminal, você está lidando com um problema específico do Claude Code — mais comumente configuração de permissões ou o bug “Did 0 searches”.

A busca na web da AnyCap funciona quando o Claude Code está offline?

Não — mas nada mais funciona também. A busca na web da AnyCap exige conexão com a internet, porque faz requisições HTTP reais para mecanismos de busca. O que ela não exige é que a ferramenta WebSearch do Claude Code esteja funcional, com permissão aprovada ou sem limitações de taxa. Se você tem internet, a busca da AnyCap funciona.

Próximos passos