软件里的「AI 智能回复」需要接一个大模型才能用。但很多朋友第一次配置时卡在三个框：接口地址（Base URL）、API 密钥（Key）、模型名——不知道去哪拿、怎么填。

这篇把常见的几家大模型、以及「中转站」的填法讲清楚，照着填就行。

先说清楚：WorkBuddy、Codex 那些 Agent 能接吗？

很多人第一反应是「我平时用 WorkBuddy / Codex / 某某 Agent，能不能直接接进来？」——先给结论：这些基本都不能接，原因不是软件不兼容，而是它们本身不是「可被第三方调用的模型 API」。

下面逐个说清楚，免得白折腾。

WorkBuddy / WorkBuddy 国际版

WorkBuddy 这类是「Agent 客户端」——它自己是一个调用大模型的产品界面，帮你连模型、跑任务、管理对话。它对外不提供「模型推理 API」（也就是没有一个 https://xxx/v1/chat/completions 这样的接口让你把问题发过去、拿回答回来）。所以没法当作模型服务商填进本软件。

它内部其实也是接了某家大模型（比如 Claude、GPT、DeepSeek），你真正该填的是它背后那家大模型的官方 API 或一个中转站，而不是 WorkBuddy 本身。

OpenAI Codex

Codex 这个名字有两个含义，都接不了：

  • 老的 Codex 模型（code-davinci 系列）：早就下线了，现在没有任何可用的推理接口。
  • Codex CLI / Codex Agent（现在 ChatGPT 里那个写代码的 Agent）：它是绑在 ChatGPT 订阅账号里的产品功能，只能通过官方客户端/网页使用，不开放第三方 API 调用。你不能拿一个 Codex 的 Key 往通用 chat/completions 里发。

要接 OpenAI 的模型，用 OpenAI 官方 API（https://api.openai.com），或走中转站，而不是 Codex。

各种「Agent」客户端（Cursor、Cline、各类套壳 Agent、各种 AI 助手 App）

这一类同理，绝大多数不提供模型 API：

  • 它们是「用模型的产品」，不是「模型接口」；
  • 有的内部有 API 但只给自己用（不对外）；
  • 有的干脆是把你导向它自己的服务器，你无法指定 Base URL / 拿到独立 Key。

判断标准很简单：一个工具能不能接，就看它给不给你三样东西——独立的 Base URL、独立的 API Key、独立可选的模型名。给不了这三样，就接不了。

那想「少花钱/图方便」怎么办？

用中转站（下面会讲）。中转站就是专门提供「OpenAI 兼容 API」的服务，把 GPT、Claude、Gemini、DeepSeek 等统一成一个接口给你调——这才是能填进本软件的东西。

先理解这三个框

不管哪家模型，本质上都是填这三样东西：

  • 接口地址（Base URL）：模型服务商的接口域名。有的软件要求填到域名，路径部分会自动补；有的要求填完整路径。填的时候注意看软件提示——本软件是填 Base URL，路径（如 /v1/chat/completions）单独一个框，留空会用默认值。
  • API 密钥（Key）：服务商后台生成的密钥，通常以 sk- 开头，只显示一次，拿到要保存好。
  • 模型名：你要用的具体模型，比如 deepseek-chat。

还有一个 API 协议：大部分用「OpenAI 协议」，Claude 用「Anthropic 协议」。本软件有下拉可选。

主流模型怎么填

下面这些是常见服务商的填法（以「OpenAI 协议」为例）：

DeepSeek

  • 接口地址：https://api.deepseek.com
  • 接口路径：/v1/chat/completions
  • API 协议：OpenAI
  • 密钥：DeepSeek 开放平台 → API keys 生成
  • 模型名：deepseek-chat（通用对话）或 deepseek-reasoner（推理模型）

阿里通义千问（DashScope）

  • 接口地址：https://dashscope.aliyuncs.com/compatible-mode
  • 接口路径：/v1/chat/completions
  • API 协议：OpenAI
  • 模型名：qwen-plus / qwen-max / qwen-turbo 等

月之暗面 Kimi（Moonshot）

  • 接口地址：https://api.moonshot.cn
  • 接口路径：/v1/chat/completions
  • API 协议：OpenAI
  • 模型名：moonshot-v1-8k / moonshot-v1-32k 等

智谱 GLM

  • 接口地址：https://open.bigmodel.cn/api/paas
  • 接口路径：/v4/chat/completions
  • API 协议：OpenAI
  • 模型名：glm-4-plus / glm-4-flash（免费档）等

火山引擎豆包

  • 接口地址：https://ark.cn-beijing.volces.com/api
  • 接口路径：/v3/chat/completions
  • API 协议：OpenAI
  • 模型名：填你在火山方舟创建的「接入点 ID」或对应模型名

OpenAI 官方

  • 接口地址：https://api.openai.com
  • 接口路径：/v1/chat/completions
  • API 协议：OpenAI
  • 模型名：gpt-4o / gpt-4o-mini 等

Anthropic Claude（协议选 Anthropic）

  • 接口地址：https://api.anthropic.com
  • 接口路径：/v1/messages
  • API 协议：Anthropic
  • 模型名：claude-3-5-sonnet-20241022 之类（Claude 官方没有模型列表接口，需手动填）

各家模型更新很快，上面的模型名只是举例。具体以你后台能看到的模型列表为准。本软件点「连接」按钮可以自动拉取大部分服务商的模型列表，能拉到就直接下拉选，不用手打。

中转站是什么，怎么填

海外的模型（OpenAI、Claude、Gemini）直接用官方接口，国内往往面临支付、网络两个门槛。所以很多人用「中转站」——它把各家模型统一成一个接口，你用人民币充值，它帮你转发请求。

我自己在用的一个中转站是 亿方云AI（yicode.ai），注册后按下面的方式填：

  • 注册地址：https://www.yicode.ai/register?aff=M38BBADCVHTV
  • 接口地址：https://api.yicode.ai （以它后台给的为准）
  • 接口路径：/v1/chat/completions
  • API 协议：OpenAI
  • 密钥：中转站后台 → 令牌/API Key
  • 模型名：中转站后台会列出支持的模型名（GPT、Claude、Gemini、DeepSeek 等都有），照着填

说明一下：这个中转站不是我开的，只是我自己在用、觉得方便，分享给需要的人，大家可以自行注册试用。如果你有更合适的中转站也完全可以用别的，填法都一样——Base URL 换成那家的、密钥换成那家的、模型名用那家支持的就行。

配置完怎么验证

  1. 填好三样 + 选好协议；
  2. 点「连接」按钮，能自动拉出模型列表就说明地址和密钥填对了；
  3. 从下拉里选一个模型，点「测试连接」，能收到模型的回话就说明整条链路通了；
  4. 最后记得开启「AI 智能回复」开关，不然配好了也不会用。

几个常见坑

  • Key 泄露：密钥等于钱包，别截图发群里、别提交到公开仓库。泄露了立刻去后台删除重建。
  • 地址填多或填少：Base URL 只填到域名（或服务商指定的前缀），别把 /v1/chat/completions 也塞进 Base URL，否则会拼成两遍路径报 404。
  • 模型名写错：模型名必须和服务商后台一字不差，大小写、连字符都要对。
  • 协议选错：Claude 一定要选 Anthropic 协议，选成 OpenAI 会报错。
  • 余额不足：很多「连不上/报错」其实是账户没钱了，先去后台看余额。

照着填，基本都能通。实在搞不定，可以先把 Base URL、错误提示记下来，大概率能一眼看出是地址、密钥还是模型名的问题。