Codex CLI 配置指南

Codex CLI 是 OpenAI 官方的终端编码代理，可以在本地读取、修改并运行代码。
它默认连接 OpenAI，也支持通过自定义 model_provider 接入 MaoMaoToken API，使用账号中可用的 GPT 编码模型。

开源地址：openai/codex

TIP

Codex CLI 使用 OpenAI 兼容接口时，base_url 需要填写 https://api.maomaotoken.com/v1，注意末尾要带 /v1。
这点和 Claude Code 不一样。

准备工作

在配置 Codex CLI 前，需要先准备好下面几项：

项目	说明
Node.js	用于通过 npm 安装 Codex CLI
Codex CLI	OpenAI 官方终端编码代理
MaoMaoToken API Key	建议使用 `auto` 分组的令牌
默认模型	选择你账号中可用的 GPT 编码模型

安装步骤

1. 安装 Node.js

访问 Node.js 官网，建议下载左侧的 LTS 版本。LTS 是长期支持版，更适合日常稳定使用。

安装完成后，打开命令行验证：

bash

node -v
npm -v

INFO

如果你使用 macOS 并准备通过 Homebrew 安装 Codex CLI，可以跳过 Node.js 的 npm 安装方式。

2. 安装 Codex CLI

打开 cmd、PowerShell 或终端，通过 npm 全局安装：

bash

npm install -g @openai/codex

macOS 用户也可以使用 Homebrew：

bash

brew install codex

验证安装：

bash

codex --version

INFO

Codex CLI 支持 macOS、Linux 和 Windows。Windows 用户可以在 PowerShell 中直接运行，也可以使用 WSL2 获得更接近 Linux 的开发环境。

配置文件位置

Codex CLI 的主配置文件是 config.toml。

系统	配置文件位置
Windows	`%USERPROFILE%\.codex\config.toml`
macOS	`~/.codex/config.toml`
Linux	`~/.codex/config.toml`

接入 MaoMaoToken 需要做两件事：

在 config.toml 中注册一个自定义供应商
在系统环境变量中保存 MaoMaoToken API Key

获取 API Key

进入 MaoMaoToken 控制台，打开 API Key 管理页面，复制你的令牌。

WARNING

建议使用 auto 分组的令牌。不要把 API Key 写进公开仓库，也不要在截图中暴露完整令牌。

写入 config.toml

打开或新建 ~/.codex/config.toml，写入下面内容：

toml

# 默认使用 MaoMaoToken 供应商与模型
model = "gpt-5.4"
model_provider = "maomaotoken"

[model_providers.maomaotoken]
name = "MaoMaoToken"
base_url = "https://api.maomaotoken.com/v1"
wire_api = "responses"
env_key = "MAOMAOTOKEN_API_KEY"

配置项说明：

配置项	说明
`model`	默认模型名，填写 MaoMaoToken 支持的模型，例如 `gpt-5.4`、`gpt-5.3-codex`
`model_provider`	指向下方定义的供应商 ID，这里是 `maomaotoken`
`name`	供应商显示名称
`base_url`	MaoMaoToken 网关地址，Codex CLI 这里必须带 `/v1`
`wire_api`	接口协议，推荐使用 `responses`
`env_key`	保存 API Key 的环境变量名，下一步会设置

TIP

优先使用 wire_api = "responses"，这是 Codex 更适合的接口模式。
如果遇到兼容问题，可以尝试改成 wire_api = "chat" 后再测试。

设置 API Key 环境变量

env_key 指定的环境变量需要在系统中保存真实 API Key。下面示例统一使用：

txt

MAOMAOTOKEN_API_KEY

Windows PowerShell

以下命令会把配置永久保存到用户级环境变量，重启后也不会丢失。

powershell

[Environment]::SetEnvironmentVariable("MAOMAOTOKEN_API_KEY","你的 MaoMaoToken API Key","User")

设置后关闭 PowerShell，重新打开一个新窗口，再验证：

powershell

echo $env:MAOMAOTOKEN_API_KEY

macOS Zsh

macOS 默认使用 Zsh，可以把环境变量写入 ~/.zshrc。

bash

{
echo ''
echo '# MaoMaoToken'
echo 'export MAOMAOTOKEN_API_KEY="你的 MaoMaoToken API Key"'
} >> ~/.zshrc
source ~/.zshrc

验证：

bash

echo "$MAOMAOTOKEN_API_KEY"

Linux Bash / Zsh

不确定自己使用哪个 Shell 时，先运行：

bash

echo $SHELL

Bash 用户

bash

{
echo ''
echo '# MaoMaoToken'
echo 'export MAOMAOTOKEN_API_KEY="你的 MaoMaoToken API Key"'
} >> ~/.bashrc
source ~/.bashrc

Zsh 用户

bash

{
echo ''
echo '# MaoMaoToken'
echo 'export MAOMAOTOKEN_API_KEY="你的 MaoMaoToken API Key"'
} >> ~/.zshrc
source ~/.zshrc

DANGER

必须把 你的 MaoMaoToken API Key 替换为自己的真实 API Key，否则 Codex CLI 无法正常调用模型。

启动 Codex CLI

进入你的项目目录，启动交互式会话：

bash

codex

首次在某个项目目录运行时，Codex CLI 可能会询问是否信任该目录。确认后即可开始使用。

后续需要替换的图片

