Guia completo para usar a API DeepSeek no Cursor: configuração, modelos personalizados e revisão de custos

Atualização de 2026-06-08: a DeepSeek já mudou para V4 (deepseek-v4-flash / deepseek-v4-pro). Os nomes antigos deepseek-chat / deepseek-reasoner ainda funcionam como aliases, mas o aviso oficial diz que serão desativados em 2026-07-24. Este texto foi ajustado conforme a documentação da API DeepSeek, a documentação oficial do Cursor e a página de Pricing, com nomes de modelos, base de preços e checklist de diagnóstico sincronizados.

No fim do mês passado, levei um susto ao olhar a fatura do banco: o Cursor Pro tinha cobrado mais 20 dólares. Em três meses, só essa ferramenta já tinha consumido 60 dólares.

O Cursor é realmente bom. A experiência de programação assistida por IA me prendeu. Mas toda vez que a cobrança aparece, bate aquela dúvida: vale mesmo esse preço? Especialmente quando o plano Ultra sobe direto para 200 dólares por mês. Para um desenvolvedor individual, é caro demais.

Até que um dia vi alguém em um grupo técnico comentar que dava para configurar a API DeepSeek por conta própria dentro do Cursor. Minha primeira reação foi: isso é confiável? Vai dar trabalho? A qualidade do código segura?

Depois que testei, entendi o apelo.

A configuração levou 5 minutos. No primeiro mês, gastei só 3 yuans chineses. E a qualidade do código? Fica atrás do Claude 3.5, sim, mas é mais do que suficiente para programação diária. Em alguns casos, até surpreende.

Este artigo mostra o passo a passo para configurar tudo. Também deixo claros os pontos de atenção, inclusive limitações que a documentação oficial nem sempre explicita.

Por que escolher a API DeepSeek?

Vamos começar pelo dinheiro.

O Cursor Pro custa 20 dólares por mês, e o Ultra chega a 200 dólares. Para um desenvolvedor individual, não é uma despesa pequena. Ainda mais se você só escreve código, corrige bugs e não usa IA o dia inteiro em ritmo pesado.

E a API DeepSeek?

Olhe esta tabela de preços para ter uma ideia, usando o preço oficial em dólar e uma conversão aproximada para yuan:

• deepseek-v4-flash (recomendado para o dia a dia): entrada a $0.14 por milhão de tokens, cache hit a apenas $0.0028, saída a $0.28 por milhão de tokens, cerca de ¥1 / ¥2.
• deepseek-v4-pro (raciocínio complexo): entrada em torno de $1.74 por milhão de tokens, saída em torno de $3.48 por milhão de tokens, com contexto de cerca de 1M.
• Os nomes antigos deepseek-chat/deepseek-reasoner ainda apontam para os modos sem raciocínio/com raciocínio do V4-Flash, mas o aviso oficial diz que serão desativados em 2026-07-24. Em configurações novas, preencha diretamente os nomes v4.

Isso pode parecer abstrato. Em um cenário real: eu converso com IA cerca de 100 a 150 vezes por mês, e cada conversa envolve, em média, algumas centenas de linhas de código. Fazendo a conta, o gasto mensal com a API DeepSeek fica por volta de 2 a 5 yuans.

Sim, yuan. Não dólar.

A comparação de custos fica clara de cara:

Depois do custo, vem a qualidade.

A capacidade de código do DeepSeek-V3 está entre as melhores dos modelos open source. Na prática, para escrever código de negócio comum, refatorar e explicar lógica mais complexa, ele se sai bem. Ainda existe diferença em relação ao Claude 3.5 Sonnet, mas não a ponto de atrapalhar o uso diário.

E há uma surpresa: o raciocínio do DeepSeek-R1 é muito forte. Quando o problema exige várias etapas de raciocínio ou desenho de algoritmo, às vezes ele entrega acima do esperado.

Para quem faz sentido?

Resumindo, se você se encaixa em algum destes casos, a API DeepSeek pode ser uma boa:

1. Desenvolvedor individual/independente - tem orçamento limitado, mas quer usar IA como apoio.
2. Estudante - 20 dólares por mês pesa.
3. Equipe pequena - comprar Pro para todo mundo fica caro.
4. Usuário leve - usa poucas vezes por dia, sem uso pesado.

Mas, se você precisa de uso intenso e da melhor experiência possível, eu ainda recomendo usar o Cursor Pro sem muita volta. Afinal, ele tem Tab autocompletion e edição multiarquivo no Composer, recursos que a API DeepSeek ainda não cobre.

Preparação: resolva em 5 minutos

