Claude Code vs Cursor: comparativo de custo, agentes e automação

A escolha entre claude code vs cursor deixou de ser uma questão de preferência de interface. Em outubro de 2026, as duas ferramentas resolvem o mesmo problema (um agente que lê o repositório, edita arquivos e executa comandos), mas com modelos de cobrança e superfícies de uso distintos. Para um time que paga por assento e roda agentes em CI, a diferença aparece direto na fatura mensal e no tempo gasto configurando o pipeline.

O ponto de inflexão recente é comercial: em 12 de outubro de 2026, o Cursor passou a ser vendido para novos clientes dentro da X Subscription, um pacote que inclui Grok e X Premium. Nesse modelo, o uso de modelos de terceiros, como Claude e GPT, é cobrado à parte, pelo preço de lista da API. Já o Claude Code continua incluído nos planos de assinatura do Claude, com limites por janela de 5 horas e semanais.

Este artigo compara as duas ferramentas com dados verificados nas páginas oficiais na data de publicação: custo por plano, como os tokens são cobrados, automação headless, regras de projeto e integração com MCP. O objetivo é que você consiga estimar o custo mensal real e escolher com base em critérios mensuráveis.

Visão geral

Claude Code é o agente de código da Anthropic. Ele roda no terminal (CLI claude), em extensões para VS Code e JetBrains, no app desktop e na web. Todas as superfícies compartilham o mesmo motor, então o CLAUDE.md, as configurações e os servidores MCP do repositório valem em qualquer uma delas. O foco é execução agentiva: planejar, editar vários arquivos, rodar testes, criar commits e abrir pull requests.

Cursor é um editor de código derivado do VS Code com agente embutido, autocomplete (Tab), modos de planejamento e depuração, agentes em nuvem (Cloud Agents) e revisão automática de PR (Bugbot). Também oferece uma CLI, cujo binário se chama agent, com modo não interativo para scripts e CI.

A diferença estrutural:

Um detalhe prático: o Claude Code tem extensão oficial para o próprio Cursor. Não é uma escolha excludente; muitos times usam o Cursor como editor e o Claude Code como agente.

Custo real: planos e cobrança de tokens

Esta é a seção que mais muda o resultado da comparação, porque os dois produtos medem consumo de forma diferente.

Planos do Claude (Claude Code incluído)

Segundo a página oficial de preços do Claude, o Claude Code está incluído a partir do plano Pro:

Os limites reiniciam em janelas móveis de 5 horas, e os planos pagos também têm limites semanais. Web, desktop, mobile e Claude Code consomem do mesmo pool. Ao atingir o limite, é possível esperar o reset, mudar de plano ou ativar créditos de uso.

Fora da assinatura, o Claude Code também pode autenticar com uma conta da Anthropic Console e pagar por token. Preços de API na data de publicação (por milhão de tokens):

Planos do Cursor (X Subscription)

A página de preços do Cursor exibe, para novos clientes, os planos da X Subscription:

O uso incluído é um pool compartilhado de modelos Grok entre o Grok e o Cursor. Modelos de terceiros, como Claude e GPT, ficam disponíveis a partir do Premium, mas são cobrados separadamente pelo preço de lista da API, via recarga de créditos. Assinantes antigos de Cursor Pro, Pro+ e Ultra mantêm o plano e o uso incluído de modelos de terceiros enquanto não migrarem; segundo a cobertura do lançamento, a migração é irreversível.

Exemplo de cálculo

Suponha um desenvolvedor que roda, por mês, 40 milhões de tokens de input (dos quais 30 milhões são cache read) e 3 milhões de tokens de output no Sonnet 5.5. O script abaixo calcula o custo a preço de lista, que é o que o Cursor Premium cobraria além da assinatura:

// Estimativa de custo mensal a preço de lista (dados sintéticos)
type Price = { input: number; output: number; cacheRead: number }; // US$ por milhão

const sonnet55: Price = { input: 2, output: 10, cacheRead: 0.1 };

function monthlyCost(p: Price, inputM: number, cacheReadM: number, outputM: number): number {
  const uncached = inputM - cacheReadM;
  return uncached * p.input + cacheReadM * p.cacheRead + outputM * p.output;
}

const tokens = monthlyCost(sonnet55, 40, 30, 3); // 10*2 + 30*0.1 + 3*10 = 53
console.log({ tokens, cursorPremium: 30 + tokens, claudePro: 20 });
// { tokens: 53, cursorPremium: 83, claudePro: 20 }

O cálculo ignora o custo de escrita em cache, que o Cursor não detalha. Mesmo assim, ele mostra a lógica: quem quer usar modelos Claude como principal paga a assinatura do Cursor mais os tokens, enquanto no Claude Code o consumo está dentro do plano até o limite da janela. A comparação inverte quando o time aceita usar Grok ou Composer como modelo principal: aí o uso incluído do Cursor cobre o trabalho sem custo variável.

Automação, CI e modo headless

Para pipelines de geração de conteúdo, revisão de PR ou correção de lint em lote, o que importa é o modo não interativo.

Claude Code em script

O Claude Code segue a filosofia Unix: aceita entrada via pipe e roda em CI com a flag -p.

