Claude Platform Docs
Notas de versão

Notas de versão da Claude Platform

Atualizações da Claude Platform, incluindo a Claude API, os SDKs de cliente e o Claude Console.

Subscribe

As notas de versão da Claude Platform listam as alterações na Claude API, nos SDKs de cliente e no Claude Console, das mais recentes para as mais antigas.

9 de outubro de 2026

  • Agora você pode permitir que um agente do Claude Managed Agents use workflows dinâmicos, em beta com o cabeçalho beta managed-agents-2026-04-01. Para trabalhos com muitas partes, como revisar centenas de documentos, o agente pode escrever um "workflow" (fluxo de trabalho). Um workflow é um programa que executa muitos agentes em fases e combina seus resultados. O servidor o executa em segundo plano como uma execução de workflow. Para ativar os workflows dinâmicos, defina o campo multiagent do agente como {"type": "multiagent_20261001", "workflows": {"type": "enabled"}}. Para orientar o agente, diga a ele no seu prompt do sistema quando iniciar uma execução. Acompanhe cada execução por meio dos eventos workflow_run.* no fluxo de eventos da sessão. Consulte Execuções de workflow.

8 de outubro de 2026

7 de outubro de 2026

  • Reduzimos o preço das leituras de "prompt cache" (cache de prompt) no Claude Sonnet 5.5 de $0,20 USD para $0,10 USD por milhão de tokens: 0,05x o preço base de entrada em vez de 0,1x. As gravações em cache e todos os outros preços permanecem inalterados. Consulte Preços do cache de prompt.
  • Lançamos o Claude Haiku 5.5 (claude-haiku-5-5), nosso modelo mais capaz ajustado para trabalhos de alto volume e sensíveis à latência. Ele tem uma "context window" (janela de contexto) de 1M de tokens, 128k tokens máximos de saída e pensamento adaptativo com o parâmetro effort. Ele está disponível na Claude API, no Claude in Amazon Bedrock, na Claude Platform on AWS, no Claude on Google Cloud e no Claude in Microsoft Foundry. Consulte Novidades do Claude Haiku 5.5.
  • Código escrito para o Claude Haiku 4.5 pode quebrar no Claude Haiku 5.5. O "extended thinking" (pensamento estendido) manual (budget_tokens), os parâmetros de amostragem temperature, top_p e top_k, e o preenchimento prévio de mensagens do assistente podem, cada um, retornar um erro 400. computer_20250124 também retorna um erro 400: use o toolset computer_toolset_20260801 na Claude API e no Google Cloud, ou computer_20251124 no Amazon Bedrock. Uma requisição que envia blocos de pensamento de volta após uma alteração em system, tools ou em turnos anteriores também pode retornar um erro 400. No Amazon Bedrock, as saídas estruturadas não estão disponíveis para o Claude Haiku 5.5. O pensamento adaptativo fica ativado por padrão, então uma resposta pode começar com blocos thinking, e o texto deles é omitido, a menos que você defina thinking.display como "summarized". O mesmo texto também conta como mais tokens. Consulte o guia de migração para cada alteração. Para padrões de prompting específicos do modelo, consulte Prompting do Claude Haiku 5.5.
  • Os SDKs de Python e TypeScript agora incluem classes, em beta, para a ferramenta de uso de navegador e a ferramenta de uso de computador. Você cria uma subclasse de uma delas e escreve um método por ferramenta usando sua própria automação de navegador ou de desktop. O SDK executa o loop de ferramentas, as políticas de URL e de arquivos que você define para o navegador e seu callback de aprovação. Consulte Uso de navegador e de computador com os toolsets do SDK.
  • Os planos Claude Max e Team agora incluem créditos mensais de API. Para saber como resgatá-los, consulte Créditos de API para os planos Max e Team.
  • No Claude Managed Agents, um ambiente de nuvem com rede limited agora também aplica seus allowed_hosts às ferramentas web_search e web_fetch. Uma chamada web_fetch para uma URL em um host que não corresponde a allowed_hosts retorna ao agente um resultado de erro url_not_allowed. web_search omite resultados desses hosts. Quando allowed_hosts não lista nenhum host, nenhuma das ferramentas retorna uma página ou um resultado de pesquisa. allow_package_managers e allow_mcp_servers não adicionam hosts para essas ferramentas. Para permitir que as ferramentas alcancem um host, adicione-o a allowed_hosts, o que também o libera para o sandbox. A rede unrestricted e os ambientes auto-hospedados não limitam essas ferramentas. Consulte Rede do ambiente.
  • Com a rede limited, a criação de uma sessão falha com um erro 400 quando o allowed_domains de uma ferramenta web habilitada tem uma entrada que não está dentro de allowed_hosts. O mesmo acontece com uma atualização de sessão que adiciona tal entrada. Uma entrada de allowed_hosts corresponde a um único host exato, a menos que comece com *., então docs.example.com não está dentro de ["example.com"]. Para corrigir o erro, adicione o host a allowed_hosts ou remova a entrada de allowed_domains. Consulte Restringir domínios de pesquisa na web e busca na web.
  • No Claude Managed Agents, a ferramenta web_fetch agora busca apenas URLs que já apareceram na sessão, por exemplo no texto de uma mensagem do usuário, em um resultado de web_search ou em uma página que web_fetch retornou anteriormente. Isso reduz o risco de exfiltração de dados. Uma URL que aparece apenas na própria saída do Claude, no "system prompt" (prompt do sistema) do agente, em um documento anexado ou na saída de uma ferramenta como bash, read ou uma ferramenta MCP não conta: uma chamada web_fetch para ela retorna ao agente um resultado de erro url_not_in_prior_context. Para permitir que o agente busque uma URL, envie-a no texto de um evento user.message.