Antes de configurar, você precisa separar algumas coisas. É simples, basta seguir.

Obtenha a DeepSeek API Key

O primeiro passo é criar uma conta na plataforma aberta da DeepSeek e gerar uma API Key.

1. Abra a plataforma aberta da DeepSeek.
2. Cadastre-se e faça login. Ela aceita celular, e-mail e conta do GitHub.
3. Entre no console e encontre a opção “API Keys”.
4. Clique em “Create API Key” e dê um nome a ela, como “cursor-use”.
5. Depois de criar, copie e guarde a API Key. Ela só aparece uma vez.

Lembre-se de carregar saldo antes. O mínimo costuma ser 10 yuans, com suporte a Alipay e WeChat Pay. Usuários novos aparentemente recebem cerca de 5 yuans de crédito, o que já dá para testar.

Entenda os dois modos do Cursor

Este ponto confunde muita gente. O Cursor tem, na prática, duas formas de usar DeepSeek.

1. Modo de assinatura integrada

Vultr - Servidor cloud NVMe de alto desempenho, 32 locais globais, deploy Docker com um clique

Ver preços →Anúncio

Assinantes do Cursor Pro podem usar diretamente o modelo deepseek-r1 integrado. Esse modo não exige configurar API própria, mas requer assinatura Pro e consome a cota do próprio Cursor.

2. Modo de API personalizada (foco deste artigo)

Você configura a API DeepSeek com sua própria API Key e usa seu próprio saldo. Esse modo não exige assinatura Pro, e o custo fica totalmente sob seu controle.

O que vamos configurar é o segundo modo: API personalizada.

Separe estas informações

Antes de começar, confirme que você tem:

• API Key: a string que você acabou de copiar da plataforma DeepSeek.

• Base URL: https://api.deepseek.com, usada na configuração.

• Nome do modelo (versão nova de 2026, preencha diretamente os nomes v4):

  • deepseek-v4-flash - modo duplo sem raciocínio/com raciocínio, primeira escolha para programação diária, rápido e barato.
  • deepseek-v4-pro - raciocínio de ponta, para algoritmos complexos e decisões de arquitetura.

  Os nomes antigos deepseek-chat / deepseek-reasoner ainda apontam para os modos sem raciocínio/com raciocínio do V4-Flash, mas o aviso oficial diz que eles serão desativados em 2026-07-24. Em novas configurações, use diretamente os nomes v4 acima para evitar falhas depois dessa data.

Escolha um primeiro. Eu geralmente uso deepseek-v4-flash: é rápido e resolve. Para problemas mais complexos, mudo para deepseek-v4-pro.

Tutorial passo a passo de configuração

Agora vamos configurar de verdade. Vou detalhar cada etapa para reduzir a chance de você travar no meio.

Passo 1: abra as configurações do Cursor

Há duas formas:

• Atalho: no Mac, pressione Cmd + ,; no Windows/Linux, pressione Ctrl + ,.
• Clique: no canto superior direito, clique no ícone de engrenagem e escolha “Settings”.

Depois de entrar na tela de configurações, encontre “Models” na lateral esquerda e clique.

Passo 2: adicione um modelo personalizado

Na página Models, você verá um botão “Add model”. Clique nele.

Uma caixa de diálogo vai pedir o nome do modelo. Aqui há duas opções:

1. deepseek-v4-flash - use no dia a dia, com resposta rápida.
2. deepseek-v4-pro - use para problemas complexos que exigem raciocínio.

Minha sugestão é configurar primeiro deepseek-v4-flash. Se depois quiser usar o modelo de raciocínio mais forte, volte e adicione deepseek-v4-pro.

Digite deepseek-v4-flash no campo e confirme.

Passo 3: configure a Base URL

Esta etapa é crítica. Muita gente erra exatamente aqui.

Depois de adicionar o modelo, você verá a página de configuração dele. Encontre a opção “Override OpenAI Base URL” e expanda.

No campo, preencha:

https://api.deepseek.com

Alguns tutoriais dizem para adicionar o sufixo /v1. Na prática, os dois costumam funcionar:

• https://api.deepseek.com funciona.
• https://api.deepseek.com/v1 também funciona.

Eu normalmente não adiciono o sufixo, por simplicidade.

Atenção: não coloque espaço ou quebra de linha por engano. Esse URL precisa estar exatamente certo.

Passo 4: insira a API Key

Ainda nessa página de configuração, role para baixo até encontrar o campo “API Key”.

Cole a API Key que você copiou da plataforma DeepSeek.

Pontos importantes:

• Garanta que a API Key foi copiada por completo, sem perder caracteres no começo ou no fim.
• Não deixe espaços antes ou depois.
• Não quebre linha.

