O caso: uma empresa usa o Claude Sonnet 5.5 num assistente interno de pesquisa. Em cada sessão, o assistente lê 5 páginas de documentação com a ferramenta web fetch. São 2.000 sessões por mês. Desde 20/10/2026, o administrador pode desligar o web fetch para a organização inteira ou limitar os domínios no Console. Vale a pena mexer nisso, e quanto custa cada página lida?
Resposta curta: o web fetch não tem tarifa própria: você paga os tokens da página que entra no contexto. Com 5 páginas grandes de documentação, a sessão leva 125.000 tokens de entrada, ou US$ 0,2500 no Sonnet 5.5. No mês, são US$ 500,00. Com um teto de 10.000 tokens por página, o mês cai para US$ 200,00. Volumes e tamanhos de página do caso são exemplo.
O que mudou em 20/10/2026
As notas de versão da Claude Platform de 20/10/2026 trazem três mudanças ligadas ao web fetch, a ferramenta que deixa o Claude ler o conteúdo de uma URL durante o pedido:
- Desligar para a organização. Um administrador pode desligar o web fetch na página Capabilities do Console. Com ele desligado, um pedido à Messages API que inclua a ferramenta falha com erro 400 (
invalid_request_error), com a mensagem de que o web fetch não está habilitado. - Domínios por organização. Com o web fetch ligado, o administrador pode definir na mesma página uma lista de domínios permitidos ou bloqueados.
- Managed Agents seguem a regra. As ferramentas
web_fetcheweb_searchdos Managed Agents passam a respeitar as restrições de domínio da organização.
A documentação explica como as regras se somam. A lista allowed_domains de um pedido precisa estar dentro da lista permitida da organização. Um domínio fora dela gera erro de validação. Se o pedido permitir um domínio que a organização bloqueia, a API devolve 400 com o nome do domínio em conflito.
Na prática, o controle sai do código de cada time e vai para o Console. É um recurso de segurança, mas mexe na conta, porque cada página lida vira token de entrada.
Como o web fetch é cobrado
A página oficial da ferramenta é direta: o web fetch não tem custo adicional. Você paga só os tokens do conteúdo buscado que entra na conversa, ao preço de entrada do modelo. O campo usage da resposta mostra quantas buscas houve em server_tool_use.web_fetch_requests.
A documentação dá três tamanhos de referência:
| Conteúdo buscado | Tokens aproximados | Sonnet 5.5 | Opus 5.5 | Fable 5.1 |
|---|---|---|---|---|
| Página comum (10 kB) | 2.500 | US$ 0,0050 | US$ 0,0100 | US$ 0,0250 |
| Página grande de documentação (100 kB) | 25.000 | US$ 0,0500 | US$ 0,1000 | US$ 0,2500 |
| PDF de artigo científico (500 kB) | 125.000 | US$ 0,2500 | US$ 0,5000 | US$ 1,2500 |
Preços de entrada pela tabela do site, atualizada em outubro de 2026. Uma leitura isolada é barata. O problema é a soma: o agente lê várias páginas por sessão, e essas páginas ficam no histórico.
A conta do caso: sessão e mês
Premissas de exemplo: 5 páginas grandes de documentação por sessão, de 25.000 tokens cada, e 2.000 sessões por mês. A comparação é entre deixar a página inteira entrar e usar o parâmetro max_content_tokens com teto de 10.000 tokens por página.
| Modelo | Sessão sem teto | Sessão com teto | Mês sem teto | Mês com teto |
|---|---|---|---|---|
| Sonnet 5.5 | US$ 0,2500 | US$ 0,1000 | US$ 500,00 | US$ 200,00 |
| Opus 5.5 | US$ 0,5000 | US$ 0,2000 | US$ 1.000,00 | US$ 400,00 |
| Fable 5.1 | US$ 1,2500 | US$ 0,5000 | US$ 2.500,00 | US$ 1.000,00 |
A tabela conta só os tokens das páginas, na primeira leitura. Instruções, pergunta e resposta vêm à parte. No Sonnet 5.5, o teto corta 60% do custo das páginas. Em reais, pelo dólar de referência do site, o mês vai de R$ 2.504,80 para R$ 1.001,92.
O teto tem um preço: a página é cortada. Se a informação estiver no fim do documento, o Claude não a vê. Teste o teto com perguntas reais antes de fixar o número.
Atenção ao Haiku 5.5
O Haiku 5.5 cobra mais caro quando o prompt passa de 100 mil tokens. A regra conta toda a entrada do pedido, incluindo o que veio do web fetch. No caso, as 5 páginas sem teto somam 125.000 tokens e já passam do limite sozinhas. Com o teto, ficam em 50.000, e a sessão custa US$ 0,0050 em páginas no Haiku 5.5, pelo preço até 100 mil tokens.
Para agentes baratos no Haiku 5.5, o max_content_tokens deixa de ser ajuste fino e vira proteção contra a mudança de faixa.
O custo escondido: a página volta a cada turno
O conteúdo buscado entra no histórico. A cada novo turno da conversa, a API recebe o histórico inteiro e cobra a página de novo como entrada.
Exemplo no Sonnet 5.5: depois das 5 leituras sem teto, a conversa segue por mais 3 turnos. A API relê 375.000 tokens de páginas.
| Como o histórico é cobrado | Custo extra por sessão | Em 2.000 sessões |
|---|---|---|
| Entrada normal | US$ 0,7500 | US$ 1.500,00 |
| Cache de prompt de 5 minutos | US$ 0,1000 | US$ 200,00 |
A linha do cache soma o adicional da gravação, cobrada uma vez, e as leituras pelo preço de cache, de US$ 0,10 por milhão no Sonnet 5.5. A releitura sem cache custa mais que a primeira leitura das páginas.
PDF não respeita o teto
Um detalhe da documentação muda a conta. O max_content_tokens vale para texto, não para conteúdo binário como PDF. Um PDF de 500 kB entra com cerca de 125.000 tokens mesmo com o teto ligado. No Sonnet 5.5, isso dá US$ 0,2500 por leitura, ou US$ 500,00 se cada sessão do caso ler um PDF desse tamanho.
Se o seu agente lê relatórios e editais em PDF, o controle de custo precisa ser outro: limitar domínios, usar max_uses ou filtrar o conteúdo.
Outras alavancas da própria ferramenta
A documentação lista mais quatro formas de controlar o que entra no contexto:
max_uses: limita o número de buscas por pedido. Buscas que falham também contam. Não há limite padrão.- Filtragem dinâmica: nas versões
web_fetch_20260209e posteriores, o Claude escreve código para filtrar a página antes de ela entrar no contexto. Funciona no Claude 4.6 em diante. response_inclusion: na versãoweb_fetch_20260318, o valor"excluded"tira da resposta os blocos de página consumidos pelo código. A documentação diz que isso reduz o custo de tokens de saída em fluxos de agente.- Cache da ferramenta: o web fetch guarda resultados em cache. O padrão é
use_cache: true. Desligar traz conteúdo novo, mas aumenta a latência.
O que fazer agora
| Situação | Ação sugerida |
|---|---|
| Ninguém na empresa usa web fetch | Desligar na página Capabilities e evitar uso acidental |
| Agente só precisa de sites conhecidos | Lista de domínios permitidos na organização |
| Agente lê documentação longa | max_content_tokens e filtragem dinâmica |
| Agente lê PDF | Domínios restritos e max_uses, porque o teto não vale |
| Conversas com muitos turnos | Cache de prompt sobre o histórico |
Antes de desligar, procure no código pedidos que mandam a ferramenta. Depois da mudança, eles passam a falhar com 400, e o erro aparece para o usuário final.
Erros comuns
- Achar que o web fetch é grátis. A ferramenta não tem tarifa, mas cada página vira token de entrada.
- Contar a página uma vez só. Ela volta em todo turno seguinte.
- Confiar no teto para PDF. O
max_content_tokensnão vale para conteúdo binário. - Desligar sem avisar os times. Pedidos com a ferramenta passam a receber erro 400.
- Lista do pedido maior que a da organização. Domínio fora da lista da organização gera erro de validação.
Perguntas frequentes
Quanto custa ler uma página com o web fetch do Claude?
Só os tokens da página, ao preço de entrada. Uma página comum de 10 kB tem cerca de 2.500 tokens: US$ 0,0050 no Sonnet 5.5 e US$ 0,0100 no Opus 5.5.
Como desligar o web fetch na minha organização?
Um administrador desliga na página Capabilities do Console. Depois disso, pedidos à Messages API com a ferramenta recebem erro 400.
O teto de tokens vale para PDF?
Não. Um PDF de 500 kB entra com cerca de 125.000 tokens mesmo com o teto, o que custa US$ 0,2500 no Sonnet 5.5.
Quanto economiza o max_content_tokens?
No caso de exemplo, com teto de 10.000 tokens em páginas de 25.000, o mês no Sonnet 5.5 cai de US$ 500,00 para US$ 200,00, só nas páginas.
Por que a conta sobe em conversas longas?
Porque a página fica no histórico. No caso, 3 turnos depois das leituras custam US$ 0,7500 a mais por sessão sem cache e US$ 0,1000 com cache.
Quer refazer a conta com o seu agente? Use a calculadora de custo de API de IA e some os tokens das páginas à entrada.
