跳到主要内容
AeroReviewAI API 选购 · 价格与来源核对

AI 指南

Cline 与 Cherry Studio 的协议匹配:先看端点类型再选供应商

两款客户端支持的自定义协议集合不同,选错类型是接入失败的第一原因。本文给一张协议匹配表、各自的字段与验证步骤,以及分层排错。

编辑:AeroReview 编辑部 · 更新时间:

先问服务商要“端点类型”,而不是“兼容性”

“OpenAI 兼容”在实务里至少可能指三种不同协议:Chat Completions(/v1/chat/completions)、Responses(/v1/responses)、以及 Anthropic Messages(/v1/messages,常被笼统归进“兼容”宣传里)。2026-10-07 核验的协议事实:Codex CLI 只支持 Responses;Claude Code 只说 Anthropic /v1/messages;Cline 与 Cherry Studio 的自定义项各覆盖其中一部分。客户端能不能接,由服务商实际暴露的端点类型决定。

协议匹配表

这张表按 2026-10-07 核对的官方文档整理:Cline 的 OpenAI Compatible 页只覆盖 chat 协议;Cherry Studio 自定义服务商默认可加 OpenAI 与 Anthropic 端点,更多设置里再加 OpenAI Responses、Gemini 与图像端点,且端点与 API Key 可独立配置。若服务商只给 chat 协议而你要跑 Codex,问题不在客户端——换服务商或换客户端。

服务商端点(以官方文档/端点声明为准)      客户端配置
────────────────────────────────────────────────────────────
/v1/chat/completions (openai chat)   → Cline「OpenAI Compatible」
                                       Cherry 自定义服务商 · OpenAI 端点
/v1/messages (anthropic)             → Cherry 自定义服务商 · Anthropic 端点
                                       (Cline 的 OpenAI Compatible 页未提供
                                         Anthropic 兼容自定义项)
/v1/responses (openai responses)     → Cherry「更多设置」· OpenAI Responses 端点
                                       (Codex CLI 唯一支持协议)
gemini generateContent               → Cherry「更多设置」· Gemini 端点

Cline:OpenAI Compatible 配置与验证

设置面板里 API Provider 选 “OpenAI Compatible”。必填三项:Base URL(官方文档特意强调不是 https://api.openai.com/v1——那是官方 API 专属)、API Key、Model ID,填完点 Verify 验证。可选字段可设 Max Output Tokens、Context Window、Image Support 与输入/输出单价(按 token 或每百万),单价字段只影响 Cline 面板里的用量估算,不影响服务商实际计费——真实计费以服务商后台与官方价页为准。

Cherry Studio:自定义服务商配置与验证

路径:设置 → 模型服务 → “+ 添加服务商”。填名称与 API 密钥,端点默认可加 OpenAI 与 Anthropic 两类;“更多设置”里可再加 OpenAI Responses、Gemini、图像生成/编辑 Base URL,也可以“从预设创建”(适合 Coding Plan 接入、多账号管理或项目隔离,端点与 Key 独立配置)。加模型用“获取模型列表”自动拉取,或手动输入模型 ID;配完点“检测”验证连通。

排错与验收

Verify / 检测失败时按固定顺序分层:路径(是否带 /v1、前缀是什么)→ 鉴权头类型(Bearer 还是 X-Api-Key、服务商要哪种)→ 模型 ID(是否属于该分组、拼写是否一致)。一次只改一层,别三个变量一起动。

验收条件(可具体观察的协议与工具能力,不含无法自证的身份判断):(1) Cline Verify 通过且完成一次完整对话往返;Cherry Studio “检测”通过且对话框完成一次往返;(2) 所选端点类型与你要用的能力匹配——chat 端点只承诺 chat 协议本身,不承诺 Codex/Claude Code 的 agent 能力,工具内的工具调用、多轮上下文是否可用要在验收里逐项点一遍;(3) 响应里自报的 model 字段不构成模型身份证明(中转场景可改写),因此“同一模型 ID 在不同工具里是否同代一致”不作为验收项,它属于需要专门证据的独立问题。

协议类型与验收结果记进你的服务商台账——下次接新工具直接查表,不再重新试错。

来源与核对记录

合规与风险提示

  • 不教绕过服务商协议或地区限制;Anthropic 端点接入前,先确认你所在地区与服务商条款相互允许。
  • 各客户端字段名称随版本可能变化,以工具内实际界面与官方文档为准(本文核对于 2026-10-07)。