掌握 IDE 扩展功能

Codex IDE extension 让你在 VS Code、Cursor、Windsurf 和其他 VS Code-compatible editors 中

Codex IDE extension 让你在 VS Code、Cursor、Windsurf 和其他 VS Code-compatible editors 中直接使用 Codex。它和 Codex CLI 使用同一个 agent，也共享同一套 configuration（配置）。

Prompting Codex

你可以在编辑器里用 Codex chat（聊天）、edit（编辑）和 preview changes（预览改动）。

当 Codex 能拿到 open files（已打开文件）和 selected code（选中代码）作为 context（上下文）时，你可以写更短 prompts，并获得更快、更相关的结果。

你可以在 prompt 中用 @file 形式引用任意文件：

参考 @example.tsx，为应用新增一个名为 "Resources" 的页面，页面内容使用 @resources.ts 中定义的资源列表。

Switch between models

你可以用 chat input（聊天输入框）下方的 switcher（切换器）切换模型。

官方截图：

https://developers.openai.com/images/codex/ide/switch_model.png

Adjust reasoning effort

Reasoning effort（推理强度）控制 Codex 在回答前思考多久。

更高的 effort 对复杂任务有帮助，但响应更慢，也会使用更多 tokens，更快消耗 rate limits。这个影响在高能力模型上尤其明显。

使用上面同一个 model switcher，为每个模型选择：

low
medium
high

建议从 medium 开始。只有当任务需要更深分析时，再切到 high。

Choose an approval mode

默认情况下，Codex 在 Agent mode 下运行。

在这个模式中，Codex 可以自动：

read files（读取文件）。
make edits（修改文件）。
在 working directory（工作目录）内 run commands（运行命令）。

但如果 Codex 要在 working directory 外工作，或访问 network（网络），仍然需要你的 approval（审批）。

如果你只是想聊天，或想先 planning（规划）再修改，可以用 chat input 下方的 switcher 切到 Chat。

官方截图：

https://developers.openai.com/images/codex/ide/approval_mode.png

如果你需要 Codex 在无需审批的情况下读取文件、修改文件，并运行带 network access 的命令，可以使用 Agent (Full Access)。这个模式风险更高，启用前要确认任务边界和仓库状态。

Cloud delegation

你可以把更大的任务交给 cloud 中的 Codex，然后在 IDE 里跟踪进度和 review 结果。

使用步骤：

为 Codex 设置 cloud environment： https://chatgpt.com/codex/settings/environments
选择 environment，并点击 Run in the cloud。

你可以让 Codex 从 main 分支开始运行，这适合启动新想法；也可以让它从你的 local changes（本地改动）开始运行，这适合完成已经进行中的任务。

官方截图：

https://developers.openai.com/images/codex/ide/start_cloud_task.png

当你从 local conversation（本地对话）启动 cloud task 时，Codex 会记住 conversation context，这样云端任务可以接着你刚才的上下文继续。

Cloud task follow-up

Codex extension 可以直接 preview cloud changes（预览云端改动）。

你可以继续要求 Codex 在 cloud 中 follow up（追加修改）。不过很多时候，你会想把 changes 应用到本地，自己运行测试并完成收尾。

当你在本地继续这个 conversation 时，Codex 也会保留 context，减少重复说明。

官方截图：

https://developers.openai.com/images/codex/ide/load_cloud_task.png

你也可以在 Codex cloud interface 查看 cloud tasks：

https://chatgpt.com/codex

Web search

Codex 内置 first-party web search tool（第一方网页搜索工具）。

对于 Codex IDE Extension 里的 local tasks，Codex 默认启用 web search，并从 web search cache 返回结果。这个 cache 是 OpenAI 维护的网页结果索引，所以 cached mode 返回的是预先索引过的结果，而不是实时抓取 live pages。

这样可以减少 arbitrary live content（任意实时内容）带来的 prompt injection 暴露面。但你仍然应该把 web results 当作 untrusted（不可信）内容。

如果你把 sandbox 配成 full access，web search 默认使用 live results：

https://developers.openai.com/codex/agent-approvals-security

如需关闭 web search，或切换到获取最新数据的 live results，见 Config basics：

https://developers.openai.com/codex/config-basic

当 Codex 执行搜索时，你会在 transcript（转录记录）或 codex exec --json 输出中看到 web_search items。