Cursor CLI 接入 CodeGateway 兼容性说明

(Unofficial)

本指南由社区独立维护,与被介绍的第三方工具厂商无官方隶属、背书或赞助关系,不代表其官方文档。文中第三方商标归其各自所有者所有。

Cursor CLI 仅支持 Cursor 账号鉴权,官方 CLI 无自定义端点配置——本文说明原因与替代方案。

结论:Cursor CLI 目前无法接入 CodeGateway。官方 CLI 仅支持 Cursor 账号鉴权(浏览器登录或 API Key),参数表中没有自定义上游地址的入口。

原因

  • Cursor CLI 的鉴权方式只有两种:浏览器登录(推荐)与 API Key(在 Cursor Dashboard 生成,经 CURSOR_API_KEY 或 --api-key 传入)。

  • 官方 CLI 参数与配置参考(cursor.com/docs/cli/reference/parameters、reference/configuration)中不存在 base URL / provider / 自定义端点相关配置项。

  • 容易混淆的一点:Cursor 编辑器(IDE 应用)支持为自定义模型设置 API Key + Base URL,但那是编辑器功能;Cursor CLI 没有对应配置。

替代方案

如果你想要一个命令行编码代理,且希望经由 CodeGateway 接入多模型:

如果你依然想用 Cursor 的模型能力(不通过 CLI),可以在 Cursor 编辑器里使用你自己的 API Key 设置自定义模型——这不属于本帮助中心的接入范围。

未来可能的变化

如果 Cursor 官方为 CLI 开放自定义模型端点配置,本页会立即更新接入步骤。

常见问题

Q:Cursor CLI 用什么命令? 安装后命令是 agent(如 agent "新增一个函数")。安装:curl https://cursor.com/install -fsS | bash。

Q:我用 Cursor 编辑器自定义了 Base URL,CLI 会继承吗? 不会。CLI 与编辑器是独立配置。

Q:只能用 Cursor 官方模型吗? 是。CLI 的模型列表仅限账号可用模型(agent models),无法指向第三方端点。

相关资料

参考资料

把这篇文档跑成一次真实调用

缺少官方 Key 或面临海外信用卡支付受限?注册后创建一把 sk-cg- 密钥,把 base URL 指向 CodeGateway,现有 SDK 与 CLI 不用改代码即可切换。按量计费,绑卡赠免费额度。

免费注册
作者:CodeGateway 团队