Codex 使用指南
Codex 是 OpenAI 官方的终端编码代理。它适合在本地仓库中完成问答、编辑、执行命令和逐步协作，也支持通过 ChatGPT 账号直接登录使用。
适合谁
- 已经在使用 ChatGPT / OpenAI 生态
- 习惯终端工作流
- 希望把 AI 直接带进当前代码仓库，而不是在网页里来回切换
官方系统要求
结合 OpenAI 官方仓库与产品说明，实际使用前建议满足：
- macOS 12+
- Ubuntu 20.04+ / Debian 10+
- Windows 11，推荐通过 WSL 2
- Node.js 22+
- 4 GB 以上内存，8 GB 更稳妥
安装
macOS
方案 A：npm
bash
npm install -g @openai/codex方案 B：Homebrew
bash
brew install --cask codexLinux
方案 A：npm
bash
npm install -g @openai/codex方案 B：下载官方 Release 二进制
如果你不想依赖 Node，全量二进制包通常更适合服务器或受控环境。
Windows
OpenAI 对 Windows 的推荐方向依旧是 WSL 2。
方案 A：在 WSL 中安装
bash
npm install -g @openai/codex方案 B：通过官方 Release 下载对应平台二进制
如果你已经在 Windows 本地维护固定环境，也可以直接使用官方发布的可执行文件。
安装后检查
bash
codex --version
codex --help接入 Flash API
Codex CLI 支持通过 ~/.codex/config.toml 和 auth.json 使用自定义 provider。这也是把它接到 Flash API 最稳的方式之一。
你需要准备
- 已安装 Codex CLI
- 一个可用的 Flash API Key
- 如果后台区分令牌组，优先创建 Codex / GPT 对应的 Key
Flash API 地址
text
https://ai.flashapi.top/v1配置目录
macOS / Linux
bash
mkdir -p ~/.codexWindows
cmd
mkdir %USERPROFILE%\.codex写入 config.toml
toml
model_provider = "flashapi"
model = "gpt-5.2-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
approval_policy = "on-request"
web_search = "live"
sandbox_mode = "danger-full-access"
[model_providers.flashapi]
name = "flashapi"
base_url = "https://ai.flashapi.top/v1"
wire_api = "responses"
requires_openai_auth = true写入 auth.json
json
{
"OPENAI_API_KEY": "你的Flash API Key"
}启动
bash
cd /path/to/project
codex如果你配置正确，Codex 后续请求会走 flashapi 这个 provider，而不是默认的 OpenAI 登录路径。
首次使用
进入项目目录后直接运行：
bash
cd /path/to/your/project
codex启动后通常有两条主路径：
- 使用 ChatGPT 账号登录
- 使用 OpenAI API Key
如果你本来就是 ChatGPT Plus / Pro / Team / Enterprise 用户，直接登录往往是最省事的方式。
常见使用方式
交互模式
bash
codex适合边看边改、逐步补充约束。
单次提问
bash
codex exec "Explain the architecture of this repository"适合做快速分析、脚本调用或自动化。
在仓库里协作
text
先阅读当前仓库，告诉我认证模块、数据库层和 HTTP 路由分别在哪。
不要修改任何文件。确认理解没偏之后，再继续：
text
只修改登录超时逻辑，并运行项目已有测试。
如果测试失败，先解释原因，不要自己跳过。macOS / Windows / Linux 的差异建议
macOS
- 本地交互体验通常最好。
- 如果你本来就使用 Homebrew，维护升级会更简单。
Windows
- 推荐 WSL 2，尤其是涉及 shell、脚本、权限和路径映射时。
- 如果你要让 Codex 修改真实项目文件，尽量把仓库放在 WSL 文件系统内，而不是 Windows 与 WSL 混合路径。
Linux
- 适合长期命令行开发和服务器环境。
- 如果是受限环境，可以优先考虑 Release 二进制而不是全局 npm。
可选：用 CC-Switch 管理 Codex 配置
如果你不想手改 config.toml 和 auth.json，也可以用 CC-Switch 维护 Codex 的 Flash API 配置。对应字段通常是：
Base URL：https://ai.flashapi.top/v1API Key：你的 Flash API KeyModel：如gpt-5.2-codex
实用建议
先让它解释，再让它修改
先确认它对仓库结构的理解，再授权改动，通常比一上来就让它大改更稳。
把边界写清楚
例如：
text
不要新增依赖。
不要改 public API。
只允许修改 tests/ 和 src/auth/ 下的文件。保留测试命令
如果仓库已有 AGENTS.md、README.md 或测试说明，尽量写清楚。Codex 对这类显式约束利用得比较好。
常见问题
codex 启动后还是要求 OpenAI 登录
优先检查：
~/.codex/config.toml是否真的存在model_provider是否写成了flashapiauth.json里是否有OPENAI_API_KEY- 终端里是否还有其它旧环境变量干扰
官方链接
- OpenAI 仓库：https://github.com/openai/codex
- OpenAI 产品说明：https://openai.com/index/introducing-codex/