从入门到高阶的Codex终极使用实用技巧

Codex 作为 OpenAI 推出的强大编程助手，不仅能完成基础的代码生成和重构，更隐藏着许多能极大提升开发效率的高阶功能。下文会带你从基础配置出发，一步步解锁 Codex 的全部潜力，让你成为真正的 Codex 大师。

一、 基础配置：通往高阶之路的第一步

在探索高级技巧之前，确保你的 Codex 环境已经正确配置。无论是 IDE 插件还是 CLI 工具，一个稳定的基础是发挥其全部能力的前提。

CLI 环境安装

对于追求极致效率的开发者，CLI（命令行工具）是必不可少的。

环境要求：macOS 12+ / Ubuntu 20.04+ / Debian 10+，或 Windows 11 的 WSL2。强烈建议在类 Unix 环境下使用。

安装 Node.js：确保已安装 Node.js 18 或更高版本。

全局安装 Codex CLI：

npm install -g @openai/codex

登录授权：

# 使用 OpenAI 账户登录（会跳转浏览器授权）codex login# 或直接使用 API 密钥登录codex login --api-key "你的OpenAI-API密钥"

VS Code/Cursor 插件配置

安装插件：在 VS Code 或 Cursor 的插件市场搜索 Codex 并安装。

注意：0.5.9 及之后的版本有重大调整，如果无法适应，建议使用 0.5.8 或更早版本。

打开插件配置：

编辑 setting.json：点击 “在 setting.json 中编辑”，添加以下配置。这里以使用中转站为例：

