Como Usar Claude Sonnet 5 no Cursor

O Claude Sonnet 5 foi lançado em 30 de junho de 2026 e se encaixa perfeitamente na forma como a maioria das pessoas usa o Cursor. A Anthropic o descreve como seu modelo Sonnet mais "agentic" até agora, com desempenho de uso de ferramentas próximo ao Opus 4.8, mas com um preço muito menor. Isso é importante no Cursor, onde o modelo passa a maior parte do tempo lendo arquivos, editando código e executando comandos em loop. Este guia mostra como habilitar o Sonnet 5 no Cursor, quando usar sua própria chave de API da Anthropic, como tirar o máximo proveito do modo agente e quando mudar para um modelo maior. Para uma visão geral completa do modelo, leia o que é o Claude Sonnet 5, e o anúncio oficial da Anthropic cobre os detalhes do lançamento.

Você também verá onde o Apidog se encaixa: quando o Cursor e o Sonnet 5 constroem uma API para você, o Apidog é onde você envia requisições, as salva, simula respostas e executa testes automatizados contra os endpoints.

Por que o Sonnet 5 é um bom padrão no Cursor

O agente do Cursor realiza muitas etapas pequenas e orientadas por ferramentas. Ele abre arquivos, aplica edições, busca na base de código e executa comandos de terminal. Esse é exatamente o tipo de trabalho em que o Sonnet 5 se destaca.

Os benchmarks de lançamento da Anthropic colocam o Sonnet 5 a poucos pontos do Opus 4.8 em tarefas de agente. No SWE-bench Pro, um benchmark de codificação, os números reportados foram de 63,2% para o Sonnet 5 e 69,2% para o Opus 4.8, um aumento em relação aos 58,1% do Sonnet 4.6. No Terminal-Bench 2.1, o Sonnet 5 pontuou 80,4% contra 82,7% do Opus 4.8. No OSWorld-Verified, um benchmark de uso de computador, o Sonnet 5 atingiu 81,2% contra 83,4% do Opus 4.8. Esses são números relatados pela Anthropic, não nossos próprios testes. Para a tabela completa, consulte o detalhamento dos benchmarks do Claude Sonnet 5.

O padrão é consistente. Com ferramentas em loop, o Sonnet 5 fica dentro de um a três pontos do Opus 4.8. Em raciocínio puro, o Opus avança cerca de seis pontos. O Cursor quase sempre tem ferramentas em loop, então você obtém a maior parte da qualidade de ponta sem pagar o preço de ponta.

O preço é a outra metade. O Sonnet 5 custa o mesmo por token que o Sonnet 4.6: US$ 3 por milhão de tokens de entrada e US$ 15 por milhão de tokens de saída na taxa padrão. A Anthropic está oferecendo uma taxa introdutória de US$ 2 por milhão de entrada e US$ 10 por milhão de saída até 31 de agosto de 2026. O Opus 4.8 custa US$ 5 por milhão de entrada e US$ 25 por milhão de saída. Em uma sessão de agente longa, essa diferença se acumula rapidamente.

Duas formas de usar o Sonnet 5 no Cursor

O Cursor suporta os modelos Claude da Anthropic diretamente, e também suporta o "bring-your-own-key" (BYOK) se você quiser faturar através da sua própria conta Anthropic. A terminologia do menu pode mudar entre as versões do Cursor, então considere estes como a forma do fluxo, e não como passos exatos.

Opção 1: Seletor de modelo integrado do Cursor

Se o seu plano Cursor incluir modelos Claude, este é o caminho mais rápido.

1. Abra o Cursor e clique no seletor de modelo. Ele geralmente fica na entrada de chat ou do Composer, ou em Configurações.
2. Procure por Claude Sonnet 5 na lista de modelos.
3. Selecione-o. O Cursor agora roteia suas solicitações através do Sonnet 5 para chat, edições e execuções de agente.

Novos modelos podem levar um tempo para aparecer em uma determinada versão do Cursor. Se você ainda não vê o Sonnet 5, atualize o Cursor para a versão mais recente e verifique novamente. Para mais ajuda com a configuração, o guia de configuração do Cursor aborda a configuração do zero.

Opção 2: Traga sua própria chave de API da Anthropic

O BYOK é útil quando você deseja controle direto sobre o faturamento, limites mais altos vinculados à sua conta ou um modelo que seu plano Cursor não inclui.

1. Obtenha uma chave de API da Anthropic no Console Claude. Crie uma chave em "API keys" da sua organização.
2. No Cursor, abra Configurações e encontre a seção de modelos ou chaves de API.
3. Cole sua chave da Anthropic no campo do provedor Anthropic e salve.
4. Selecione Claude Sonnet 5 como seu modelo ativo.