6 de outubro de 2026

  • Adicionamos capabilities.server_tools à Models API. GET /v1/models e GET /v1/models/{model_id} agora informam se cada modelo aceita as ferramentas de pesquisa na web e de execução de código. Para verificar se um modelo aceita a ferramenta de execução de código, leia capabilities.server_tools.code_execution. O capabilities.code_execution de nível superior informa se o código pode chamar as outras ferramentas da sua requisição. Consulte Usando a Models API.

5 de outubro de 2026

  • Adicionamos capabilities.thinking.types.disabled à Models API. GET /v1/models e GET /v1/models/{model_id} agora informam se cada modelo aceita thinking: {type: "disabled"}, que desativa o pensamento. Consulte Usando a Models API.

1 de outubro de 2026

  • Adicionamos um campo line à Models API. GET /v1/models e GET /v1/models/{model_id} agora retornam a linha de modelos à qual cada modelo pertence. Claude Opus 4.5 e Claude Opus 4.6 informam opus, por exemplo. Use line para agrupar modelos sem analisar seus IDs. line é null para um modelo que não pertence a nenhuma linha. Consulte Usando a Models API.
  • O Dreams (prévia de pesquisa) agora oferece suporte ao Claude Opus 5.5, ao Claude Fable 5.1 e ao Claude Sonnet 5.5. Consulte Modelos compatíveis.

30 de setembro de 2026

  • No Python SDK 1.10.0, TypeScript SDK 0.130.0, C# SDK 12.52.0, Go SDK 1.77.0, Java SDK 2.67.0, PHP SDK 0.53.0, Ruby SDK 1.75.0 e na versão 1.37.0 da CLI ant, os métodos da Admin API para informações da organização, membros, convites, workspaces, chaves de API, limites de taxa, contas de serviço, federação de identidade de carga de trabalho, chaves de criptografia gerenciadas pelo cliente e configurações de conformidade saíram do beta: chame-os em client.organization e ant organization. Essas versões também mantêm client.beta.organization e ant beta:organization.
  • Anunciamos a descontinuação do modelo Claude Sonnet 4.5 (claude-sonnet-4-5-20250929), com desativação na Claude API agendada para 30 de novembro de 2026. Recomendamos migrar para o Claude Sonnet 5.5. Leia mais em Descontinuações de modelos.

