Como usar a API do Claude Sonnet 5

Resposta rápida

Claude Sonnet 5 API é o novo modelo da classe Sonnet da Anthropic para agentes de código, raciocínio de longo contexto, uso de ferramentas e trabalho profissional baseado em conhecimento. A Anthropic anunciou o Claude Sonnet 5 em 30 de junho de 2026, posicionando-o como o modelo Sonnet mais “agente” até agora e uma grande atualização em relação ao Claude Sonnet 4.6. Desenvolvedores podem usá-lo via CometAPI com o ID de modelo claude-sonnet-5 pelo endpoint nativo Anthropic Messages POST /v1/messages ou pelo endpoint compatível com OpenAI POST /v1/chat/completions.

Por que o Claude Sonnet 5 importa agora

A Anthropic introduziu o Claude Sonnet 5 em 30 de junho de 2026, e o lançamento mira diretamente desenvolvedores que constroem sistemas agentes. A empresa descreve o Sonnet 5 como o modelo Sonnet mais agente até agora, com planejamento mais robusto, uso de ferramentas, código, trabalho em navegador e terminal, e raciocínio profissional. O posicionamento mais importante é que o Sonnet 5 reduz a distância para o Claude Opus 4.8, permanecendo na faixa Sonnet, mais rápida e com melhor custo.

Isso importa porque o mercado já foi além de simples chat completions. Aplicações de IA em produção precisam cada vez mais de um modelo que leia grandes contextos, chame ferramentas, escreva código, inspecione documentos, use um navegador, execute comandos de terminal, se recupere de erros e conclua fluxos de trabalho de múltiplas etapas. Os modelos Claude Sonnet historicamente foram populares para codificação e fluxos de agentes, e o Sonnet 5 foi construído exatamente para essa categoria.

O lançamento também muda como os desenvolvedores devem pensar sobre controle de API. O Claude Sonnet 5 usa pensamento adaptativo por padrão. Orçamentos manuais de pensamento estendido foram removidos para este modelo, e as notas de migração da Anthropic dizem que configurações de amostragem não padrão como temperature, top_p e top_k podem retornar erro 400. Em outras palavras, migrar do Sonnet 4.6 não é apenas trocar o nome do modelo.

O que é a Claude Sonnet 5 API?

Claude Sonnet 5 API é a interface programática para o modelo Sonnet 5 da Anthropic. Ela é projetada para geração de texto, codificação, uso de ferramentas, raciocínio sobre documentos, entendimento de imagens e fluxos de trabalho de longo contexto. No CometAPI, o ID de modelo é:

claude-sonnet-5

Você pode chamá-la de duas maneiras principais:

1. Use o endpoint Anthropic Messages do CometAPI quando quiser comportamento nativo do Claude, pensamento adaptativo, controle de esforço, cache de prompt, ferramentas, busca na web, streaming e formatos de resposta da Anthropic.
2. Use o endpoint de chat compatível com OpenAI do CometAPI quando sua aplicação já utiliza chat completions estilo OpenAI e você quiser roteamento de modelos mais fácil entre famílias Claude, GPT, Gemini e outras.

Para a maioria das equipes de produção, o endpoint nativo Messages é a melhor primeira escolha para fluxos de agentes específicos do Claude. O endpoint compatível com OpenAI é melhor quando portabilidade, comparação de modelos ou migração mínima importam mais do que controles específicos do Claude.

Especificações rápidas do Claude Sonnet 5

O que há de novo na Claude Sonnet 5 API: inovações-chave

A Anthropic posicionou o Sonnet 5 como uma atualização substancial em relação ao Sonnet 4.6, focando em confiabilidade agente no mundo real.

1. Novo tokenizador e eficiência de tokens

O Sonnet 5 usa um tokenizador atualizado (similar ao Opus 4.7). O mesmo texto de entrada pode mapear para cerca de 1,0–1,35× mais tokens dependendo do tipo de conteúdo, com média de cerca de 30% a mais.

