Como Usar Claude Sonnet 5 no Cursor

O Claude Sonnet 5 foi lançado em 30 de junho de 2026 e combina bem com o fluxo típico do Cursor: ler arquivos, editar código, executar comandos e repetir esse ciclo até a tarefa ficar pronta. A Anthropic descreve o Sonnet 5 como seu modelo Sonnet mais “agentic” até agora, com desempenho de uso de ferramentas próximo ao Opus 4.8 e custo menor. Neste guia, você verá como habilitar o Sonnet 5 no Cursor, quando usar sua própria chave da Anthropic, como trabalhar melhor no modo agente e quando trocar para um modelo maior. Para contexto do modelo, veja o que é o Claude Sonnet 5 e o anúncio oficial da Anthropic.

Experimente o Apidog hoje

Você também verá onde o Apidog entra no fluxo: depois que o Cursor e o Sonnet 5 geram uma API, use o Apidog para enviar requisições, salvar coleções, simular respostas e automatizar testes contra os endpoints.

Por que usar o Sonnet 5 como padrão no Cursor

O agente do Cursor executa várias ações pequenas e orientadas por ferramentas:

• abre arquivos;
• busca símbolos e referências;
• aplica edições;
• executa comandos no terminal;
• lê erros;
• ajusta o código;
• repete o ciclo.

Esse é exatamente o tipo de tarefa em que o Sonnet 5 tende a ser útil.

Nos benchmarks de lançamento da Anthropic, o Sonnet 5 ficou próximo do Opus 4.8 em tarefas agênticas:

Benchmark	Sonnet 5	Opus 4.8
SWE-bench Pro	63,2%	69,2%
Terminal-Bench 2.1	80,4%	82,7%
OSWorld-Verified	81,2%	83,4%

Esses números são os reportados pela Anthropic, não testes próprios. Para a tabela completa, consulte os benchmarks do Claude Sonnet 5.

O padrão é claro: com ferramentas em loop, o Sonnet 5 fica a poucos pontos do Opus 4.8. Como o Cursor trabalha principalmente nesse modo, você obtém boa parte da qualidade de um modelo maior sem pagar o mesmo custo.

Em preço, o Sonnet 5 mantém a mesma taxa por token do Sonnet 4.6:

• US$ 3 por milhão de tokens de entrada;
• US$ 15 por milhão de tokens de saída;
• taxa introdutória até 31 de agosto de 2026: US$ 2 por milhão de entrada e US$ 10 por milhão de saída.

O Opus 4.8 custa US$ 5 por milhão de entrada e US$ 25 por milhão de saída. Em sessões longas de agente, essa diferença pesa.

Como usar o Sonnet 5 no Cursor

Há duas formas principais:

1. selecionar o modelo diretamente no Cursor;
2. usar sua própria chave de API da Anthropic.

A interface do Cursor pode mudar entre versões, então trate os passos abaixo como o fluxo geral.

Opção 1: selecionar o Sonnet 5 no Cursor

Use esta opção se seu plano do Cursor já incluir modelos Claude.

1. Abra o Cursor.
2. Clique no seletor de modelo no chat, no Composer ou em Configurações.
3. Procure por Claude Sonnet 5.
4. Selecione o modelo.
5. Use-o para chat, edições e modo agente.

Se o Sonnet 5 ainda não aparecer:

1. atualize o Cursor;
2. reinicie o app;
3. verifique novamente o seletor de modelos.

Para configurar o ambiente do zero, veja o guia de configuração do Cursor.

Opção 2: usar sua própria chave da Anthropic

Use BYOK, ou “bring your own key”, quando você quiser:

• faturamento direto pela Anthropic;
• limites ligados à sua conta Anthropic;
• acesso a um modelo que seu plano Cursor não inclui.

Passos:

1. Acesse o Console Claude.
2. Crie uma chave em API keys na sua organização.
3. No Cursor, abra Settings.
4. Procure a seção de modelos ou chaves de API.
5. Cole a chave no provedor Anthropic.
6. Salve.
7. Selecione Claude Sonnet 5 como modelo ativo.