TODO：替换为终端运行 codex 后进入交互式会话的截图，注意隐藏 API Key、用户名和项目路径中的敏感信息。

常用操作

切换模型

在会话中输入：

txt

/model

也可以在启动时通过 -m 指定模型：

bash

codex -m gpt-5.3-codex

调整审批模式

Codex CLI 在编辑文件或执行命令前，通常会根据审批模式决定是否请求确认。

会话中可以输入：

txt

/approvals

启动时也可以指定审批策略：

bash

codex --ask-for-approval on-request
codex --ask-for-approval never

WARNING

never 会减少确认步骤，更适合受控环境或自动化任务。普通用户刚开始使用时，建议先保持默认或使用 on-request。

脚本化运行

用 exec 子命令把一次性任务交给 Codex CLI，适合脚本或 CI：

bash

codex exec "为 main.go 中的 ParseConfig 补充单元测试"

图像输入

可以附带截图或设计稿，让 Codex CLI 结合图片理解需求：

bash

codex -i screenshot.png "按这张设计稿实现登录页"

联网搜索

需要获取最新信息时，可以启用 Web 搜索：

bash

codex --search

接入 MCP 工具

可以在 config.toml 中通过 [mcp_servers.*] 注册 MCP 服务。MCP 配置可以和 MaoMaoToken 供应商配置共存。

示例：

toml

[mcp_servers.chrome-devtools]
command = "npx"
args = ["chrome-devtools-mcp@latest"]

常见问题

npm install -g 提示权限错误

不要优先使用：

bash

sudo npm install -g @openai/codex

更推荐使用 nvm 管理 Node.js，或修改 npm 全局目录：

bash

npm config set prefix ~/.npm-global

然后将 ~/.npm-global/bin 加入 PATH。macOS 用户也可以通过 Homebrew 安装 Node.js 或直接用 Homebrew 安装 Codex CLI。

启动后仍要求登录 OpenAI 账号

可以按下面顺序检查：

config.toml 中是否写了 model_provider = "maomaotoken"
[model_providers.maomaotoken] 是否存在
env_key 是否为 MAOMAOTOKEN_API_KEY
系统环境变量 MAOMAOTOKEN_API_KEY 是否已经设置
设置环境变量后是否重新打开了终端

配置了自定义供应商后，Codex CLI 会使用对应 API Key 调用 MaoMaoToken，不需要再走 ChatGPT 登录。

报错 404 或模型不存在

优先检查三项：

base_url 是否为 https://api.maomaotoken.com/v1
model 是否填写了账号可用的模型名
API Key 是否使用了建议的 auto 分组令牌

TIP

Codex CLI 的 base_url 必须带 /v1。如果写成 https://api.maomaotoken.com，很可能会出现接口路径不匹配。

wire_api 报错

默认推荐：

toml

wire_api = "responses"

如果当前网关兼容性异常，可以尝试改为：

toml

wire_api = "chat"

改完后重新启动 Codex CLI。

环境变量未生效

Windows 中通过 SetEnvironmentVariable(...,"User") 设置后，需要重新打开终端。仍然不显示时，可以尝试注销 Windows 或重启。

macOS / Linux 中执行：

bash

source ~/.zshrc
# 或
source ~/.bashrc

再验证：

bash

echo "$MAOMAOTOKEN_API_KEY"

API 调用失败或余额不足

可以按下面顺序检查：

API Key 是否复制完整，前后不要多空格
MaoMaoToken 控制台中账户余额是否充足
API Key 分组是否正确，建议使用 auto 分组
当前网络是否能访问 MaoMaoToken API

网络检查命令：

bash

curl -I https://api.maomaotoken.com

远程服务器连接超时

Linux 服务器可以先检查外网访问：

bash

curl -I https://api.maomaotoken.com

如果当前网络需要代理，可以配置 HTTPS_PROXY 环境变量后重试。

Codex CLI 配置指南 ​

准备工作 ​

安装步骤 ​

1. 安装 Node.js ​

2. 安装 Codex CLI ​

配置文件位置 ​

获取 API Key ​

写入 config.toml ​

设置 API Key 环境变量 ​

Windows PowerShell ​

macOS Zsh ​

Linux Bash / Zsh ​

Bash 用户 ​

Zsh 用户 ​

启动 Codex CLI ​

常用操作 ​

切换模型 ​

调整审批模式 ​

脚本化运行 ​

图像输入 ​

联网搜索 ​

接入 MCP 工具 ​

常见问题 ​

npm install -g 提示权限错误 ​

启动后仍要求登录 OpenAI 账号 ​

报错 404 或模型不存在 ​

wire_api 报错 ​

环境变量未生效 ​

API 调用失败或余额不足 ​

远程服务器连接超时 ​

Codex CLI 配置指南

准备工作

安装步骤

1. 安装 Node.js

2. 安装 Codex CLI

配置文件位置

获取 API Key

写入 config.toml

设置 API Key 环境变量

Windows PowerShell

macOS Zsh

Linux Bash / Zsh

Bash 用户

Zsh 用户

启动 Codex CLI

常用操作

切换模型

调整审批模式

脚本化运行

图像输入

联网搜索

接入 MCP 工具

常见问题

npm install -g 提示权限错误

启动后仍要求登录 OpenAI 账号

报错 404 或模型不存在

wire_api 报错

环境变量未生效

API 调用失败或余额不足

远程服务器连接超时