25. IDE 扩展

本节目标：在 VS Code、Cursor、Windsurf 里装好 Codex 扩展，掌握 Agent 模式三档审批、编辑器上下文自动喂入、面板操作、模型切换和云端委派。

你平时写代码大概率泡在编辑器里。Codex 的 IDE 扩展就是把它塞进 VS Code、Cursor、Windsurf—不用切窗口，侧边栏直接对话，改动直接在编辑器里看 diff。

扩展和 CLI 是什么关系

扩展不是第四个新工具。它用的是和 CLI 同一个代理，共享同一份 ~/.codex/config.toml 配置和同一个登录。你在 CLI 里调好的模型、沙箱、审批策略，扩展全部继承。

打个比方，CLI 是你坐进驾驶座握方向盘—直接、全功能。扩展是配套的遥控器，让你在编辑器里点几下就把车开起来，还能在大屏上实时看并排 diff。发动机、油箱是同一套，你换哪个操控，车还是那辆车。

安装：认准 openai.chatgpt

支持哪些编辑器

官方明确支持 VS Code、VS Code Insiders、Cursor、Windsurf。系统层面 macOS、Windows、Linux 全支持。

三种安装方式

方式一：扩展市场搜。按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows）打开扩展视图。

Warning

很多人顺手搜 Codex，跳出一堆第三方小插件。官方扩展的 ID 是 openai.chatgpt，发布者是 OpenAI。认准发布者再点安装，别装成仿冒的。

方式二：点链接直装。开着编辑器时点对应链接直接跳到安装页：

VS Code  : vscode:extension/openai.chatgpt
Cursor   : cursor:extension/openai.chatgpt
Windsurf : windsurf:extension/openai.chatgpt

方式三：命令行装（最快）：

code --install-extension openai.chatgpt

Cursor 把 code 换成 cursor 即可。

装完图标找不到？

现象	编辑器	排查动作
装完没看到 Codex	VS Code	重启编辑器，看右侧栏
右侧栏找不到入口	Cursor	活动栏折叠项把 Codex 藏了，pin 出来
想挪到左边主侧栏	VS Code	直接拖回左侧活动栏

Tip

Cursor 的横排活动栏一挤就把后装的扩展收进折叠菜单。这个坑 VS Code 用户碰不到，Cursor 用户基本人均踩一次。

第一次点开 Codex 面板会提示登录。用 ChatGPT 账号登录功能最全，你的订阅本身就含 Codex 用量。

编辑器上下文：把「你说的是哪段」喂准

扩展相比 CLI 最大的便利，是能直接借用编辑器里的上下文。你不用费劲描述「哪个文件的哪段代码」，选中就喂进去了。

@file 提及文件

在提示框里用 @ 跟上文件名，Codex 就把那份文件当参考：

用 @example.tsx 当参考，给 app 加一个叫 "Resources" 的新页面，
内容是 @resources.ts 里定义的资源列表

一句话 @ 了两个文件，一个当样板、一个当数据源，Codex 不用猜。

选中代码自动喂

直接在编辑器里选中一段代码，它就进了当前对话的上下文。扩展还有个 Auto Context 开关，开着的时候自动把你最近打开的文件带进去。用 /auto-context 随时开关。

Tip

拖图片进提示框当参考时，按住 Shift 再拖—否则 VS Code 会拦住扩展的拖放。

三档审批模式

输入框下方有个审批模式切换器，点一下就换，不用碰配置文件。

审批模式	Codex 的行为	什么时候用
Agent（默认）	工作目录内自动读文件、改文件、跑命令；出工作目录或联网才问你	日常开发主力档
Chat	只聊天、只出主意，不直接改	先讨论方案、读代码、做审查
Agent (Full Access)	读、改、跑命令、联网全部免审批	完全信任的环境，谨慎使用

三个真实场景：

接手陌生项目、想让它先讲架构：切 Chat，只读不改，出方案后再放它动手
日常增删改查：用默认的 Agent，工作区内的活自己干
跑一个确定无害的批处理：临时切 Full Access 省得一路点同意，跑完记得切回来

Warning

大改动前先用 Chat 让它把方案讲一遍，在动手前框住它，比事后收拾干净得多。Full Access 干完立刻降回 Agent。

