AI 编程教程中文版
官方教程中文版产品入口

安装和使用 IDE 扩展

说明如何安装 Codex IDE extension，并理解它和本地项目、编辑器上下文、登录方式的关系。

📖 本篇术语速查表
英文 / 缩写中文一句话解释
IDE 扩展IDE extension在编辑器里使用 Codex 的插件。
JetBrains—一类 IDE，集成方式略有不同。
侧边栏sidebar把 Codex 放到合适侧边栏位置。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你装好并配置 Codex 的 IDE 扩展。

你是 Codex IDE 扩展安装顾问，帮我在编辑器里装好并配置 Codex 扩展。

【角色】
你熟悉扩展安装、JetBrains 集成、把 Codex 移到合适侧边栏、登录、更新扩展。

【输入】
- 我的编辑器（VS Code / JetBrains / 其它）：___
- 我的账号 / 登录方式：___
- 是否多设备同步：___
- 遇到的安装问题：___

【工作流程】
1. 给对应编辑器的安装步骤
2. 处理 JetBrains 等的差异
3. 调整侧边栏位置、完成登录
4. 说明怎么更新和排查安装问题

【输出规范】
▌一、安装步骤（按编辑器）
▌二、JetBrains 等差异
▌三、侧边栏 + 登录
▌四、更新与排错

【硬约束】
- 登录凭据安全处理，不暴露
- 按我的编辑器给步骤，不混淆
- 更新前提醒注意兼容
- 不确定的步骤标注需查官方文档
- 步骤能直接照做
- 装完先用一个只读小任务确认扩展工作正常，再正式投入开发，别带着问题硬用

Codex IDE extension 让你在编辑器里直接使用 OpenAI 的 coding agent（编程 Agent）。它可以 read（读取）、edit（编辑）和 run code（运行代码），帮助你构建功能、修 bug、理解不熟悉的代码。

在 VS Code extension 里，你可以把 Codex 放在 IDE 侧边栏里和代码并排使用，也可以把任务 delegate（委托）给 Codex Cloud。

IDE 支持范围、套餐权益、下载入口和编辑器集成会变化。安装前先看官方 IDE 页面和 pricing 页面，不要依赖旧截图、旧博客或二手列表。

计划包含内容见：

https://developers.openai.com/codex/pricing

官方概览视频：

https://www.youtube.com/watch?v=sd21Igx4HtA

Extension setup

Codex IDE extension 支持 VS Code forks（VS Code 分支编辑器），例如 Cursor 和 Windsurf。

你可以从 Visual Studio Code Marketplace 安装：

https://marketplace.visualstudio.com/items?itemName=openai.chatgpt

也可以按编辑器直接打开安装入口：

Codex IDE integrations 的平台和编辑器覆盖范围以官方 IDE 文档为准。安装时先确认当前编辑器、操作系统和登录方式是否仍被支持。

在 Windows 上，你可以用 Windows sandbox 原生运行 Codex；如果需要 Linux-native environment（原生 Linux 环境），也可以使用 WSL2。Windows 设置见：

https://developers.openai.com/codex/windows

安装后，你会在 editor sidebar（编辑器侧边栏）看到 Codex。

在 VS Code 里，Codex 默认打开在右侧边栏。如果你安装后没有马上看到 Codex，重启 VS Code。

如果你使用 Cursor，activity bar（活动栏）默认是横向显示。折叠的项目可能会隐藏 Codex，所以可以 pin（固定）它，并重新调整 extensions 的顺序。

Codex extension 截图：

https://cdn.openai.com/devhub/docs/codex-extension.webp

JetBrains IDE integration

如果你想在 JetBrains IDEs 里使用 Codex，先确认官方 IDE 页面或 JetBrains 官方页面是否仍提供对应 integration。

它支持三种登录方式：

  • ChatGPT 登录。
  • API key。
  • JetBrains AI subscription（JetBrains AI 订阅）。

参考入口：

https://blog.jetbrains.com/ai/2026/01/codex-in-jetbrains-ides/

Move Codex to the right sidebar

在 VS Code 中，Codex 会自动出现在 right sidebar（右侧边栏）。如果你更喜欢把它放在 primary sidebar（左侧主边栏），可以把 Codex icon 拖回左侧 activity bar。

在 Cursor 这类 VS Code forks 中，你可能需要手动把 Codex 移到右侧边栏。移动前，可能还需要临时修改 activity bar orientation（活动栏方向）：

  1. 打开 editor settings，搜索 activity bar，位置在 Workbench settings。
  2. 把 orientation 改成 vertical。
  3. 重启编辑器。