Impacto: preços introdutórios ($2/$10 por milhão de tokens de entrada/saída até 31 de agosto de 2026) tornam a transição aproximadamente neutra em custo. Após isso, o preço padrão é $3/$15, igual ao Sonnet 4.6 por token, mas potencialmente maior por tarefa devido à inflação de tokens. Sempre recontar tokens com o novo modelo.

2. Melhorias de capacidade

O Sonnet 5 mostra ganhos substanciais sobre o Sonnet 4.6 em benchmarks:

• Codificação e tarefas agentes: mais próximo ao Opus 4.8 em avaliações tipo SWE-bench, busca agente (BrowseComp) e uso de computador (OSWorld-Verified).
• Raciocínio e trabalho de conhecimento: melhor foco sustentado, auto-verificação e tratamento de código legado ou tarefas profissionais de múltiplas etapas.
• Multimodal e uso de ferramentas: chamadas de ferramentas paralelas e capacidades de visão mais fortes.

O desempenho escala com níveis de esforço (low/medium/high/xhigh), permitindo ajustes finos de custo e performance. Em esforços mais altos, iguala ou se aproxima do Opus em muitas tarefas.

Feedback inicial de usuários destaca conclusão mais rápida de tarefas complexas, menos alucinações e melhor execução no mundo real.

3. Salvaguardas de cibersegurança e segurança

• Comportamentos indesejáveis gerais menores que 4.6.
• Capacidades reduzidas de exploração cibernética vs. Opus (marcou 0% de explorações completas em testes de vulnerabilidades do Firefox).
• Salvaguardas cibernéticas ativadas por padrão — detecção em tempo real e bloqueio de uso perigoso (igual ao Opus 4.7/4.8, menos estrito que alguns modelos superiores).

Isso torna o Sonnet 5 mais seguro para agentes em produção em ambientes sensíveis à cibersegurança.

O Claude Sonnet 5 é mais forte em raciocínio relevante para cibersegurança do que o Sonnet 4.6, mas não é tão forte quanto o Opus 4.8 e está substancialmente abaixo do Mythos 5 nas tarefas cibernéticas avaliadas.

A conclusão importante para API é que as salvaguardas escalam com a capacidade do modelo. A Anthropic descreve salvaguardas baseadas em classificadores ao longo do tráfego, com categorias como uso proibido, duplo uso de alto risco e duplo uso. Trocas de uso proibido e duplo uso de alto risco são bloqueadas por padrão, enquanto tarefas de segurança de duplo uso comuns, como detecção de vulnerabilidades, não são bloqueadas por padrão.

Para equipes de segurança legítimas, isso significa que o Sonnet 5 pode ser útil para trabalho defensivo como revisão de código, orientação de configuração segura, triagem de vulnerabilidades, documentação de incidentes e planejamento de patches.

Pensamento adaptativo no Claude Sonnet 5

Pensamento adaptativo é uma das mudanças mais importantes voltadas aos desenvolvedores no Claude Sonnet 5. Em vez de pedir aos desenvolvedores que escolham manualmente um orçamento de pensamento para cada chamada, o Claude pode alocar o esforço de raciocínio dinamicamente com base na tarefa.

Pensamento adaptativo é um dos destaques do Sonnet 5. Ele ajusta dinamicamente a profundidade do raciocínio:

• Níveis de esforço: low (rápido/barato), medium, high (análise mais profunda), com opções adaptativas.
• Padrões: high na API/Claude Code para o Sonnet 5.
• Benefícios: equilíbrio entre qualidade vs. custo/latência. Esforços mais altos se destacam em tarefas complexas, mas consomem mais tokens.

Exemplo de prompt:

Use adaptive thinking for this task: Quick overview first, then detailed analysis and code if critical issues are found.

Em integrações antigas do Claude, equipes frequentemente usavam controles de pensamento estendido como:

{
  "thinking": {
    "type": "enabled",
    "budget_tokens": 32000
  }
}

