Cursor 编辑器接入
在 Cursor IDE 中通过自定义 Anthropic / OpenAI 端点接入 QCode.cc，支持 Cursor v3 的 Agents Window 与 Design Mode
Cursor 编辑器接入¶
Cursor 是基于 VS Code 的 AI-native 编辑器。Cursor v3（2026-04 发布）引入 Agents Window（多 agent 协调）、Design Mode（视觉设计 + 代码联动）、CLI agents（终端中的子 agent）三大新能力。本文介绍如何把 QCode.cc 配置为 Cursor 的上游模型来源。
为什么用 Cursor¶
- Agents Window（v3 新增）：在侧边栏并行跑多个 AI agent，互相不干扰
- Cursor Composer：多文件编辑 + 上下文感知重构，比 Cursor Chat 更适合大改
- Inline Edit (Cmd+K)：选中代码后直接给指令，最快速的迭代方式
- 基于 VS Code：所有 VS Code 扩展生态可继承（包括 Claude Code 的 VS Code 扩展）
前置条件¶
配置步骤¶
Cursor 有两条接入路径，按场景选其一即可。
路径 A：Custom OpenAI-compatible endpoint（推荐）¶
走 OpenAI 协议接 QCode 的 /openai/v1 路径，可用 GPT-5.5 / GPT-5.4 / Gemini 等多家模型。
- 打开 Cursor 设置：
Cmd + ,（macOS）/Ctrl + ,（Windows/Linux） - Models → 滚到底部 Override OpenAI Base URL
- 填写：
| 字段 | 值 |
|---|---|
| OpenAI API Key | 你的 QCode.cc API Key（cr_ 开头） |
| Override OpenAI Base URL | http://103.236.53.153/openai/v1 |
- 在 Models 列表勾选要启用的模型（如
gpt-5.5、gpt-5.4-codex），未列出的可点 + Add model 手动加 model id - 点 Verify 测试连通；通过后即可在 Cursor Chat / Composer 中使用
路径 B：Custom Anthropic endpoint（接 Claude）¶
⚠️ 已知限制：Cursor 的 Anthropic 集成在 Agent 模式下使用 OpenAI Responses API 风格，与 QCode 的 Anthropic 协议路径在某些场景下不兼容（具体表现为某些工具调用 schema 转换失败）。建议优先用路径 A 走 OpenAI 协议；如果要用 Claude 模型，可在路径 A 里加
claude-opus-4-7等 model id（QCode 在 OpenAI 协议层做透传）。
备用节点¶
| 节点 | OpenAI Base URL | Anthropic Base URL |
|---|---|---|
| 深圳直连（CN 用户首选；支持 probe.qcode.cc 查询） | http://103.236.53.153/openai/v1 |
http://103.236.53.153/api |
| 全球通用（境外用户首选） | https://api.qcode.cc/openai/v1 |
https://api.qcode.cc/api |
完整节点列表（含北美 / 欧洲 / 亚洲备用）见 接入点与 API 格式。
与 Claude Code 同时使用¶
Cursor 的内置 AI 与独立的 Claude Code CLI 并不冲突——两者都可在同一个 Cursor 窗口里用：
- Cursor 的 Chat / Composer：编辑器内的 AI，走 Cursor 设置中配的端点
- Claude Code CLI：在 Cursor 集成终端（
Ctrl + `）里运行claude，走 CLI 自身的ANTHROPIC_BASE_URL环境变量
两条路径独立认证，但用同一个 QCode API Key 就共享配额（详见 计费说明）。
限制与注意¶
- Privacy Mode：Cursor 默认会把代码片段发给配置的端点。如果你在 Cursor 设置里启用了 Privacy Mode，请确认 API Key 配置后仍然能接到 QCode；Privacy Mode 不影响外发流量，只阻止 Cursor 自己存储 prompt
- Cursor Pro 订阅 与 QCode API Key 是独立的两套 — Cursor Pro 给你 Cursor 内置 quota（走 Cursor 自己的 GPT-4 池），QCode API Key 走我们家的中转池。两者都在用时按 Cursor 设置的优先级路由
- Cursor v3 Agents Window 当前对 OpenAI / Anthropic 协议的兼容性最稳；非主流 provider（如自建 OSS 模型）支持度参差
常见问题¶
Cursor 提示 "API key not valid"¶
- 确认 API Key 完整、
cr_开头、无前后空格 - 在 Cursor 设置里点 Verify 看具体错误
- 命令行测试连通：
bash curl -H "Authorization: Bearer YOUR_KEY" \ http://103.236.53.153/openai/v1/models返回 JSON 列表则端点 + API Key 都 OK
Composer 用不了 Claude 模型¶
Cursor v2 起 Composer 默认走 OpenAI 协议；选 Claude 时需要在 Models 列表里手动添加 claude-opus-4-7 等 model id（即使 QCode 通过 OpenAI 协议透传 Claude 模型，Cursor 也需要识别 model id 才能下拉显示）。
Inline Edit (Cmd+K) 速度慢¶
Cursor 的 Cmd+K 默认用 Cursor 自家 fast model；切换到 QCode 后改走配置的 base URL，首次延迟会比 Cursor 内置稍高（多一跳中转）。可在设置里勾选 Cursor Tab 用 Cursor 默认，Chat / Composer 用 QCode 端点。
下一步¶
- VS Code 集成 — 同源编辑器，通用配置思路
- 接入点与 API 格式 — QCode.cc 三协议四接入域全表
- Claude Code 完整教程 — CLI 工作流参考
- 计费说明 — 共享配额规则