在 Warp 里配置 Codex CLI：从安装到上手

这是一份把 OpenAI 开源编码代理 Codex CLI 装进 Warp 终端的实操指南，从安装、登录、跑第一个会话到写配置文件，大约 5 分钟能跑通。文中还给了权限模式、项目约定文件和几个提效技巧，适合想快速把 AI 编码代理接入日常工作流的人。

准备条件与安装

• 需要一个能访问 Codex 的 ChatGPT 账号（付费套餐自带额度），或者改用 OpenAI API key。
• 环境要求 Node.js 18 以上（走 npm）或 macOS 上的 Homebrew；系统支持 macOS 和 Linux，Windows 属于实验性支持，建议放进 WSL 工作区使用。
• npm 全局安装命令是 npm install -g @openai/codex，macOS 也可以用 brew install codex，装完用 codex --version 验证。
• 也可以直接从 GitHub releases 下载对应平台的二进制包。

登录与第一个会话

• 首次运行 codex 后选择 Sign in with ChatGPT，用 ChatGPT 账号登录，额度算在套餐内；CI/CD 或自动化场景可以改为设置 OPENAI_API_KEY 环境变量。
• 进入项目目录再启动 codex，会打开一个交互式终端会话。
• 可以先让它做低风险任务，比如解释项目结构，再让它动手改代码，例如给数据库连接模块加错误处理。
• Codex 会先读相关文件、提出改动方案，修改前要你确认，改动以 diff 形式呈现，可以逐条接受或拒绝。

模型与权限模式

• 会话内用 /model 命令切换可用模型。
• 三种审批模式：Auto 是默认值，允许在工作目录内读写和执行命令，超出范围会先询问；Read-only 只做咨询式回答；Full Access 放开更大自主权，包括网络访问。
• 用 /permissions 随时切换模式，按自己的信任程度逐步放开。

用配置文件固化项目约定

• 在项目根目录建 codex.md 或 AGENTS.md，写清技术栈和编码规范，Codex 每次会话开始都会读取并遵守。
• 示例内容包括：后端 Node.js + Express + TypeScript，数据库 PostgreSQL 配 Prisma，单测用 Vitest、端到端用 Playwright。
• 规范可以写得很具体，比如只用 ESM 导入不用 require()、所有 API 端点必须做 Zod 输入校验、提交前跑 npm test。
• 想让 Warp 在 Codex 需要你时发通知，可在 ~/.codex/config.toml 的 [tui] 下加 notification_condition = "always" 并重启 Codex；没配置时 Warp 会在终端显示设置提示。

提效技巧

• 用语音口述复杂指令，Warp 的语音转写对任何 CLI 代理都可用。
• 把 bug 截图、设计稿或报错信息直接粘进提示词，让 Codex 看到你看到的内容。
• 改动后用 Warp 的 Code Review 面板（⌘+Shift++）看可视化 diff，可以留行内评论再发回给 Codex 修正。
• 用垂直标签让 Claude Code 和 Codex 并行处理同一任务，对比两者方案取长补短。
• 按 Ctrl+G 打开 Warp 的富文本输入编辑器，比在裸 CLI 里敲长提示舒服得多。

今天就能做

• 今天就用 npm install -g @openai/codex 装好，进一个自己的项目跑 codex，先让它解释项目结构熟悉交互。
• 在项目根目录写一份 AGENTS.md，把技术栈、导入规范、校验要求和测试命令写进去，让后续每次会话自动遵守。
• 先用默认 Auto 模式，等熟悉后再考虑 Full Access；改动一律在 diff 视图里逐条确认。