Codex批注功能实测：选中代码定点修改高效技巧

Codex精准修改代码的关键在于批注功能。准备工作分三步：选定工作区、激活自动审查、关联项目。随后可通过IDE批注、浏览器标注或聊天框路径定位三种方式锁定修改范围。

让AI只改一小段逻辑却得到整个文件重写？理解错意图？避免这种失控的关键在于放弃纯聊天框对话，改用批注功能将修改指令精确绑定到具体行号和逻辑块。

批注模式启动前的核心准备工作

第一步：启动Codex桌面App，左侧导航栏点击「项目」，选中目标本地文件夹。警告：未选定工作区时，批注无法映射至真实文件路径，所有标注将失效。

第二步：将底部权限开关拨至「自动审查」模式。批注触发的修改属高风险操作，自动审查可逐一显示Codex拟修改的行、删除与新增内容，杜绝未经授权的函数体重写。

第三步：确保当前对话已关联工作区。右下角状态栏必须显示“✅ 已连接到 [你的文件夹名]”。若显示“未连接”，点击刷新图标重新载入上下文。

方法一：通过IDE批注（适用于VS Code插件）

安装并登录Codex VS Code扩展后，在编辑器中选中目标代码片段，右键点击「Add Codex Annotation」。

在弹出窗口中填写具体需求。例如：“将第42行的硬编码timeout值改为从config读取，保留原有默认值fallback”。忌讳使用“优化一下”“改得更好”等模糊措辞。批注越精确，Codex输出的Diff越干净。

点击「Send to Codex」，右侧面板立即展示AI理解的修改方案及Diff预览。核对无误后点「Apply」——此步骤不会绕过审查，仍需手动确认。

方法二：浏览器前端页面标注（支持实时预览）

第一步：点击Codex右侧工具栏「+」，选择「Browser」，输入本地开发服务URL（例如 http://localhost:3000/book-list）。

第二步：页面完全加载后，点击工具栏「Mark」按钮。鼠标悬停到目标DOM元素，出现蓝色边框时单击即创建锚点。

第三步：在弹出文本框中描述修改要点。例如：“搜索框应支持中文模糊匹配，目前仅响应英文首字母；需同步修改API调用参数为?q=xxx&fuzzy=true”。必须包含当前行为、预期行为和关键参数名，否则Codex可能仅修改前端而忽略接口层。

第四步：勾选「Include screenshot」，点击「Send」。Codex将自动截取屏幕并提取相关HTML/CSS/JS代码片段，生成包含上下文信息的修改建议。

方法三：聊天框内精准定位批注（适用于无GUI环境）

在对话框中输入文件路径和行号，例如：@src/components/BookSearch.tsx#L38-45，换行后写明需求：“此处filter逻辑应兼容null和undefined值，添加空值保护”。

Codex会自动解析路径和行号，锁定对应代码块。若文件不存在或行号超界，会明确报错，不会无依据猜测。

如需同时标注多个位置，用分号隔开：@file1.ts#L12 @file2.ts#L88-92。单次最多标注3个位置，超出部分需拆分为多轮请求。