---
title: Cursor 接入
description: 在 Cursor 里用自定义 OpenAI API 密钥和 Base URL 调用 1折AI 的 Claude 模型，以及哪些功能不会走自定义 API 密钥。
---

Cursor 允许在设置里填自己的 API 密钥（API key），聊天模型会用这个 API 密钥发请求。下面是接 1折AI 的做法，以及几个必须先知道的限制。

<Warning>

先了解这三点再动手：

- Cursor 官方说明里，**自定义 API 密钥只对聊天模型生效，Tab 补全始终用 Cursor 自己的模型**。
- 请求会先经过 Cursor 的服务器再发给你填的地址，所以 Base URL 必须是公网可访问的（`https://1zheai.com/v1` 没问题，本地 `localhost` 代理不行）。
- "Override OpenAI Base URL" 这个开关不在 Cursor 的官方文档里，下面的界面描述来自 Cursor 论坛和社区教程，Cursor 改版后可能变化。

</Warning>

## 配置

<Steps>
<Step title="打开模型设置">

Cursor → **Cursor Settings** → **Models**，找到 Keys 区域。

</Step>
<Step title="填 OpenAI API Key 和 Base URL">

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

Base URL 要带 `/v1`。

</Step>
<Step title="添加模型">

在模型列表里点 **Add model**，输入模型 ID，例如 `claude-sonnet-5-5`，然后打开它的开关。模型 ID 见[支持的模型](/docs/models/)。

</Step>
<Step title="在聊天里试一次">

在 Chat 面板选刚加的模型，发一条消息。回复正常后，到控制台[调用日志](/docs/usage-logs/)确认这笔调用。

</Step>
</Steps>

## 已知问题

<Warning>

Cursor 论坛有反馈：设置了 Override OpenAI Base URL 后，名字以 `claude-` 开头的模型可能会被 Cursor 当成 Anthropic 模型，交给 Anthropic 的 API 密钥处理，或者直接报错。选择 Claude 时，模型 ID 以 `claude-` 开头，如果遇到这个问题，先清空 Cursor 里填过的 Anthropic API 密钥再试。

参考：[论坛帖 144899](https://forum.cursor.com/t/anthropic-models-break-when-override-openai-baseurl-is-set/144899)、[论坛帖 146998](https://forum.cursor.com/t/override-anthropic-base-url-automatically-switches-on-when-using-anthropic-byok/146998)。

</Warning>

## 常见问题

<AccordionGroup>
<Accordion title="Tab 补全会用 1折AI 吗？">

不会。按 Cursor 官方说明，Tab 补全一直用 Cursor 自带的模型，不走你的 API 密钥。

</Accordion>
<Accordion title="点 Verify 失败？">

先确认 Base URL 带了 `/v1`。社区反馈 Verify 按钮对非 OpenAI 的模型名不一定通过，可以直接在 Chat 里发一条消息测试，以调用日志里有没有记录为准。

</Accordion>
<Accordion title="Agent / Composer 能用吗？">

社区教程普遍反馈只有 Chat 走自定义 API 密钥，Agent、Apply、Inline Edit 等功能可能仍然走 Cursor 自己的后端。以你实际在调用日志里看到的记录为准。

</Accordion>
<Accordion title="想在编辑器里完整使用 Claude？">

如果你主要想用 Claude 写代码，[Claude Code](/docs/quickstart-claude-code/)（命令行或 VS Code 插件）和 [Cline](/docs/quickstart-cline/) 对自定义地址的支持更完整。

</Accordion>
</AccordionGroup>