前置条件
- 1已安装 Cursor 0.48+ 版本
- 2已注册 DeepSeek 开放平台账号并创建 API Key
- 3本机已安装 Docker 24+（走路径 B 时需要）
- 4已安装 Node.js 18+（走源码手动路径时需要）
读完想动手？新用户首单 8 折上云
服务器 + 大模型 API + 对象存储，新用户首购享 20% 补贴
常见问题
Q接入自定义模型后 Tab 补全还能用吗？
能用，但必须先打开 Settings → Models → Cursor Tab 里对该模型的开关。Cursor 对 Tab 走的是独立的 FIM（Fill-In-the-Middle）端点，DeepSeek 官方 API 不提供 FIM，所以 Tab 补全需要走兼容层把 prompt/completion 请求转成 chat 请求，延迟会比官方 Tab 高 120-300ms。实测 68ms/token 的生成速度下体感可接受，但在快速连续输入时会出现「补全追不上光标」，建议把 Tab debounce 调到 250ms。
Q为什么 Agent 模式报错「Model does not support tool use」？
三个原因按概率排序：(1) Base URL 填错成不含 /v1 的形式，Cursor 拼出 /chat/completions 之外的路径；(2) 你在 Model 列表里手动填了模型名但没点 Verify，Cursor 拉不到该模型的 capabilities；(3) 使用的中转网关把 tools 字段吃掉了。逐个排查：先用 curl 直连确认 dto 里有 function calling，再回 Cursor 点 Verify，最后换代理。
QV4.1 Flash 和 V4 Pro 在 Cursor 里怎么取舍？
看任务类型。Tab 补全、单行改写、生成注释、写单测这类短输出、高重复的任务用 Flash，成本约为 Pro 的 60%，延迟低 37%；跨文件架构设计、复杂重构方案、需要一次理解整个模块（>8K token 上下文）的任务用 Pro。自己在 Cursor 里建两个自定义模型条目，用 Cmd+/ 切换，比在配置文件里改要快。
QCursor Rules 对自定义模型生效吗？
生效，但要注意规则粒度。Rules 里 .mdc 文件会被拼进 system prompt，Flash 这种激活参数较小的模型对超长 system 的遵循度会下降，实测 Rule 总长度超过 1,800 tokens 后 Composer 的约束命中率从 91% 掉到 63%。建议：把规则拆成多个文件用 globs 精确匹配，单条 Rule 控制在 400 tokens 以内，Always 类型只留 3 条以内。
QAPI Key 会不会被 Cursor 上传？
不会。Key 存在本机 ~/.cursor/ 的配置里，请求从你的机器直连 DeepSeek（或你自建的代理）。但要注意两点：一是不要把 Key 写进项目根目录的 .cursorrules 并提交到 git；二是如果用的是第三方中转，Key 会经过对方网关，敏感项目建议走自建代理。