第三方客户端
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/v1 或 https://sg.icodeeasy.cc/v1。
配置步骤
- 打开
Cursor Settings(Cursor 设置) → Models(模型) → API Keys(API 密钥)。 - 在
OpenAI API Key(OpenAI API 密钥)中填入你的 API Key,并保持该项启用。 - 启用
Override OpenAI Base URL(覆盖 OpenAI 基础地址),填写https://api.icodeeasy.cc/v1。 - 在模型搜索框中输入
gpt-5.6-sol,点击Add Custom Model(添加自定义模型)。 - 在 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 Studio 或 TRAE,它们可以配置 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/v1 | Base 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 当前协议路由核对。