28 de setembro de 2026

  • Lançamos o Claude Sonnet 5.5 (claude-sonnet-5-5). Ele está disponível na Claude API, no Claude no Amazon Bedrock, na Claude Platform on AWS, no Claude no Google Cloud e no Claude no Microsoft Foundry. Para sua janela de contexto, limites de saída e preços, consulte a página do modelo Claude Sonnet 5.5.
  • Código escrito para o Claude Sonnet 5 pode quebrar no Claude Sonnet 5.5 de cinco maneiras. Para desativar o pensamento antecipado, envie thinking: {"type": "between_tools"} em vez de "disabled", com esforço high ou inferior. O "tool use" (uso de ferramentas) forçado (tipos de tool_choice any e tool) retorna um erro 400. Os blocos de pensamento ficam vinculados ao modelo e à conversa. Na Claude API e no Google Cloud, a ferramenta de uso de computador anterior computer_20251124 não é aceita. A ferramenta advisor rejeita Claude Opus 4.8, Claude Opus 4.7 e Claude Sonnet 5 como advisors. Consulte Novidades do Claude Sonnet 5.5 para cada alteração e o guia de migração para requisições de antes e depois. Para padrões de prompting específicos do modelo, consulte Prompting do Claude Sonnet 5.5.
  • Os blocos de pensamento que o Claude Sonnet 5.5 produz funcionam apenas na conta que os produziu ou em uma conta vinculada a ela. Quando outra conta envia um desses blocos, a API descarta o bloco antes que o modelo o veja, e a requisição é bem-sucedida. Blocos de modelos anteriores não são afetados. Consulte Pensamento preservado.

24 de setembro de 2026

  • Estamos retomando a cobrança de "refusals" (recusas) que chegam antes de qualquer saída quando stop_details.category é "bio", "frontier_llm" ou "reasoning_extraction", as categorias em que medimos baixos volumes de falsos positivos. Recusas no meio do streaming já eram cobradas. As recusas cobradas com esta alteração são faturadas como qualquer outra requisição, pelas tarifas do modelo que a executou. Recusas antes de qualquer saída em outras categorias continuam sem cobrança, e o crédito de fallback não muda. Esta alteração se aplica a todas as plataformas. Consulte Como as recusas são cobradas.
  • Os endpoints de sessões locais da Compliance API saíram do beta para sessões do Claude for Microsoft 365 no Excel, PowerPoint, Word e Outlook (valores de product_surface que começam com office_agents). Consulte Sessões nas máquinas dos usuários.
  • O Activity Feed da Compliance API não retorna mais nomes de arquivos, nomes de documentos de projeto nem títulos de artefatos. Os campos filename e title em atividades de arquivo, documento de projeto e artefato agora estão sempre vazios ou omitidos, inclusive em atividades registradas antes desta alteração. Para consultar um nome ou título pelo ID presente na atividade, use uma Compliance Access Key com o escopo read:compliance_user_data. Consulte Entender o objeto Activity.

23 de setembro de 2026

  • O diagnóstico de cache saiu do beta na Claude API e não exige mais o cabeçalho beta cache-diagnosis-2026-04-07. Para ativá-lo, inclua o objeto diagnostics em uma requisição Messages. Requisições que ainda enviam o cabeçalho continuam funcionando como antes. As respostas de POST /v1/messages agora sempre incluem o campo diagnostics, que é null quando a requisição não incluiu o objeto diagnostics.

22 de setembro de 2026

  • Lançamos o Claude Opus 5.5 (claude-opus-5-5), um modelo para programação agêntica de longa duração e trabalho de conhecimento. Ele tem uma "context window" (janela de contexto) de 1M de tokens por padrão, 128k tokens de saída máximos e "adaptive thinking" (pensamento adaptativo) sempre ativo, a $4 / $20 USD por MTok (o Claude Opus 5 custa $5 / $25). O Claude Opus 5.5 está disponível na Claude API, no Claude in Amazon Bedrock, na Claude Platform on AWS, no Claude on Google Cloud e no Claude in Microsoft Foundry. Consulte Novidades do Claude Opus 5.5 para ver capacidades, alterações na API e orientações de migração.
  • No Claude Opus 5.5, o pensamento não pode ser desativado: thinking: {"type": "disabled"} e thinking: {"type": "enabled", ...} retornam um erro 400. Omita o campo thinking e controle a profundidade do pensamento com o parâmetro effort. Os tipos any e tool de tool_choice também retornam um erro 400, como no Claude Fable 5.1; use auto com "strict tool use" (uso estrito de ferramentas). Na Claude API e no Google Cloud, o "computer use" (uso do computador) neste modelo requer o toolset computer_toolset_20260801, e a ferramenta anterior computer_20251124 retorna um erro 400; no Amazon Bedrock, computer_20251124 continua funcionando. Consulte o guia de migração.
  • O "fast mode" (modo rápido) (prévia de pesquisa) está disponível para o Claude Opus 5.5 na Claude API.
  • Agora é possível definir ferramentas dentro de uma mensagem do sistema no meio da conversa, em beta na Claude API com o cabeçalho beta inline-tools-2026-09-15. Um bloco tool_addition pode conter a definição completa da ferramenta (tool: {"type": "tool_definition", "definition": {...}}), para que você possa adicionar uma ferramenta, alterar seu schema ou mover uma ferramenta de servidor para uma versão mais recente sem editar tools nem invalidar o "prompt cache" (cache de prompt). O mesmo cabeçalho abrange a adição e a remoção de ferramentas por referência. Usando também o cabeçalho beta mcp-client-2026-09-15 do conector MCP, a definição pode ser um toolset MCP, e uma resposta registra a lista de ferramentas obtida de cada servidor em um bloco mcp_tool_listing, que fixa essa lista quando você a envia de volta.

