Codex接入指南 | Zlux Docs

安装 Codex CLI

执行如下命令安装：


npm install -g @openai/code
# 或者
brew install codex

执行codex --version后，如果能输出版本号，就说明安装成功了。

创建API Key

登录后在 API密钥 页面中创建并复制一个API Key.

创建auth.json文件

删除并重新创建~/.codex/auth.json，更新其中的内容为：


{
  "OPENAI_API_KEY": "你的API_KEY"
}

创建config.toml文件

删除并重新创建~/.codex/config.toml，更新其中的内容为：


model_provider = "zlux"
model = "gpt-5.3-codex"
model_reasoning_effort = "hign"
disable_response_storage = true
preferred_auth_method = "apikey"
 
[model_providers.zlux]
name = "zlux"
base_url = "https://api.zlux.ai/openai/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
supports_websockets = false

验证

重启终端 后，运行如下命令：


codex exec --skip-git-repo-check -m gpt-5.3-codex "Reply with exactly CODEX_PROXY_OK"

如果输出里有CODEX_PROXY_OK，就说明代理配置生效了。

常见问题

代理未生效？
- 配置完成后一定要重启终端，这样环境变量的更改才能生效。
- 先确认OPENAI_BASE_URL是不是https://api.zlux.ai/openai/v1。
- 再确认OPENAI_API_KEY是不是 Zlux 的 API Key。
- 如果改过~/.codex/config.toml，确认supports_websockets = false。
- 还不行的话，重新执行codex login --with-api-key。