主题
01-04 · Codex CLI
Codex CLI 是 OpenAI 官方推出的、与 Claude Code 类似的终端 AI 编码助手，背后是 GPT-5-Codex 等 OpenAI 模型。它和 Claude Code 不是替代关系而是互补关系：复杂 Bug 排查我们更倾向 Codex（推理深），日常快速产出我们更倾向 Claude Code（速度快、上下文理解好）。
公司没有强制要求每个人都用，按你自己的节奏选用即可。
一、Claude Code vs. Codex 适配场景
| 场景 | 推荐 |
|---|---|
| 日常功能开发、写脚手架、读懂大型代码库 | Claude Code |
| 难定位的并发 / 边界 Bug | Codex（推理深） |
| 数学 / 算法题 / 性能优化 | Codex |
| 大批量重构、跨文件修改 | Claude Code |
| 写文档 / 写测试 | 两者都行，看心情 |
公司常用的"组合拳"：
日常开发 → Claude Code
↓
遇到查不动的 Bug → 切到 Codex
↓
细节修补 → 继续 Codex二、安装
2.1 前置依赖
- Node.js 18+（同 Claude Code）
2.2 全局安装
bash
npm install -g @openai/codex验证：
bash
codex --version2.3 国内特别注意
- Codex 调用的是 OpenAI API，必须开 Clash Verge + 美/日节点（参考 01-魔法环境-ClashVerge.md）。
- 直接用 ChatGPT Plus / Pro 订阅登录可以省 API 费用。
三、登录
bash
codex login会弹浏览器，两种方式二选一：
- 用 ChatGPT Plus / Pro 订阅登录（推荐，无 Token 焦虑）
- 粘贴 OpenAI API Key（按用量计费）
公司方案：默认走 ChatGPT 订阅。需要 API Key 找团队 Lead。
四、最小可用流程
bash
mkdir hello-codex && cd hello-codex
codex
# 进入交互界面后输入：
# > 写一个 nodejs 的 express hello world，跑在 3000 端口
# 它会列出计划 → 写文件 → 询问执行
# 退出： /exit五、关键参数
模型与推理深度
bash
# 默认模型
codex
# 显式指定模型（gpt-5、gpt-5-codex 等）
codex -m gpt-5-codex
# 调高推理强度（更慢更准）
codex -m gpt-5-codex -c model_reasoning_effort="high"
# 一次性非交互执行
codex -p "找出当前目录的内存泄漏点"配置文件
~/.codex/config.toml：
toml
# 默认模型
model = "gpt-5-codex"
# 默认推理深度
[model_reasoning]
effort = "medium" # low / medium / high六、把 Codex 作为 MCP 接到 Claude Code
这是公司里很多人在用的 "双 AI 协同" 玩法：在 Claude Code 里调用 Codex 处理硬骨头。
bash
# 给 Claude Code 注册一个 codex MCP
claude mcp add codex -s user -- codex -m gpt-5-codex -c model_reasoning_effort="high" mcp
# 进入 claude 后查看
# > /mcp
# 应该能看到 codex 这一项之后在 Claude Code 里可以直接说：
"这个 bug 我已经定位到 X 函数，请用 codex 工具深度分析。"
七、CC Switch —— 统一管理多 CLI
如果你同时装了 Claude Code、Codex CLI、Gemini CLI，强烈推荐：
- 仓库：https://github.com/farion1231/cc-switch
- 提供 GUI / CLI 一键切换不同账号、不同模型来源。
- 入职后你大概率会同时配两套以上账号，早装早省事。
八、参考资料
✅ 至此，你的开发环境已就绪：
- 网络层：Clash Verge
- IDE：Windsurf + 星火插件
- 终端 AI：Claude Code CLI（必装）+ Codex CLI（可选）
继续 → 02 · 核心方法论