OpenAI Codex IDE 扩展可以直接装进 VS Code、Cursor、Windsurf 和 JetBrains IDEs，在编辑器里使用编码代理读写代码、运行任务，并可把长任务交给 Codex Cloud。安装后若看不到面板，先重启 IDE；在 Cursor 里还可能需要把 activity bar 改成 vertical 才能把 Codex 拖到右侧边栏。
OpenAI Codex IDE 扩展安装与配置
Codex 是 OpenAI 的编码代理，可以读取、编辑和运行代码，帮助你更快编写代码、调试并修复问题、理解陌生代码库。通过 OpenAI Codex VS Code 扩展，你可以在 IDE 里并排使用 Codex，或把任务委托给 Codex Cloud。
ChatGPT Plus、Pro、Business、Edu 和 Enterprise 计划都包含 Codex。查看包含内容。
Extension setup
Codex IDE 扩展可用于 VS Code 及其 fork，例如 Cursor 和 Windsurf。
你可以从 Visual Studio Code Marketplace 获取 Codex 扩展，也可以按 IDE 直接安装：
- Download for Visual Studio Code
- Download for Cursor
- Download for Windsurf
- Download for Visual Studio Code Insiders
- Download for JetBrains IDEs
Codex IDE 集成支持 VS Code 兼容编辑器和 JetBrains IDEs，可在 macOS、Windows 和 Linux 上使用。Windows 上可以原生运行 Codex 的 Windows sandbox，也可以在需要 Linux 原生环境时使用 WSL2。安装细节见 Windows setup guide。
安装完成后，Codex 会出现在编辑器侧边栏。VS Code 里默认打开在右侧边栏。如果你在 VS Code 里没立刻看到它，重启编辑器。
如果你使用 Cursor，activity bar 默认是横向排列。被折叠的项目可能会把 Codex 隐藏起来，这时可以把它固定，并调整扩展顺序。
JetBrains IDE integration
如果你想在 Rider、IntelliJ、PyCharm 或 WebStorm 这类 JetBrains IDEs 里使用 Codex，安装 JetBrains IDE integration 即可。它支持用 ChatGPT 登录、API key 登录，或使用 JetBrains AI subscription。
Move Codex to the right sidebar
在 VS Code 里，Codex 会自动出现在右侧边栏。
如果你更想放到主侧边栏，也就是左侧，可以把 Codex 图标拖回左侧 activity bar。
在 Cursor 这类 VS Code fork 里，你可能需要手动把 Codex 移到右侧边栏。操作前通常要先临时改 activity bar 的方向：
- 打开编辑器设置，搜索
activity bar（在 Workbench settings 里）。 - 把方向改成
vertical。 - 重启编辑器。
然后把 Codex 图标拖到右侧边栏，比如拖到 Cursor chat 旁边。Codex 会作为侧边栏里的另一个 tab 显示。
移动完成后，把 activity bar 方向改回 horizontal，恢复默认行为。以后如果想改回去，随时都可以把 Codex 再拖回主侧边栏。
Sign in
安装扩展后，它会提示你使用 ChatGPT 账号或 API key 登录。你的 ChatGPT 计划已经包含 usage credits，因此通常不需要额外配置。更多信息见 pricing page。
Update the extension
扩展会自动更新，但你也可以在 IDE 里打开扩展页面手动检查更新。
Set up keyboard shortcuts
Codex 提供了一些可以绑定到 IDE 快捷键的命令，例如切换 Codex chat，或者把内容加入 Codex context。
要查看所有可用命令并绑定快捷键，请在 Codex chat 里选择设置图标，然后选择 Keyboard shortcuts。
你也可以参考 Codex IDE extension commands 页面。
如果你还不熟悉 Codex，可以先读 best practices guide。
Work with the Codex IDE extension
| 功能 | 作用 |
|---|---|
| Prompt with editor context | 用打开的文件、选区和 @file 引用，让提示词更短、结果更相关 |
| Switch models | 使用默认模型，或切换到其他模型来发挥各自优势 |
| Adjust reasoning effort | 在 low、medium、high 之间选择，平衡速度和深度 |
| Image generation | 不离开编辑器就能生成或编辑图片，需要迭代时可使用参考素材 |
| Choose an approval mode | 根据你想给 Codex 多大自主权，在 Chat、Agent、Agent (Full Access) 之间切换 |
| Delegate to the cloud | 把长任务交给云端环境处理，在 IDE 里查看进度和结果 |
| Follow up on cloud work | 预览云端改动、继续追问，并把生成的 diff 应用到本地完成测试 |
| IDE extension commands | 查看可从命令面板运行、也可绑定快捷键的完整命令 |
| Slash commands | 用 slash commands 控制 Codex 行为，并快速修改常用设置 |
| Extension settings | 为模型、审批和其他默认值调整 Codex 的编辑器设置 |
常见问题
OpenAI Codex IDE 扩展支持哪些编辑器
Codex IDE 扩展支持 VS Code 及其 fork，例如 Cursor 和 Windsurf，也支持 JetBrains IDEs。
在 Windows 上，可以原生运行 Windows sandbox，或者在需要 Linux 原生环境时使用 WSL2。
Codex 安装后看不到侧边栏怎么办
先重启编辑器，尤其是在 VS Code 里。
如果你用的是 Cursor，Codex 可能被折叠隐藏，检查 activity bar 是否显示完整，必要时把 Codex 固定到可见位置。
Codex 怎么登录，能不能用 API key
安装后可以用 ChatGPT 账号或 API key 登录。
如果你使用的是 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 计划，通常已经包含 usage credits，不需要额外配置。