我跑通第一个 Codex 任务的全过程。还有踩的那些坑

装完 Codex 那天晚上，我挺兴奋的。打开终端，cd 进公司的正式项目。输入了一句现在想想都觉得鲁莽的话：

帮我重构一下使用者模块。

接下来我就看着它一口气改了十几个文件——登录、权限、接口、测试、前端页面全动了。改完之后它告诉我 “已完成”。我看着满屏的 diff完全不知道哪些是必要的改动，哪些是它的 “自由发挥”。

使用者痛点：大量未知改动导致审查成本爆炸，难以判断代码安全性。

那次体验给我最大的教训就是：第一天用 Codex。目标不应该是 “让它证明自己很强”，而是让自己理解它怎么读文件、怎么改文件、怎么展示 diff、怎么被你纠正。

我后来重新来了一次用一个只有几行代码的玩具项目。这篇文章就是那次完整过程的复盘。

从一个只有一行逻辑的文件开始

我先建了一个干净的目录：

mkdir hello-codex
cd hello-codex

接下来创建了一个 main.py内容就这几行：

def add:
return a + b

为什么选这么简单？因为只有这样，后面 Codex 改了什么我才能一眼看懂。 你看不懂的 diff，就不是你能审查的 diff。

紧接着做了一件到现在都觉得最关键的事——打一个 Git 检查点：

git init
git add -A
git commit -m "init: hello codex demo"

使用者痛点：没有提交记录，一旦出错只能手工回滚或直接丢失工作。

后来我才知道。没有这一步的话，Codex 改坏文件时你连回退的地方都没有。Git 检查点就是你和混乱之间最终那道防线。不过，

至于我的第一件事，让它只读。不让它动手

启动 Codex 之后我的第一条消息是：

请解释 main.py 这个文件在做什么用新手能听懂的话说。不要修改任何文件，

这一步看似多余，却验证了三件事：

• Codex 能正常启动；
• 它能读到当前目录的文件；
• 它理解的内容和我的是否一致。不过，

If it mis‑explains add。you should be alarmed – maybe you’re in wrong folder or project structure is too complex.

使用者痛点：工具在错误上下文中运行导致后续所有指令失效。

让它改一个很小的东西

确认它能正常读项目之后我才给了第一个修改任务：

• . 只修改 Main.py.
• . 不要新增第三方依赖.
• . 改完后告诉我具体改了哪几行.

This task satisfies three conditions: tiny scope,clear result。easy review.

The result looked roughly like this:

def add -> float:
if not isinstance) or not isinstance):
raise TypeError
return a + b

别只看它说什么要看它改了什么

This is a step many people skip. After Codex says “done”,it may also give a summary. The summary cannot replace git diff.

git diff

I n asked myself three questions:

1. The change only touches Main.py?
2. I can understand every new line?
3. No unexpected modifications slipped in?

If all answers are “yes”。iteration is considered successful.

使用者痛点：依赖工具提供文字摘要会误导审查，真实差异才是可信依据。

不满意？在同一个会话里纠正就好

I tried a scenario: I wasn’t happy with English error message. I simply said in same session:

刚才的错误提示用中文，而且不要改变函数名。请重新调整，其实，

The model continues based on existing context—no need to restart or re‑prompt from scratch. This conversational continuity is a huge usability win.

让它补个测试。接下来跑验证

The next step was to ask for a minimal test file:

请为 add 函数创建一个最小测试文件 test_main.py。从要求来看，. 使用 Python 标准库 unittest。. 覆盖正常相加和非数字报错两个场景。. 不要引入第三方测试框架。不过，

I ran:

python -m unittest

If tests pass。great. If y fail,I feed traceback back to Codex:

<粘贴报错>
请先解释原因，再做最小修复。This “modify → verify → fix” loop is where Codex shines.

改坏了怎么办？


If you have a Git checkpoint,just discard all uncommitted changes:
git restore . 


If stray files were added and you want m gone:
git clean -fd 



Please run 

You can even ask Codex for an explanation before executing:

请解释 git restore . 和 git clean -fd 会删除什么。不要输入命令，

。

---