Cursor / Cline / Cherry Studio 接入自定义 API 中转的完整配置

主流 AI 编程工具和客户端怎么填自定义 Base URL?覆盖 Cursor、Cline、Roo Code、Continue、Cherry Studio、ChatBox 的逐项配置,附 Claude 与 GPT 模型切换技巧。

AI 编程工具默认只让你登官方账号,但它们几乎全部留了「自定义 OpenAI 兼容端点」的口子。填对 Base URL,你就能在这些工具里用任意模型、按 token 付费,而不是按月订阅。这篇文章逐个过一遍配置。

先记住两个地址

所有工具的配置都基于这两个值:

  • Base URL(OpenAI 兼容):https://api.zaimod.com/v1
  • API Key:在 控制台 创建,sk- 开头

用到 Anthropic 原生协议的工具(如 Cursor 的 Claude 直连模式),Base URL 填 https://api.zaimod.com(不带 /v1)。

Cursor

  1. Settings → Models → OpenAI API Key 区域,勾选 Override OpenAI Base URL
  2. Base URL 填 https://api.zaimod.com/v1,API Key 填你的 key
  3. 点 Verify,通过后在模型列表手动添加你要用的模型名(如 claude-sonnet-5、gpt-5.6-terra)
  4. Composer/Chat 里切换模型即可

注意:Cursor 的 Tab 补全走它自家模型,不受此配置影响。

Cline(VS Code 插件)

  1. 侧边栏打开 Cline → 设置图标
  2. API Provider 选 OpenAI Compatible
  3. Base URL:https://api.zaimod.com/v1,API Key 填入,Model ID 填 claude-sonnet-5
  4. 想用 Anthropic 原生协议的话,Provider 选 Anthropic,Base URL 填 https://api.zaimod.com

Cline 的任务上下文很长,建议搭配 claude-sonnet-5 或 gemini-3-pro-preview(1M 上下文窗口友好)。

Roo Code

配置和 Cline 同构:Provider 选 OpenAI Compatible,Base URL 和 Key 同上。Roo 支持给不同模式(Code/Architect/Ask)配不同模型——把便宜模型(gpt-4o-mini)配给 Ask,贵的配给 Code,成本能降一半以上。

Continue

编辑 ~/.continue/config.json:

JSON
{
  "models": [
    {
      "title": "Claude via zaimod",
      "provider": "openai",
      "model": "claude-sonnet-5",
      "apiBase": "https://api.zaimod.com/v1",
      "apiKey": "sk-your-zaimod-key"
    }
  ]
}

Cherry Studio

  1. 设置 → 模型服务 → 添加供应商
  2. API 地址:https://api.zaimod.com/v1(或勾选 OpenAI 类型后填)
  3. API 密钥填入,模型列表手动添加,比如 gemini-3.1-flash-lite-preview、deepseek-v4-flash
  4. 开启「流式传输」获得打字机效果

ChatBox

设置 → 模型 → AI 模型提供方选 OpenAI 兼容,API Domain 填 https://api.zaimod.com,Key 填入后在模型栏输入模型名。

通用排错清单

配置完跑不通时,按顺序检查:

  1. Base URL 多了或少了 /v1:OpenAI 兼容通道要带 /v1,Anthropic 原生通道不带
  2. 模型名拼写:直接从模型列表复制,别手打
  3. Key 权限:控制台里确认 Key 未被限额或禁用
  4. 401 错误:Key 填错或前面多了空格
  5. 429 错误:触发限流,退避几秒重试;持续出现就在控制台提工单

成本参考

编程场景按重度使用算(每天 300 次交互、平均每次 3K 输入 + 800 输出 tokens):

  • 全部用 claude-sonnet-5:约 $4.8/天
  • 问答用 gpt-4o-mini($0.16/$0.62)+ 编码用 claude-sonnet-5:约 $1.5/天

按 token 付费 + 分模型配置,普遍比 $20/月的订阅更省,还不用抢限额。

还没有 Key?注册一个,两分钟配完 →

延伸阅读

#cursor 自定义 api#cline base url#cherry studio 配置#continue openai 兼容
免费创建 API Key

相关阅读

Cursor、Copilot 与自接 API 的成本账:Tab 补全怎么算

AI 编程工具订阅和自接 API 到底哪个划算?算清 Cursor Pro、GitHub Copilot 的订阅费与配额限制,再用真实挂单价算出自接 API 在轻度、中度、重度使用下的月成本,给出分界点与混合方案。

DeepSeek 免费档能干什么:5 个生产级用法

平台上有一个按次计费 0 元的 deepseek-v4-flash-free 免费档,每天限流。本文给出 5 个真正能上生产的用法:意图分类、内容打标签、结构化抽取、会话摘要、批量预处理,并附用量测算与降级策略。

流式输出 SSE 原理与调试:从 curl 到前端

大模型 API 的流式输出本质是一条 SSE 长连接。本文拆解 text/event-stream 报文格式、stream:true 的分片结构、curl 与前端 ReadableStream 的调试方法,以及代理缓冲、[DONE]、usage 丢失等高频坑位。