Codex 安装与多模型切换

预计阅读 12 分钟

Codex 安装与多模型切换#

5 分钟跑通 Codex，理解它跟 Claude Code 的差异化价值。

0. 为什么用 Codex（而不是只用 Claude Code）#

Claude Code 和 Codex 不是替代，是互补。我自己同时跑两个，原因：

维度	Claude Code	Codex
模型	Claude 系列	GPT-5 系列（gpt-5.x / gpt-5.x-codex / o3 / o4 等）
长上下文	1M context（Sonnet/Opus 4.6+）	截至本节官方未公开统一上限，按模型而定
风格偏向	稳重、TS/React 友好	推理更强、Python/Rust 优秀
工具生态	MCP / Skills / Hooks 原生	MCP / Plugin / app-server / Sandbox / Review subcommand
价格	订阅制	ChatGPT 订阅或 API key

实战中我同时跑两个的场景：

Claude Code 写主代码 → Codex review 二次校验：互相挑错，单 Agent 翻车率明显下降
Claude Code 处理大代码库 / 长文档 → Codex 跑深推理（算法 / 安全审计 / 数学）
长跑无人值守 → 两边都开 sandbox + 自动批准，把 4 台机器吃满

1. 三平台安装（实测）#

macOS（推荐 brew）#

bash

brew install --cask codex

或走 npm：

bash

npm i -g @openai/codex

最新版本以 npm view @openai/codex version 为准（version 经常更新）。

Linux / WSL#

bash

# 装 Node 20+
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
npm i -g @openai/codex

WSL / SSH 等无浏览器环境登录走 --device-auth，见下节。

Windows native#

官方支持 winget / scoop 安装，命令请看 openai.com/codex 最新仓库 README。Windows 下避开带空格的目录（C:\Users\Your Name\... 这种），有概率让 Codex 路径解析失败。

2. 登录方式#

bash

codex login            # 进入交互式登录管理菜单
codex login status     # 查看当前登录状态

A. ChatGPT 订阅登录（OAuth，推荐）#

codex login 默认会弹浏览器走 OAuth。订阅 ChatGPT Plus / Pro / Team / Enterprise 的话，按订阅 quota 用，不消耗 API 余额。

B. 设备授权流程（SSH / WSL / 服务器）#

无浏览器环境用：

bash

codex login --device-auth
# 终端给一个 URL + 一次性 code，到任意能上网的设备打开输入

C. API key 登录#

bash

printenv OPENAI_API_KEY | codex login --with-api-key
# 从 stdin 读 key（避免出现在 history）

适合按 token 计费、要精细成本控制的场景。

坑：订阅 quota 和 API quota 完全独立。订阅打满要等月度刷新；API 超量直接收费。同一台机器只能登一种。

3. 模型切换（CLI + config）#

命令行单次指定#

bash

codex -m gpt-5.5
codex -m o3-mini

-m / --model 接模型 ID。具体当前可用的 ID 跟订阅档位 / API key 权限有关，跑 codex 进入交互后按 /model 看真实可选清单（最稳的方式）。

配置默认模型（持久化）#

编辑 ~/.codex/config.toml，最简单的写法是顶层字段：

toml

model = "gpt-5.5"
model_reasoning_effort = "xhigh"
service_tier = "fast"

坑：很多老教程写 [default] section 包起来——实测当前 codex（v0.124+）用顶层字段就行，不需要也不要 [default]。

Profile 多组配置切换#

toml

# ~/.codex/config.toml

model = "gpt-5.5"   # 默认

[profiles.review]
model = "o3-mini"
model_reasoning_effort = "xhigh"

[profiles.long-doc]
model = "gpt-4.1"

然后：

bash

codex --profile review
codex -p long-doc       # -p 简写

别名快捷启动（zsh / bash）#

bash

# ~/.zshrc 或 ~/.bashrc
alias cx='codex'
alias cxr='codex --profile review'    # 跑 review 默认参
alias cxl='codex --profile long-doc'  # 跑长文档默认参

4. Sandbox + 批准模式（自动化必学）#

实测可选值：

bash

codex -s read-only           # 默认；只读
codex -s workspace-write     # 写当前工作目录、禁网（推荐日常）
codex -s danger-full-access  # 完整系统 + 网络（长跑 / 自动化）

批准策略：

bash

