先看一个挺常见的场景你拿到了一个能写代码的 AI 工具比如 Codex特别开心开口就是“帮我写个用户登录接口”。十分钟后代码出来了字段是空的安全校验没有连 token 怎么刷新都没提。你追问它它又改改完这边不对那边崩。问题出在哪不是 Codex 笨而是你给的需求不够格。需求一句话AI 只能给你返回一段符合这句话的代码但它猜不到你脑子里还有十句没说出来的话。这篇文章要聊的就是一个非常实用的组合用开源工具 Grill Me 先让 AI 反过来“审问”你把你的模糊想法一层层问透直到需求规格完全清晰再把这份带约束、带边界、带验收标准的规格扔给 Codex让它动手写代码。整个流程是我们实际用了两周、跑了五六个项目之后最顺手的一种协作方式尤其适合给 AI 编程工具当“需求分析员”用的场景。不管你是刚开始用 Codex 的新手还是已经在用 AI 编程但总觉得返工率高的人这套流程都能直接抄走。1. 先想清楚为什么“先拷问需求”比“让 AI 写码”更重要1.1 AI 写代码的本质是“把规格翻译成实现”很多人对 AI 编程工具有个误解觉得它是“需求理解者”你说个大概它就能领会精神。实际上大模型再聪明它的本质也是一台超级翻译机你把需求写成自然语言放在上下文集里它把这些文字翻译成程序代码。翻译器的输出质量完全取决于输入文字的精度。这个逻辑可以拿装修来类比。你跟设计师说“我要温馨一点”设计师给你设计出来你可能想砸墙。但如果你说“我不要暖色调原木风电视墙要预留 100 寸投影的位置沙发旁边要一个带感应灯的双层边几”哪怕设计师水平一般做出来也差不到哪去。AI 写代码是一模一样的道理你说“做一个登录”它给你一个裸奔版登录你说清楚验证码策略、token 有效期、账号锁定规则、数据库表结构它给你的就是能直接上线的生产级代码。所以关键技能不是“怎么让 AI 写代码”而是“怎么把模糊变成清晰”。这部分工作Grill Me 就是专门来干这个的。1.2 需求模糊会带来哪些真金白银的浪费我自己踩过不少坑总结下来需求不明确导致的开销特别实在Token 费用翻倍第一次生成 1 万 token发现问题后重新沟通再生成 1 万 token折腾三轮就是 3 倍成本。上下文被污染Codex 改着改着前面错误版本的代码会干扰后面所有决定它可能在你旧代码的基础上继续缝补越补越乱。隐性 bug 大量堆积你没想到的边界情况AI 更想不到。比如签到接口没说“补签”规则它默认就是当天签当天没说并发控制用户狂点两下就领双倍积分。最贵的是时间看似省了编程时间结果全花在“和 AI 来回解释需求”和“验收 AI 做错的东西”上反而比手写还累。这个现象背后有个放大效应需求阶段的 1 块钱遗漏到了代码阶段要花 10 块钱去修补到了测试阶段可能要花 100 块。以前这个效应存在于人和程序员之间现在完整搬到了人和 AI 之间。1.3 Codex 负责干活Grill Me 负责捞需求——两者的分工Codex 是 OpenAI 出的编程智能体它的特点是不只能聊天还能直接读写你本地文件、执行测试命令、跑 Git本质上是“帮你在电脑上干活的助手”。它执行能力强但问题在于它默认你给的需求是完备的。Grill Me名字取得挺好grill 就是“拷问”的意思是一个开源命令行工具核心功能和名字一个样它会把一个 AI 模型变成“需求分析师”反过来不停向你提问。你先告诉它你在做什么、目标是什么然后它一个问题接一个问题地问一直问到你俩都认为需求足够清楚了为止。这两个工具合起来正好补完了 AI 编程的最后一环Grill Me 做需求侧帮你把抽象想法拆成具体规则、边界条件、技术约束。Codex 做实现侧拿到高质量需求规格后稳定地产出高质量代码。简单说让会提问的去提问让会写代码的去写代码互不越界。这套组合跑通之后我对 AI 编程的信任度明显上了一个台阶返工率从“基本每次都要改”降到了“大多数一次过”。2. 环境准备装好 Codex 和 Grill Me 这组搭档2.1 Codex CLI 安装、登录与常见开门问题Codex 目前主要提供 CLI 和 IDE 插件两种形态我建议先把 CLI 装好因为后面要配合自动化和批处理场景。以 macOS/Linux 为例最常规的安装方式就是走 npmnpm install -g openai/codex codex --version装完以后要登录授权跑一下codex login它会打开浏览器走 OAuth 授权授权成功后在终端就能直接调 Codex 了。这里我遇到过一个很普遍的问题“codex auth token is unavailable”这个报错基本就是登录态丢了或者没有正确写入本地配置。排查思路很简单重新执行一遍codex login如果还不行就检查你的~/.codex目录下的 auth 文件是否被清理过权限是不是变成 root 所有了我就碰到过因为用 sudo 安装导致配置目录权限混乱的情况。另外如果你想接的不是默认服务而是第三方 OpenAI 兼容接口比如 DeepSeek、国产大模型、企业内部网关可以在~/.codex/config.toml里配置自定义 provider大概是这样model deepseek-chat model_provider deepseek [model_providers.deepseek] name DeepSeek base_url https://api.deepseek.com/v1 env_key DEEPSEEK_API_KEY注意env_key对应的环境变量要提前设置好Codex 启动时会去读。这个配置我之前折腾了挺久最大的坑是 URL 结尾的/v1到底要不要带不同服务商要求不一样以你接的服务商文档为准。2.2 Codex 的两种工作形态命令行和 VS Code 插件CLI 形态下最常用的子命令是codex exec后面跟你要它干的事比如codex exec 根据 docs/需求.md 中的接口定义实现 user_service.go并补充单元测试它会在当前目录下读文件、改文件、跑命令全程自主干活。这个形态适合批量任务、CI 集成、或者你不想老是切窗口的时候用。VS Code 插件形态则适合交互式改代码。安装OpenAI Codex插件后在编辑器里选中一段代码右键就有“Ask Codex”的入口。它能直接读你当前打开的整个工程上下文你选中哪段它改哪段返回 diff 给你确认。插件形态的好处是“所见即所得”你随时可以打断它修正方向适合任务边界还不完全确定的时候用。我个人的习惯是任务清晰用 CLI任务模糊用插件。一旦需求规格已经定死就交给 CLI 全自动跑如果还在探索阶段就在插件里一边聊一边改。2.3 Grill Me安装方式和它到底怎么“拷问”你Grill Me 这个工具本身轻量得很本质是一个对话提问循环器。安装方式要看它当前的版本常见的是通过 Python 生态安装比如pip install grill-me或者用uv tool install也有 Docker 或直接 clone 仓库跑的简便方式。如果你拉到最新的 GitHub 仓库README 里一般会写清楚一条命令装好装完在终端里敲grill就能进入对话。第一次打开它你会看到一段提示语大意是告诉我你在做什么、你想得到什么以及你已经思考过哪些方案。然后它就开始问了。交互上有几个很实用的设计回车 让它继续问下一个问题输入skip 跳过当前问题输入done 告诉它别再问了我觉得够了输入reset 清空当前对话重来它背后接的是任意 OpenAI 兼容的大模型接口所以你也需要在环境变量里配一个 API KeyOPENAI_API_KEY或者你用第三方服务给的 key。Grill Me 本身不生产内容它只是把“追问”这个动作模板化真正提出好问题的其实是背后那个模型。有个细节要提醒Grill Me 问出来的问题质量取决于你开篇那段背景描述写得多细。你丢给它一句“我想做个签到系统”它问的问题就会很泛你丢给它“我想做一个积分签到后端接口给 App 端用后端是 Python FastAPI已经有一张 users 表了”它问的问题立刻专业很多。它就像个面试官你简历写得越实在追问越有针对性。2.4 网络/代理类报错的一般排查路径Codex 用得多了难免碰到各种连不上、请求失败的问题。最近我就看到有人报了一个很典型的错cc switch local proxy failed while handling codex endpoint /responses. provider ...大意是本地某个代理切换工具在拦截 Codex 的/responses接口请求时失败了。这种报错现场排查起来不复杂按层级走就行先判断是不是环境变量问题检查HTTP_PROXY、HTTPS_PROXY这些变量是不是被设置成了某个已经不在运行的本地代理地址。再查代理工具状态如果你用了一些系统级代理切换/抓包工具确认它是否在正常监听有没有把 codex 的请求域名加进被代理列表。最后做排除法临时清掉代理环境变量直接请求一次如果通了说明问题就在本地代理这一层而不是 Codex 本身的配置问题。这里没必要默认省事遇到类似报错先把 curl 手动请求一下目标 API 看通不通能帮你省掉大量“猜配置”的时间。3. 核心实战用 Grill Me 榨干需求再让 Codex 落地3.1 今天要做的案例一个用户签到积分接口讲理论太虚我拿一个真实写过的例子带大家走一遍全流程。项目背景是这样我们有个 App想做“每日签到得积分”的功能积分以后能换优惠券。最初需求就一句话“做一个签到接口用户每天能签一次签到得 5 个积分。”这句话如果直接丢给 Codex它能写出来但一定是灾难级代码没有防重复签到、没有积分流水表、没考虑时区、没做并发控制甚至连返回格式都是它自己瞎编的。所以我们先把它丢给 Grill Me 拷问。3.2 拷问实录Glrill Me 会追问哪些问题、为什么我把背景输入 Grill Me 后完整的问答大概长这样删掉了寒暄保留了和业务直接相关的核心对话我我想做一个积分签到功能。App 端每天可以签到一次签完给 5 个积分以后积分可以兑换优惠券。Grill Me积分是“签到一次加 5 分”这种余额制还是需要记录每一笔积分变动明细我需要明细用户要在积分记录页看到“签到 5”这种历史流水。Grill Me用户每天签到一次这里的“一天”是按自然日北京时间零点到零点算还是按用户注册时间算 24 小时一轮我按自然日北京时间零点重置。这个业务要求是运营定的。Grill Me如果用户连续签到要不要额外奖励比如 7 天连续多给 10 分我这版本先不做连续奖励就固定每天 5 分但表结构要预留连续签到天数的字段方便后面加。Grill Me用户如果今天已经签到过了App 端需要明确提示“已签到”那接口返回应该直接报错还是返回一个“今日已签到”的状态码让前端友好展示我返回业务状态码不要报网络错误。约定好code4001表示今日已签到。Grill Me同一个用户同一秒点两次签到会出现并发插入问题你希望后端怎么处理我用数据库唯一索引兜底配合先查后插索引字段是user_id 签到日期。Grill Me积分表需要冗余哪些用户信息还是只存 userId我只存 userId用户昵称头像这些实时查用户服务不冗余。Grill Me接口权限呢需要登录才能签还是匿名也能签我必须登录从网关传过来X-User-Id头后端 trusts 网关不再校验 token我们内部架构是这样。看到没有这些问题是 Codex 绝对不会主动问你的。它面对“每日签到”这段需求大概率直接给你一套自己的默认答案单表、无索引、无状态码约定、无并发策略。Grill Me 的价值不在于它能替你做决定而在于它把你本来必须自己拍板的业务规则全部翻出来摆到你面前逼你逐个确认。这个过程就是把隐性需求变成显性需求。3.3 把问答整理成 Codex 能直接执行的“需求规格说明书”拷问到了尾声我把所有答案整理成一份规格文档存成docs/checkin-requirement.md然后告诉 Grill Me 可以停了。这份文档就是 Project 唯一的主角。它写得好不好直接决定 Codex 输出质量高不高。我当时整理出来的核心内容大概是# 签到接口需求规格说明书 ## 业务背景 App 端每日签到得积分固定 5 分/天后续可能增加连续签到奖励。 ## 功能需求 1. GET /api/v1/checkin/today查询今日签到状态返回已签到/未签到。 2. POST /api/v1/checkin执行签到。 ## 业务规则 - 自然日维度北京时间 0 点重置使用 Asia/Shanghai 时区。 - 每个用户每天最多签到一次重复签到返回 HTTP 200 code4001。 - 签到成功后给用户积分账户 5并写入积分流水表。 - 用户身份从网关的 X-User-Id 头获取不信任前端传的 userId。 ## 数据表设计 - user_points(user_id, total_points, updated_at) - points_log(id, user_id, change_amount, reason, ref_id, created_at) - checkin_record(id, user_id, checkin_date, created_at) 唯一索引uk_user_date(user_id, checkin_date) ## 接口约定 - 统一响应格式{ code: 0, message: ok, data: {...} } - code4001 表示今日已签到data 里带 recent_streak 字段本期固定返回 1。 - 必须开启事务积分余额更新 积分流水 签到记录三张表同成功同失败。 ## 技术约束 - Python 3.11 FastAPI。 - SQLAlchemy 2.xPostgreSQL 15。 - 使用 Alembic 生成迁移脚本。 - 时间统一存储 UTC业务判断时转换成北京时间。这份文档几百个字但每个字都是有效信息。Codex 不需要“猜”不需要“假设”它要做的事情就是老老实实按规格翻译成代码。3.4 交给 Codex命令、改动过程和最终代码结构我当时的操作是把规格文档放进项目根目录然后直接跑codex exec 读取 docs/checkin-requirement.md按规格实现签到功能。先检查项目现有结构尽量复用已有用户服务和数据库配置。完成后运行测试确认接口通过。Codex 会先自己扫描项目结构读requirements 文档里的表设计和接口约定然后动手建模型、写路由、加迁移脚本、写测试。整个过程中它偶尔会停下来问问题比如发现项目里没有统一的响应格式封装时它会自己决定怎么解决并明确汇报“我在 utils/response.py 里新增了统一响应函数”。最后生成的目录结构大概是app/ api/v1/checkin.py # 两个接口的路由与逻辑 models/points.py # 积分账户和流水模型 models/checkin.py # 签到记录模型 core/resp.py # 统一响应封装 tests/ test_checkin.py # 正常签到、重复签到、并发签到测试 alembic/versions/xxx_add_checkin_tables.pyCodex 生成的checkin.py核心逻辑我到现在还记得它把“唯一索引兜底 先插后查”处理得很干净async def checkin(user_id: str): today datetime.now(ZoneInfo(Asia/Shanghai)).date() try: async with db.session() as session: # 核心唯一索引作为并发兜底 record CheckinRecord(user_iduser_id, checkin_datetoday) session.add(record) await session.flush() # 更新积分和流水 await add_points(session, user_id, 5, reasondaily_checkin, ref_idstr(record.id)) await session.commit() except IntegrityError: return {code: 4001, message: 今日已签到, data: {recent_streak: 1}} return {code: 0, message: ok, data: {recent_streak: 1}}看完这段代码我是有点惊喜的因为它在并发场景的处理完全符合我在需求里写的“唯一索引兜底”策略。如果当初我直接拿原始需求去生成它大概率写不出这个 IntegrityError 捕获因为在简短需求下模型没有动机去考虑并发场景。3.5 回看效果同样任务两种做法的差异为了验证流程价值我之后刻意拿同一个案例做了个对照把最原始的“做一个签到接口”直接丢给 Codex让它自由发挥。差异非常明显维度直接让 Codex 写先 Grill Me 拷问再让 Codex 写生成代码时间3 分钟8 分钟含拷问时间字段/表设计单表凑合三表完整并发重复签到没处理唯一索引兜底时区处理用本地时间未指定明确北京时间内部存 UTC返回格式随便定义按团队规范后续改动成本几乎所有字段都要重构直接可测几乎没改单看第一轮的速度直接写确实快但算上接下来两天里来回改 bug 的时间先拷问的方案整整省了两三个工作日。这就是我想表达的核心Grill Me 多花的那几分钟本质上是买 AI 编程返工险而且保费极低。4. Codex 上手必调模式、参数和提示词这三大件4.1 工作模式计划、全自动、对话到底怎么选Codex 干活的方式有好几档我用下来最重要的区分是下面三档计划模式PlanCodex 先不动文件只输出一套它打算怎么改的方案等你确认后它才真正动手。适合改动面大、牵一发动全身的重构任务。全自动模式Exec收到你的指令后直接改代码、跑命令全程自主执行直到任务完成。适合规格明确、改动范围清晰的实现任务。对话模式Chat/Interactive在终端里来回聊边聊边改。适合探索阶段比如你还没想清楚某个功能到底怎么设计。我的建议是在跑“Grill Me 拷问 Codex 实现”这套流程时默认用计划模式先跑一遍。尤其你的需求文档比较复杂时让 Codex 先把它的实现计划亮出来你扫一眼有没有理解偏差比让它闷头改完再让你 review 省事得多。4.2 参数和安全设置沙箱与审批模式别用默认值Codex 默认配置下权限比较大它能直接在你的文件系统里改文件。我觉得“能改”没问题但“审批”和“沙箱”要好好设置。--sandbox限制 Codex 的文件系统权限只允许它在指定目录下操作。我一般必开防止它把无关目录里的文件动了。--approval-mode有 on-request 等。我建议设置成on-request让 Codex 每次要执行 shell 命令或写文件前先征求你的同意。虽然有点烦但能在 Codex 跑飞时及时踩刹车。--skip-git-repo-check默认 Codex 会检查当前目录是不是 Git 仓库不是的话拒绝干活。不建议跳过因为 Git 仓库状态是唯一能救回误删代码的保命符。实操铁律在运行任何 Codex 全自动任务之前先确保工作区干净git status 没有未提交的大改动最好单独开一个分支给它折腾。我吃过一次亏让 Codex 改一个老项目它改动过程中把我的一个旧工具函数覆盖了幸好我先 commit 了一份不然那段逻辑真写不回来了。4.3 让 Codex 更听话的提示词公式试了无数种写法之后我总结出一个给 Codex 下任务的提示词公式效果非常稳定背景 任务 约束 验收标准示意背景这是一个 FastAPI PostgreSQL 的积分系统已有用户服务和统一响应封装。 任务读取 docs/checkin-requirement.md按规格实现签到功能。 约束 - 不修改现有用户服务的接口 - 使用项目既有的 SQLAlchemy 2.x 模式 - 时区统一用 ZoneInfo不要自己写固定 offset - 所有接口返回必须走 utils/response.py 中的统一格式 验收标准 - pytest tests/test_checkin.py 全部通过 - 并发签到测试覆盖用 IntegrityError 兜底重复请求这段话信息量大但结构清爽Codex 每条都能执行。“不修改现有接口”这种显式约束尤其重要因为大模型默认喜欢把涉及的代码都捎带手改一遍你不说它就会好心办坏事。5. 高发问题排查与独家避坑清单5.1 高频报错速查表这款组合用了这么长时间有些问题来回出现。我把遇到过的和身边朋友遇到过的整理成一个速查表直接按表排查效率最高。现象大概率原因怎么处理codex 命令找不到npm 全局目录没进 PATH重装或手动 export PATH检查npm root -gauth token is unavailable登录态失效、auth 文件被清重新codex login清理~/.codex/auth.json后重登local proxy failed / endpoint 请求失败本地代理切到错误节点、环境变量残留检查 HTTP_PROXY 环境变量临时清空做对照测试接入第三方模型报 401/404Base URL 路径不对或 Key 没配对核对 provider 文档确认/v1要还是不要、请求头如何传任务执行超时单次指令塞了太多任务拆任务一次最多做 5 个以内小目标Codex 改了不该改的文件没开沙箱、约束没写加--sandbox提示词里显式声明“不要改动哪些文件”测试跑不过但代码看着对时区/环境变量依赖差异用 docker 环境复现先补测试日志再定位5.2 几条来自实战的私房建议最后几条建议不是文档里能看到的完全是实际操作中换回来的教训拷问记录要存档。Grill Me 当前会话结束就没了但我每次都把问答内容复制进docs/requirements/目录存成 md。为什么因为以后这个功能迭代时你忘了当时为什么定“固定 5 分”看回拷问记录就能想起来。拷问记录就是你们团队的决策日志。一次只喂一个需求。有人喜欢把“签到积分商城优惠券核销”全塞给 Codex让它一次做完。我的经验是任务边界越大失败概率指数级上升拆成独立小迭代逐个做最后再拼接。让 Codex 补测试比让它补功能靠谱。代码写完后我习惯追加一句“把测试补全重点覆盖需求文档里提到的所有边界条件”。Codex 对“测试要覆盖文档条目”的理解比“请把代码写健壮点”要强得多因为文档条目是具体目标而“健壮”是抽象形容词。不要迷信模型越强越好。我在 Grill Me 上用的模型和 Codex 上的模型经常不是同一个。拷问阶段用一个反应快、便宜的模型就够生成阶段用能力更强的模型。省钱效果明显而且拷问质量并没有因此下降。开始前先让 Codex 复述需求。代码生成前加一句“先用三句话总结你对需求规格的理解我会确认后再动手”。这个步骤多花 20 秒能拦截掉至少一半的理解偏误。大部分翻车现场在让 AI 复述需求的那一刻就已经暴露了。我自己现在接新需求的第一反应已经不是“这代码怎么写”而是“这需求我能用三句话讲清楚吗讲不清楚就先开个 Grill Me”。这个习惯改变之后AI 编程对我的价值才真正发挥出来——它不是帮我省掉写代码的手指而是帮我把脑子里的糊涂账理清。如果你打算认真用 Codex 干活我建议你把这个流程原样跑三遍第三遍你会有自己的手感知道该往里加什么减什么。