Depois de colar, confira visualmente. Essa Key normalmente começa com sk- e segue como uma string longa.

Passo 5: salve e valide

Quando tudo estiver preenchido, clique no botão “Save” no fim da página.

O Cursor vai testar a conexão automaticamente. Espere alguns segundos. Se aparecer um check verde, a configuração deu certo.

Se aparecer um X vermelho ou algum erro, sem pânico. Pule para a seção de solução de problemas, mais abaixo.

Passo 6: comece a usar

Depois que a configuração passar, já dá para usar.

Abra a interface de chat do Cursor, com o atalho Cmd/Ctrl + L. No menu suspenso de seleção de modelo, você verá o deepseek-v4-flash que acabou de adicionar.

Selecione esse modelo e comece a conversar. Peça, por exemplo, uma função simples para testar o resultado.

Sugestão para o primeiro uso:

Faça uma pergunta simples, como “escreva uma função de sequência de Fibonacci em Python”. Observe a velocidade de resposta e a qualidade do código para calibrar sua expectativa.

Limitações importantes: leia antes de cair em armadilhas

Depois de configurar, não comemore cedo demais. Há algumas limitações que você precisa conhecer. São pontos que percebi depois de usar por um mês, e a documentação oficial nem sempre deixa isso tão claro.

Só funciona no modo Chat

Esta é a maior limitação.

O DeepSeek configurado por API personalizada só pode ser usado na interface de chat. Você consegue conversar, pedir geração de código, explicar lógica e revisar código. Tudo isso funciona.

Mas:

• O código gerado precisa ser copiado manualmente para o editor.
• Não dá para usar “Apply” como no Pro para aplicar diretamente em arquivos.
• Não há suporte ao modo Composer, com edição coordenada em vários arquivos.

Em outras palavras, ele “conversa”, mas não “mexe nos arquivos”.

Para mim, isso não pesa tanto, porque já costumo alterar o código manualmente. Mas, se você depende muito dos recursos de aplicação de código do Cursor, esse ponto pode incomodar.

Tab autocompletion não fica disponível

O Tab autocompletion do Cursor é muito bom: enquanto você escreve, ele prevê de forma inteligente a próxima linha.

Railway - Plataforma de deploy moderna, sem ops complexas, no ar em minutos

Começar agora →Anúncio

O problema é que esse recurso só funciona com os modelos integrados do Cursor. API personalizada não cobre isso.

O Tab Completion continua usando os modelos próprios do Cursor. Ou seja, se você não tem assinatura Pro, esse recurso de completar com Tab não fica disponível.

Ainda assim, não é o fim do mundo. O modo Chat já resolve a maior parte dos problemas; Tab é um bônus, não uma necessidade.

Compatibilidade de modelos é limitada

A API personalizada do Cursor só aceita APIs em formato compatível com OpenAI.

A DeepSeek é compatível, então funciona. Mas APIs de outros formatos não entram, por exemplo:

• Modelos de raciocínio da OpenAI, como o1, o1-mini e o3-mini, não são suportados.
• LLMs locais personalizados também não entram.
• Outras APIs que não seguem o formato OpenAI não podem ser conectadas.

Felizmente, a DeepSeek é compatível. Para este caso, ela resolve.

Observação de segurança

Usar uma API Key personalizada significa que sua Key será enviada aos servidores do Cursor a cada requisição.

O Cursor diz oficialmente que não armazena sua Key, mas as requisições passam pelo backend deles. Vale ter isso em mente.

Se segurança for uma preocupação forte, você pode:

1. Trocar a API Key periodicamente.
2. Definir limites de uso para a API Key no console da DeepSeek.
3. Verificar regularmente os logs de chamadas da API.

Pessoalmente, acho o risco aceitável. Afinal, mesmo que uma Key da DeepSeek vaze, o prejuízo tende a ficar limitado ao saldo da conta. Não é tão sensível quanto uma Key de serviço em nuvem.

Experiência real de uso e análise de custo

Depois de tanta teoria, vamos para a prática. Usei por mais de um mês e deixo aqui a experiência real e os gastos.

Cenários de uso diário

No dia a dia, uso a API DeepSeek principalmente para estas tarefas:

1. Revisão e otimização de código

Jogo o código pronto no chat e peço para encontrar problemas e sugerir melhorias. Nesse cenário, ele se sai bem e encontra detalhes que às vezes passam batido.

2. Debug de bugs

Quando não entendo uma mensagem de erro, envio o log e o código relacionado. Ele analisa causas possíveis e aponta caminhos de correção. A taxa de acerto fica em torno de 70% a 80%, melhor do que chutar no escuro.