Para o Claude Sonnet 5, não envie esse padrão antigo. As notas de migração do Sonnet 5 dizem que orçamentos manuais de pensamento estendido foram removidos e podem retornar erro 400. Use pensamento adaptativo e controles de esforço em seu lugar.

Como funciona o controle de esforço

O parâmetro effort dá aos desenvolvedores uma forma mais simples de influenciar quanto trabalho o modelo realiza. Os níveis atuais de esforço da Anthropic incluem low, medium, high, xhigh e max; high é o padrão e equivale a omitir o parâmetro. Uma política prática de produção se parece com isto:

O padrão arquitetural é estável: roteie tarefas difíceis para esforço maior e tarefas simples para esforço menor.

Por que usar a Claude Sonnet 5 API com CometAPI?

CometAPI é útil quando as equipes querem uma camada de integração única para muitas famílias de modelos. Em vez de construir integrações separadas de provedor para cada modelo, você pode rotear Claude, GPT, Gemini, modelos de imagem, vídeo, embeddings e outras APIs por trás de uma conta e uma arquitetura de aplicação.

Para o Claude Sonnet 5, o CometAPI oferece três vantagens práticas.

Primeiro, o CometAPI expõe o Claude Sonnet 5 tanto pelo endpoint nativo Anthropic Messages quanto por um endpoint compatível com OpenAI. Isso significa que uma equipe pode usar recursos nativos do Claude para fluxos de agentes sérios enquanto ainda testa o Sonnet 5 dentro de aplicações que já usam chat completions estilo OpenAI.

Segundo, o catálogo do CometAPI facilita a comparação de modelos. Você pode executar o mesmo conjunto de prompts contra Sonnet 5, Sonnet 4.6, modelos da faixa Opus, modelos da faixa GPT, modelos da faixa Gemini e modelos especializados. Isso importa porque o melhor modelo para codificação pode não ser o melhor para extração de documentos, suporte ao cliente, chat sensível à latência ou processamento em lote sensível a custo.

Terceiro, o CometAPI ajuda com roteamento de produção. Você pode começar com o Sonnet 5 como modelo padrão para codificação e raciocínio agente, e depois adicionar regras de fallback para disponibilidade, orçamento, latência ou comportamento de recusa. Um sistema de IA maduro não deve ficar soldado a um nome de modelo para sempre.

Como usar a Claude Sonnet 5 API com CometAPI

Os exemplos abaixo usam código no servidor. Nunca exponha sua chave CometAPI em JavaScript do navegador, apps móveis, repositórios públicos ou logs do lado do cliente.

Etapa 1: Crie e armazene sua chave CometAPI

Armazene sua chave de API como uma variável de ambiente:

export COMETAPI_KEY="your_cometapi_key"

No Windows PowerShell:

$env:COMETAPI_KEY="your_cometapi_key"

Etapa 2: Escolha o endpoint correto

Use POST /v1/messages quando quiser comportamento nativo do Claude:

https://api.cometapi.com/v1/messages

Use POST /v1/chat/completions quando quiser chat compatível com OpenAI:

https://api.cometapi.com/v1/chat/completions

Recomendação: comece com /v1/messages para novos sistemas de agentes Claude Sonnet 5. Use /v1/chat/completions quando você já possui wrappers de SDK OpenAI, roteadores de modelos ou ferramentas de avaliação de múltiplos modelos baseadas em chat completions.

Etapa 3: Chamar o Claude Sonnet 5 com cURL

Este é o exemplo mais simples da API nativa Messages:

curl https://api.cometapi.com/v1/messages \  -H "Authorization: Bearer $COMETAPI_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "claude-sonnet-5",    "max_tokens": 1200,    "messages": [      {        "role": "user",        "content": "Write a concise migration checklist for moving a Node.js API from Express 4 to Express 5."      }    ]  }'

Para o Sonnet 5, evite adicionar antigos overrides de amostragem ou orçamentos manuais de pensamento, a menos que a documentação atual os suporte para sua rota. Deixe o pensamento adaptativo lidar com o raciocínio e use controle de esforço onde suportado.