codex -a untrusted    # 只白名单命令免确认
codex -a on-request   # 模型决定何时问
codex -a never        # 永不问（自动化）
codex -s workspace-write -a never  # workspace-write sandbox + 自动批准
codex --dangerously-bypass-approvals-and-sandbox  # 完全跳过（仅在外部隔离环境用）

坑：--dangerously-bypass-approvals-and-sandbox 比 Claude Code 的 --dangerously-skip-permissions 更激进——它同时关 sandbox。只在容器 / 隔离 VM 里用。

5. Codex 真正强的几个 subcommand#

bash

codex exec "<prompt>"         # 非交互模式（脚本 / cron 用）
codex review                  # 一键 code review（自动跑当前仓库）
codex resume                  # 续接最近会话
codex resume --last "继续"    # 续接 + 直接发新 prompt
codex mcp                     # 管理 MCP server（list / add / remove）
codex plugin                  # 管理 plugin（list / enable / install）
codex sandbox <cmd>           # 在 codex sandbox 里跑任意命令（验证 sandbox 行为）
codex apply                   # 把 Codex 上次产出的 diff git apply

codex review 是 Vincent 自己最常用的——Claude Code 写完代码，一行 cxr 让 Codex 第二意见，发现 typo / 逻辑漏洞 / spec 不一致。

6. Codex vs Claude Code 任务分工（我的实战分配）#

任务	推荐
TS / React / 前端	Claude Code
Python / Rust / 算法	Codex
大代码库整体重构（>200K context）	Claude Code（Opus 1M）
数学证明 / 复杂推理	Codex（o3 / o4 系列）
Code review / fact-check	Codex `review`
长跑 / 整夜自跑	Claude Code (`--dangerously-skip-permissions`) 或 Codex (`-s workspace-write -a never`)
ChatGPT 订阅打通	Codex
Anthropic 订阅打通	Claude Code

主写用 Claude Code、关键节点 Codex 复核——这是单人开发最稳的双 Agent 配置。

7. 你将学到#

5 分钟跑通 Codex（含无浏览器环境）
理解 Codex 跟 Claude Code 的差异化价值
多模型 + profile 切换的工程化写法
sandbox + approval 的全部档位
双 Agent 互补使用模式

适合谁#

已经在用 Claude Code，想加一个互补 Agent
想理解 OpenAI Codex 跟 ChatGPT 订阅的关系
准备搭多 Agent 协作系统的工程师

本节体验如何？

Codex 安装与多模型切换

预计阅读 12 分钟

Codex 安装与多模型切换#

5 分钟跑通 Codex，理解它跟 Claude Code 的差异化价值。

0. 为什么用 Codex（而不是只用 Claude Code）#

Claude Code 和 Codex 不是替代，是互补。我自己同时跑两个，原因：

维度	Claude Code	Codex
模型	Claude 系列	GPT-5 系列（gpt-5.x / gpt-5.x-codex / o3 / o4 等）
长上下文	1M context（Sonnet/Opus 4.6+）	截至本节官方未公开统一上限，按模型而定
风格偏向	稳重、TS/React 友好	推理更强、Python/Rust 优秀
工具生态	MCP / Skills / Hooks 原生	MCP / Plugin / app-server / Sandbox / Review subcommand
价格	订阅制	ChatGPT 订阅或 API key

实战中我同时跑两个的场景：

Claude Code 写主代码 → Codex review 二次校验：互相挑错，单 Agent 翻车率明显下降
Claude Code 处理大代码库 / 长文档 → Codex 跑深推理（算法 / 安全审计 / 数学）
长跑无人值守 → 两边都开 sandbox + 自动批准，把 4 台机器吃满

1. 三平台安装（实测）#

macOS（推荐 brew）#

bash

brew install --cask codex

或走 npm：

bash

npm i -g @openai/codex

最新版本以 npm view @openai/codex version 为准（version 经常更新）。

Linux / WSL#

bash

# 装 Node 20+
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
npm i -g @openai/codex

WSL / SSH 等无浏览器环境登录走 --device-auth，见下节。

Windows native#

2. 登录方式#

bash

codex login            # 进入交互式登录管理菜单
codex login status     # 查看当前登录状态

A. ChatGPT 订阅登录（OAuth，推荐）#

codex login 默认会弹浏览器走 OAuth。订阅 ChatGPT Plus / Pro / Team / Enterprise 的话，按订阅 quota 用，不消耗 API 余额。

B. 设备授权流程（SSH / WSL / 服务器）#

无浏览器环境用：

bash