O ID do modelo na API é:

claude-sonnet-5

Você normalmente não precisa digitar esse ID na interface do Cursor, mas ele é necessário se você chamar a API diretamente. O guia da API Claude Sonnet 5 mostra o formato da requisição, o ID do modelo e a resposta.

Não coloque a chave no código. Prefira variáveis de ambiente:

export ANTHROPIC_API_KEY="sua-chave-aqui"

E nunca faça commit dela no Git.

O que mudou no Sonnet 5 e por que isso importa no Cursor

O Sonnet 5 é um substituto direto do Sonnet 4.6 no nível da API, mas há mudanças de comportamento importantes.

Raciocínio adaptativo por padrão

No Sonnet 4.6, uma requisição sem o campo thinking era executada sem raciocínio. No Sonnet 5, a mesma requisição usa raciocínio adaptativo.

No Cursor, isso ajuda em tarefas como:

• planejar refatorações em vários arquivos;
• entender dependências antes de editar;
• corrigir erros depois de rodar testes;
• decompor uma mudança grande em passos menores.

O trade-off: prompts complexos podem levar mais tempo e consumir mais tokens de saída, porque tokens de raciocínio também contam.

Novo tokenizador

O Sonnet 5 usa um novo tokenizador. O mesmo texto tende a gerar cerca de 30% mais tokens do que no Sonnet 4.6.

Na prática:

• a janela de contexto comporta um pouco menos texto médio;
• prompts equivalentes podem custar mais;
• medições antigas do Sonnet 4.6 não devem ser reutilizadas.

Se você acompanha custos no Cursor ou via BYOK, faça uma nova medição com cargas reais.

Restrições ao chamar a API diretamente

Se você usar a API da Anthropic fora do Cursor, observe:

• budget_tokens para raciocínio estendido manual retorna erro 400;
• alterar temperature, top_p ou top_k para valores não padrão também retorna erro 400.

Direcione o comportamento pelo prompt. O Cursor lida com isso internamente, então você só tende a encontrar esses erros se integrar diretamente com a API.

Como usar o Sonnet 5 no modo agente do Cursor

O modo agente é onde o Sonnet 5 costuma entregar mais valor. Ele pode ler o projeto, propor um plano, editar arquivos, executar comandos e validar o resultado.

Um fluxo prático:

1. Defina o resultado esperado.
   
   Explique o que deve existir ao final, não cada microetapa.

2. Limite o escopo.
   
   Informe pastas, arquivos ou módulos relevantes.

3. Peça um plano antes das edições.
   
   Revise o plano antes de permitir mudanças grandes.

4. Divida tarefas grandes.
   
   Prefira prompts menores para gerar diffs mais limpos.

5. Execute testes.
   
   Peça ao agente para rodar npm test, pnpm test, pytest, go test ou o comando adequado.

6. Revise os diffs.
   
   O modelo pode escrever código, mas a responsabilidade de merge continua sendo sua.

Exemplo de prompt útil no Cursor:

Implemente um endpoint POST /orders no backend Express.

Escopo:
- routes/orders.js
- app.js
- tests/orders.test.js

Requisitos:
- validar customerId obrigatório
- validar items como array não vazio
- retornar 400 em payload inválido
- retornar 201 com o pedido criado
- adicionar testes automatizados

Antes de editar, mostre o plano.
Depois de editar, rode os testes.

Esse tipo de instrução dá ao agente contexto suficiente sem abrir demais o escopo.

Exemplo: criar uma API e testar o endpoint

Suponha que você peça ao Sonnet 5 no Cursor para criar uma rota do Express que receba um pedido e retorne JSON.

Um resultado possível:

// 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 pode gerar a rota, conectar no app e criar testes. Mas você ainda precisa validar o comportamento com requisições reais. É aí que o Apidog ajuda.

No Apidog, você pode:

1. criar uma requisição POST /orders;
2. definir o corpo JSON;
3. confirmar que a resposta retorna 201;
4. validar o schema da resposta;
5. salvar a requisição em uma coleção;
6. reutilizar variáveis de ambiente para base URL e chaves;
7. adicionar asserções automatizadas;
8. executar a suíte em CI;
9. criar mocks para o frontend trabalhar antes do backend ficar pronto.