切模型与调思考深度

模型和思考深度都在输入框下方的切换器里，点几下就切。

切模型：简单活给轻量模型省额度，复杂活给旗舰模型保质量。具体有哪些型号以你本地切换器显示为准。

调思考深度（reasoning effort）：控制 Codex 回你之前先想多久。三档可选：

档位	特点	适合
`low`	扫一眼就答，快但容易毛糙	送分题、简单改动
`medium`	速度与深度平衡（推荐默认）	日常大多数编程
`high`	深度推理，慢但稳	跨模块推理的疑难任务

Tip

从 medium 起步，只有遇到真需要深想的硬骨头才切 high。一刀切全程拉满纯属浪费—又慢又烧额度。

面板使用与 Git 集成

并排 diff 审改动

Codex 改完代码，直接在编辑器里以并排 diff 的形式展示增删。看明白再应用，不满意可以拒绝。

代码审查

用 /review 进入代码审查模式，审未提交的改动或跟某个基准分支对比。这是写完想找「第二双眼睛」把关时的标准动作。

右键代码操作

选中代码后右键，可以快速执行解释、重写、审查、生成测试等操作。

云端委派

手头一个又慢又长的活，不用占着你本机，直接丢到 Codex 云端跑。

先在 ChatGPT 的 Codex 设置里建好一个云端环境
在扩展里选好环境，点 Run in the cloud

你可以让云端从 main 起跑（适合全新点子），也可以带着本地改动起跑（适合收尾进行到一半的活）。云端跑完，把改动拉回本地应用 diff。

Note

从本地对话发起云端任务时，Codex 会记住这段对话的上下文，能接着你刚才聊的往下干。

斜杠命令

在 Codex 聊天框里敲 / 弹出命令列表。官方实际提供的是下面这些：

斜杠命令	作用
`/status`	查当前对话的 thread ID、上下文用量、速率限制
`/auto-context`	开关 Auto Context
`/local`	切到本地模式
`/cloud`	切到云端模式
`/review`	进入代码审查模式
`/goal`	给 Codex 设一个持续目标
`/feedback`	提交反馈

Warning

网上不少老教程列的 /explain、/fix、/test 这些命令在官方文档里查不到。以编辑器里敲 / 实际弹出的为准。

自定义快捷键

Codex 的扩展命令默认大多没绑快捷键，但都能自己绑。

打开命令面板（Cmd+Shift+P / Ctrl+Shift+P）
跑 Preferences: Open Keyboard Shortcuts
搜 Codex 或具体命令 ID，点铅笔图标绑键

可绑的常用命令：

命令 ID	作用
`chatgpt.newChat`	新建对话
`chatgpt.addToThread`	把选中代码加进当前对话
`chatgpt.addFileToThread`	把整个文件加进当前对话
`chatgpt.implementTodo`	让 Codex 处理选中的 TODO 注释

Tip

想用回纯 CLI 的味道？在编辑器里打开集成终端，直接敲 codex 就行—它和扩展共享同一份配置和登录，无缝切。

Windows 专属设置

如果你的代码和工具链都在 WSL2 里，在编辑器设置里开 chatgpt.runCodexInWindowsSubsystemForLinux。否则 Codex 默认用 Windows 原生沙箱直接跑。改完会自动重载窗口生效。

小结

关系：扩展不是新工具，和 CLI 共享同一个代理、同一份配置和登录
安装：认准 ID openai.chatgpt、发布者 OpenAI；Cursor 记得把折叠的图标 pin 出来
上下文：@file 喂文件、选中代码自动喂，把「你说的是哪段」的猜测成本干掉
三档审批：Chat 只谋不动、Agent 工作区内自动（默认）、Full Access 全放开（慎用）
模型与思考深度：日常 medium 一把过，硬活临时拉 high
云端委派：/cloud 一键把长任务丢到云端跑，带着上下文
斜杠命令：认准 /status、/local、/cloud、/review 这套官方清单

下一章讲 Codex Cloud—在浏览器里把任务完全外包给 OpenAI 的云环境，怎么连 GitHub 仓库、怎么监控任务、怎么收 PR。