Appearance
Codex IDE 扩展把 AI Agent 直接嵌入你的编辑器，支持 VS Code、Cursor、Windsurf 和 JetBrains IDEs。安装后 Codex 出现在侧边栏，可以读文件、写代码、运行命令，还能把长任务推送到 Codex Cloud 执行。本文覆盖安装配置、三种工作模式和主要功能入口。
Codex IDE 扩展
Codex IDE 扩展让你在编辑器里直接使用 AI Agent：读取、编辑、运行代码，加速开发、定位 Bug、理解陌生代码库。通过 VS Code 扩展还可以把任务委托给 Codex Cloud 执行。
ChatGPT Plus、Pro、Business、Edu 和 Enterprise 计划均包含 Codex。详见定价页面。
安装扩展
Codex VS Code 扩展支持 VS Code 及其 fork（Cursor、Windsurf 等）：
Codex VS Code 扩展在 macOS 和 Linux 上正式支持；Windows 支持为实验性，建议使用 WSL2 工作区，参考 Windows 安装指南。
安装完成后，Codex 出现在编辑器侧边栏。VS Code 默认在右侧边栏打开 Codex。如果 VS Code 里看不到，尝试重启编辑器。
Cursor 默认横向显示活动栏，可能把 Codex 图标折叠隐藏——可以把它 Pin 住并调整扩展排序。
JetBrains IDE 集成
Rider、IntelliJ、PyCharm、WebStorm 等 JetBrains IDEs 可安装独立的集成插件，支持 ChatGPT 账号登录、API Key 或 JetBrains AI 订阅。
将 Codex 移到右侧边栏
VS Code 里 Codex 默认在右侧边栏，如需换到左侧，直接拖动图标即可。
Cursor 等 fork 里可能需要手动移动：
- 打开编辑器设置，搜索
activity bar（Workbench 设置） - 把方向改为
vertical - 重启编辑器
- 把 Codex 图标拖到右侧边栏（如 Cursor Chat 旁边）
- 完成后把活动栏方向改回
horizontal
登录
安装扩展后，系统会提示用 ChatGPT 账号或 API Key 登录。ChatGPT 计划包含使用额度，无需额外配置。
更新扩展
扩展会自动更新；也可以在 IDE 里打开扩展页面手动检查更新。
设置快捷键
Codex 提供可绑定快捷键的命令（如切换 Codex 面板、向上下文添加文件等）。
查看所有可用命令并绑定快捷键：在 Codex 面板里点击设置图标 → Keyboard shortcuts。
主要功能入口
| 功能 | 说明 |
|---|---|
| 使用编辑器上下文 Prompt | 引用打开的文件、选中代码和 @file 写更短的 Prompt |
| 切换模型 | 按需切换不同能力的模型 |
| 调整推理强度 | low/medium/high 三档权衡速度与深度 |
| 选择审批模式 | Chat / Agent / Agent (Full Access) |
| 委托到 Cloud | 把长任务推送到云端，在 IDE 里追踪进度 |
| 跟进 Cloud 任务 | 预览 Cloud 改动，应用到本地测试和收尾 |
| IDE 命令 | 命令面板可用的完整命令列表 |
| Slash 命令 | 在对话里快速调整行为的命令 |
| 扩展设置 | 模型、审批模式等默认值配置 |
常见问题
Q: Codex 扩展在 VS Code 里安装完看不到图标怎么办？
A: 尝试重启 VS Code。如果仍然看不到，检查活动栏是否折叠了 Codex 图标——可以右键活动栏选择显示所有图标，或手动把 Codex 图标拖到可见位置。
Q: 在 Cursor 里 Codex 和内置 AI 功能会冲突吗？
A: 不冲突，两者是独立的扩展。Codex 扩展使用 OpenAI 的模型和 ChatGPT 账号，Cursor 的 AI 功能使用各自的配置，互不干扰。
Q: IDE 扩展和 Codex App 的关系是什么？
A: 两者共享配置（~/.codex/config.toml），安装在同一项目里时会自动同步——IDE 扩展里能看到 Codex App 的线程，反之亦然。主要区别是界面：IDE 扩展内嵌在编辑器里，Codex App 是独立桌面应用，后者有更完整的线程管理和 Worktree 支持。