CodeRelay 使用教程

方式 A：OpenAI 兼容客户端

在客户端的自定义模型 / 自定义 API 配置里：

• base_url 填 http://127.0.0.1:11435/v1
• Key 填第二步创建的那个 sk- Key
• 不需要配置任何环境变量

Cursor、CodeBuddy IDE 等支持自定义 base_url 的客户端都适用。

用 curl 验证链路：

curl http://127.0.0.1:11435/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"你好"}]}'

把 sk-xxxx 换成你自己的 Key。model 写 auto 时，用哪个账号由账号池调度决定。

方式 B：注入 Cursor（接管 Agent 请求）

「Cursor 服务」页会启动一个本地桥接，把 Cursor 发往 *.cursor.sh 的 Agent 请求接管并改派到反代服务，其余请求原样转发给 Cursor 官方后端。

操作顺序：

1. 启动桥接 — 进入「Cursor 服务」页，点「启动桥接」。后续的证书安装命令由桥接生成（含实际证书路径），桥接起不来就没有可用命令。
2. 生成并信任根证书 — 到 「设置 → 网络 → 证书管理」点「生成根证书」，复制页面给出的安装命令，在终端里执行。CodeRelay 不会自动提权；提示权限不足时，以管理员权限重开终端再执行一次。
3. 添加模型绑定 — 回到「Cursor 服务」页，点「添加绑定」，把一个 API Key 与一个模型配对。没有绑定，Cursor 的模型选择器里就是空的。
4. 开启「注入 Cursor」开关 — 开关只有在桥接运行且证书就绪后才能打开。打开前先存盘：它会改写 Cursor 的 settings.json，并强制结束 Cursor 进程以让代理设置生效，未保存的编辑内容可能丢失。
5. 重新打开 Cursor — 开关旁显示「已注入 / 已接管模型请求」即为生效。

如何还原：

• 关闭「注入 Cursor」开关，或点「停止桥接」，会清除 Cursor 的代理设置，Cursor 回到官方模型。
• 停止桥接会连带关闭注入——代理是桥接进程内的实例，进程一走注入必然失效。

四个必须知道的坑：

• 升级 Cursor 后注入会失效。 请完全退出并重新启动 Cursor，再重新开启注入。
• 不要停在半开状态。 如果 Cursor 的代理设置仍指向本地代理、但注入已关闭，Cursor 会连不上网络。此时点「停止桥接」或重新打开注入开关清理。
• Tab 补全不再由本桥接提供。 相关请求原样转发给 Cursor 官方，可用性取决于你自己的 Cursor 账号额度，属预期行为（这是唯一仍依赖 Cursor 自身的部分）。
• 代理端口在 「设置 → 网络」里，0 表示由系统自动分配；注入已开启时改动端口，需先关闭注入再重新开启才生效。