设置截图：

https://cdn.openai.com/devhub/docs/codex-workbench-setting.webp

然后把 Codex icon 拖到右侧边栏，例如放在 Cursor chat 旁边。Codex 会作为 sidebar 里的另一个 tab 出现。

移动完成后，可以把 activity bar orientation 重新设回 horizontal，恢复默认行为。

如果之后改变主意，随时可以把 Codex 拖回 primary sidebar。

Sign in

安装 extension 后，它会提示你使用 ChatGPT account 或 API key 登录。

ChatGPT plan、API key 和团队账号的可用方式、额度和计费口径会变化。价格和额度见：

https://developers.openai.com/codex/pricing

Update the extension

Extension 会自动更新。

你也可以在 IDE 里打开 extension page，手动检查是否有更新。

Set up keyboard shortcuts

Codex 提供可以绑定到 IDE keyboard shortcuts（快捷键）的 commands，例如：

  • toggle Codex chat（打开/关闭 Codex 聊天）。
  • add items to the Codex context（把项目加入 Codex 上下文）。

查看所有可用 commands 并绑定快捷键：

  1. 打开 Codex chat。
  2. 选择 settings icon（设置图标）。
  3. 选择 Keyboard shortcuts。

命令列表见：

https://developers.openai.com/codex/ide/commands

Slash commands 列表见：

https://developers.openai.com/codex/ide/slash-commands

如果你刚开始使用 Codex，先读 best practices guide：

https://developers.openai.com/codex/learn/best-practices

Work with the Codex IDE extension

下面是 IDE extension 最常用的能力。

Prompt with editor context

使用 open files（已打开文件）、selections（选区）和 @file references（文件引用），用更短 prompt 得到更相关的结果：

https://developers.openai.com/codex/ide/features#prompting-codex

Switch models

使用 default model（默认模型），或切换到其他模型，发挥各自优势：

https://developers.openai.com/codex/ide/features#switch-between-models

Adjust reasoning effort

在 low、medium、high 之间选择 reasoning effort（推理强度），按任务在速度和深度之间取舍：

https://developers.openai.com/codex/ide/features#adjust-reasoning-effort

图片生成

无需离开编辑器，就可以生成或编辑图片；需要迭代时，也可以使用 reference assets（参考素材）：

https://developers.openai.com/codex/ide/features#image-generation

Choose an approval mode

在 Chat、Agent、Agent (Full Access) 之间切换，根据你希望 Codex 拥有的 autonomy（自主程度）选择模式：

https://developers.openai.com/codex/ide/features#choose-an-approval-mode

Delegate to the cloud

把较长任务交给 cloud environment，在 IDE 里监控进度并 review 结果：

https://developers.openai.com/codex/ide/features#cloud-delegation

跟进云端任务

预览 cloud changes，继续要求 Codex follow up，然后把生成的 diffs 应用到本地测试和收尾：

https://developers.openai.com/codex/ide/features#cloud-task-follow-up

IDE extension commands

浏览可从 command palette（命令面板）运行、也可以绑定快捷键的完整 commands：

https://developers.openai.com/codex/ide/commands

斜杠命令

用 slash commands 控制 Codex 行为，并从聊天里快速修改常用设置：

https://developers.openai.com/codex/ide/slash-commands

Extension settings

通过 editor settings 调整模型、approvals 和其他默认行为：

https://developers.openai.com/codex/ide/settings

接下来去哪

IDE 功能

安装后先理解 editor context、model、reasoning、approval 和 cloud delegation。

IDE 设置

把模型、approval mode、默认行为和快捷键配置到可解释状态。

IDE 斜杠命令

用 slash commands 在编辑器里快速控制 Codex 行为。

官方 IDE 文档

安装入口、支持编辑器和功能变更以官方页面为准。

使用网页版 Codex

介绍 Codex web 入口如何读取代码、修改代码和运行验证，适合不想先配置本地环境的新手。

掌握 IDE 扩展功能

梳理 Codex IDE extension 的核心功能，包括编辑器上下文、local/cloud 模式、图片输入和代码审查。

本页目录

Extension setupJetBrains IDE integrationMove Codex to the right sidebarSign inUpdate the extensionSet up keyboard shortcutsWork with the Codex IDE extensionPrompt with editor contextSwitch modelsAdjust reasoning effort图片生成Choose an approval modeDelegate to the cloud跟进云端任务IDE extension commands斜杠命令Extension settings接下来去哪