Etapa 4: Exemplo em Python com o SDK da Anthropic

Muitos fluxos de trabalho do SDK da Anthropic podem apontar para o CometAPI definindo a base URL e a chave de API.

import osimport anthropic​client = anthropic.Anthropic(    base_url="https://api.cometapi.com",    api_key=os.environ["COMETAPI_KEY"],)​message = client.messages.create(    model="claude-sonnet-5",    max_tokens=1500,    messages=[        {            "role": "user",            "content": (                "Review this deployment plan for a payments API. "                "Return the top risks, missing tests, and rollout checklist."            ),        }    ],)​for block in message.content:    if getattr(block, "type", None) == "text":        print(block.text)

Se sua rota do CometAPI suportar controle de esforço pelo mesmo formato da documentação atual da Anthropic, você pode adicionar uma configuração de esforço para trabalhos mais difíceis:

message = client.messages.create(    model="claude-sonnet-5",    max_tokens=3000,    thinking={"type": "adaptive"},    output_config={"effort": "high"},    messages=[        {            "role": "user",            "content": "Analyze this incident report and propose a root-cause investigation plan.",        }    ],)

Como os esquemas de provedores e agregadores podem evoluir, teste parâmetros de esforço em homologação antes da produção. Se uma rota rejeitar output_config, remova-o ou use o formato de parâmetro do CometAPI documentado no momento.

Etapa 5: Exemplo de chat completion compatível com OpenAI

Use este caminho se sua aplicação já usa chat completions compatíveis com OpenAI.

curl https://api.cometapi.com/v1/chat/completions \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {
        "role": "system",
        "content": "You are a senior backend engineer. Be precise and practical."
      },
      {
        "role": "user",
        "content": "Design a retry strategy for a webhook delivery service. Include database fields and failure states."
      }
    ],
    "max_completion_tokens": 1800,
    "stream": false
  }'

A rota compatível com OpenAI é excelente para portabilidade, mas não presuma que todo recurso nativo do Claude mapeia perfeitamente para chat completions. Para fluxos avançados do Claude, prefira o endpoint Messages.

Etapa 6: Exemplo de streaming

Streaming melhora a latência percebida para chat, assistentes de codificação e relatórios longos.

const response = await fetch("https://api.cometapi.com/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "claude-sonnet-5",
    max_tokens: 2500,
    stream: true,
    messages: [
      {
        role: "user",
        content: "Write a production runbook for investigating elevated API error rates.",
      },
    ],
  }),
});

if (!response.ok) {
  throw new Error(`Stream failed: ${response.status} ${await response.text()}`);
}

for await (const chunk of response.body) {
  process.stdout.write(Buffer.from(chunk).toString("utf8"));
}

Em produção, faça parse de eventos enviados pelo servidor em vez de imprimir chunks brutos. Também trate desconexões de rede, respostas parciais, idempotência de retry e cancelamento pelo usuário.

Computer Use / Agentic Flows: combine com ferramentas para controle de navegador/terminal. O Sonnet 5 se destaca aqui.

Boas práticas com CometAPI:

• Monitore o dashboard de uso para custos.
• Faça testes A/B de modelos (por exemplo, Sonnet 5 vs. Opus 4.8).
• Configure alertas de orçamento.
• Use para integrações do Claude Code apontando para o endpoint CometAPI.

Dicas de prompting para o Claude Sonnet 5

O Claude Sonnet 5 funciona melhor quando a tarefa é explícita e os critérios de sucesso são visíveis.

Use esta estrutura para tarefas de codificação e agentes:

Goal: [what should be achieved]
Context: [repo, system, constraints, known facts]
Inputs: [files, logs, tickets, data]
Rules: [must not change, security requirements, output format]
Success criteria: [tests pass, plan quality, risk list, exact schema]
Output: [what you want returned]

Por exemplo:

Goal: Find likely causes of increased checkout API latency.
Context: The service is Node.js, PostgreSQL, Redis, and Stripe webhooks.
Inputs: I will provide logs, traces, recent deploy notes, and database metrics.
Rules: Do not invent metrics. Separate evidence from hypotheses.
Success criteria: Return the top 5 likely causes, what evidence supports each one, and the next query or dashboard to check.
Output: A table followed by a 30-minute investigation plan.

Preços do Claude Sonnet 5 no CometAPI

O catálogo ao vivo do CometAPI verificado para este artigo lista claude-sonnet-5 em:

Sempre verifique os preços atuais no dashboard do CometAPI antes de publicar afirmações de preços para clientes. Os preços dos modelos podem mudar, e acordos empresariais podem diferir dos valores públicos do catálogo.

Exemplo de estimativa de custo

def estimate_sonnet5_cost(input_tokens, output_tokens):
    input_price_per_million = 1.60
    output_price_per_million = 8.00

    input_cost = (input_tokens / 1_000_000) * input_price_per_million
    output_cost = (output_tokens / 1_000_000) * output_price_per_million
    return round(input_cost + output_cost, 6)


print(estimate_sonnet5_cost(input_tokens=120_000, output_tokens=8_000))
print("Expected output: 0.256")

Se uma análise de longo contexto usar 120.000 tokens de entrada e 8.000 tokens de saída, o custo estimado do catálogo é cerca de $0.256 no preço verificado do CometAPI. Isso não inclui quaisquer taxas de plataforma separadas, descontos, impostos ou mudanças futuras de preços.

Para fluxos de agentes, meça também o custo por tarefa resolvida. Um agente de codificação que completa um ticket em uma execução de alto esforço do Sonnet 5 pode ser mais barato do que um modelo de menor custo que precisa de várias tentativas e correção humana.

Guia de migração do Claude Sonnet 4.6

Migrar é direto, mas requer atenção às mudanças de compatibilidade.

O que muda do Sonnet 4.6 para o Sonnet 5?

Checklist de migração:

1. Atualize o nome do modelo: altere "claude-sonnet-4-6" para "claude-sonnet-5".
2. Tokenizador e custos: reteste prompts e reconte tokens. Espere ~30% de aumento.
3. Configuração de pensamento: substitua pensamento estendido legado por adaptativo (thinking: {type: "adaptive"}) + nível de esforço. budget_tokens manual está obsoleto/removido.
4. Parâmetros de amostragem: remova temperature, top_p, top_k — não são mais suportados (use system prompts para controle de estilo).
5. Teste minuciosamente: execute testes de regressão em fluxos agentes, uso de ferramentas e parsing de saída. Valide custos.
6. Limites de taxa: limites aumentados disponíveis; verifique seu nível.
7. Aumente max_tokens onde o pensamento adaptativo possa precisar de mais orçamento.

Código de migração retrocompatível

async function runClaudeTask({ prompt, taskType, useSonnet5 = true }) {
  const model = useSonnet5 ? "claude-sonnet-5" : "claude-sonnet-4-6";
  const effort =
    taskType === "coding_agent" || taskType === "security_review"
      ? "high"
      : "medium";

  const body = {
    model,
    max_tokens: taskType === "coding_agent" ? 5000 : 1800,
    thinking: useSonnet5 ? { type: "adaptive" } : undefined,
    messages: [{ role: "user", content: prompt }],
  };

  if (useSonnet5) {
    body.output_config = { effort };
  }

  const response = await fetch("https://api.cometapi.com/v1/messages", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(body),
  });

  if (response.status === 400 && useSonnet5) {
    // Retry once without optional Sonnet 5-only controls in case the route schema changed.
    delete body.output_config;
    const retry = await fetch("https://api.cometapi.com/v1/messages", {
      method: "POST",
      headers: {
        Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify(body),
    });

    if (!retry.ok) {
      throw new Error(`Retry failed: ${retry.status} ${await retry.text()}`);
    }

    return retry.json();
  }

  if (!response.ok) {
    throw new Error(`Claude request failed: ${response.status} ${await response.text()}`);
  }

  return response.json();
}

