Codex App 配置指南

Codex App 是 OpenAI 的桌面编码代理，适合在图形界面里管理项目、查看任务、和本地代码仓库协作。
本文只讲 Codex App 接入 MaoMaoToken 的 GPT 系列模型；如果你需要终端版，请参考 Codex CLI 配置指南。

本文示例模型统一使用 gpt-5.5。实际使用时，请以你账号中可用的模型为准。

后续需要替换的图片

TODO：替换为 Codex App 主界面截图，重点展示已打开项目和聊天输入区域。注意隐藏用户名、项目路径和任何 API Key。

TIP

Codex App、Codex CLI 和 IDE 插件会共享 Codex 配置层。用户级配置通常放在 ~/.codex/config.toml；Windows 原生模式下对应 %USERPROFILE%\.codex\config.toml。

准备工作

开始前先准备下面几项：

项目	说明
Codex App	OpenAI 的桌面端编码代理
MaoMaoToken API Key	建议使用 `auto` 分组的令牌
默认模型	本文示例使用 `gpt-5.5`
配置文件	`config.toml`

WARNING

不要把 API Key 写进公开仓库，也不要在截图中暴露完整令牌。

通用配置

后面的 macOS、Windows Native、Windows + WSL 都会用到同一段配置。把它写入对应环境里的 config.toml。

toml

model_provider = "maomaotoken"
model = "gpt-5.5"
model_reasoning_effort = "high"
model_verbosity = "medium"
approval_policy = "on-request"
sandbox_mode = "workspace-write"

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

配置含义：

配置项	说明
`model_provider`	默认使用下方定义的 MaoMaoToken Provider
`model`	默认调用的模型，本文示例为 `gpt-5.5`
`model_reasoning_effort`	推理强度，`high` 适合编码任务
`model_verbosity`	回复详细程度，`medium` 比较适合普通用户
`approval_policy`	审批策略，`on-request` 会在需要时请求确认
`sandbox_mode`	沙箱模式，`workspace-write` 允许在工作区内读写
`base_url`	MaoMaoToken OpenAI 兼容端点，Codex 这里需要带 `/v1`
`wire_api`	接口协议，推荐使用 `responses`
`requires_openai_auth`	使用自定义 API Key 时设为 `false`
`env_key`	从环境变量读取 API Key，不把密钥写进配置文件

TIP

Codex App 的 base_url 需要填写 https://api.maomaotoken.com/v1，注意末尾带 /v1。
这点和 Claude Code 的基础地址不同。

macOS 安装与配置

1. 安装 Codex App

打开官方 macOS 下载地址：

https://persistent.oaistatic.com/codex-app-prod/Codex.dmg

下载后双击 .dmg，按系统提示把 Codex 拖入 Applications。

2. 写入配置文件

打开终端，创建 Codex 配置目录：

bash

mkdir -p ~/.codex
open -a TextEdit ~/.codex/config.toml

把上面的“通用配置”粘贴进去并保存。

3. 设置 API Key

macOS 默认 Shell 通常是 Zsh，可以写入 ~/.zshrc：

bash

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

验证：

bash

echo "$MAOMAOTOKEN_API_KEY"

DANGER

必须把 你的 MaoMaoToken API Key 替换为控制台里复制的真实令牌。

4. 打开项目验证

启动 Codex App，选择一个代码目录，然后发送一个轻量任务：

txt

解释当前项目结构，并指出入口文件在哪里。

如果 Codex 能正常读取项目并回复，说明 macOS 侧已经接入 MaoMaoToken。

后续需要替换的图片

TODO：替换为 macOS Codex App 打开项目后的截图，重点展示项目目录和一次成功回复。注意隐藏敏感路径和 API Key。

Windows Native 安装与配置

Windows 默认使用 Windows Native Agent，命令在 PowerShell 环境执行，配置文件在 Windows 用户目录下。

后续需要替换的图片

TODO：替换为 Windows Codex App 主界面截图，重点展示 App 已启动。

1. 安装 Codex App

可以任选一种方式安装：

方式	命令或链接
Microsoft Store	Codex App
PowerShell	`winget install Codex -s msstore`

PowerShell 安装命令：

powershell

winget install Codex -s msstore

2. 写入配置文件

用 PowerShell 创建并打开配置文件：

powershell

New-Item -ItemType Directory -Force "$HOME\.codex"
notepad "$HOME\.codex\config.toml"

把“通用配置”粘贴进去并保存。

实际路径通常类似：

txt

C:\Users\你的用户名\.codex\config.toml

3. 设置 API Key

推荐写入 Windows 用户级环境变量：

powershell

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

关闭 Codex App 和 PowerShell，重新打开后验证：

powershell

echo $env:MAOMAOTOKEN_API_KEY

4. 打开项目验证