codex login --device-auth
# 终端给一个 URL + 一次性 code，到任意能上网的设备打开输入

C. API key 登录#

bash

printenv OPENAI_API_KEY | codex login --with-api-key
# 从 stdin 读 key（避免出现在 history）

适合按 token 计费、要精细成本控制的场景。

坑：订阅 quota 和 API quota 完全独立。订阅打满要等月度刷新；API 超量直接收费。同一台机器只能登一种。

3. 模型切换（CLI + config）#

命令行单次指定#

bash

codex -m gpt-5.5
codex -m o3-mini

-m / --model 接模型 ID。具体当前可用的 ID 跟订阅档位 / API key 权限有关，跑 codex 进入交互后按 /model 看真实可选清单（最稳的方式）。

配置默认模型（持久化）#

编辑 ~/.codex/config.toml，最简单的写法是顶层字段：

toml

model = "gpt-5.5"
model_reasoning_effort = "xhigh"
service_tier = "fast"

坑：很多老教程写 [default] section 包起来——实测当前 codex（v0.124+）用顶层字段就行，不需要也不要 [default]。

Profile 多组配置切换#

toml

# ~/.codex/config.toml

model = "gpt-5.5"   # 默认

[profiles.review]
model = "o3-mini"
model_reasoning_effort = "xhigh"

[profiles.long-doc]
model = "gpt-4.1"

然后：

bash

codex --profile review
codex -p long-doc       # -p 简写

别名快捷启动（zsh / bash）#

bash

# ~/.zshrc 或 ~/.bashrc
alias cx='codex'
alias cxr='codex --profile review'    # 跑 review 默认参
alias cxl='codex --profile long-doc'  # 跑长文档默认参

4. Sandbox + 批准模式（自动化必学）#

实测可选值：

bash

codex -s read-only           # 默认；只读
codex -s workspace-write     # 写当前工作目录、禁网（推荐日常）
codex -s danger-full-access  # 完整系统 + 网络（长跑 / 自动化）

批准策略：

bash

codex -a untrusted    # 只白名单命令免确认
codex -a on-request   # 模型决定何时问
codex -a never        # 永不问（自动化）
codex -s workspace-write -a never  # workspace-write sandbox + 自动批准
codex --dangerously-bypass-approvals-and-sandbox  # 完全跳过（仅在外部隔离环境用）

坑：--dangerously-bypass-approvals-and-sandbox 比 Claude Code 的 --dangerously-skip-permissions 更激进——它同时关 sandbox。只在容器 / 隔离 VM 里用。

5. Codex 真正强的几个 subcommand#

bash

codex exec "<prompt>"         # 非交互模式（脚本 / cron 用）
codex review                  # 一键 code review（自动跑当前仓库）
codex resume                  # 续接最近会话
codex resume --last "继续"    # 续接 + 直接发新 prompt
codex mcp                     # 管理 MCP server（list / add / remove）
codex plugin                  # 管理 plugin（list / enable / install）
codex sandbox <cmd>           # 在 codex sandbox 里跑任意命令（验证 sandbox 行为）
codex apply                   # 把 Codex 上次产出的 diff git apply

codex review 是 Vincent 自己最常用的——Claude Code 写完代码，一行 cxr 让 Codex 第二意见，发现 typo / 逻辑漏洞 / spec 不一致。

6. Codex vs Claude Code 任务分工（我的实战分配）#

任务	推荐
TS / React / 前端	Claude Code
Python / Rust / 算法	Codex
大代码库整体重构（>200K context）	Claude Code（Opus 1M）
数学证明 / 复杂推理	Codex（o3 / o4 系列）
Code review / fact-check	Codex `review`
长跑 / 整夜自跑	Claude Code (`--dangerously-skip-permissions`) 或 Codex (`-s workspace-write -a never`)
ChatGPT 订阅打通	Codex
Anthropic 订阅打通	Claude Code

主写用 Claude Code、关键节点 Codex 复核——这是单人开发最稳的双 Agent 配置。

7. 你将学到#

5 分钟跑通 Codex（含无浏览器环境）
理解 Codex 跟 Claude Code 的差异化价值
多模型 + profile 切换的工程化写法
sandbox + approval 的全部档位
双 Agent 互补使用模式

适合谁#

已经在用 Claude Code，想加一个互补 Agent
想理解 OpenAI Codex 跟 ChatGPT 订阅的关系
准备搭多 Agent 协作系统的工程师