Codex + 智谱 GLM 配置
Codex + 智谱 GLM 配置
Section titled “Codex + 智谱 GLM 配置”这一篇带你把 Codex 连接到智谱开放平台的 GLM 模型。
智谱这篇最容易踩的坑是：它有 通用 API 端点，也有 GLM 编码套餐专属 Coding 端点。这两个端点不是一回事。你如果买的是 Coding 套餐，就要注意官方文档里的专属端点提示；如果只是普通 API 调用，就走通用端点。
前置教程：Codex + 硅基流动配置
如果你还没有完整跑过“官方参数 -> 环境变量 -> 配置草稿 -> 只读验收”的流程，建议先完成前置教程，再回到本篇。
依据来源：OpenAI Codex 官方手册中的 Custom model providers、
config.toml、环境变量认证说明；智谱 AI 开放文档中的快速开始、API 使用概述、通用端点、Coding 端点、Bearer 鉴权和示例模型。
跟着本篇做完后，你应该能做到：
- 从智谱官方文档确认通用 API Base URL。
- 分清通用端点和 GLM 编码套餐 Coding 端点。
- 从模型概览确认当前可用模型名。
- 创建或准备智谱 API Key。
- 把 API Key 放到 Windows 环境变量
BIGMODEL_API_KEY。 - 让 Codex 生成 GLM 配置草稿。
- 写入配置后用最小对话和只读项目分析验收。
- 失败时能判断是 Key、端点、模型名、额度还是套餐类型问题。
本篇不做什么
Section titled “本篇不做什么”本篇不做这些事：
- 不评测 GLM 所有模型。
- 不讲智谱所有 API。
- 不让你把真实 API Key 发给 Codex。
- 不默认你购买了 GLM 编码套餐。
- 不在配置未验收前让 Codex 修改业务代码。
本篇只解决一个目标：
让 Codex 可以通过智谱 GLM 接口正常响应，并完成一次只读项目分析。第 1 步：打开智谱官方文档
Section titled “第 1 步：打开智谱官方文档”先打开快速开始文档：
https://docs.bigmodel.cn/cn/guide/start/quick-start再打开 API 使用概述：
https://docs.bigmodel.cn/cn/api/introduction你要确认 4 件事：
| 要确认的信息 | 官方文档示例 | 你要记下什么 |
|---|---|---|
| 通用 API 端点 | https://open.bigmodel.cn/api/paas/v4 | 普通 API 调用用这个 |
| 对话补全路径 | /chat/completions | Codex 配置里通常只写 Base URL |
| 鉴权方式 | Authorization: Bearer YOUR_API_KEY | 需要 API Key |
| 示例模型 | glm-5.1 | 本篇默认用这个 |
Codex 配置里建议写 Base URL：
https://open.bigmodel.cn/api/paas/v4不要写成完整接口：
https://open.bigmodel.cn/api/paas/v4/chat/completions第 2 步：确认你是不是 Coding 套餐
Section titled “第 2 步：确认你是不是 Coding 套餐”智谱官方文档特别提示：使用 GLM 编码套餐时，需要配置专属 Coding 端点：
https://open.bigmodel.cn/api/coding/paas/v4而不是通用端点：
https://open.bigmodel.cn/api/paas/v4注意这句话：
Coding API 端点仅限 Coding 场景，并不适用通用 API 场景。所以你先判断自己属于哪种情况：
| 你的情况 | 应该使用的 Base URL |
|---|---|
| 普通 API 调用 | https://open.bigmodel.cn/api/paas/v4 |
| 明确购买/使用 GLM 编码套餐 | https://open.bigmodel.cn/api/coding/paas/v4 |
如果你不确定自己是不是 Coding 套餐，先按普通 API 调用处理，不要乱填 Coding 端点。
第 3 步：确认模型名
Section titled “第 3 步：确认模型名”本篇默认使用官方示例模型：
glm-5.1智谱快速开始文档中还展示了其他模型方向，例如：
GLM-5.1GLM-5V-TurboGLM-ImageCogVideoX-3
但 Codex 做代码任务时，先不要随便选图像、视频、多模态模型。
你要做：
- 打开智谱模型概览。
- 确认
glm-5.1当前可用。 - 确认你的账号有权限调用。
- 如果使用 Coding 套餐，确认套餐对应模型和端点要求。
第 4 步：准备智谱 API Key
Section titled “第 4 步：准备智谱 API Key”进入智谱开放平台：
https://open.bigmodel.cn/你要做：
- 登录账号。
- 进入 API Keys 页面。
- 创建一个新的 API Key。
- 复制 API Key。
- 保存到安全位置。
- 确认账号有可用额度或套餐。
智谱官方文档也提醒：不要泄露 API Key，不要直接硬编码在代码中，建议使用环境变量或配置文件保存。
不要把 API Key 放到这些地方：
- 不要发给 Codex。
- 不要写进 Markdown。
- 不要发到微信。
- 不要截图露出完整 Key。
- 不要提交到 Git。
第 5 步：设置 Windows 环境变量
Section titled “第 5 步：设置 Windows 环境变量”本篇建议环境变量名：
BIGMODEL_API_KEY方法 A：用 Windows 图形界面设置
Section titled “方法 A：用 Windows 图形界面设置”适合新手。
操作步骤：
- 按
Win键。 - 搜索
环境变量。 - 打开“编辑系统环境变量”。
- 点击“环境变量”。
- 在“用户变量”区域点击“新建”。
- 变量名填写：
BIGMODEL_API_KEY- 变量值填写你的真实智谱 API Key。
- 点击确定。
- 关闭所有设置窗口。
- 关闭当前 PowerShell。
- 重新打开一个新的 PowerShell。
方法 B：用 PowerShell 设置
Section titled “方法 B：用 PowerShell 设置”适合熟悉 PowerShell 的用户。
打开 PowerShell，运行：
setx BIGMODEL_API_KEY "你的真实智谱 API Key"注意：
- 引号里替换成你的真实 Key。
- 执行后关闭当前 PowerShell。
- 重新打开 PowerShell 才能读到新变量。
第 6 步：验证环境变量能读取
Section titled “第 6 步：验证环境变量能读取”重新打开 PowerShell 后运行：
$env:BIGMODEL_API_KEY如果能看到一串 Key，说明环境变量能读到。
截图时一定要遮住输出。
如果没有输出，先不要继续配置 Codex。
按顺序检查：
- 变量名是不是
BIGMODEL_API_KEY。 - 设置后有没有重开 PowerShell。
- API Key 有没有复制完整。
- 你是不是在另一个 Windows 用户里启动了 Codex。
第 7 步：让 Codex 生成配置草稿
Section titled “第 7 步：让 Codex 生成配置草稿”打开 Codex。
先不要让它直接写文件。
如果你使用普通 API 通用端点，把下面这段复制给 Codex：
我准备把 Codex 连接到智谱开放平台的 GLM 通用 API。
我已经从智谱官方文档确认：- 通用 API base_url：https://open.bigmodel.cn/api/paas/v4- 对话接口完整路径：https://open.bigmodel.cn/api/paas/v4/chat/completions- model：glm-5.1- API Key 环境变量名：BIGMODEL_API_KEY
要求：1. 先不要修改任何文件。2. 不要让我把真实 API Key 发给你。3. 请根据当前 Codex 官方配置方式，给出 config.toml 配置草稿。4. provider_id 使用 bigmodel。5. 配置里只能写环境变量名，不能写真实 API Key。6. base_url 只写到 /api/paas/v4，不要写完整 /chat/completions。7. 请解释每一行配置是什么意思。8. 请特别说明是否需要 wire_api 字段；如果你不确定，请写“不确定”，不要编。9. 请提醒我如果购买的是 GLM 编码套餐，应核对 Coding 端点。你希望 Codex 给出的草稿大概像这样：
model = "glm-5.1"model_provider = "bigmodel"
[model_providers.bigmodel]name = "Zhipu GLM / BigModel"base_url = "https://open.bigmodel.cn/api/paas/v4"env_key = "BIGMODEL_API_KEY"如果你明确使用 GLM 编码套餐，Base URL 应该改成：
base_url = "https://open.bigmodel.cn/api/coding/paas/v4"重点检查：
model是你从官方文档确认的模型名。model_provider是bigmodel。[model_providers.bigmodel]和model_provider对得上。base_url没有带/chat/completions。env_key是BIGMODEL_API_KEY，不是你的真实 Key。- 普通端点和 Coding 端点没有混用。
关于 wire_api 的说明
Section titled “关于 wire_api 的说明”智谱官方文档提供的是标准 HTTP API，对话补全接口路径是 /chat/completions。
OpenAI Codex 官方手册说明自定义 provider 涉及 Base URL、wire API、认证和可选请求头；当前手册示例里的 wire_api 注释为 responses，并标注这是支持值。
所以本篇继续采用保守做法：
不要自己随便加 wire_api。先让 Codex 根据当前版本解释是否需要。最终用只读任务验收能不能跑通。如果 Codex 要加 wire_api = "chat"，你要追问：
请说明你添加 wire_api = "chat" 的依据来自哪里。当前 Codex 官方手册是否支持这个值？如果没有明确依据，请不要添加。第 8 步：让 Codex 写入配置
Section titled “第 8 步：让 Codex 写入配置”确认配置草稿没问题后，再发：
我确认智谱 GLM 配置草稿可以继续。
请把 bigmodel provider 写入 Codex 用户级配置文件。
要求：1. 修改前先告诉我目标配置文件路径。2. 只修改 Codex 配置文件。3. 不要写入真实 API Key。4. 只写入 env_key = "BIGMODEL_API_KEY"。5. 如果配置文件不存在，请先说明将创建哪个文件。6. 修改后展示 diff。7. 用中文解释每一处变化。8. 不要修改业务项目文件。Windows 上 Codex 用户级配置一般位于：
C:\Users\你的用户名\.codex\config.toml也可以理解成：
~\.codex\config.toml如果你设置过 CODEX_HOME，让 Codex 先解释实际路径。
第 9 步：重启 Codex
Section titled “第 9 步：重启 Codex”配置文件和环境变量改完后，建议重新启动。
操作顺序：
- 退出当前 Codex。
- 关闭当前 PowerShell。
- 重新打开 PowerShell。
- 进入练习项目目录。
- 重新启动 Codex。
这样可以确保新环境变量和新配置都被读取。
第 10 步：做最小对话验证
Section titled “第 10 步：做最小对话验证”进入 Codex 后，先发：
请只用一句中文回复：智谱 GLM 配置验证开始。如果能正常回复，说明模型调用链路有机会是通的。
如果这里失败，不要继续项目操作，先看错误信息。
第 11 步：做只读项目验证
Section titled “第 11 步：做只读项目验证”最小对话能回复后，再做项目只读验证。
复制这段给 Codex：
请只读分析当前项目，不要修改任何文件，不要创建文件，不要删除文件。
请按下面格式输出：
## 1. 响应状态- 你是否能正常响应：- 如果你能判断，本次使用的模型/provider 是什么：- 如果不能判断，请写“不能判断”：
## 2. 当前项目- 当前目录：- 是否像项目根目录：- 判断依据：
## 3. 只读检查- 你查看了哪些文件或目录：- 有没有运行只读命令：- 有没有修改文件：
## 4. 智谱配置提醒- 当前配置更像通用端点还是 Coding 端点：- 如果我购买的是 GLM 编码套餐，应该核对什么：- 如果模型不存在，应该先查哪里：
## 5. 下一步建议- 如果配置正常，下一篇应该做什么：- 如果配置异常，先查哪 3 件事：你希望看到：
- Codex 能正常输出。
- 它能读到当前项目路径。
- 它没有修改文件。
- 它能提醒通用端点和 Coding 端点不要混用。
- 它能说明不确定的地方。
第 12 步：确认没有改业务文件
Section titled “第 12 步：确认没有改业务文件”继续让 Codex 检查：
请检查当前 Git 状态，确认这次智谱 GLM 配置验证有没有修改业务项目文件。
要求：1. 只运行只读检查。2. 不要修改任何文件。3. 如果工作区噪音较多，请列出变化文件，并说明这些变化是否和本次配置有关。如果工作区干净，本篇验收更稳。
如果有变化，先截图，再让 Codex 解释 diff，先不要提交。
问题 1：API Key 无效或 401
Section titled “问题 1：API Key 无效或 401”优先检查：
BIGMODEL_API_KEY是否存在。- Key 是否复制完整。
- Key 是否属于当前智谱账号。
- 账号是否有额度或套餐。
- 是否设置后没有重开 PowerShell。
可以问 Codex：
Codex 提示 BIGMODEL_API_KEY 相关错误。请只读检查当前环境是否能读取这个环境变量。不要显示完整 Key，只告诉我是否存在，以及长度是否大于 0。问题 2：端点写错
Section titled “问题 2：端点写错”普通 API 调用使用：
https://open.bigmodel.cn/api/paas/v4GLM 编码套餐使用：
https://open.bigmodel.cn/api/coding/paas/v4不要把完整接口写进 Codex 配置：
https://open.bigmodel.cn/api/paas/v4/chat/completionsCodex 配置里建议写 Base URL，让请求路径由 provider 逻辑拼接。
问题 3：模型不存在或无权限
Section titled “问题 3：模型不存在或无权限”优先检查：
glm-5.1当前是否在模型概览里。- 当前账号是否有权限调用。
- 是否需要开通模型或套餐。
- 你是否把 Coding 套餐模型放到了通用端点。
- 你是否把通用模型放到了 Coding 端点。
可以问 Codex：
智谱返回模型不存在或无权限。请不要修改配置，先列出我应该去智谱模型概览、API Keys 和套餐页面确认的 5 个位置。问题 4：能聊天，但代码任务效果不稳定
Section titled “问题 4：能聊天，但代码任务效果不稳定”这不一定是配置错误。
可能原因：
- 当前模型不适合代码代理任务。
- 没有使用 Coding 套餐对应端点。
- 项目上下文太长。
- 提示词太模糊。
- 任务范围太大。
- Codex 权限范围不够。
先用只读项目分析和单文件小改动验证，不要一上来重构。
本篇验收结果
Section titled “本篇验收结果”做到这里，如果满足下面 8 条，就说明智谱 GLM 配置教程完成：
- 你从智谱官方文档确认了通用 API 端点。
- 你知道通用端点和 Coding 端点不能混用。
- 你从模型概览确认了当前可用模型名。
- 你把 API Key 放进了
BIGMODEL_API_KEY环境变量。 - Codex 配置文件没有出现真实 API Key。
- Codex 能正常回复一句中文验证消息。
- Codex 能完成一次只读项目分析。
- Git 状态确认没有意外业务文件变化。
下一篇学什么
Section titled “下一篇学什么”下一篇看：第一次让 Codex 阅读项目。
如果你想继续补齐国内模型系列，下一篇服务商教程可以写：Codex + 豆包/火山方舟配置。
- OpenAI Codex 官方手册：
https://developers.openai.com/codex/codex-manual.md - 智谱快速开始：
https://docs.bigmodel.cn/cn/guide/start/quick-start - 智谱 API 使用概述：
https://docs.bigmodel.cn/cn/api/introduction