Tutorial de configuração do Cursor
Indicado para versões do Cursor que permitem personalizar a OpenAI Key / Base URL.
Leia isto primeiro: o acesso às configurações de modelos varia entre as versões do Cursor. A integração direta com o Token da Guishu só é indicada quando as configurações do Cursor exibem opções como OpenAI API Key e Override OpenAI Base URL / Custom Base URL.
| Item de configuração | Conteúdo a preencher | Observação |
|---|---|---|
| API Key | sk-xxxxxxxx | Insira sua própria Token Key da Guishu. |
| Base URL | https://api.llm-token.cn/v1 | Se houver a opção Override / Custom Base URL, preencha-a aqui. |
| Model ID | Nome completo do modelo na lista de modelos | O nome do modelo deve ser exatamente igual e estar completo. |
1. Abra as configurações de modelos do Cursor
- Abra o Cursor.
- Acesse Cursor Settings.
- Localize Models ou as configurações relacionadas a API Keys.
- Localize os campos de OpenAI API Key e Base URL.
A imagem mostra a área de configurações de Models do Cursor. A opção “Mo…
2. Preencha a interface do Token da Guishu
- Ative OpenAI API Key ou a opção de API Key personalizada.
- No campo API Key, insira sua Key iniciada por
sk-. - Em Base URL / Override OpenAI Base URL, insira
https://api.llm-token.cn/v1. - Se houver suporte a modelos personalizados, informe o ID do modelo, por exemplo
claude-sonnet-4-6ougpt-5.4. - Clique em Verify / Save e crie uma nova sessão para testar.
Como verificar: depois de salvar, crie um novo Chat, selecione o modelo configurado e envie “Olá, responda com uma frase em chinês”. Se a resposta for gerada normalmente, a configuração foi concluída.
3. Limitações do Cursor
| Situação | Recomendação |
|---|---|
| Não há a opção Override Base URL | A versão atual pode não aceitar a integração direta com um gateway personalizado. Recomendamos usar VS Code + Cline, Trae + Cline, OpenCode ou WorkBuddy. |
| Falha na verificação | Verifique a Key, a Base URL e o ID do modelo. Não use o caminho completo do endpoint na Base URL. |
| Algumas funções continuam usando os modelos internos do Cursor | Essa é uma limitação do próprio Cursor. Em geral, uma Key personalizada é usada principalmente por modelos de chat padrão, enquanto certas funções internas ainda podem usar os modelos fornecidos pelo Cursor. |
| A lista de modelos não aparece | Teste primeiro com um ID de modelo específico. Se ainda falhar, mude para um cliente semelhante ao Cline. |
4. Alternativas recomendadas
Se sua versão do Cursor não permite personalizar a Base URL, as alternativas mais confiáveis são VS Code + Cline ou Trae + Cline. Os dois tutoriais estão disponíveis no guia principal e apresentam itens de configuração mais claros.