Codex 配置教程

Codex 是 OpenAI 推出的代码 Agent，适合代码仓库分析、修改、测试、文档整理和代码审查。通过 FlyMux 可以把 Codex 接入统一的 OpenAI 兼容接口。

前置检查

• 已安装 Node.js 与 npm，Windows 用户建议同时安装 Git for Windows
• 当前网络可以访问 https://api.flymux.com
• 已在 FlyMux 控制台创建 API Key

检查命令：

macOS / Linux

node -v
npm -v
curl -I https://api.flymux.com

Windows

node -v
npm -v
curl.exe -I https://api.flymux.com

安装 Codex

根据你的使用习惯选择安装方式：

客户端	平台	安装方式
CLI	Windows / macOS / Linux	npm install -g @openai/codex
桌面 App	macOS Apple Silicon	官网安装包或 brew install --cask codex
VSCode 扩展	Windows / macOS / Linux	在扩展市场搜索 Codex

安装后验证：

codex --version

先测试 API Key

使用 OpenAI 兼容接口地址：

curl https://api.flymux.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

成功时会返回模型列表。失败时通常会返回 INVALID_API_KEY、401 Unauthorized 或网络连接错误。

手动配置

Codex 配置目录通常位于用户目录下的 .codex 文件夹。

macOS / Linux

mkdir -p ~/.codex
touch ~/.codex/config.toml
touch ~/.codex/auth.json

Windows

mkdir $env:USERPROFILE\.codex -Force
New-Item -Path "$env:USERPROFILE\.codex\config.toml" -ItemType File -Force
New-Item -Path "$env:USERPROFILE\.codex\auth.json" -ItemType File -Force

config.toml

写入 ~/.codex/config.toml，Windows 路径为 %USERPROFILE%\.codex\config.toml。

macOS / Linux

model_provider = "flymux"
model = "gpt-5.4"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
model_verbosity = "high"

[model_providers.flymux]
name = "flymux"
base_url = "https://api.flymux.com/v1"
wire_api = "responses"
requires_openai_auth = true

Windows

model_provider = "flymux"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.flymux]
name = "flymux"
base_url = "https://api.flymux.com/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json

写入 ~/.codex/auth.json，Windows 路径为 %USERPROFILE%\.codex\auth.json。

{
  "OPENAI_API_KEY": "sk-你的API密钥"
}

WARNING

不要把 auth.json 或包含 API Key 的配置文件提交到版本控制。

启动使用

进入需要 Codex 操作的项目目录后运行：

cd /path/to/project
codex

可以先从小任务开始：

帮我介绍一下这个项目的结构和主要模块

先不要改代码，帮我找出这个仓库的启动方式和构建命令

检查一下这个项目里最值得优先修复的 3 个问题

常用命令

命令	说明
/model	切换当前模型，部分模型下可调整推理强度
/permissions	调整当前会话的审批和权限策略
/review	对当前工作区改动做代码审查
/resume	从历史会话列表恢复之前的对话
/new	在当前 CLI 会话中开启新对话
/init	在当前目录生成 AGENTS.md 模板
/compact	压缩当前对话以释放上下文
/undo	撤销 Codex 的上一次操作
/diff	查看当前 Git diff，包括未跟踪文件
/mention	将指定文件或目录加入对话上下文
/status	查看会话配置和 token 使用情况
/mcp	列出当前可用的 MCP 工具
/exit	退出 Codex CLI

使用建议

• 任务描述越具体，结果越稳定。明确技术栈、文件范围、验收标准和是否允许改代码。
• 大任务建议先让 Codex 分析方案，再继续执行。
• 每个会话尽量只处理一组相关问题，完成后用 /new 开新会话。
• 把项目规范写进 AGENTS.md，让新会话自动加载协作约束。

常见问题

连接失败或请求超时

先确认本机网络能访问 FlyMux API：

macOS / Linux

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

Windows

curl.exe -I https://api.flymux.com

如果网络正常，再检查 ~/.codex/config.toml 中的 base_url 是否为 https://api.flymux.com/v1。

401 Unauthorized

检查两项：

• ~/.codex/auth.json 中的 API Key 是否完整
• 当前 API Key 是否在 FlyMux 控制台中仍然有效

Windows 终端乱码

按 Win + R 输入 intl.cpl，在“管理”中打开“更改系统区域设置”，勾选“使用 Unicode UTF-8 提供全球语言支持”，保存后重启电脑。

如何配置全局提示词

在项目根目录创建 AGENTS.md，写入项目规范、常用命令、禁止事项和验收要求。也可以在 Codex 会话中运行 /init 自动生成模板。

如何减少上下文浪费

Codex 支持 /compact 压缩上下文，但压缩后可能丢失细节。建议控制单次任务范围，完成一个模块后及时开启新会话。

替代配置方式

如果你不想手动编辑配置文件，可使用 CC-Switch 配置工具 管理 Codex、Claude Code 等客户端配置。