Codex

​

准备工作

1. 在 AIMax 平台 创建文本 API Key。
2. 优先选择平台当前对该 Key 展示、并支持 OpenAI Responses 的 GPT 模型；本文使用 gpt-5.4 作为配置示例。
3. 如果 Codex 已登录 OpenAI 或 ChatGPT 账号，先退出该账号，避免与 AIMax API Key 认证冲突。

​

下载安装

​

桌面客户端

​

终端

npm install -g @openai/codex
codex --version

​

写入配置

model_provider = "aimax"
model = "gpt-5.4"
preferred_auth_method = "apikey"

[model_providers.aimax]
name = "AIMax"
base_url = "https://api.aimaxa.cn/v1"
wire_api = "responses"
requires_openai_auth = true

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

​

选择模型

model = "gpt-5.4"

​

启动使用

​

桌面客户端

1. 完全退出 Codex 桌面客户端。
2. 重新打开客户端，选择项目并新建会话。
3. 输入 只回复 OK，不要调用任何工具。。
4. 收到回复后，再逐项验证项目读取、代码编辑、Shell、MCP 和联网能力。

​

终端

codex

codex --model "gpt-5.4"

codex exec \
  --model "gpt-5.4" \
  --ephemeral \
  --skip-git-repo-check \
  --sandbox read-only \
  "只回复 OK，不要调用任何工具。"

​

排错

• 401/403：检查 auth.json、API Key 状态和配置目录。
• 仍显示登录选择：退出 OpenAI/ChatGPT 账号，完全关闭 Codex 后重开。
• 模型不存在：回到平台确认该 Key 当前可见模型，并原样填写完整模型名称。
• 文本成功但工具失败：分别验证目标模型的 Responses、工具调用和 Codex 本地权限。
• 本地环境异常：运行 codex doctor。