# Revisão de segurança dos arquivos alterados em relação à main
git diff main --name-only | claude -p "revise estes arquivos e liste riscos de segurança"

# Saída estruturada para consumir em outro passo do pipeline
claude -p --output-format json "resuma as mudanças do último commit" | jq -r '.result'

Além do CLI, há integração oficial com GitHub Actions e GitLab CI/CD, revisão automática de PR (GitHub Code Review) e tarefas agendadas na nuvem, que continuam rodando com o computador desligado. Atenção ao custo: rodar o Claude Code em GitHub Actions normalmente exige uma chave de API cobrada por uso.

Cursor em script

A CLI do Cursor usa o binário agent e tem flags equivalentes:

# Instalação (macOS, Linux, WSL)
curl https://cursor.com/install -fsS | bash

# Apenas propõe mudanças
agent -p "adicione JSDoc às funções exportadas de src/utils.ts"

# Aplica mudanças e retorna JSON
agent -p --force --output-format json "atualize as dependências de desenvolvimento" | jq -r '.result'

Para scripts, a autenticação usa a variável CURSOR_API_KEY. Sem --force, o agente apenas sugere alterações, o que é um padrão seguro para CI. O Cursor ainda oferece Cloud Agents com Automations e máquinas self-hosted, e o Bugbot para revisão de PR nos planos Premium e superiores.

Trade-off

Os dois cobrem o caso básico. A diferença está no ecossistema: o Claude Code tem integrações de CI documentadas como primeira classe; o Cursor concentra a automação nos Cloud Agents.

Regras de projeto e contexto

Ambos leem instruções versionadas no repositório, mas com formatos diferentes.

No Claude Code, o CLAUDE.md na raiz é lido no início de toda sessão. É um Markdown livre:

# Diretrizes do projeto

- Use TypeScript estrito em todo arquivo novo.
- Rode `npm test` antes de propor commit.
- Nunca altere arquivos em `migrations/` sem pedido explícito.

No Cursor, as regras de projeto ficam em .cursor/rules e precisam da extensão .mdc, com frontmatter que controla quando a regra entra no contexto:

---
globs: src/components/**/*.tsx
alwaysApply: false
---

Com alwaysApply: true, a regra entra em toda sessão; com globs, entra quando um arquivo correspondente está no contexto; com apenas description, o agente decide. Isso dá controle mais granular sobre o consumo de contexto em monorepos.

O denominador comum é o AGENTS.md: o Cursor o aceita nativamente e o Claude Code pode lê-lo no lugar do CLAUDE.md. Se o time usa as duas ferramentas, manter as instruções em AGENTS.md evita duplicação.

Ambos também suportam MCP (Model Context Protocol) para conectar ferramentas externas, como Jira, Google Drive ou servidores próprios. Um servidor MCP escrito uma vez funciona nas duas ferramentas.

Comparativo

Critérios objetivos, com dados das páginas oficiais em 25/10/2026:

Quando escolher cada um

• Claude Code: o modelo principal do time é Claude, o trabalho é majoritariamente agentivo (tarefas multiarquivo, testes, PRs) e há demanda por CI e tarefas agendadas. O custo fica previsível dentro do plano.
• Cursor: o time quer um editor completo com autocomplete, alterna entre vários provedores de modelo e aceita Grok ou Composer como modelo principal para aproveitar o uso incluído.
• Ambos: Cursor como editor e Claude Code instalado como extensão dentro dele. É a combinação com menor atrito de migração, ao custo de duas assinaturas.

Perguntas frequentes

O Claude Code é gratuito?

Não. O plano Free do Claude não inclui o Claude Code. O acesso começa no Pro, a US$ 20/mês, ou via conta da Anthropic Console com cobrança por token de API.

Posso usar modelos Claude dentro do Cursor?

Sim, a partir do plano Premium da X Subscription. O consumo desses modelos não sai do uso incluído: é cobrado à parte pelo preço de lista da API, via créditos pré-pagos. Assinantes antigos do Cursor mantêm o uso incluído enquanto não migrarem.

Dá para usar Claude Code e Cursor juntos?

Sim. O Claude Code tem extensão oficial para o Cursor, instalável pelo painel de extensões. Mantenha as instruções do projeto em AGENTS.md para que os dois agentes leiam as mesmas regras.

Qual dos dois é melhor para CI/CD?

Os dois têm modo não interativo com -p e saída JSON. O Claude Code tem integração oficial documentada com GitHub Actions e GitLab CI/CD; o Cursor concentra a automação nos Cloud Agents. Em ambos, rodar no CI costuma exigir chave de API e gera custo por uso.

Como os limites de uso se comparam?

Nenhum dos dois publica limites absolutos em tokens. O Claude expressa o uso em múltiplos por janela de 5 horas, com limite semanal; o Cursor expressa em múltiplos do plano Plus, em um pool semanal. A forma mais confiável de comparar é medir o próprio consumo durante uma semana de trabalho.

Referências

• Claude: planos e preços
• Claude Code: visão geral (documentação oficial)
• Anthropic: preços da API por modelo
• Cursor: planos e preços
• Cursor: Rules (documentação oficial)
• Cursor CLI: modo headless
• xAI: anúncio da X Subscription