Integração com o Cursor

Documentação mantida por 1ZheAI. Fontes e correções.

Encontrou um erro? Contate o suporte com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

O Cursor permite preencher sua própria chave de API (API key) nas configurações, e os modelos de chat usam essa chave de API para enviar solicitações. Abaixo está como integrar com a 1折AI, além de algumas restrições que você precisa conhecer antes de começar.

Entenda estes três pontos antes de começar:

• Na documentação oficial do Cursor, a chave de API personalizada só se aplica aos modelos de chat; a conclusão com Tab sempre usa os próprios modelos do Cursor.
• As solicitações passam primeiro pelos servidores do Cursor antes de serem enviadas ao endereço que você preencheu, portanto a Base URL precisa ser acessível pela internet pública (https://1zheai.com/v1 funciona, mas um proxy local localhost não funciona).
• A opção “Override OpenAI Base URL” não consta na documentação oficial do Cursor; a descrição da interface abaixo vem do fórum do Cursor e de tutoriais da comunidade e pode mudar após atualizações do Cursor.

Configuração

1. Abrir configurações de modelo

   Cursor → Cursor Settings → Models, localize a área Keys.

2. Preencher OpenAI API Key e Base URL

   text

   OpenAI API Key              sk-你的Key（1折AI 的 Key）
   Override OpenAI Base URL    https://1zheai.com/v1

   A Base URL deve incluir /v1.

3. Adicionar modelo

   Na lista de modelos, clique em Add model, insira o ID do modelo, por exemplo claude-sonnet-5-5, e ative a opção dele. Os IDs dos modelos estão em modelos suportados.

4. Testar uma vez no chat

   No painel Chat, selecione o modelo recém-adicionado e envie uma mensagem. Após a resposta funcionar normalmente, verifique esta chamada nos logs de chamadas do console.

Problemas conhecidos

Há relatos no fórum do Cursor de que, após configurar o Override OpenAI Base URL, modelos cujo nome começa com claude- podem ser tratados pelo Cursor como modelos Anthropic, sendo encaminhados para a chave de API da Anthropic ou retornando erro diretamente. Ao selecionar Claude, o ID do modelo começa com claude-; se encontrar esse problema, limpe primeiro a chave de API da Anthropic preenchida no Cursor e tente novamente.

Referência: tópico do fórum 144899, tópico do fórum 146998.

Perguntas frequentes

A conclusão por Tab usa 1折AI?

Não. Segundo a documentação oficial do Cursor, a conclusão com Tab sempre usa os modelos nativos do Cursor e não passa pela sua chave de API.

Clicar em Verify falha?

Primeiro confirme se a Base URL inclui /v1. Relatos da comunidade indicam que o botão Verify nem sempre aprova nomes de modelos que não são da OpenAI; você pode enviar diretamente uma mensagem no Chat para testar, considerando como critério se há registro nos logs de chamadas.

Agent / Composer pode ser usado?

Os tutoriais da comunidade relatam amplamente que apenas o Chat usa a chave de API personalizada; funcionalidades como Agent, Apply e Inline Edit podem continuar usando o próprio backend do Cursor. Considere como critério o que você realmente vê registrado nos logs de chamadas.

Quer usar Claude por completo no editor?

Se seu objetivo principal é usar Claude para escrever código, Claude Code (linha de comando ou extensão do VS Code) e Cline oferecem suporte mais completo a endereços personalizados.