最后更新

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。

GLMGLMOllama CloudCoding Plan

可以添加什么

选择器标签模型 ID认证方式
GLM-5.2 (Ollama Cloud)ollama-cloud/glm-5.2Ollama Cloud API Key
GLM-5.3 (Ollama Cloud)ollama-cloud/glm-5.3Ollama Cloud API Key
GLM-5.3-Flash (Ollama Cloud)ollama-cloud/glm-5.3-flashOllama Cloud API Key
GLM-5.3 (Coding Plan)zai-coding/glm-5.3Z.ai GLM Coding Plan API Key
GLM-5.3-Flash (Coding Plan)zai-coding/glm-5.3-flashZ.ai GLM Coding Plan API Key
GLM-5.2 (Coding Plan)zai-coding/glm-5.2Z.ai GLM Coding Plan API Key
GLM-5-Turbo (Coding Plan)zai-coding/glm-5-turboZ.ai GLM Coding Plan API Key
GLM-5.3-Flash (Z.ai API)zai-api/glm-5.3-flashZ.ai 平台计量 API Key
GLM-5.3 (Z.ai API)zai-api/glm-5.3Z.ai 平台计量 API Key
GLM-5.2 (Z.ai API)zai-api/glm-5.2Z.ai 平台计量 API Key
GLM-4.7 (Z.ai API)zai-api/glm-4.7Z.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

你启用的供应商必须报告 SHOWready。然后完全退出 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-flashzai-api/glm-5.3-flashopenrouter/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 ...,其余流程相同。

官方链接

相关:模型总览Codex 中的 DeepSeekCodex 中的 Kimi安装