AI 编程助手配置指南:Cursor/Cline 接入教程
随着大语言模型能力的爆发,直接在编辑器里与 AI 对话、让代码自动补全甚至生成整个文件,已经从尝鲜变成了日常。今天这篇文章就带你从零开始,把两款主流 AI 编程助手——**Cursor** 和 **Cline**——配置好,让它们真正为你的生产力服务。我们不讲虚的,直接上步骤和配置代码。
---
## 一、Cursor 配置:像用 IDE 一样接入你的 API Key
Cursor 基于 VS Code 深度定制,最大的亮点是既能用官方集成的模型,也能接入你自己的 API Key。接入自有 Key 的好处很明显:按量计费,成本可控;还能自由选择模型供应商,不被单一厂商绑定。
### 1. 获取并填入 API Key 打开 Cursor 后,进入 **Settings → Models → OpenAI API Key**,或者更直接的,在设置中搜索 `OpenAI API Key`。如果你使用的是兼容 OpenAI 格式的第三方 API,这里同样可用。
点击 “Override OpenAI Base URL” 开关,填入中转站或代理的地址。例如:
``` https://api.tokenpocket.site/v1 ```
然后在 API Key 框中粘贴你的 Key。保存后,Cursor 就会把所有使用 `gpt-4`、`gpt-3.5-turbo` 等模型的请求转发到你指定的 Base URL。
### 2. 模型名配置示例 很多中转服务把 DeepSeek、Qwen、Claude 等模型都映射成 OpenAI 兼容的模型名。在 Cursor 的模型选择列表里,你可以手动输入这些名字。例如你想用 DeepSeek-V3,直接在下拉框输入 `deepseek-chat` 即可。
如果你需要更精细的控制,可以修改 Cursor 的配置文件 `~/.cursor/config.json`,添加自定义模型:
```json { "models": [ { "title": "DeepSeek-V3", "model": "deepseek-chat", "provider": "openai", "apiKey": "your-api-key", "apiBase": "https://api.tokenpocket.site/v1" }, { "title": "Claude 3.5 Sonnet", "model": "claude-3-5-sonnet-20241022", "provider": "openai", "apiKey": "your-api-key", "apiBase": "https://api.tokenpocket.site/v1" } ] } ```
保存后重启 Cursor,你就能在模型列表中看到这些选项了。
---
## 二、Cline 配置:把 VS Code 变成全自动编程终端
Cline 是 VS Code 扩展生态里目前最强的 AI 编程代理之一。它能直接读写文件、执行终端命令、浏览器测试,甚至迭代修复自己产生的错误。要让它跑起来,同样需要配置 API Key 和 Base URL。
### 1. 安装并打开设置 在 VS Code 扩展商店搜索 “Cline” 并安装。侧边栏会出现一个机器人图标,点击进入对话面板。点击右上角齿轮图标,进入 **API Provider** 设置。
### 2. 选择 OpenAI Compatible 提供商 虽然 Cline 原生支持 Anthropic、OpenAI 等官方 API,但最灵活的选择是 **OpenAI Compatible** 选项。在这里填写:
- **Base URL**: `https://api.tokenpocket.site/v1` - **API Key**: 你的 Key - **Model ID**: 按需填写,比如 `qwen-max`、`claude-3-opus-20240229` 或 `gemini-1.5-pro`
配置完成的效果如下:
``` Provider: OpenAI Compatible Base URL: https://api.tokenpocket.site/v1 API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxx Model: deepseek-chat ```
点击 “Test Connection” 测试连通性,出现绿色提示后就可以开始让 Cline 帮你写代码了。
### 3. 高级技巧:用自定义 System Prompt Cline 允许你通过 `.clinerules` 文件定义项目级规则,相当于给 AI 编程助手写一份工作手册。在项目根目录创建 `.clinerules` 文件,内容例如:
``` 你是一个严谨的 TypeScript 后端工程师。 - 所有接口必须定义完整的 DTO 类型。 - 数据库查询使用 Prisma ORM。 - 每个函数都要写 JSDoc 注释。 ```
这样 Cline 的每一次回复都会遵循你的项目规范。
---
## 三、为什么选择自建 API 接入
不管是 Cursor 还是 Cline,用自有 Key 接入的最大优势是**省钱**和**自由**。官方订阅一个月 20 美元起步,且模型选择受限。通过中转服务,你可以按量付费,用多少扣多少;而且可以在 DeepSeek、Qwen、Claude、Gemini 等多个模型之间随时切换,哪个强用哪个。
我自己长期在用 **TokenPocket API 中转站**(https://tokenpocket.site),它把所有主流模型统一成了 OpenAI 格式,一行 Base URL 就够了。特别方便的是它支持 **USDT 直接支付**,免去信用卡和银行卡的地域限制,随充随用。新用户注册还能领到免费体验额度,用来测试配置再好不过。
如果你受够了调试 API Key、发起跨境支付的麻烦,不妨现在就打开 TokenPocket,把 Key 填入你的编辑器。让 AI 编程助手真正变成你指尖的加速器,而不是一个需要反复折腾的玩具。