Codex 接入智谱 GLM 的兼容性检查

当前结论（2026-08 核对）：官方公开资料不足以确认原生兼容。 智谱通用 API 文档公开示例使用 /chat/completions；Coding 套餐还有独立端点。Codex 需要 Responses API，不能只凭 /responses 匿名请求返回 401 就宣布跑通。

教程目标

分清智谱通用 API、Coding 套餐、模型名和协议端点，在官方支持与真实账号验证前保持安全停止状态。

第 1 步：确认你买的是什么

在控制台记录但不要粘贴密钥：

• 通用按量 API 还是 GLM Coding 套餐。
• 官方给出的 Base URL。
• 可用模型 ID。
• Key 的适用端点、额度和地域。

套餐专属 Key 与通用 API Key 不能根据名称猜测互换。

第 2 步：检查 Responses 证据

合格证据必须来自智谱官方文档，并明确列出：

1. POST .../responses 完整路径。
2. 请求与响应对象。
3. 流式事件。
4. 目标 GLM 模型支持范围。
5. 工具调用与错误行为。

官方通用 HTTP 介绍中的 /chat/completions 示例不能满足这些条件。

第 3 步：理解匿名 401 的局限

部分服务会在路由分发前统一鉴权，因此不存在或不兼容的路径也可能先返回 401。没有有效账号响应、事件格式和 Codex 任务验证，不能把 401 当作 Responses 支持证明。

第 4 步：当前安全做法

• 不向 config.toml 写入未经官方确认的 BigModel provider。
• 不用真实 Key 反复试探猜测路径。
• 使用智谱官方支持的客户端或 SDK 完成 GLM 任务。
• 确需协议转换时，先完成源码、数据、权限、日志和回滚审查。

第 5 步：未来的验收流程

请只读核对智谱官方 Responses API 文档与我所用套餐的端点。
先不要改 config.toml，也不要读取或显示完整 API Key。
只有端点、模型、流式事件和工具调用都有官方依据时，才生成配置草稿。

然后依次验证最小响应、只读仓库分析、工具调用、错误处理和 Git 状态。每项都保留脱敏结果。

常见误区

• 通用端点和 Coding 端点混用。
• 把 glm-* 模型名存在当作协议兼容证明。
• 只看 HTTP 状态，不检查响应事件结构。
• 从论坛复制旧配置并明文写 Key。

验收结果

1. 已区分通用 API 与 Coding 套餐端点。
2. 已确认当前官方公开示例不足以证明 Responses 兼容。
3. 未写入未经验证的 BigModel Codex provider。
4. 后续支持状态必须同时通过官方文档和真实账号端到端测试。

参考：https://docs.bigmodel.cn/cn/guide/develop/http/introduction

下一篇看：Responses API 和 Chat Completions 的区别。