18 de setembro de 2026

  • No diagnóstico de cache, a resposta a uma requisição que envia o cabeçalho beta cache-diagnosis-2026-04-07 agora sempre inclui o campo diagnostics. O campo é null quando a requisição não incluiu o objeto diagnostics. Antes, o campo era omitido nesse caso.
  • Os endpoints de sessões locais da Compliance API agora também retornam transcrições de sessões do Claude in Chrome (valor de product_surface claude_in_chrome), em beta para organizações Claude Enterprise, com sua Compliance Access Key existente e o escopo read:compliance_user_data. Consulte Sessões nas máquinas dos usuários.

14 de setembro de 2026

  • A Messages API agora pode compactar uma conversa sob demanda na Claude API, em beta com o cabeçalho beta compact-2026-09-04. Envie o parâmetro de nível superior compaction, e a API retorna um bloco compaction assinado que resume as mensagens que você enviou. Em solicitações posteriores, envie esse bloco primeiro, no lugar dessas mensagens. Você escolhe quando compactar, a solicitação pode ser executada em segundo plano e você pode manter os turnos recentes palavra por palavra após o resumo. Em modelos com pensamento preservado, o pensamento nesses turnos mantidos pode permanecer válido.
  • Com o cabeçalho beta thinking-binding-controls-2026-08-01, o campo de resposta input_transformations ganha um segundo tipo de entrada, thinking_mismatch_allowed. Ele identifica um bloco de pensamento que falhou na verificação de prefixo em uma solicitação na qual a API não aplica essa verificação: no Claude Fable 5.1, por exemplo, uma solicitação de uma conta criada antes de 31 de agosto de 2026, com prefix_mismatch_behavior não definido. O bloco ainda chega ao modelo inalterado. Registre essas entradas para encontrar edições de histórico no tráfego de produção antes de optar pela aplicação da verificação. Consulte Definir o comportamento de incompatibilidade e ler input_transformations.

10 de setembro de 2026

  • As políticas de permissão do Claude Managed Agents agora incluem auto: o servidor avalia cada chamada de ferramenta do agente ou MCP e a executa, a nega ou pausa para aguardar sua aprovação. Os eventos agent.tool_use e agent.mcp_tool_use informam como cada chamada foi avaliada em um campo evaluation junto com evaluated_permission. Consulte Deixar o servidor avaliar cada chamada com auto.
  • A versão 1.32.0 da CLI ant adiciona ant beta:sessions connect, que conecta seu terminal a uma sessão do Claude Managed Agents. Você pode acompanhar a sessão ao vivo, enviar mensagens e permitir ou negar chamadas de ferramentas que estão aguardando aprovação. Passe --web para servir localmente o visualizador de sessões do Claude Console e abrir a sessão nele. Consulte Conecte-se a uma sessão do Managed Agents a partir do seu terminal.

9 de setembro de 2026

  • No diagnóstico de cache, a API agora armazena a "fingerprint" (impressão digital) de uma requisição somente quando a requisição inclui o objeto diagnostics. Uma requisição que envia apenas o cabeçalho beta cache-diagnosis-2026-04-07 ainda é aceita, mas nenhuma fingerprint é armazenada. Um turno posterior que aponte previous_message_id para ela informa previous_message_not_found. Inclua diagnostics em todos os turnos, com "previous_message_id": null no primeiro.

3 de setembro de 2026

  • A versão 1.30.0 da CLI ant adiciona ant apply, que cria e atualiza agentes, ambientes, skills, memory stores e implantações a partir de arquivos no seu repositório. Descreva cada recurso em um arquivo, execute ant apply e aprove o plano que ele exibe. Faça commit do arquivo de lock claude-lock.json que ele grava para que execuções posteriores, na sua máquina ou em CI, atualizem os mesmos recursos em vez de criar novos. Consulte Gerencie recursos como código com ant apply.
  • As alterações de esforço por mensagem, em beta, também estão disponíveis no Google Cloud para Claude Fable 5.1, Claude Mythos 5.1 e Claude Opus 5, com o mesmo cabeçalho beta mid-conversation-output-config-2026-07-01.

