Codex新手教程

如果你是第一次接触 Codex，不用担心，这篇教程就是按“新手第一次上手”来写的。

你不需要一开始就理解所有参数，也不需要先搞清楚所有模式。你只要先记住一句话：

✅ 先记这一句就够了

• 想先体验：用 codex
• 想让它在当前项目里自动干活：用 codex --full-auto
• 想完全放开权限：只在隔离环境里考虑 codex --yolo

🤖 Codex 是什么

你可以把 Codex 理解成一个“在终端里工作的 AI 编码助手”。

它不是一个单纯聊天的机器人，而是可以直接进入你的项目目录，帮你做这些事情：

• 📖 读代码，理解项目结构
• ✍️ 改代码，生成补丁
• ▶️ 跑命令、看报错、辅助排查问题
• 🔍 做代码审查
• 🌐 需要时查文档、查资料

简单说：它更像一个会在你项目里动手做事的助手。

💡 新手理解方式

如果你以前用过 AI 问代码问题，那么 Codex 可以理解为“聊天能力 + 终端执行能力 + 项目内改代码能力”的组合版。

🛠️ 最常用的 3 种启动方式

如果你现在最困惑的是：

我到底该用哪个命令启动？

那你直接看这一节就够了。

1. 💬 普通模式

codex

这是最适合新手的起点。

适合场景：

• 👀 先看一看 Codex 怎么工作
• 🧠 先分析项目，不急着改代码
• ✋ 想自己控制节奏

2. 🤖 自动模式

codex --full-auto

这是更适合日常开发的模式。

适合场景：

• ✅ 希望 Codex 在当前项目目录里自动处理任务
• ✅ 希望它自己读文件、改代码、跑命令
• ✅ 想在效率和安全之间取得平衡

如果你已经不是第一次用 Codex，这通常是更推荐的模式。

3. 🚨 全权限模式

codex --yolo

这个模式不是给大多数新手准备的。

适合场景：

• ⚠️ 你非常清楚风险
• ⚠️ 你正在容器、虚拟机、云端 IDE 等隔离环境中运行
• ⚠️ 你明确知道自己为什么需要跳过审批和限制

🚨 新手请谨慎使用

codex --yolo 会跳过审批，并允许更高权限执行。不要在有重要数据、生产配置、敏感凭证的本机环境中直接使用。

🧭 这些参数到底是什么意思

第一次看到这些参数时，很多人都会有点懵。没关系，你不需要一次全懂。

你只要先理解两个概念就行：

1. 📝 审批模式

审批模式决定：Codex 做一些操作前，要不要先问你。

常见取值包括：

• untrusted：更保守，很多操作都会先问你
• on-request：需要时再请求批准
• never：不再询问，直接执行

2. 📦 沙箱模式

沙箱模式决定：Codex 能访问和修改多大的范围。

常见取值包括：

• read-only：只读，不改文件
• workspace-write：只允许修改当前工作区
• danger-full-access：不受工作区限制，几乎等于完全放开

3. 🧪 为什么有些教程命令看起来很长

有些旧教程会写成这样：

codex --ask-for-approval never --sandbox danger-full-access

这条命令的意思其实就是：

• ❌ 不再请求审批
• ❌ 不再限制访问范围

所以它已经非常接近“高风险放开模式”了。

如果你只是想让 Codex 在当前项目里自动修代码，优先使用：

codex --full-auto

✅ 新手可以这样记

• 不懂就先用 codex
• 想提效就用 codex --full-auto
• 不熟悉风险就不要碰 danger-full-access

🪟 Windows 用户怎么用最省心

方案一：🐧 用 WSL2（最推荐）

如果你在 Windows 上开发，推荐优先用 WSL2。

原因很简单：

• ✅ 终端体验更稳定
• ✅ 和 Linux 工具链更一致
• ✅ Node、Git、脚本兼容性通常更好
• ✅ 更接近官方推荐的 CLI 使用方式

典型流程：

cd "/home/yourname/project"
codex

方案二：🖥️ 直接在 Windows Terminal / PowerShell 中使用

如果你的项目本身就在 Windows 路径下，也可以这样用：

cd "E:\Codex"
codex

这种方式更适合：

• 🟡 你只是先体验一下
• 🟡 项目不依赖复杂脚本链路
• 🟡 你暂时还没准备好 WSL 环境

