Codex IDE Commands：命令面板和快捷键速查

适用场景

这篇手册适合已经安装 Codex IDE Extension 的用户。你会学到如何从命令面板调用 Codex、如何把文件或选区加入线程、如何给常用命令绑定快捷键。

如果你经常在编辑器里切换鼠标、复制文件路径、粘贴代码片段，IDE Commands 可以明显减少上下文搬运。

步骤 1：打开命令面板

在 VS Code 类编辑器中，打开命令面板：

• macOS：Cmd+Shift+P
• Windows/Linux：Ctrl+Shift+P

输入 Codex，查看扩展提供的命令。命令列表可能随扩展版本变化，正式名称以当前编辑器显示为准。

步骤 2：打开 Codex 侧边栏

常用入口是打开 Codex sidebar。这样你可以在不离开编辑器的情况下查看线程、输入任务、确认审批和检查结果。

适合这样使用：

请根据当前文件解释这个组件的数据流，先不要改代码。

如果 Codex 需要更多上下文，再把相关文件或选区加入线程。

步骤 3：把选区加入当前线程

选中一段代码后，通过命令面板运行“Add selected text range as context”一类命令。官方命令 ID 中包含 chatgpt.addToThread。

适合场景：

• 只想让 Codex 看一个函数。
• 让 Codex 解释一段复杂逻辑。
• 针对当前选区生成测试。
• 让 Codex 修复一个局部 TODO。

比起把整份文件交给 Codex，选区上下文更轻，也更容易让任务保持聚焦。

步骤 4：把整个文件加入线程

如果问题跨越整个文件，例如组件状态、路由导出、配置文件结构，可以使用“Add file to thread”一类命令。官方命令 ID 中包含 chatgpt.addFileToThread。

添加后可以这样问：

请阅读这个文件，找出导致移动端布局溢出的最可能原因，并给出最小修改方案。

先让 Codex 解释判断，再让它修改，会更容易审查。

步骤 5：用命令处理 TODO

官方命令列表中包含处理选中 TODO 的入口。使用方法通常是：

1. 在代码里选中 TODO 注释或相关代码。
2. 从命令面板运行 Codex 的 TODO 实现命令。
3. 在 Codex 面板里补充约束，例如“不改公共 API”“必须补测试”。
4. 审查 diff 和验证结果。

这类命令适合小而明确的开发任务。

步骤 6：绑定快捷键

如果你频繁使用某个命令：

1. 打开命令面板。
2. 运行 Keyboard Shortcuts。
3. 搜索 Codex 或具体命令 ID。
4. 点击编辑图标。
5. 输入你想要的快捷键。

建议只给高频动作绑定快捷键，例如新建线程、打开侧边栏、加入选区。不要给高风险动作设置容易误触的组合键。

常见错误

不要把整个仓库都当成默认上下文。IDE Extension 的优势是贴近当前编辑位置，应优先给最相关的文件或选区。

不要在同一个线程里混入太多不相关选区。上下文越杂，Codex 越难判断你的真实目标。

不要把 IDE Commands 和 CLI 命令混为一谈。前者是编辑器扩展命令，后者是终端里的 codex 命令。

小结

Codex IDE Commands 的核心价值是减少上下文搬运。熟练使用命令面板、选区加入、文件加入、新建线程和快捷键之后，你可以把 Codex 当作编辑器里的协作开发者，而不是另一个需要手动复制粘贴的聊天窗口。