{    // ... 其他配置    "chatgpt.apiBase": "https://code.claude-opus.top/openai", // 配置你自己的中转 API 地址    "chatgpt.config": {        "preferred_auth_method": "apikey",        "model": "gpt-5-codex",        "model_reasoning_effort": "high", // 默认开启高推理模式        "disable_response_storage": true,        "wire_api":"responses"    }}

配置 API Key：Codex 需要授权才能使用。推荐使用 API Key 方式。

在用户主目录下找到 ~/.codex/auth.json 文件（没有则新建），填入你的 Key：

{  "OPENAI_API_KEY": "sk-xxx...你的密钥"}

二、 性能拉满：解锁 Codex 的“狂暴模式”

这部分是高阶技巧的核心，我们将通过特定的命令和配置，让 Codex 发挥出 100% 的战斗力。

技巧 1：满血配置启动命令

忘记简单的 codex "..." 吧！使用下面这条 “满血命令”，直接将 Codex 的性能拉满：

codex -m gpt-5-codex -c model_reasoning_effort="high" -c model_reasoning_summary_format=experimental --search --dangerously-bypass-approvals-and-sandbox

这条命令的含金量在于：

1. -m gpt-5-codex：强制使用最强的 gpt-5-codex 模型，专为编程优化。
2. -c model_reasoning_effort="high"：将推理力度拉到最高，让它花更多时间深度思考复杂问题。
3. -c model_reasoning_summary_format=experimental：开启“解释模式”，每一步操作都会生成结构化总结，方便你审查它的思路。
4. --search：启用网页搜索工具，让 Codex 能联网查询最新资料。
5. --dangerously-bypass-approvals-and-sandbox：这是最刺激的狂暴模式！ 无需任何手动审批，直接在你的文件系统上执行读写操作。不完成任务誓不罢休！（请在绝对信任的环境下使用）

技巧 2：设置专属快捷方式（Alias）

每次都输入上面那串长命令太麻烦了。通过设置 alias（别名），你可以用一个简短的命令来触发满血模式。

将以下命令添加到你的 ~/.bashrc, ~/.zshrc 或其他 shell 配置文件中：

alias codex='codex -m gpt-5-codex -c model_reasoning_effort="high" -c model_reasoning_summary_format=experimental --search --dangerously-bypass-approvals-and-sandbox'

保存后，执行 source ~/.zshrc (或对应文件) 使其生效。现在，你只需在终端输入 codex，就是以满血配置启动了！

三、 高阶定制：让 Codex 成为你的专属专家

技巧 3：用AGENTS.md喂养项目专属知识

这是 Codex 最强大的功能之一。通过在项目中创建 AGENTS.md 文件，你可以为 Codex 提供关于该项目的 “长期记忆”和“行动指南”。

AGENTS.md 的作用类似于给 AI 看的 README，它会始终遵循文件中的规则。

1. 项目根目录 /AGENTS.md：定义整个项目的规范，团队共享。
2. 子目录 /AGENTS.md：针对特定模块的详细说明。
3. 全局 ~/.codex/AGENTS.md：定义你的个人全局偏好。

AGENTS.md 示例：

# AGENTS.md## 项目简介这是一个基于 Next.js + TypeScript 的电商后台管理系统。## 开发规范- **代码风格**：必须遵循 Prettier + ESLint 规范。- **命名规范**：所有组件和变量使用驼峰命名法。- **提交信息**：严格遵循 Conventional Commits 格式。## 常用命令- **启动开发环境**：`npm run dev`- **运行测试**：`npm test`- **构建生产包**：`npm run build`## 注意事项- **禁止**直接修改 `dist` 文件夹下的任何内容。- 开发新功能时，**必须**编写对应的单元测试。

技巧 4：深度定制config.toml配置文件

Codex 的所有全局配置都存放在 ~/.codex/config.toml 文件中。与 Claude Code 的 json 不同，Codex 使用 toml 格式，提供了更精细的控制。

常用配置项：

# 更换默认模型model = "gpt-4o"# 调整默认审批策略# 'untrusted' (默认): 运行不信任的命令前提示# 'never' (完全信任): 从不提示，自动执行# 'on-failure': 命令在沙箱中失败时，请求许可以非沙箱模式重试approval_policy = "untrusted"# 配置沙箱模式# 'read-only' | 'workspace-write' | 'danger-full-access'sandbox_mode = "workspace-write"# 设置 Profile (配置文件组)，为不同场景创建独立配置[profiles.safe_mode]model = "gpt-3.5-turbo"approval_policy = "untrusted"sandbox_mode = "read-only" # 只读沙箱

启动时可通过 codex --profile safe_mode "..." 来调用特定配置。

MCP 配置示例 (以 context7 为例):

[mcp_servers.Context7]command = "npx"args = ["-y", "@upstash/context7-mcp@latest"]

技巧 5：灵活的权限审批管理

在交互模式中，你可以随时通过 /approvals 命令来动态调整当前会话的权限级别。

1. 只读 (Read Only): 最安全，任何修改或执行操作都需要你手动批准。
2. 自动 (Auto): 默认模式，允许在工作区内自动修改和运行命令，访问外部资源时会请求批准。
3. 完全访问 (Full Access): 最高风险，拥有完全的磁盘和网络访问权限，没有任何提示。

四、 终极工作流：打造 Codex + Claude Code 编程搭子

尽管 Codex 功能强大，尤其在 后端逻辑、算法实现、项目重构 等方面表现出色，但 Claude Code 在 UI 构建、前端细节实现 上仍有优势。最强的开发者，会让它们协同工作。

核心差异对比

“左右互搏”协同工作流

这是一种通过交叉审核来确保代码质量的终极工作流：

1. 方案设计：由 Claude Code 快速生成初步方案和前端界面。
2. 方案评审：将方案交由 Codex 进行逻辑和架构层面的审核与“挑刺”。
3. 达成共识：将 Codex 的意见反馈给 Claude Code，进行多轮讨论，直至二者对方案达成一致。
4. 代码实现：由 Claude Code 根据最终方案编写具体代码。
5. 代码审查 (Code Review)：将生成的代码交由 Codex 进行审查。
6. 迭代修复：重复步骤 3-5，直至代码通过双方审核后提交。

五、 究极彩蛋：学习官方系统提示词

想知道 Codex 的“底层思想”吗？OpenAI 已经公开了它的系统提示词！通过学习它，你可以更好地理解其工作原理，从而写出更精准的指令。