方案三：☁️ 在云端或沙箱环境里运行

如果你准备使用高权限模式，例如 --yolo 或 danger-full-access，更推荐把项目放到隔离环境里，例如：

• ☁️ 容器环境
• ☁️ 虚拟机
• ☁️ 云端 IDE
• ☁️ 临时开发机

这样做不是为了“更酷”，而是为了“更安全”。

💡 实践建议

如果你打算让 Codex 高权限自动改代码，最好把仓库放在一个可以随时销毁、随时重建的环境中运行。

🧪 新手最常用的提问模板

如果你不知道该怎么开口，可以先直接复制下面这些提示词。

1. 🔍 先让它读懂项目

先阅读这个项目，告诉我：目录结构、技术栈、启动方式、核心模块，以及你建议我先看哪些文件。

2. 🧠 先分析，不改代码

先不要改代码。先帮我定位这个问题可能出现在哪几个文件，并给出排查思路。

3. 🗂️ 先给计划，再执行

先给出一个简短执行计划，等我确认后再开始修改代码。

4. 🛠️ 直接修复问题

请复现并修复首页白屏问题，修复后告诉我改了哪些文件、为什么这样改。

5. 👀 做代码审查

请审查当前改动，重点关注：边界条件、异常处理、安全风险、是否存在明显的重复逻辑。

🧩 新手说人话就行

你不需要把提示词写得特别“像程序员”。大多数时候，直接把你的目标说清楚，Codex 就能理解。

⌨️ 常用命令，先记这些就够了

继续上一次会话

codex resume --last

非交互执行一个任务

codex exec "修复 CI 失败，并输出修改摘要"

带图片一起分析

codex -i "/path/to/screenshot.png" "解释这个报错页面，并告诉我可能的修复方向"

开启联网搜索

codex --search

适合需要查阅最新资料、官方文档、依赖变更说明的场景。

⚡ 会话里的常用 Slash Commands

进入 Codex 交互界面后，你还可以使用一些 Slash Commands。

常见的有：

• /permissions：切换权限模式
• /model：切换模型或推理强度
• /review：对当前改动做代码审查
• /diff：查看当前会话产生的改动
• /clear：清空当前上下文
• /compact：压缩上下文，降低会话负担
• /mcp：查看或管理 MCP 服务

如果你不确定某个命令能做什么，直接在会话里输入 / 查看列表即可。

🛡️ 新手最该记住的安全建议

如果你不想踩坑，下面这些建议很重要：

• 🧾 尽量在 Git 仓库里使用，方便查看 diff 和回滚
• 🐣 第一次接触项目时，优先用普通模式或较保守权限
• 🚫 没有隔离环境时，不要直接使用 --yolo
• 🔐 不要在带有生产密钥、支付凭证、私有证书的目录里盲目放开权限
• 🧠 先让它分析，再让它执行，通常比“一上来全自动”更稳妥
• ⚠️ 涉及删除、批量改动、系统配置变更时，先确认影响范围

❓ 常见问题

1. 为什么我输入 codex 后，它没有立刻开始改代码？

因为 codex 本质上是交互式入口。你启动它之后，还需要告诉它你想做什么。

推荐流程是：

• 进入项目目录
• 告诉它当前目标
• 让它先分析，再决定是否修改代码

2. 我到底该用 codex、--full-auto 还是 --yolo？

可以直接这样判断：

• 想先体验、先聊天、先分析：用 codex
• 想让它在当前项目里自动工作：用 codex --full-auto
• 想完全放开，并且你有隔离环境：才考虑 codex --yolo

3. 为什么官方更推荐 WSL？

因为很多开发工具链、脚本、权限模型都更贴近 Linux 环境，WSL 对 CLI 工具通常会更稳定一些。

🔗 官方文档

如果你后面想继续深入了解，可以再看官方文档：

• Codex CLI 概览
• CLI Command Line Options
• Authentication
• Security and approvals
• Slash commands
• Windows 使用说明

✅ 最后送你一句建议

如果你只记住一句话，请记住这句：

第一次先用 codex，熟悉后再用 codex --full-auto；--yolo 只在你明确知道风险且身处隔离环境时使用。

这样你既能享受到 Codex 的效率，又不会因为权限开太大而踩坑。