Esse padrão permite testar o Sonnet 5 sem tornar sua aplicação frágil. Você pode manter um modelo de fallback, remover campos opcionais em erros de esquema e rotear workloads difíceis para esforços maiores.

Existe uma Claude Sonnet 5 API gratuita?

Não há evidência pública confiável de que a Anthropic ofereça uma Claude Sonnet 5 API gratuita ilimitada. Porém, desenvolvedores podem começar a testar o Claude Sonnet 5 via CometAPI com crédito de teste gratuito. Após criar uma conta no CometAPI, novos usuários podem receber $1 em crédito gratuito, que pode ser usado para explorar modelos suportados e executar testes iniciais de API antes de adicionar mais orçamento.

Perguntas frequentes sobre a Claude Sonnet 5 API

O que é a Claude Sonnet 5 API?

Claude Sonnet 5 API é a interface para desenvolvedores do modelo Sonnet 5 da Anthropic, um modelo de IA de alto desempenho para codificação, agentes, uso de ferramentas, raciocínio de longo contexto, análise de documentos e trabalho profissional.

Como uso a Claude Sonnet 5 API com CometAPI?

Use o ID de modelo claude-sonnet-5. Para comportamento nativo do Claude, envie requisições para POST https://api.cometapi.com/v1/messages. Para chat compatível com OpenAI, use POST https://api.cometapi.com/v1/chat/completions.

O que há de novo no Claude Sonnet 5?

O Claude Sonnet 5 adiciona desempenho mais forte em codificação agente e uso de ferramentas, janela de contexto de 1M tokens, pensamento adaptativo por padrão, controle de esforço, novo tokenizador e salvaguardas atualizadas para solicitações cibernéticas e de alto risco.

O Claude Sonnet 5 suporta pensamento adaptativo?

Sim. Pensamento adaptativo está ativado por padrão no Claude Sonnet 5. Desenvolvedores não devem usar antigos orçamentos manuais de pensamento estendido com o Sonnet 5; em vez disso, use controles de esforço onde suportado.

Por que o novo tokenizador do Claude Sonnet 5 importa?

O novo tokenizador pode produzir cerca de 30% mais tokens para o mesmo texto do que o Claude Sonnet 4.6. Isso afeta custo, empacotamento de contexto, cache de prompts, chunking e planejamento de max_tokens.

CometAPI vs. Anthropic direto: qual é melhor

CometAPI oferece acesso unificado, preços mais baixos e experimentação multi-modelo mais fácil — ideal para a maioria dos desenvolvedores.

Devo migrar do Claude Sonnet 4.6 para o Claude Sonnet 5 imediatamente?

Migre em etapas. Remova parâmetros não suportados, reconte tokens, execute seus evals internos, monitore custo e comportamento de recusa, mantenha o Sonnet 4.6 como fallback e roteie gradualmente mais tráfego de produção para o Sonnet 5.

Conclusão final

Claude Sonnet 5 API é um dos lançamentos de modelo para desenvolvedores mais importantes de 2026 porque aprofunda os modelos da classe Sonnet em trabalho agente. Os casos de uso mais fortes são agentes de codificação, fluxos de trabalho em terminal, análise de longo contexto, uso de ferramentas, raciocínio multimodal sobre documentos e automação profissional. A migração também é mais sutil do que trocar o nome do modelo: o Sonnet 5 introduz um novo tokenizador, pensamento adaptativo por padrão, controle baseado em esforço, comportamento de amostragem alterado e salvaguardas de cibersegurança atualizadas.

Recomendação: comece com o CometAPI hoje para acesso contínuo ao Sonnet 5 (e 500+ outros modelos) com créditos gratuitos, custos menores e gestão unificada. Inscreva-se em CometAPI, integre em minutos e escale com confiança.