---
title: "Integração com o Cursor"
description: "Como usar uma chave de API personalizada da OpenAI e uma Base URL no Cursor para chamar os modelos Claude da 1折AI, e quais funcionalidades não usam a chave de API personalizada."
headingIds: {"Configuração":"section-1","Problemas conhecidos":"section-2","Perguntas frequentes":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
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.

<Warning>

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.

</Warning>

## Configuração

<Steps>
<Step title="Abrir configurações de modelo">

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

</Step>
<Step title="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`.

</Step>
<Step title="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](/pt/docs/models/).

</Step>
<Step title="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](/pt/docs/usage-logs/) do console.

</Step>
</Steps>

## Problemas conhecidos

<Warning>

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](https://forum.cursor.com/t/anthropic-models-break-when-override-openai-baseurl-is-set/144899), [tópico do fórum 146998](https://forum.cursor.com/t/override-anthropic-base-url-automatically-switches-on-when-using-anthropic-byok/146998).

</Warning>

## Perguntas frequentes

<AccordionGroup>
<Accordion title="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.

</Accordion>
<Accordion title="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.

</Accordion>
<Accordion title="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.

</Accordion>
<Accordion title="Quer usar Claude por completo no editor?">

Se seu objetivo principal é usar Claude para escrever código, [Claude Code](/pt/docs/quickstart-claude-code/) (linha de comando ou extensão do VS Code) e [Cline](/pt/docs/quickstart-cline/) oferecem suporte mais completo a endereços personalizados.

</Accordion>
</AccordionGroup>