启动 Codex App，添加项目目录后发送：

txt

执行 git status，并解释当前工作区状态。

如果 PowerShell 执行策略阻止脚本运行，可以在 PowerShell 中执行：

powershell

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

如果 Git 功能不可用，先安装原生 Git：

powershell

winget install Git.Git

Windows + WSL 配置

如果你的项目主要在 Linux 工具链里开发，可以把 Codex Agent 切到 WSL。

后续需要替换的图片

TODO：替换为 Codex App 设置中切换 Agent 到 WSL 的截图，重点标注 Agent 选项。

1. 切换 Agent

在 Codex App 中打开 Settings，把 Agent 从 Windows Native 切换到 WSL，然后重启 App。这个设置通常需要重启后才会生效。

2. 写入 WSL 内配置

切到 WSL 终端后创建配置：

bash

mkdir -p ~/.codex
nano ~/.codex/config.toml

把“通用配置”写入 WSL 内的 ~/.codex/config.toml。

3. 设置 WSL 内 API Key

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

验证：

bash

echo "$MAOMAOTOKEN_API_KEY"

WARNING

Windows Native 和 WSL 是两个环境。Agent 跑在 WSL 时，要改 WSL 里的 ~/.codex/config.toml，也要在 WSL 里设置 MAOMAOTOKEN_API_KEY。

常用 App 设置

默认打开编辑器

可以在设置里选择默认 Open In 编辑器，例如 VS Code 或 Visual Studio。

后续需要替换的图片

TODO：替换为 Codex App 设置默认编辑器的截图，重点标注 Open In 或编辑器选择项。

集成终端

Windows 下集成终端可以选择 PowerShell、Command Prompt、Git Bash 或 WSL。
这个设置和 Agent 运行环境是两件事：你可以让 Agent 跑 WSL，同时集成终端仍使用 PowerShell。

后续需要替换的图片

TODO：替换为 Codex App 设置集成终端的截图，重点标注 Terminal 选项。

修改终端后通常只对新会话生效，必要时重启 Codex App。

常见问题

启动后仍要求登录 OpenAI

确认当前环境的 config.toml 已写入：

toml

model_provider = "maomaotoken"

同时确认 MAOMAOTOKEN_API_KEY 能在同一个环境里读取到。使用 MaoMaoToken Provider 时，Codex 会用环境变量里的 API Key 调用 MaoMaoToken，不需要把密钥写入配置文件。

404 或模型不存在

检查三项：

base_url 必须是 https://api.maomaotoken.com/v1
model 必须是你账号可用的模型，例如 gpt-5.5
API Key 建议使用 auto 分组令牌

Windows 和 WSL 配置不一致

先看 Agent 跑在哪个环境：

Agent 环境	配置文件	API Key 设置位置
Windows Native	`%USERPROFILE%\.codex\config.toml`	Windows 用户环境变量
WSL	WSL 内 `~/.codex/config.toml`	WSL Shell 环境变量

想重置为更保守的权限

保持下面配置即可：

toml

approval_policy = "on-request"
sandbox_mode = "workspace-write"

这会让 Codex 在需要越过沙箱或执行敏感操作时先询问。

API 调用失败或余额不足

可以按下面顺序检查：

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

网络检查命令：

bash

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

Codex App 配置指南 ​

准备工作 ​

通用配置 ​

macOS 安装与配置 ​

1. 安装 Codex App ​

2. 写入配置文件 ​

3. 设置 API Key ​

4. 打开项目验证 ​

Windows Native 安装与配置 ​

1. 安装 Codex App ​

2. 写入配置文件 ​

3. 设置 API Key ​

4. 打开项目验证 ​

Windows + WSL 配置 ​

1. 切换 Agent ​

2. 写入 WSL 内配置 ​

3. 设置 WSL 内 API Key ​

常用 App 设置 ​

默认打开编辑器 ​

集成终端 ​

常见问题 ​

启动后仍要求登录 OpenAI ​

404 或模型不存在 ​

Windows 和 WSL 配置不一致 ​

想重置为更保守的权限 ​

API 调用失败或余额不足 ​

Codex App 配置指南

准备工作

通用配置

macOS 安装与配置

1. 安装 Codex App

2. 写入配置文件

3. 设置 API Key

4. 打开项目验证

Windows Native 安装与配置

1. 安装 Codex App

2. 写入配置文件

3. 设置 API Key

4. 打开项目验证

Windows + WSL 配置

1. 切换 Agent

2. 写入 WSL 内配置

3. 设置 WSL 内 API Key

常用 App 设置

默认打开编辑器

集成终端

常见问题

启动后仍要求登录 OpenAI

404 或模型不存在

Windows 和 WSL 配置不一致

想重置为更保守的权限

API 调用失败或余额不足