InícioGuia
Configuração de endpoint personalizado para a API Claude Code no Cursor
Procurando uma configuração de API Claude Code para Cursor que não dependa de um único fornecedor? O Cursor pode se conectar a qualquer endpoint compatível com OpenAI, e este guia mostra cada configuração necessária.
Atualizado

O que você está configurando
O Cursor é um editor com recursos de IA integrados. Entre suas configurações de modelo há um campo que permite substituir a base URL do OpenAI pela sua, além de um local para inserir sua própria chave. Isso permite enviar requisições de chat para qualquer serviço que siga o formato de chat-completions do OpenAI. Este serviço segue o formato, então o Cursor pode usá-lo como o modelo por trás do chat e das edições em linha.
Os valores que você inserirá são fixos. Base URL: https://api.claudecodeapikey.com/v1. Nome do modelo: uncensored. Chave: a da sua conta, enviada como token Bearer. Nada mais precisa ser configurado no lado do servidor.
Entenda com clareza o que isso é. O modelo por trás do endpoint é um modelo de pesos abertos de um provedor independente. Não é um modelo Claude e não é a API oficial da Anthropic ou de qualquer outro. Se você veio aqui esperando o próprio Claude dentro do Cursor, isso é algo diferente, e as seções finais explicam como avaliar se é bom o suficiente para seu trabalho.
Antes de abrir o Cursor
Prepare isso primeiro para não parar no meio do caminho.
- Crie uma conta com Google ou com e-mail e senha.
- Abra a página da chave de API e crie uma chave. O guia da chave mostra onde fica cada botão.
- Resgate o crédito de teste de $0,50 se quiser testar sem pagar. É um clique, não precisa de cartão e dura 7 dias.
- Execute uma verificação rápida pelo terminal para confirmar que a chave funciona antes de culpar o editor.
curl https://api.claudecodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'
Uma resposta JSON com uma mensagem significa que a chave e a URL estão corretas. Um HTTP 401 significa que a chave está errada ou tem espaços extras. Corrija isso aqui, porque as mensagens de erro do Cursor são menos específicas que as do curl.
Configuração passo a passo no Cursor
Os nomes dos menus variam entre as versões do Cursor, então trate os rótulos abaixo como um guia e procure a correspondência mais próxima.
- Abra as configurações do Cursor e vá para a seção de modelos.
- Encontre o campo para uma chave de API OpenAI e cole sua chave deste serviço.
- Ative a opção para substituir a base URL do OpenAI e insira
https://api.claudecodeapikey.com/v1. Inclua o/v1no final e não adicione nenhum caminho adicional como/chat/completions. - Use a opção para adicionar um modelo personalizado e digite
uncensoredexatamente, em minúsculas. - Pressione o botão de verificar ou salvar ao lado do campo da chave. O Cursor envia uma pequena requisição de teste.
- Abra um painel de chat, selecione
uncensoredno menu suspenso de modelos e envie um prompt curto.
Se a etapa de verificação falhar, mas a verificação com curl passou, verifique se você digitou a URL no campo de base URL e não no campo da chave, e se a versão do Cursor não redefiniu a substituição após uma atualização. O guia de início rápido mantém os passos atuais para este editor.
Um detalhe importante: uma única substituição se aplica ao slot do provedor OpenAI. Se você também usar modelos reais do OpenAI por meio desse slot, eles também serão roteados para este endpoint. Muitas pessoas mantêm um perfil separado no Cursor ou desativam a substituição quando querem voltar.
Teste com um prompt de codificação real
Uma saudação prova pouco. Use um prompt que exercite a janela de contexto e instruções. Selecione uma função no seu projeto, abra o chat e peça algo concreto, como adicionar validação de entrada e um teste unitário. Observe três coisas.
- Streaming. A resposta deve aparecer token por token. O endpoint faz streaming via SSE, então uma longa espera seguida por um bloco de texto sugere que um proxy ou configuração está armazenando em buffer.
- Uso de contexto. Anexe dois ou três arquivos e faça uma pergunta que exija todos eles. A janela de contexto tem 100.000 tokens, o que comporta muito código fonte, mas seu editor decide quanto realmente envia.
- Seguir instruções. Peça uma resposta apenas com diff ou um formato de saída estrito e veja se o modelo segue. Modelos de pesos abertos variam nisso, e você quer aprendê-lo desde o primeiro dia.
Mantenha uma lista curta de cinco tarefas reais do seu próprio repositório e execute-as novamente sempre que alterar uma configuração, como temperatura. Avaliar com seu próprio código supera qualquer afirmação geral, inclusive a nossa.
Corrigindo os erros comuns
401 ou chave inválida
A chave está errada, expirou na área de transferência ou tem espaços ao redor. Cole-a novamente. Certifique-se de que o esquema de Autorização seja Bearer, que o Cursor faz para você quando usa o campo de chave do OpenAI.
404 ou modelo não encontrado
Quase sempre um problema de base URL. A falta de /v1 ou o excesso de /chat/completions quebram o caminho. O nome do modelo também deve ser uncensored, sem maiúsculas ou espaços.
429 com rate_limited ou concurrency
Você atingiu um limite. A chave de teste permite 2 requisições simultâneas e 60 por minuto, e a chave completa permite 8 simultâneas e 300 por minuto. Um editor pode disparar várias requisições de uma vez, como chat mais edições em segundo plano, e o streaming mantém seu slot até o fim. O código de erro indica qual limite: rate_limited é requisições por minuto, concurrency é muitas de uma vez. Uma sobrecarga temporária também retorna 429 com Retry-After: 5, então esperar cinco segundos e tentar novamente é o correto.
A resposta é cortada
A janela de contexto tem 100.000 tokens, incluindo prompt e conclusão. Um anexo muito grande deixa pouco espaço para a resposta. Envie menos arquivos ou inicie um chat novo.
Recursos que não fazem nada
A API é apenas de texto e não oferece embeddings. Se um recurso do Cursor precisar de um modelo de embedding ou entrada de imagem, não funcionará por este endpoint.
Configurações que valem a pena ajustar quando funcionar
Após o primeiro chat bem-sucedido, alguns ajustes tornam o uso diário mais suave.
Reduza a temperatura para tarefas de edição. Se seu editor permitir, um valor em torno de 0,2 gera código mais estável. Para brainstorming, aumente-a. Em seguida, monitore a quantidade de contexto que você anexa. A janela é generosa, mas cada arquivo anexado é cobrado como entrada, então fechar abas não relacionadas e excluir pastas de build mantém o custo baixo e as respostas mais focadas.
Se você usar o modo agente ou multi-etapas, lembre-se do suporte a chamada de funções: o endpoint aceita tools e tool_choice e faz streaming de tool_calls. Se um recurso específico do Cursor os usa depende da versão, então execute uma pequena tarefa de agente e leia o que acontece antes de confiar em uma grande alteração. Por fim, dê uma olhada no cabeçalho X-Balance-USD em um teste de terminal de vez em quando, para que um saldo baixo não surpreenda você no meio do trabalho.
Usando a mesma chave em scripts
Uma vantagem de um endpoint compatível com OpenAI é que a chave configurada no Cursor também funciona em código. Aqui está um exemplo em Node, útil para scripts de build ou ferramentas de mensagem de commit.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.claudecodeapikey.com/v1",
apiKey: process.env.API_KEY,
});
const out = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
],
});
console.log(out.choices[0].message.content);
Armazene a chave em uma variável de ambiente, não em um arquivo que você faz commit. Cada resposta inclui um cabeçalho X-Balance-USD, então um script pode avisar quando o crédito estiver baixo.
Custo e quando vale a pena manter
O uso no editor é intensivo em entrada porque cada requisição carrega o contexto do arquivo. A $0,15 por 1M de tokens de entrada e $0,50 por 1M de saída, uma requisição com 15.000 tokens de entrada e 1.000 tokens de saída custa 0,015 x $0,15 + 0,001 x $0,50 = $0,00225 + $0,0005 = $0,00275. Cem dessas requisições custam $0,275. A página de preços tem valores de recarga, a partir de $20, com bônus a partir de $50.
Mantenha sua configuração atual se você depende do modelo de um fornecedor específico para refatorações complexas, ou se seu fluxo de trabalho depende de recursos que um endpoint de chat simples não oferece. Use este quando quiser um preço baixo por token, uma API simples e menos recusas de conteúdo em trabalho lícito. Muitos desenvolvedores mantêm ambos configurados e alternam por tarefa.
Mais guias
Perguntas e respostas
Qual base URL eu insiro no Cursor?
Insira https://api.claudecodeapikey.com/v1 incluindo o /v1. Não adicione /chat/completions no final.
Qual nome de modelo eu devo adicionar?
Adicione um modelo personalizado chamado uncensored, em minúsculas. É o único ID de modelo que a API oferece.
Isso me dá modelos Claude no Cursor?
Não. O endpoint oferece um único modelo de pesos abertos de um provedor independente. Não é uma API oficial da Anthropic ou de qualquer outro fornecedor.
Por que recebo erros 429 no editor?
Ou você ultrapassou o limite por minuto ou tem muitas requisições simultâneas. Uma chave de teste permite 2 simultâneas e 60 por minuto; uma chave completa permite 8 e 300.
Posso testar sem pagar?
Sim. Novos usuários podem obter $0,50 de crédito de teste na página da chave de API. Não precisa de cartão e é válido por 7 dias.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.