O ID do modelo que a Anthropic expõe é claude-sonnet-5, uma string exata sem sufixo de data. Você geralmente não digita o ID na interface do Cursor, mas precisará dele se programar algo contra a própria API. Nosso guia da API Claude Sonnet 5 cobre a forma bruta da requisição, o ID do modelo e o formato da resposta em detalhes.

Mantenha sua chave de API fora do seu código. Armazene-a em uma variável de ambiente ou no seu chaveiro do sistema operacional, e nunca a commite no git.

O que mudou nos bastidores (e por que isso importa para o Cursor)

O Sonnet 5 é um substituto direto do Sonnet 4.6 no nível da API, mas algumas mudanças de comportamento merecem atenção, mesmo dentro do Cursor.

O raciocínio adaptativo agora está ativado por padrão. No Sonnet 4.6, uma solicitação sem o campo thinking era executada sem raciocínio. No Sonnet 5, a mesma solicitação é executada com raciocínio adaptativo. No Cursor, isso significa que o modelo raciocina mais antes de agir em uma tarefa difícil, o que é desejável para planejar mudanças em vários arquivos. A saída pode incluir tokens de raciocínio, então as respostas podem levar um pouco mais de tempo e custar um pouco mais em prompts complexos.

O Sonnet 5 também vem com um novo tokenizador. O mesmo texto de entrada produz aproximadamente 30% mais tokens do que no Sonnet 4.6, cerca de 1,3 vezes mais. As formas de solicitação e resposta são idênticas, então nada se quebra. Mas tudo o que você mede em tokens muda. Sua janela de contexto de 1 milhão de tokens comporta um pouco menos de texto em média, e o custo de uma solicitação equivalente pode ser maior, embora a taxa por token permaneça inalterada. Se você monitora os gastos do Cursor, faça uma nova medição com o Sonnet 5 em vez de reutilizar seus números do 4.6.

Mais duas restrições importam se você programar diretamente contra a API. O raciocínio estendido manual com budget_tokens retorna um erro 400. Definir temperature, top_p ou top_k para um valor não padrão também retorna um erro 400. Direcione o comportamento através do seu prompt. O Cursor lida com isso dentro de suas próprias chamadas de modelo, então você só encontrará esses problemas se construir contra a API da Anthropic por conta própria.

Usando o Sonnet 5 no modo agente do Cursor

O modo agente é onde o Sonnet 5 realmente se destaca. Ele permite que o modelo leia seu projeto, planeje uma mudança, edite vários arquivos, execute comandos de terminal e, em seguida, verifique seu próprio trabalho.

Um fluxo de trabalho que funciona bem:

1. Descreva o resultado, não os passos. Diga ao Sonnet 5 o que você quer construir e quais arquivos ou pastas estão no escopo.
2. Deixe-o planejar primeiro. Com o raciocínio adaptativo ativado, o Sonnet 5 tende a apresentar uma abordagem antes de editar. Leia o plano e corrija-o precocemente se ele desviar.
3. Mantenha as tarefas dentro do escopo. Tarefas menores e bem definidas geram diffs mais limpos e custam menos do que um prompt gigante e aberto.
4. Revise cada diff. O modelo é forte em codificação agêntica, mas a fusão ainda é sua responsabilidade.

Como o Cursor mantém ferramentas em loop, a força agêntica do Sonnet 5 se manifesta diretamente. Ele lida bem com o ciclo de leitura, edição, execução e verificação sem que você precise recorrer a um modelo mais caro para o trabalho de rotina.

Um exemplo realista: construa uma API e depois a teste

Digamos que você peça ao Sonnet 5 no Cursor para criar um route do Express que crie um pedido e o retorne como JSON.

// routes/orders.js
const express = require('express');
const router = express.Router();

router.post('/orders', (req, res) => {
  const { customerId, items } = req.body;
  if (!customerId || !Array.isArray(items) || items.length === 0) {
    return res.status(400).json({ error: 'customerId and items are required' });
  }
  const order = {
    id: `order_${Date.now()}`,
    customerId,
    items,
    status: 'created',
  };
  return res.status(201).json(order);
});

module.exports = router;

O Cursor e o Sonnet 5 podem gerar isso, integrá-lo ao seu aplicativo e até mesmo rascunhar um teste. Mas o código gerado ainda precisa de verificação real contra solicitações reais. É aí que o Apidog entra.

No Apidog, você pode:

• Enviar uma solicitação POST /orders com um corpo JSON e confirmar que você recebe um 201 e o formato de resposta correto.
• Salvar a solicitação em uma coleção para que toda a sua equipe a reutilize.
• Armazenar sua URL base e quaisquer chaves como variáveis de ambiente, para que você nunca codifique segredos.
• Adicionar asserções automatizadas, por exemplo, que status seja igual a created e id esteja presente, e então executar a suíte em CI.
• Simular o endpoint para que seu frontend possa ser construído com base em respostas realistas antes que o backend esteja finalizado.

Cursor e Sonnet 5 escrevem o código rapidamente, e o Apidog oferece uma maneira reproduzível de confirmar o comportamento da API. Se você migrou de outras ferramentas, este guia testando API sem Postman mostra o fluxo de teste de ponta a ponta. Baixe o Apidog para acompanhar com seus próprios endpoints.

Notas sobre custo e uso

O Cursor gerencia seu próprio faturamento, limites e acesso a modelos, e esses detalhes específicos mudam com o tempo, então verifique diretamente os detalhes do plano atual do Cursor. Alguns princípios se mantêm independentemente do plano:

• O Sonnet 5 é mais barato de usar do que o Opus 4.8. Para codificação diária, isso o torna um padrão sensato.
• O raciocínio adaptativo pode aumentar o custo em prompts difíceis porque os tokens de raciocínio contam para a saída. Em muitas pequenas edições, essa sobrecarga geralmente é pequena.
• O novo tokenizador significa que o mesmo código e prompts consomem mais tokens do que no Sonnet 4.6. Faça o orçamento com isso em mente.
• Com o BYOK, sua fatura Anthropic reflete o uso real nas taxas acima. Modele suas cargas de trabalho reais em vez de assumir a paridade total com os números antigos do Sonnet.

Para uma visão mais ampla sobre como escolher um modelo dentro do Cursor, consulte a comparação dos melhores modelos Cursor.

Quando trocar de modelos

O Sonnet 5 cobre bem a maioria dos trabalhos no Cursor. Mude para o Opus 4.8 para o raciocínio mais complexo: decisões de arquitetura complicadas, depuração sutil que requer raciocínio profundo passo a passo ou execuções autônomas de longo prazo onde a qualidade importa mais do que o custo. Em raciocínio puro sem ferramentas, o Opus 4.8 supera o Sonnet 5 em cerca de seis pontos nos benchmarks relatados, e essa margem pode valer o preço premium nas tarefas mais difíceis.

Para todo o resto, desde o desenvolvimento de funcionalidades até refatorações e escrita e execução de testes, o Sonnet 5 oferece um desempenho agêntico próximo ao Opus por um preço mais baixo. Mantenha o Sonnet 5 como seu padrão e mude para o Opus 4.8 apenas quando uma tarefa realmente travar.

Perguntas frequentes

O Claude Sonnet 5 está disponível no Cursor? O Cursor suporta os modelos Claude da Anthropic, e o Sonnet 5 deve aparecer no seletor de modelos assim que sua versão do Cursor o suportar. Se ele estiver faltando, atualize o Cursor para a versão mais recente. Você também pode adicioná-lo através do "bring-your-own-key" com uma chave de API da Anthropic.

Preciso da minha própria chave de API para usar o Sonnet 5 no Cursor? Nem sempre. Se o seu plano Cursor incluir modelos Claude, você pode selecionar o Sonnet 5 sem uma chave. Use o BYOK quando quiser faturar através da sua própria conta Anthropic ou precisar de controle direto sobre os limites. O guia da API Claude Sonnet 5 explica como criar uma chave.

O Sonnet 5 ou o Opus 4.8 é melhor para codificação no Cursor? Para a maioria dos trabalhos no Cursor, o Sonnet 5 oferece o melhor custo-benefício porque seu desempenho é próximo ao do Opus 4.8 em codificação agêntica por um preço mais baixo. Recorra ao Opus 4.8 para as tarefas de raciocínio mais difíceis. A comparação Sonnet 5 vs Opus 4.8 detalha o trade-off.

Por que o Sonnet 5 parece usar mais tokens do que o Sonnet 4.6? O Sonnet 5 usa um novo tokenizador que produz aproximadamente 30% mais tokens para o mesmo texto. O preço por token não mudou, mas o custo de solicitações equivalentes pode ser maior. Meça suas cargas de trabalho reais em vez de reutilizar contagens de tokens antigas.

Posso usar o Sonnet 5 no Cursor gratuitamente? Isso depende do seu plano Cursor, que o Cursor controla. O Sonnet 5 é o modelo padrão no plano gratuito da web e aplicativo Claude, mas isso é separado do Cursor. Verifique os detalhes do plano atual do Cursor para saber o que está incluído.