Exemplo de body:

{
  "customerId": "cus_123",
  "items": [
    {
      "sku": "book_001",
      "quantity": 2
    }
  ]
}

Exemplos de validações que você pode transformar em asserções:

status code == 201
response.body.status == "created"
response.body.id exists
response.body.customerId == "cus_123"

Cursor e Sonnet 5 aceleram a escrita do código. O Apidog torna a validação da API reproduzível para você e para o time.

Se você vem de outras ferramentas, este guia sobre testar API sem Postman mostra o fluxo de ponta a ponta. Você também pode baixar o Apidog e testar com seus próprios endpoints.

Como controlar custo e uso

O Cursor gerencia seus próprios planos, limites e acesso a modelos. Como esses detalhes mudam, verifique sempre a página atual do plano.

Ainda assim, alguns princípios ajudam:

• use Sonnet 5 como padrão para codificação diária;
• reserve Opus 4.8 para tarefas realmente difíceis;
• divida prompts grandes em tarefas menores;
• evite pedir ao agente para explorar o repositório inteiro sem escopo;
• monitore custos novamente, porque o tokenizador mudou;
• com BYOK, acompanhe o uso diretamente na conta Anthropic.

Exemplo de prompt mais econômico:

Analise apenas os arquivos em src/api/orders.
Encontre possíveis bugs de validação no endpoint POST /orders.
Não edite ainda. Liste os problemas primeiro.

Esse prompt evita que o agente leia arquivos desnecessários e reduz o custo da sessão.

Para escolher modelos dentro do Cursor, veja a comparação dos melhores modelos Cursor.

Quando trocar do Sonnet 5 para o Opus 4.8

Use o Sonnet 5 para a maior parte do trabalho:

• desenvolvimento de funcionalidades;
• refatorações;
• correções de bugs;
• geração de testes;
• atualização de documentação;
• leitura e edição de múltiplos arquivos;
• ciclos de executar teste e corrigir erro.

Considere trocar para o Opus 4.8 quando a tarefa envolver:

• decisões complexas de arquitetura;
• depuração sutil com muitas hipóteses;
• raciocínio profundo sem muitas ferramentas;
• execução autônoma longa em que qualidade vale mais que custo;
• problemas em que o Sonnet 5 ficou preso.

Nos benchmarks reportados, o Opus 4.8 supera o Sonnet 5 em raciocínio puro por uma margem maior do que em uso de ferramentas. Por isso, faz sentido manter o Sonnet 5 como padrão e escalar para Opus apenas quando necessário.

Perguntas frequentes

O Claude Sonnet 5 está disponível no Cursor?

O Cursor suporta modelos Claude da Anthropic. O Sonnet 5 deve aparecer no seletor de modelos quando sua versão do Cursor o suportar. Se não aparecer, atualize o Cursor. Você também pode usar BYOK 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 seu plano Cursor incluir modelos Claude, você pode selecionar o Sonnet 5 sem chave própria. Use BYOK quando quiser faturamento pela Anthropic ou controle direto de limites. O guia da API Claude Sonnet 5 explica como trabalhar com a API.

Sonnet 5 ou Opus 4.8: qual é melhor para codificação no Cursor?

Para a maioria das tarefas no Cursor, o Sonnet 5 oferece melhor custo-benefício. Ele fica próximo do Opus 4.8 em codificação agêntica e custa menos. Use Opus 4.8 para 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?

Porque o Sonnet 5 usa um novo tokenizador. O mesmo texto gera aproximadamente 30% mais tokens. O preço por token não mudou, mas solicitações equivalentes podem custar mais. Meça suas cargas reais antes de estimar custo.

Posso usar o Sonnet 5 no Cursor gratuitamente?

Depende do plano do Cursor, que é controlado pelo próprio Cursor. O Sonnet 5 é o modelo padrão no plano gratuito da web e do aplicativo Claude, mas isso é separado do Cursor. Verifique o plano atual do Cursor para saber o que está incluído.