Codex IDE Overview：在编辑器侧边栏使用 Codex

适用场景

Codex IDE Extension 适合你正在编辑代码时使用。它能看到编辑器里的文件、选区、标签和项目上下文，因此很适合短 prompt、局部修改、解释当前代码和从 IDE 启动 cloud task。

如果你主要工作在 VS Code、Cursor、Windsurf 或 JetBrains IDE 中，这通常是最自然的 Codex 入口。

安装入口

官方文档说明，Codex IDE extension 可从 Visual Studio Code Marketplace 获取，也支持 VS Code forks，例如 Cursor 和 Windsurf。JetBrains 用户可以安装 JetBrains IDE integration。

安装后你应该能在编辑器侧边栏看到 Codex 图标。VS Code 中 Codex 默认在右侧边栏打开。

如果没有看到：

1. 重启编辑器。
2. 检查扩展是否启用。
3. 在命令面板搜索 Codex。
4. 在 Cursor 里检查 activity bar 是否横向显示导致图标被折叠。

Windows 环境选择

官方文档说明，Windows 用户可以原生运行 Codex 并使用 Windows sandbox；如果需要 Linux-native 环境，也可以使用 WSL2。

选择建议：

• 项目主要在 Windows 工具链上运行：使用原生 Windows。
• 项目依赖 Linux shell、路径、包管理器：使用 WSL2。
• 团队 CI 是 Linux：优先让本地环境尽量接近 CI。

第一次使用路线

安装后建议这样开始：

请根据当前打开的文件解释这个模块的作用，先不要修改代码。

然后选中一个函数或 TODO，再让 Codex 做小范围任务：

请只修改选中的函数，补充参数为空时的处理逻辑，并说明是否需要新增测试。

IDE Extension 的优势是精确上下文，所以不要一上来给整个仓库。

什么时候从 IDE 切到其他入口

• 要管理多个并行任务：切到 Codex App。
• 要脚本化任务或 CI：切到 CLI。
• 要把任务交给远端环境：使用 IDE 的 Run in the cloud 或 Codex Web。
• 要操作浏览器或桌面应用：使用 Codex App 的相关能力。

常见错误

不要只复制粘贴代码片段给 Codex。IDE Extension 可以直接把文件和选区作为上下文，应该利用这一点。

不要忽略侧边栏位置。Cursor 等编辑器的 activity bar 设置可能让 Codex 图标不明显。

不要混淆 IDE command 和 slash command。前者来自编辑器命令面板，后者来自 Codex 对话。

小结

Codex IDE Extension 的核心价值是“贴着编辑器工作”。安装后先确认侧边栏入口，再用当前文件和选区做小任务；等任务变大时，再把它交给 cloud 或切到 Codex App 管理。