1º de setembro de 2026

  • Lançamos o Claude Fable 5.1 (claude-fable-5-1), o sucessor do Claude Fable 5 para codificação agêntica de longa duração, trabalho de conhecimento e pesquisa, junto com o Claude Mythos 5.1 (claude-mythos-5-1) para participantes do Project Glasswing. Ambos os modelos suportam uma "context window" (janela de contexto) de 1M tokens por padrão, 128k tokens máximos de saída e "adaptive thinking" (pensamento adaptativo) sempre ativo, a $10 / $50 USD por MTok, o mesmo que o Claude Fable 5, com leituras de cache reduzidas para $0,25 por MTok. O Claude Fable 5.1 está disponível na Claude API, no Claude in Amazon Bedrock, na Claude Platform on AWS, no Claude on Google Cloud e no Claude in Microsoft Foundry. Consulte O que há de novo no Claude Fable 5.1 para ver capacidades, alterações na API e orientações de migração.
  • As leituras de cache de prompt no Claude Fable 5.1 e no Claude Mythos 5.1 custam $0,25 USD por milhão de tokens: 0,025x o preço base de entrada, em comparação com 0,1x em outros modelos. As gravações de cache não mudam. Consulte Preços do cache de prompt.
  • No Claude Fable 5.1 e no Claude Mythos 5.1, os tipos any e tool de tool_choice não são suportados e retornam um erro 400. auto e none não mudam. Para garantir entradas de ferramentas em conformidade com o schema, use "strict tool use" (uso estrito de ferramentas) ou "structured outputs" (saídas estruturadas).
  • Os "thinking blocks" (blocos de pensamento) produzidos pelo Claude Fable 5.1 e pelo Claude Mythos 5.1 são preservados apenas para o modelo que os produziu ou para um mais recente: modelos anteriores não conseguem lê-los, e a API descarta um bloco reenviado a um modelo anterior. O Claude Fable 5.1 aceita blocos de pensamento do Claude Opus 5, do Claude Fable 5, do Claude Mythos 5 e de modelos Claude anteriores. No Claude Fable 5.1, a API também verifica se nada antes de um bloco mudou: para novas contas criadas em ou após 31 de agosto de 2026, reenviar um bloco depois que o prompt do sistema (system), tools ou uma mensagem anterior tiver mudado retorna um erro 400. Com o cabeçalho beta thinking-binding-controls-2026-08-01, os blocos descartados são informados em um campo de resposta input_transformations, e thinking.block_binding.prefix_mismatch_behavior escolhe entre rejeitar e descartar blocos cujo histórico mudou. Consulte Pensamento preservado.
  • As alterações de esforço por mensagem estão em beta no Claude Fable 5.1, no Claude Mythos 5.1 e no Claude Opus 5 na Claude API. Adicione uma mensagem role: "system" com output_config.effort dentro de messages para alterar o esforço em turnos posteriores, preservando o cache de prompt. Inclua o cabeçalho beta mid-conversation-output-config-2026-07-01 em suas solicitações. Consulte Esforço por mensagem.
  • As mensagens do sistema com escopo de turno estão em beta (cabeçalho mid-conversation-system-clear-at-2026-08-21). Defina clear_at: "next_user_message" em uma mensagem role: "system" no meio da conversa e ela será renderizada apenas para o turno atual, permanecendo depois no histórico sem custo de tokens. Lembretes por turno não se acumulam e não invalidam o cache de prompt nem blocos de pensamento posteriores.
  • thinking.display aceita um terceiro valor, "updates", em beta (cabeçalho thinking-display-updates-2026-08-18). O raciocínio retorna com um campo thinking vazio, como em "omitted", e as breves atualizações de progresso que o Claude Fable 5.1, o Claude Mythos 5.1 e o Claude Fable 5 escrevem entre chamadas de ferramentas retornam como texto, com no máximo um bloco thinking antes de uma chamada de ferramenta. Consulte Atualizações de progresso entre chamadas de ferramentas.
  • O texto gerado pelo Claude Fable 5.1 e pelo Claude Mythos 5.1 contém o "text watermark" (marca d'água de texto) da Anthropic, e os arquivos de imagem, vídeo e áudio suportados que o Claude produz por meio da