13 在 VS Code / IDE 中使用 Codex
如果你习惯在编辑器里处理代码，可以使用 Codex IDE 扩展，在当前项目上下文中让 Codex 解释代码、修改文件、运行命令并查看差异。本文以 VS Code 为主；Cursor、Windsurf 等兼容编辑器的入口和支持范围应以当前官方文档与插件市场为准。
::: tip 官方资料最后核对日期：2026-07-26。具体安装入口以 OpenAI Codex IDE 文档 和编辑器插件市场为准，不要安装名称相近但发布者不明的扩展。 :::
适合哪些场景
- 想在当前打开的项目里直接让 Codex 改代码
- 希望一边看 diff，一边继续追问
- 更习惯 VS Code、Cursor、Windsurf 这类编辑器
- 不想频繁在桌面 App、终端和编辑器之间切换
基本流程
- 打开 VS Code / Cursor / Windsurf
- 在插件市场搜索 Codex 或 OpenAI Codex
- 安装后选择 ChatGPT 或 API Key 登录
- 打开你的项目目录
- 在 Codex 面板中输入任务
- 查看变更、运行验证、确认是否保留修改
ChatGPT 登录和 API Key 登录怎么选
官方文档说明，本地 Codex 的桌面端、CLI 和 IDE 扩展支持两种 OpenAI 登录方式：
| 登录方式 | 适合场景 | 计费和能力边界 |
|---|---|---|
| ChatGPT 登录 | 使用 ChatGPT 套餐和工作区权限 | 受套餐、工作区角色和管理员策略影响 |
| OpenAI API Key | 按 API 用量计费的本地工作流 | 受 API 组织设置影响，部分依赖 ChatGPT/OAuth 的能力可能不可用 |
CLI 与 IDE 扩展会共享缓存的登录状态。你在其中一个入口退出后，另一个入口下次启动也可能要求重新登录。
Code8 API Key、OpenAI Platform API Key 和 ChatGPT 登录不是同一凭证。使用第三方兼容 API 时，应按对应服务的配置说明设置 Provider、Base URL 和环境变量，不要把 Key 直接写进项目源码。
第三方 API、DeepSeek 和 CC Switch
这类搜索通常不是“安装另一个 VS Code 插件”，而是让 Codex 使用自定义模型提供方。建议先在 Codex 第三方 API 与中转配置 中完成 config.toml、Base URL 和密钥配置，再回到 IDE 验证。
CLI 与 IDE 扩展共享 Codex 配置层，因此排错时先确认：
- IDE 和终端是否使用同一个用户与
CODEX_HOME。 - 自定义 Provider 名称、Base URL 和模型名是否匹配。
- 密钥对应的环境变量是否在启动 VS Code 的进程中可见。
- CC Switch 或其他配置工具是否修改了当前实际读取的文件。
配置示例和安全边界见：config.toml 与 auth.json。
VS Code 代理不生效
浏览器能访问网页，不代表 VS Code 扩展进程一定继承同一代理。分别检查：
- 从哪个终端或快捷方式启动 VS Code。
- Windows 用户/系统代理环境变量是否在 VS Code 进程启动前存在。
- 使用 WSL Remote 时，代理变量是否也配置在 WSL 环境。
- Base URL 是否被误当成 HTTP 代理地址。
修改代理后完全退出并重新启动 VS Code。不要把包含用户名、密码或 API Key 的代理地址贴到公开 issue。
VS Code 无法登录
- 先确认使用的是 ChatGPT 登录还是 API Key 登录。
- ChatGPT 登录会打开浏览器，完成后需要允许浏览器返回 Codex。
- API Key 登录应核对 Key 来源和对应计费账户。
- CLI 也无法登录时，优先处理共享认证或网络问题；只有 IDE 失败时，再检查扩展状态。
- 工作区账号可能受管理员登录方式、角色或产品权限限制。
认证缓存可能位于 ~/.codex/auth.json 或系统凭据存储。不要手工分享、提交或上传 auth.json。
Windows 启动错误和 3221225781
这个数字是 Windows 进程退出码，不足以单独判断为登录、API 或 Codex 服务故障。先打开 VS Code 的扩展日志和集成终端，记录失败的实际进程与错误文本。
如果扩展安装后完全无响应，官方 Windows 沙箱排错还建议检查 Visual C++ 运行组件或 C++ Build Tools，并在安装后彻底重启 VS Code。不要仅凭退出码下载来源不明的 DLL。
在 WSL 和 SSH 项目中使用
WSL 项目应从 WSL 终端进入仓库后运行：
code .
确认状态栏显示 WSL: <发行版>，并在集成终端检查 which codex。Windows 和 WSL 是两个环境，PATH、配置和登录状态可能不同。完整说明见：Codex WSL2 安装与配置。
Remote SSH 也应先确认扩展究竟运行在本机还是远端，以及远端是否有对应 Codex 命令、配置和网络权限。
和桌面 App 的区别
桌面 App 更适合集中管理项目、对话和任务；IDE 更适合在当前代码上下文中快速修改。新手可以先用桌面 App 学会基本概念，再把常用项目放到 IDE 中处理。
使用建议
- 第一次任务先让 Codex 解释项目结构，不要直接要求大改
- 涉及命令执行、网络访问、删除文件时认真看审批提示
- 让 Codex 修改后，自己至少跑一次测试或构建
- 重要项目先提交或备份，再进行大范围修改
配置后怎么验证
- 在 IDE 中打开一个可回退的小项目。
- 让 Codex 只解释当前文件，确认上下文可读。
- 再让它做一处小修改并查看 diff。
- 运行一条低风险验证命令。
- 最后检查 CLI 与 IDE 是否使用预期的账号、Provider 和模型。