第三方客户端

Cursor 配置

Cursor 可以通过自定义 API 使用 I Code Easy。下面按 Codex 模型和 Claude 模型分别说明;Cursor Tab、Background Agent 等 Cursor 原生能力不会改用你的 API Key。

Codex 模型配置

Cursor 可以通过 OpenAI-compatible(OpenAI 兼容)接口使用 Codex 模型,推荐先配置 gpt-5.6-sol

配置速查

配置项填写内容
Provider(服务商)OpenAI
API Key(API 密钥)密钥设置 复制
Override OpenAI Base URL(覆盖 OpenAI 基础地址)https://api.icodeeasy.cc/v1
推荐模型gpt-5.6-sol

如果主域名连接慢,可以改为 https://jp.icodeeasy.cc/v1https://sg.icodeeasy.cc/v1

配置步骤

  1. 打开 Cursor Settings(Cursor 设置) → Models(模型) → API Keys(API 密钥)
  2. OpenAI API Key(OpenAI API 密钥) 中填入你的 API Key,并保持该项启用。
  3. 启用 Override OpenAI Base URL(覆盖 OpenAI 基础地址),填写 https://api.icodeeasy.cc/v1
  4. 在模型搜索框中输入 gpt-5.6-sol,点击 Add Custom Model(添加自定义模型)
  5. 在 Chat(聊天)或 Agent(智能体)顶部的模型选择器中选择 gpt-5.6-sol,发送一条简短消息测试。

Refresh Model List(刷新模型列表) 刷新的是 Cursor 内置模型,不会读取自定义 API 服务的 /v1/models。I Code Easy 模型需要手动添加,模型 ID 必须完全一致。

Claude 模型配置

当前支持状态

Cursor 当前不能直接接入 I Code Easy 的 Claude 模型:Cursor 只提供 Override OpenAI Base URL(覆盖 OpenAI 基础地址),没有可填写第三方 Anthropic Base URL(Anthropic 基础地址)的入口;而 I Code Easy 的 Claude 模型必须使用 /v1/messages 协议。

  • 不要在 OpenAI 服务商下把模型 ID 改成 claude-sonnet-4-6,该请求会走 /v1/chat/completions,与 Claude 模型协议不匹配。
  • 如果需要使用 Claude 模型,请改用 Cherry StudioTRAE,它们可以配置 Anthropic-compatible(Anthropic 兼容)地址。
  • 如果 Cursor 后续增加自定义 Anthropic Base URL,本页会再补充 Claude 配置步骤。

兼容性说明

  • Cursor Tab 始终使用 Cursor 自己的模型;填入 API Key 不会替换代码补全模型。
  • Agent(智能体)会使用工具调用并在短时间内发起多次请求。普通聊天可用但 Agent 报错时,先切到 Chat(聊天)验证基础连接,再检查模型和额度。
  • BYOK(自带 API Key)请求仍由 Cursor 后端完成最终提示词构建;Cursor 官方说明 API Key 不会持久化,但 BYOK 不适用 Cursor 的 Zero Data Retention(零数据保留)承诺。

常见问题

现象处理方式
模型刷新后仍看不到 I Code Easy 模型使用 Add Custom Model(添加自定义模型) 手动添加 gpt-5.6-sol
返回 404 或路径中出现 /v1/v1Base URL(基础地址)只填到 https://api.icodeeasy.cc/v1,不要填完整 /chat/completions 路径
Chat 可用但 Tab 没变化正常现象,Cursor Tab 不使用 BYOK
想在 Cursor 使用 Claude 模型当前没有第三方 Anthropic Base URL 配置入口,请改用 Cherry Studio 或 TRAE

官方参考

本页配置于 2026-07-16 按 Cursor 官方帮助和 I Code Easy 当前协议路由核对。