🖱️ Cursor 配置指南
Cursor 是目前最强大的 AI 驱动代码编辑器。通过接入 Old Dog AI，您可以在 Cursor 中无缝使用 claude-sonnet-4-6、gpt-5.3-codex 等最顶尖的代码模型，按需付费，大幅降低您的开发成本。
💡 前期准备：根据 Cursor 的官方限制，使用自定义 API Key 完整功能可能需要您拥有 Cursor Pro 及以上账号权限 。请确保您已在 Old Dog AI 控制台 生成了您的 API 密钥。
⚙️ 第一步：进入模型设置界面
- 打开 Cursor 编辑器。
- 点击右上角的 【齿轮图标 (Settings)】 打开设置面板。
- 在左侧菜单栏中，点击选择 【Models】 选项卡。
🔑 第二步：配置基础地址与密钥
在 Models 设置页面中，我们需要用 Old Dog AI 的接口去“覆盖”默认的 OpenAI 接口：
向下滚动页面，找到
API Keys区域。将
OpenAI API Key和Override OpenAI Base URL这两个开关全部打开 (绿色状态) 。填写 API 密钥：在
OpenAI API Key下方的密码框中，填入您的sk-开头的专属密钥 。填写覆盖地址：在
Override OpenAI Base URL下方的输入框中，填入我们的基础网络请求地址：https://api.olddog.shop/v1(⚠️ 极度重要：这里必须包含
/v1后缀，否则 Cursor 会疯狂报错！)
🧩 第三步：添加自定义模型 (核心必看)
默认情况下，Cursor 的模型列表里可能没有我们支持的最新模型（如 claude-sonnet-4-6）。我们必须手动添加它们：
- 页面重新向上滚动，回到最顶部的模型列表区域。
- 找到并点击
+ Add Custom Model(添加自定义模型) 按钮。 - 在弹出的输入框中，严格按照我们在 [1.2 模型与计费规则] 中提供的名称输入。例如输入：
claude-sonnet-4-6。 - 点击旁边的
Add按钮确认添加 。 - 添加成功后，该模型会出现在列表中。请务必确保该模型右侧的开关处于开启 (绿色) 状态！
(建议：您可以重复此步骤，把 gpt-5.3-codex、o3-pro 等写代码的神器全部加进去。)
🚀 第四步：在代码中召唤 AI
- 回到您的代码编辑界面。
- 按下快捷键
Cmd + L(Mac) 或Ctrl + L(Windows) 唤出右侧的 Chat 面板。 - 在 Chat 面板输入框的下方，点击当前显示的模型名称。
- 在下拉列表中选择您刚刚添加的
claude-sonnet-4-6。 - 开始向 AI 提出您的代码需求吧！
💡 常见问题排查
- 为什么提示 API Error 或 404？ 最常见的原因是在
Override OpenAI Base URL中忘记了写/v1，请返回设置仔细检查。 - 为什么模型不回答，提示 Model not found？ 您在添加 Custom Model 时，名称拼写有误（比如多加了空格或大小写不对）。请确保与控制台提供的名称 100% 一致。