Codex 是 OpenAI 官方推出的开源编程助手，和 Claude Code 类似，它也是一个 Coding Agent，可以帮你编程写项目。

安装 Codex

如果你喜欢图形化的界面，可以看下一篇：CCSwitch傻瓜流安装。

如果你喜欢命令行界面，可以使用 Codex CLI，GitHub 开源地址是 openai/codex。安装前需要先装好 Node.js v22+，没装的话去 nodejs.org 下载。

安装 CLI 最推荐的方式是用 npm 全局安装，所有平台通用：

npm install -g @openai/codex

macOS 用户如果偏好 Homebrew，也可以用：

brew install --cask codex

装完验证：

codex --version

能打印出版本号就算装好了。

配置中转站

默认情况下 Codex 会引导你登录 ChatGPT 账号，如果你能注册并订阅 ChatGPT 会员的话直接登录即可。

但是大部分中国用户可能无法注册和订阅 ChatGPT 账号，可以用中转站来实用 Codex。

中转站的原理就是一个代理，有它来解决支付和网络的问题，帮你把请求转发到 OpenAI 官方接口，方便国内用户使用。

创建配置目录

根据操作系统切换对应命令：

Windows CMD

if not exist "%USERPROFILE%\.codex" mkdir "%USERPROFILE%\.codex"

Windows PowerShell

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex" | Out-Null

写入 config.toml

用你顺手的编辑器打开 ~/.codex/config.toml（Windows 上是 C:\Users\<你的用户名>\.codex\config.toml），把下面这段写进去。如果文件里已经有别的内容，确保这段放在文件顶部：

model_provider = "aicode007"
model = "gpt-5.5"
model_reasoning_effort = "high"
model_verbosity = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true

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

写入 auth.json

打开 ~/.codex/auth.json（Windows 上是 C:\Users\<你的用户名>\.codex\auth.json），把内容整体替换成下面这段，再把 sk-your-api-key 换成你刚才复制的 apikey 秘钥：

{
  "OPENAI_API_KEY": "sk-your-api-key"
}

验证配置

在任意 git 仓库目录下运行 codex 启动交互式会话，然后输入 /status 查看配置状态。配置成功时 Model provider 应该显示为 aicode007 - https://api.aicode007.com：

如果 Model provider 显示不对，说明 config.toml 没生效，检查一下文件路径和文件顶部的 model_provider = "aicode007" 是否正确。

如果一切正常，就可以和 Codex 愉快地对话了，可以跟它发一句 Hello 看看模型是否能正常响应。

常用命令

进入 Codex 之后，有几个命令值得记一下。

/model 查看和切换当前使用的模型，同时可以调整推理强度（reasoning effort）。强度越高效果越好，但速度更慢、token 消耗更多，根据任务复杂度决定。

/clear 清除终端并开始新对话。不同任务之间建议用 /clear 重开，旧的上下文堆着没用，反而干扰效果。

/exit 退出 Codex，重新进入后使用 /resume 命令可以选择历史会话进行恢复，继续之前的工作。

上下文快满时，Codex 会自动压缩，你也可以用 /compact 手动触发。

在输入框里用 @ 可以引用具体文件，让 Codex 重点关注某个文件的内容。

在交互式对话中输入 /plan 可以切换到 plan 模式：Codex 会先探索项目，问你一些澄清问题，输出计划文档等你确认，你确认没问题之后才开始写代码实现。

简单任务直接说需求就行，但复杂任务，建议用 plan 模式，比如「重构这个模块的 API 设计」，先对齐思路再动手，效果好得多。

默认情况下，Codex 执行文件修改或 shell 命令时都会请求确认，频繁操作时比较烦。可以在启动时添加参数完全跳过所有授权，去掉所有限制：

# 全自动模式，在沙箱内运行（文件写入限制在工作目录）
codex --full-auto

# 完全跳过所有授权，去掉所有沙箱限制
codex --dangerously-bypass-approvals-and-sandbox