Codex GLM:在 Codex 中使用 GLM-5.3 与 GLM-5.3-Flash
本指南教你如何把 GLM-5.3、GLM-5.3-Flash、GLM-5.2 与 GLM-5-Turbo 加进 Codex 模型选择器。主要路径分别计费:Ollama Cloud、Z.ai GLM Coding Plan 与 Z.ai 计量平台 API。
可以添加什么
| 选择器标签 | 模型 ID | 认证方式 |
|---|---|---|
| GLM-5.2 (Ollama Cloud) | ollama-cloud/glm-5.2 | Ollama Cloud API Key |
| GLM-5.3 (Ollama Cloud) | ollama-cloud/glm-5.3 | Ollama Cloud API Key |
| GLM-5.3-Flash (Ollama Cloud) | ollama-cloud/glm-5.3-flash | Ollama Cloud API Key |
| GLM-5.3 (Coding Plan) | zai-coding/glm-5.3 | Z.ai GLM Coding Plan API Key |
| GLM-5.3-Flash (Coding Plan) | zai-coding/glm-5.3-flash | Z.ai GLM Coding Plan API Key |
| GLM-5.2 (Coding Plan) | zai-coding/glm-5.2 | Z.ai GLM Coding Plan API Key |
| GLM-5-Turbo (Coding Plan) | zai-coding/glm-5-turbo | Z.ai GLM Coding Plan API Key |
| GLM-5.3-Flash (Z.ai API) | zai-api/glm-5.3-flash | Z.ai 平台计量 API Key |
| GLM-5.3 (Z.ai API) | zai-api/glm-5.3 | Z.ai 平台计量 API Key |
| GLM-5.2 (Z.ai API) | zai-api/glm-5.2 | Z.ai 平台计量 API Key |
| GLM-4.7 (Z.ai API) | zai-api/glm-4.7 | Z.ai 平台计量 API Key |
GLM 还可通过 OpenCode Go、OpenRouter、Command Code、Venice 与阿里云百炼使用,这些条目因认证和计费主体不同而共存。Ollama Cloud 的 5.3 路线仍是待精确实测的 candidate;Z.ai Coding、Z.ai API 与命名的 OpenCode/OpenRouter Flash 路线已有直接验证。
选择路径
- Ollama Cloud 通过 ollama.com 账户计费。你拿到账户 API Key,路由器从 Ollama 发布的模型元数据读取上下文窗口。已用 Ollama 或想把 GLM 与 Kimi K2.7 Code、MiniMax M3、DeepSeek V4 Pro 等 Ollama Cloud 模型放一起的话选这个。
- Z.ai GLM Coding Plan 使用该计划专用编码端点及其订阅 API Key。订阅了 GLM Coding Plan、想用计划配额与
zai-coding供应商思考行为的话选这个。 - Z.ai API 是独立计费的按量平台,使用自己的
ZAI_PLATFORM_API_KEY;Coding Plan Key 与平台 Key 不能互换。
启用 Ollama Cloud
./bin/model-router codex provider-key ollama-cloud set
./bin/model-router codex providers enable ollama-cloud
密钥提示是隐藏的,值保存在受保护的按用户文件中。Windows 上用 ./codex-router.ps1 codex provider-key ollama-cloud set。
启用 Z.ai GLM Coding Plan
./bin/model-router codex provider-key zai-coding set
./bin/model-router codex providers enable zai-coding
Z.ai coding 密钥与普通 Z.ai 平台密钥不可互换。 只有 GLM Coding Plan 订阅密钥能在编码端点工作,且 Z.ai 把该端点保留给交互式编码工具。普通 Z.ai 平台密钥在此路由上会认证失败。
启用 Z.ai 计量 API
./bin/model-router codex provider-key zai-api set
./bin/model-router codex providers enable zai-api
验证集成
./bin/model-router codex doctor
./bin/model-router codex providers
你启用的供应商必须报告 SHOW 与 ready。然后完全退出 Codex、重新打开、新建任务,在选择器中找 GLM-5.3。实时(消耗配额)检查:
./bin/test-model 'zai-coding/glm-5.3' --live --yes
GLM 请求的行为
zai-coding 使用 Coding Plan 专用端点,并把 Codex 推理选择映射到每个模型声明的档位。已认证 GLM-5.3-Flash 路线只接受 low · high · max,默认 max;无后缀 GLM-5.3 声明 1M 上下文。GLM-5-Turbo 不宣传它不支持的 effort 控制。
GLM-5.3-Flash 是该系列的多模态型号。zai-coding/glm-5.3-flash、zai-api/glm-5.3-flash 与 openrouter/glm-5.3-flash 可以直接读取文本和粘贴的图片,因此路由器会把图片直接交给 GLM,而不会再调用第二个供应商的模型做 Vision Bridge 转写并消耗额外额度。无后缀 GLM-5.3 仍是纯文本路线,遇到图片时继续使用 Vision Bridge。从旧注册表更新后,请重建目录并完全退出、重新打开 Codex,再测试图片输入。
常见坑
- 密钥与配额按供应商隔离。 Ollama Cloud、Z.ai Coding Plan、Z.ai 计量 API、OpenCode Go 与阿里云百炼各自认证、各自计费。
- GLM-5.3-Flash 意外调用 Vision Bridge 通常表示目录过旧。 运行
./bin/model-router codex doctor --fix,然后完全退出并重新打开 Codex,让修正后的图片能力重新发布。 - 选择器缺失通常意味着凭据缺失。 确认供应商报告
ready后重启 Codex。见模型缺失。 - 供应商策略风险。 Z.ai 与 ollama.com 可能限制或封禁代理流量。通过 Codex Router 使用 GLM 风险自负。
- Windows 用户: 密钥命令走
./codex-router.ps1 codex provider-key ...,其余流程相同。