3. Geração de trechos de código

Quando preciso escrever funções utilitárias ou lógica de processamento de dados, peço um rascunho inicial. Nem sempre dá para usar direto, mas economiza bastante digitação. Normalmente pego o código e ajusto às necessidades reais.

4. Discussão de algoritmos

Esta parte me surpreendeu. Quando encontro um problema de algoritmo ou lógica complexa, converso com ele no modo deepseek-reasoner, e o processo de raciocínio costuma ser claro. Às vezes ele sugere caminhos que eu ainda não tinha considerado.

Cálculo de custo real

Sou desenvolvedor frontend. Em dias úteis, uso cerca de 5 a 10 vezes por dia; no fim de semana, uso ocasionalmente.

Veja a conta do primeiro mês:

• Total de conversas: cerca de 120.
• Média por conversa: 800 tokens de entrada e 500 tokens de saída.
• Consumo mensal total: 96k tokens de entrada e 60k tokens de saída.

Calculando com o preço oficial do deepseek-v4-flash, $0.14/$0.28 por milhão de tokens, aproximadamente ¥1/¥2:

• Custo de entrada: 96k × ¥1/milhão ≈ ¥0.10.
• Custo de saída: 60k × ¥2/milhão ≈ ¥0.12.
• Total: cerca de ¥0.22.

Sim, você leu certo: no primeiro mês, não chegou a três décimos de yuan. O V4-Flash ficou ainda mais barato do que a geração anterior.

Claro, isso acontece porque meu uso é leve. Se você é usuário pesado e conversa com a IA dezenas de vezes por dia, o custo pode chegar a 3 a 5 yuans por mês. Mesmo assim, comparado aos ¥145/mês do Cursor Pro, ainda economiza mais de 95%.

Comparando:

Dicas de uso

Depois de usar por um tempo, resumi algumas dicas para economizar e manter eficiência:

1. Faça perguntas enxutas

Não envie o arquivo inteiro. Envie apenas os trechos de código relevantes. Isso reduz muito o consumo de tokens.

2. Aproveite o cache

O cache hit do deepseek-v4-flash custa apenas $0.0028 por milhão de tokens, praticamente alguns centavos. Se você faz várias perguntas no mesmo contexto, as conversas seguintes saem quase de graça.

3. Comece com Flash e suba para Pro

Use deepseek-v4-flash para dúvidas comuns: é rápido e barato. Só mude para deepseek-v4-pro quando o problema exigir raciocínio mais pesado.

4. Divida o código em partes

Alibaba Cloud - Escolha dos desenvolvedores, 15% de desconto exclusivo em Lighthouse

Ganhar 15% off →Anúncio

Problemas complexos funcionam melhor quando quebrados em perguntas menores. O resultado costuma ser mais claro, e o consumo de tokens fica sob controle.

Solução de problemas comuns

Durante a configuração, alguns problemas podem aparecer. Estes são os pontos em que eu e outras pessoas do grupo mais tropeçamos.

A configuração falha e mostra erro de conexão

Sintoma: depois de clicar em Save, aparece um X vermelho, com mensagem de falha de conexão ou validação.

Passos de diagnóstico:

1. Verifique se a API Key está correta

   • Volte ao console da DeepSeek e copie novamente.
   • Confira se não há espaços extras ou quebras de linha.
   • Confirme se a Key começa com sk-.

2. Confirme se a conta tem saldo suficiente

   • Faça login no console da DeepSeek e veja o saldo.
   • Se o saldo estiver baixo, recarregue primeiro.

3. Tente adicionar o sufixo /v1

   • Mude a Base URL para https://api.deepseek.com/v1.
   • Às vezes isso resolve.

4. Confira a conexão de rede

   • Garanta que você consegue acessar o site oficial da DeepSeek.
   • Se estiver usando proxy, pode ser necessário ajustar a configuração.

Conecta, mas dá erro ao chamar

Sintoma: a validação da configuração passa, mas o uso real mostra erro.

Possíveis causas:

1. Saldo insuficiente - é a causa mais comum. Recarregue 10 yuans para testar.
2. Limite de taxa atingido - a DeepSeek tem limite de frequência. Espere alguns minutos e tente novamente.
3. Nome do modelo errado - confirme se preencheu deepseek-v4-flash ou deepseek-v4-pro. Os nomes antigos deepseek-chat/deepseek-reasoner ainda funcionam antes de 2026-07-24, mas evite caracteres a mais ou a menos.

A resposta fica muito lenta

Sintoma: uma pergunta simples demora muito para responder.

