通过 Z.AI 连接模型服务

Z.AI 官方 Codex 网关：profile 写 [model_providers.ZAI]，base_url 是 https://api.z.ai/api/v1，密钥用 env_key 不要 experimental_bearer_token。

这是换 Codex 使用的模型，流量打到 Z.AI GLM Coding Plan 的 Responses 入口，不是添加 MCP 服务。官方 Codex 页给了 [model_providers.ZAI] 和 wire_api = "responses"，但把密钥写进 experimental_bearer_token——那是把密钥写进 TOML。改成 env_key（变量名），在启动 Codex 的进程里 export ZAI_API_KEY。不要和 experimental_bearer_token / requires_openai_auth / [model_providers.*.auth] 叠在同一张供应商表。

base_url 必须是 https://api.z.ai/api/v1。不要抄 Chat Completions 的 https://api.z.ai/api/coding/paas/v4，也不要 Anthropic 的 https://api.z.ai/api/anthropic——Codex 自定义供应商只认 Responses，wire_api = "chat" 是不受支持的配置。Codex 不会在 base_url 里展开环境变量。不要写 openai_base_url，也不要把 OPENAI_API_KEY 当 Z.AI 密钥。团队套餐密钥不能和其它 Z.AI API Key 互换，要用 Team Plan 那一把。

不要把顶层 model_provider = "ZAI" 一上来写进用户 config，除非你就是要把所有会话都改走 Z.AI。官方手册和 Coding Tool Helper 都会改成默认。更稳妥是独立 profile（0.134 起不要再写 [profiles.zai]）：

# ~/.codex/config.toml
[model_providers.ZAI]
name = "ZAI"
base_url = "https://api.z.ai/api/v1"
env_key = "ZAI_API_KEY"
wire_api = "responses"

# ~/.codex/zai.config.toml
model_provider = "ZAI"
model = "glm-5.3"
model_reasoning_effort = "max"
model_context_window = 1048576

export ZAI_API_KEY=YOUR_ZAI_API_KEY
codex --profile zai
codex --profile zai -m glm-5.3

官方一键向导是 npx @z_ai/coding-helper。交互里会列出 Claude Code / Codex / OpenCode / Crush / Factory Droid；只要 Codex 就只勾 Codex。向导会改 ~/.codex/config.toml，并可能写 experimental_bearer_token 和全局 model_provider；跑完改回 env_key 和独立 profile。不要把 coding-helper auth reload claude 当成 Codex 命令。

可选目录：官方写 model_catalog_json = "~/.codex/models.json"，波浪号不会展开。改成启动时能读到的绝对路径，例如 /home/YOUR_USER/.codex/zai-models.json。本地 JSON 覆盖内置目录，不是追加。官方示例里 glm-5.3 的 base_instructions 是空字符串，仍不要整段抄人格 blob。需要 /model 列出 glm-5.3 时，只留 slug、reasoning 档（low / high / max；这颗模型关不掉思考）和 shell_command。Windows 配置在 %USERPROFILE%\.codex\config.toml，不要抄文档里丢掉用户名的 C:\Users\.codex\config.toml。

GLM-5.3 页还写：部分曾订过 Coding Plan 的密钥目前只能打 Chat Completions。那把钥匙不能拿来配 Codex；换现行 Coding Plan 密钥，或先确认 Responses 入口能通。不要为了迁就旧密钥把 wire_api 改成 chat。

配置说明：

• 不要再写 [profiles.zai] 或把密钥写进 experimental_bearer_token。
• 不要覆盖内置 ID openai、ollama、lmstudio。ZAI 是新 ID，可以。
• 不要写进项目 .codex/config.toml。项目文件无法修改 model_provider / model_providers。
• 不要把这张表当成 MCP。Vision / Web Search / Web Reader / Zread 那些 Z.AI MCP 是另一条。

改完新开会话。codex --profile zai 启动后，发送一条简短请求验证连接。401 先看是不是 Team Plan 密钥拿去打了别的套餐，或旧 Coding Plan 密钥打了 Responses；/model 仍显示 Custom 时，先 codex debug models 再决定要不要绝对路径的目录文件。