Codex IDE 扩展

Codex IDE 扩展让你在熟悉的开发环境中直接使用 Codex，无缝融入日常编码工作流。

支持的 IDE

Codex 官方支持以下 IDE：

IDE扩展 ID安装方式
VS Codeopenai.chatgptvscode:extension/openai.chatgpt
VS Code Insidersopenai.chatgpt扩展市场
Cursoropenai.chatgptcursor:extension/openai.chatgpt
Windsurfopenai.chatgptwindsurf:extension/openai.chatgpt

安装扩展

VS Code 安装

VS Code 安装

# 方法一：命令行安装
code --install-extension openai.chatgpt

# 方法二：在 VS Code 中
# 1. 打开扩展面板 (Cmd+Shift+X)
# 2. 搜索 "Codex" 或 "ChatGPT"
# 3. 点击安装

Cursor 安装

Cursor 安装

# 方法一：命令行
cursor --install-extension openai.chatgpt

# 方法二：在 Cursor 中
# 1. 打开扩展面板
# 2. 搜索 "Codex"
# 3. 点击安装

安装后需要使用 ChatGPT 账号或 OpenAI API Key 登录才能使用。

核心功能

自动上下文

IDE 扩展自动将以下内容作为上下文传递给 Codex：

  • 当前打开的文件列表
  • 编辑器中选中的文本范围
  • 当前工作目录信息

AI 对话

在 IDE 中直接与 Codex 对话：

  • 打开 Codex 面板（快捷键或侧边栏）
  • 输入问题或任务描述
  • Codex 分析当前文件和项目后回复

代码操作

选中代码后右键可执行：

操作功能
解释Codex 解释选中代码的功能
重写按需求重写选中代码
审查检查代码问题和改进建议
生成测试为选中代码生成单元测试

斜杠命令

在 Codex 面板中使用斜杠命令：

命令功能
/explain解释选中代码
/fix修复选中代码的问题
/test为选中代码生成测试
/review审查选中代码
/plan先规划再执行

斜杠命令示例

# 解释代码
/explain

# 修复 Bug
/fix this function throws error for null input

# 规划新功能
/plan implement user authentication with JWT

模型选择

在输入框下方可以切换模型：

模型特点
GPT-5.4旗舰模型，适合复杂任务
GPT-5.4-mini轻量快速，适合简单任务
GPT-5.3-Codex专业编码模型

快捷键

快捷键功能
Cmd+Shift+C打开 Codex 面板
Cmd+Shift+Enter代码补全
Cmd+Shift+R重写选中代码
Cmd+Shift+E解释选中代码

快捷键可在 IDE 设置中自定义，避免与其他扩展冲突。

云端任务委派

从 IDE 扩展启动云端任务：

  • 选择 Cloud 模式创建线程
  • 任务在云端隔离环境运行
  • 完成后通过通知或 PR 查看结果

适用场景

  • 需要并行处理多个任务
  • 从低配置设备委派大型任务
  • 跨设备协同工作

IDE 配置

设置文件打开方式

配置文件打开

# ~/.codex/config.toml

# 指定打开文件的编辑器
file_opener = "vscode"
# 可选值: vscode, vscode-insiders, windsurf, cursor, none

设置默认模型

配置默认模型

# ~/.codex/config.toml

model = "gpt-5.4"

使用技巧

选择代码作为上下文

选中代码后，Codex 自动将其作为上下文。

选中的代码越多，Codex 的回复越准确。

多文件操作

打开多个文件时，Codex 可以同时处理。

在面板中描述需要修改的文件即可。

使用内置终端

IDE 内置终端可以直接运行 Codex CLI。

这样可以享受 CLI 的完整功能。

常见问题

Q: 扩展无法连接？

确保已登录 Codex 账号，检查网络连接和代理设置。

Q: 快捷键与其他扩展冲突？

在 IDE 设置中搜索 "Codex"，自定义快捷键。

Q: 如何更新扩展？

扩展随 Codex 自动更新，或在 IDE 扩展面板手动更新。

Q: IDE 扩展与 App 的区别？

IDE 扩展深度集成开发环境，自动读取文件上下文；App 提供完整功能和多项目管理。