Soluções:

1. Mude para o modo sem raciocínio - deepseek-v4-pro em modo de raciocínio pode ser mais lento. Para uso diário, deepseek-v4-flash basta.
2. Reduza o contexto - não envie código longo de uma vez. Divida em partes.
3. Verifique a rede - os servidores da DeepSeek ficam na China; em condições normais, a resposta deve ser razoavelmente rápida.

Não encontro o modelo adicionado

Sintoma: a configuração deu certo, mas o modelo não aparece na lista da interface de chat.

Soluções:

1. Reinicie o Cursor.
2. Confirme que a configuração foi salva, voltando em Settings > Models.
3. Às vezes a lista de modelos leva alguns segundos para atualizar.

Sugestões avançadas de otimização

Depois que estiver funcionando bem, dá para testar alguns usos mais avançados.

Configure vários modelos ao mesmo tempo

Minha estratégia de configuração é:

• deepseek-v4-flash: programação diária e respostas rápidas.
• deepseek-v4-pro: algoritmos complexos e discussão de arquitetura.
• Claude 3.5 Sonnet (assinatura Pro): desenvolvimento de funcionalidades críticas e refatoração de blocos grandes de código.

Escolha o modelo conforme a complexidade da tarefa. Assim você mantém qualidade e controla custo.

Se você não tem assinatura Pro, pode considerar configurar APIs de vários provedores:

• DeepSeek para o dia a dia.
• Créditos gratuitos do OpenRouter ou Groq para experimentar outros modelos.

Estratégias de uso híbrido

Opção 1: economizar durante a semana e usar Pro no fim de semana

Use a API DeepSeek nos dias úteis para economizar. No fim de semana, quando for mexer em um projeto pessoal, assine um dia de Pro para aproveitar os recursos completos.

Opção 2: Chat pela API, Tab pelo Pro

Se você depende muito do Tab autocompletion, assine o plano Pro mais básico e use a API personalizada para conversas no Chat. Assim você economiza parte da cota do Pro.

Monitoramento de custo

Vale conferir o uso periodicamente:

1. Veja no console da DeepSeek

   • Entre no painel e confira as estatísticas de chamadas da API.
   • Observe o consumo diário e semanal.
   • Se houver um pico repentino, pode haver alguma chamada repetida passando despercebida.

2. Configure alertas de orçamento

   • Defina alertas de uso no console.
   • Por exemplo, notifique quando o saldo ficar abaixo de 5 yuans.
   • Isso evita interrupção do serviço por falta de saldo.

3. Revise todo mês

   • Veja o gasto total mensal.
   • Avalie se precisa ajustar o hábito de uso.
   • Compare com a assinatura Pro para confirmar se a solução ainda compensa.

Conclusão

Depois de tudo isso, o resumo é simples.

Configurar a API DeepSeek no Cursor não é complicado. Em 5 minutos, você coloca para funcionar, e o custo cai de cerca de 145 yuans por mês para algo entre 2 e 5 yuans. A economia aparece imediatamente.

E a qualidade do código? Ainda há diferença em relação ao Claude 3.5, mas para escrever código diário, depurar bugs e fazer code review, dá conta. O raciocínio do DeepSeek-R1 também se sai muito bem em alguns cenários.

Reforçando os pontos principais:

• Custo muito baixo: média de 2 a 5 yuans por mês, com economia de 95%+.
• Configuração simples: seguindo os passos, dá para resolver em 5 minutos.
• Qualidade utilizável: suficiente para programação diária.
• Limitação funcional: só suporta Chat, não Tab autocompletion nem Composer.

Se você é desenvolvedor individual ou faz parte de uma equipe pequena com orçamento limitado, vale testar essa solução. Configure, use por uma semana e veja se combina com seu fluxo de trabalho. Com 10 yuans de saldo, dá para usar por bastante tempo; o custo de experimentar é quase zero.

Agora você pode ir à plataforma aberta da DeepSeek e criar sua conta. Depois de configurar, volte e compartilhe sua experiência nos comentários. Tenho curiosidade real de saber como isso se comporta em diferentes rotinas de trabalho.

E, se quiser mais dicas para economizar com ferramentas de programação com IA, acompanhe o blog. Ainda vou compartilhar outras ferramentas e configurações úteis.

O dinheiro economizado já paga alguns cafés.

Antes de configurar em 2026, faça este julgamento

Leitura complementar: configuração e diagnóstico de rede do Cursor

• Guia de configuração de proxy corporativo no Cursor
• Diagnóstico completo de problemas de rede no Cursor
• Panorama das ferramentas de programação com IA em 2026