Claude、Codex 这些外部系统怎么接 API？我最近这套填写方法整理

如果你现在要做的事情很简单——

让 Claude、Codex，或者别的外部系统接上 AI API，能正常调用模型

那我建议先把这份完整教程收好：

完整教程： https://my.feishu.cn/docx/UgbAd5BpeosxFlxkNZFc5cFNnIy

因为后面不管你是接 Claude、Codex，还是一些支持 OpenAI / Claude 兼容格式的软件，很多配置思路最后都会回到这份总教程里。
所以最省事的做法就是：先把完整教程留着，缺哪一步再回去翻。

这篇我不写得太像接口文档，就讲最实际的几个问题：

1. Claude、Codex 这类外部系统，一般该填哪几个参数
2. OpenAI 兼容和 Claude 原生有什么区别
3. 我最近是怎么直接用 CCGPAI 生成令牌去接的
4. 模型调用失败时，最常见的问题是什么

说明一下：本文只做配置方法整理，方便少走弯路。正式使用前，建议先确认自己的账号状态、网络环境和使用方式符合当地法律法规及平台规则。

---

一、Claude、Codex 这类外部系统，最常填的其实就两样

大部分第三方系统要接 AI，最后无非就是填这两个：

• Base URL
• API Key

如果对方支持 OpenAI 兼容接口，通常这样填就行：

• Base URL：https://www.ccgpai.com/v1
• API Key：sk-你的令牌

说白了，很多系统的“接 AI”页面，最后就是让你填这两样。

所以如果你现在遇到的是：

• Claude 兼容客户端让我填接口地址
• Codex 让我填 OpenAI Base URL
• 某个插件让我填 API Key

那基本就是在填这里。

---

二、什么时候按 OpenAI 兼容方式接？

这个是最常见的情况。

如果对方系统支持：

• OpenAI
• OpenAI Compatible
• Chat Completions

这种字样，那通常就直接按 OpenAI 兼容接口来配。

最常见的填写方式就是：

• 提供商类型：OpenAI 或 OpenAI Compatible
• 接口地址：https://www.ccgpai.com/v1
• API Key：sk-你的令牌
• 模型名：先查可用模型列表再填

这种方式适合的范围很广，很多第三方系统、脚本、插件、桌面工具，本质上都是走这条路。

如果你现在主要接的是 Codex 这类工具，这条路一般会更顺。

---

三、什么时候按 Claude 原生方式接？

如果对方工具本身就是按 Claude / Anthropic 这套协议写的，那就可能要走原生方式。

这种情况下，除了 key 之外，通常还要带一个版本头：

• x-api-key: sk-你的令牌
• anthropic-version: 2023-06-01

也就是说：

支持 OpenAI 兼容的，优先走 OpenAI 兼容

明确要求 Claude 原生协议的，再走 Claude 原生

这样最不容易绕。

如果你现在主要接的是 Claude 兼容客户端，很多时候就会走这条。

---

四、我最近是怎么直接用 CCGPAI 生成令牌去接的？

这个地方其实没必要写得太复杂。

我最近自己的做法很直接：

先登录 CCGPAI 后台，然后直接在令牌管理里创建 key。

创建完以后，把完整的 sk-令牌 复制出来，再填到外部系统里就行。

也就是说：

• 不需要自己再折腾额外流程
• 不需要一开始就去研究别的接口
• 大多数情况下，直接复制后台完整令牌就够了

对我自己来说，这样最省事。
尤其是后面 Claude、Codex、兼容客户端这些工具一多，直接用同一套后台生成令牌，会比每个地方重新折腾轻松很多。

如果你只是正常接第三方系统，这一步基本就够了。

---

五、模型名不要手写，先查一遍最稳

很多接不上的问题，不是 key 错了，也不是地址错了，而是：

模型名写错了。

最稳的方式就是先查模型列表，再填模型名。

可以先查：

GET /v1/models

拿到返回结果后，再从里面选实际可用的模型。

这样你至少能避免两件事：

• 模型名拼错
• 当前令牌分组根本没有这个模型

这个习惯其实非常有用。

---

六、最常见的调用方式是什么？

如果按 OpenAI 兼容方式走，最常见的就是这个接口：

POST /v1/chat/completions

如果按 Claude 原生方式走，常见的是：

POST /v1/messages

所以你可以这么理解：

• OpenAI 兼容系统 → 大概率走 /v1/chat/completions
• Claude 原生系统 → 大概率走 /v1/messages

很多时候并不是系统不能接，而只是你调用方式选错了。

---

七、如果是第三方工具，一般怎么配最省事？

如果你现在接的是第三方工具，而不是自己写代码，那就更简单了。

通常就按这个思路：

如果工具支持 OpenAI 自定义接口

那就填：

• 接口地址：https://www.ccgpai.com/v1
• API Key：sk-你的令牌
• 模型名：用 /v1/models 查出来的可用模型

如果工具支持 Claude / Anthropic 原生协议

那就按原生方式填：

• Base URL：https://www.ccgpai.com/v1
• API Key：sk-你的令牌
• Header：anthropic-version: 2023-06-01

这个思路其实比死记接口更重要。

---

八、最常见的报错是什么？

1）401 Unauthorized

一般先查这几个：

• 有没有传 Authorization
• 有没有按 Bearer sk-你的令牌 这种格式传
• 令牌是不是可用
• 如果走 Claude 原生方式，有没有传 x-api-key

2）模型不可用

一般是下面这些原因：

• 模型名写错
• 当前令牌分组没有这个模型
• 当前这个模型没有可用渠道
• 系统设置里没开放这个模型

所以最稳的方式还是前面那句：

先查 /v1/models，再填模型名。

3）第三方系统明明填了还是调不通

很多时候不是接口不行，而是：

• Base URL 少了 /v1
• Authorization 格式不对
• 选错调用方式（OpenAI 兼容 / Claude 原生）
• 模型名不是当前分组可见的

这种时候别急着怀疑整套系统，先按这几个点排一下。

---

九、我自己现在为什么还留着 CCGPAI？

我自己现在留着这套是 CCGPAI。
主要还是因为后面不只是接一个东西，Claude、Codex、兼容客户端、开发工具这些一多，配置思路统一一点会省很多事。

另外这套我自己现在用下来也比较省心：

• 登录后先有免费额度，够先把流程跑通
• 常用模型调用比较稳
• 后台直接能看消耗
• 真卡在安装或配置上，也能有人带着配

官网放这里，后面自己看就行：

官网地址： https://www.ccgpai.com/

---

十、最后直接说结论

如果你现在的目标只是：

让 Claude、Codex 这类外部系统正常接上 AI API

那最省事的顺序就是：

1. 先把完整教程留着
2. 登录 CCGPAI 后台生成令牌
3. 如果对方支持 OpenAI 兼容接口，就填 https://www.ccgpai.com/v1
4. 模型名别手写，先查 /v1/models
5. 如果对方明确要求 Claude 原生协议，再走 /v1/messages
6. 出问题优先查 401、模型名、Base URL、调用方式

这样做，比一上来就死磕接口细节要快很多。

最后还是把完整教程再放一次，后面缺哪一步直接回去翻就行：

完整教程： https://my.feishu.cn/docx/UgbAd5BpeosxFlxkNZFc5cFNnIy