Codex 入门：把 AI 编程助手用在真实项目里

Codex 是 OpenAI 面向软件开发场景的 AI 编程助手。和普通聊天工具不同，它更适合直接放进项目目录里使用：它可以读取代码结构、解释文件作用、修改代码、运行命令、检查构建结果，并把过程中的关键判断反馈给你。

我当前使用的是 Windows 命令行版，版本为 codex-cli 0.139.0。这篇文章会以这个版本的命令帮助信息为准，整理一套新手能直接上手的用法。

Codex 可以做什么

Codex 最适合处理和项目文件有关的任务，例如：

  1. 分析项目目录，说明每个文件或目录的作用。
  2. 修改配置文件、脚本、样式、Markdown 文章等内容。
  3. 根据报错信息定位问题，并尝试修复。
  4. 运行构建、测试、格式化命令，验证修改有没有破坏项目。
  5. 做代码审查，指出潜在 bug、风险和缺少的测试。
  6. 生成说明文档、博客文章、README 或操作步骤。

它不是只能回答问题的聊天机器人，更像是一个能在当前目录里工作的开发助手。

最基础的使用方式

进入项目目录后，直接运行：

1
codex

这会进入交互式模式。你可以像现在这样输入需求，例如：

1
分析这个目录下文件是干什么用的

也可以启动时直接带上任务：

1
codex "帮我检查这个 Hexo 博客有哪些基础配置需要补"

如果你不在项目目录里，也可以用 -C 指定工作目录：

1
codex -C F:\1Hexo\blog-demo "帮我分析这个博客项目"

常用命令

下面这些命令是我认为最值得先记住的：

1
codex --help

查看命令帮助。

1
codex --version

查看当前版本。

1
codex doctor

检查本机 Codex 的安装、配置、登录和运行环境。

1
codex login

管理登录状态。

1
codex resume

恢复之前的交互会话。

1
codex exec "运行构建并修复失败原因"

非交互式执行一次任务，适合比较明确的自动化需求。

1
codex review --uncommitted

审查当前未提交的改动，适合在提交代码前做一次检查。

权限和安全要注意

Codex 可以运行命令和修改文件，所以不要一上来就给无限权限。一般项目里建议先用默认的受限模式，让它在需要写入、联网或执行高风险操作时再请求确认。

常见的沙箱模式包括：

1
codex --sandbox read-only

只读模式，适合让它分析项目，不允许直接改文件。

1
codex --sandbox workspace-write

允许在工作目录内写入，适合真实开发任务。

1
codex --sandbox danger-full-access

高风险模式，通常不建议日常使用，除非你明确知道后果。

我的建议是：让 Codex 做事可以，但关键操作仍然要看清楚。比如删除文件、重置 Git、安装依赖、联网访问、部署网站，都应该确认之后再执行。

一个比较舒服的工作流

我现在更推荐这样使用 Codex：

  1. 先让它分析项目结构。
  2. 再说明你的目标，例如“修复样式问题”或“新增一篇文章”。
  3. 让它先做低风险修改。
  4. 修改后运行 npm run build、测试命令或预览命令。
  5. 最后看 git diff，确认改动是否符合预期。

以这个 Hexo 博客为例，一个任务可以这样描述：

1
帮我修复文章页标题颜色太浅的问题，然后新增一篇介绍 Codex 的文章，标签设为 AI学习，最后运行 npm run build 验证。

这样的描述比“帮我优化一下”更好，因为目标、范围、验证方式都比较清楚。

Codex 的好处

Codex 对新手尤其有帮助，因为它可以把很多隐性的工程步骤显性化。

第一，它能帮你读项目。刚接触 Hexo、React、Python 或其他项目时，最难的往往不是写代码，而是不知道文件分别负责什么。Codex 可以先把目录结构讲清楚。

第二，它能把修改和验证连起来。不是只给你一段代码，而是可以改完之后运行构建或测试，检查结果。

第三，它适合小步快跑。你可以让它一次只改一个问题，比如“只修导航栏”“只新增文章模板字段”“只改文章页标题颜色”。这样更容易检查，也更不容易把项目改乱。

第四，它能降低查资料的成本。很多命令、配置项、报错信息可以直接让它解释，再结合本地项目给出具体做法。

使用时应该避免什么

不要把 Codex 当成完全自动驾驶。它很适合做助手，但项目所有权仍然在你手里。

我会避免下面几种用法：

  1. 不看 diff 就直接部署。
  2. 一次让它大改很多不相关的地方。
  3. 让它删除文件或重置 Git，但自己不确认。
  4. 把账号、密钥、令牌直接发给它。
  5. 没有构建验证就认为修改完成。

好的使用方式是：让 Codex 提速，但自己保留最后判断。

小结

Codex 最适合承担“理解项目、执行修改、验证结果、解释原因”这一整条链路。对我这个刚开始搭博客的阶段来说，它可以帮助我更快熟悉 Hexo 的结构，也能把配置、样式、文章模板这些零散工作一步步整理好。

如果只是问概念，普通聊天工具也可以；但如果要真正改项目文件、跑命令、检查构建结果，Codex 会更合适。