一、图形界面安装(新手推荐,全程3步)
这是最直观、最不容易出错的安装方式,适合绝大多数用户:
- 打开 VS Code 编辑器,点击左侧边栏的「扩展」图标(四个小方块样式),也可以直接按快捷键快速打开:
- Windows / Linux:
Ctrl + Shift + X - Mac:
Cmd + Shift + X
- 在扩展面板顶部的搜索框中输入
Codex,在结果列表里找到发布者标注为「OpenAI」、名称为「Codex - OpenAI's coding agent」的官方插件。注意区分第三方同名插件,非官方工具存在密钥泄露、功能不稳定的风险。 - 点击插件卡片上的「安装」按钮,等待几秒即可自动完成安装。安装完成后,VS Code 左侧边栏会出现 Codex 专属图标,代表插件已安装就绪。
二、命令行快速安装(适合熟悉终端的用户)
如果你的电脑已配置好 VS Code 的系统环境变量,可通过终端一键安装:
- 打开系统终端(CMD / PowerShell / 终端.app)。
- 输入以下命令并回车:
code --install-extension openai.chatgpt
- 终端提示安装成功后,重启 VS Code 即可生效。
三、安装成功验证
- 安装完成后,查看 VS Code 左侧边栏是否出现 Codex 图标,能正常点开侧边栏面板即为安装成功。
- 如果侧边栏没显示图标,可以按下
Ctrl + Shift + P(Windows)/Cmd + Shift + P(Mac)调出命令面板,输入Codex: Open Codex Sidebar并回车,即可手动调出插件面板。
实用注意事项
- 认准官方发布者:必须选择发布者为「OpenAI」的官方插件,不要安装第三方开发的同名工具,避免密钥被盗、功能异常。
- 版本兼容要求:建议将 VS Code 升级到 1.80 以上的稳定版本,版本过低可能出现插件加载失败、功能缺失等兼容问题。
- 网络要求:插件需要可正常访问 OpenAI 服务的网络环境,网络受限会直接导致后续登录失败、功能无响应。
- 无需额外装依赖:插件本身已集成完整核心功能,基础编码场景不需要额外安装其他工具,登录账号后即可直接使用。