Codex: Codex IDE 扩展
最后更新:2026-08-31
Codex IDE 扩展让你在熟悉的开发环境中直接使用 Codex,无需切换窗口。
📋 前置知识:了解 VS Code 基本操作
1. 你将学到
- 支持的 IDE 列表
- 安装与配置
- IDE 内的核心功能
- 与 CLI 版本的差异
2. 支持的 IDE
| IDE | 支持程度 | 说明 |
|---|---|---|
| VS Code | 完整支持 | 最广泛使用 |
| Cursor | 完整支持 | AI 原生 IDE |
| Windsurf | 完整支持 | AI 编码 IDE |
| VS Code forks | 部分支持 | 兼容 VS Code 插件 |
3. 安装
(1) VS Code 安装
TEXT
📖 仅展示
1. 打开 VS Code
2. 点击左侧扩展图标(或 Ctrl+Shift+X)
3. 搜索 "Codex"
4. 点击 Install
5. 登录 ChatGPT 账号
(2) Cursor 安装
TEXT
📖 仅展示
1. 打开 Cursor
2. 扩展市场搜索 "Codex"
3. Install
4. 登录账号
4. IDE 内核心功能
(1) 内联编辑
选中代码 → 右键 → "Codex: Edit" → 输入修改指令:
TYPESCRIPT
// 选中这段代码
function formatDate(date) {
return date.toISOString();
}
// 右键 → Codex: Edit → "添加本地化支持,支持中文日期格式"
// Codex 修改后
function formatDate(date: Date, locale: string = "zh-CN"): string {
return new Intl.DateTimeFormat(locale, {
year: "numeric",
month: "long",
day: "numeric",
}).format(date);
}
(2) 代码生成
TEXT
📖 仅展示
Ctrl+Shift+P → "Codex: Generate" → 输入描述
▶ 示例 1: Alice 用 IDE 扩展写代码
TYPESCRIPT
// Alice 在 VS Code 中按 Ctrl+Shift+P
// 输入 "Codex: Generate"
// 描述:"创建一个 React Hook,管理分页状态,包含页码、每页数量、总数"
// Codex 生成:
import { useState, useCallback } from "react";
interface PaginationState {
page: number;
pageSize: number;
total: number;
}
export function usePagination(initialPageSize: number = 20) {
const [state, setState] = useState<PaginationState>({
page: 1,
pageSize: initialPageSize,
total: 0,
});
const setPage = useCallback((page: number) => {
setState((prev) => ({ ...prev, page }));
}, []);
const setTotal = useCallback((total: number) => {
setState((prev) => ({ ...prev, total }));
}, []);
const totalPages = Math.ceil(state.total / state.pageSize);
return { ...state, totalPages, setPage, setTotal };
}
(3) 代码审查
TEXT
📖 仅展示
选中代码 → 右键 → "Codex: Review"
(4) 解释代码
TEXT
📖 仅展示
选中代码 → 右键 → "Codex: Explain"
5. 快捷键
| 快捷键 | 功能 |
|---|---|
Ctrl+Shift+P → Codex |
打开 Codex 命令面板 |
Ctrl+Alt+E |
编辑选中代码 |
Ctrl+Alt+G |
生成代码 |
Ctrl+Alt+R |
审查选中代码 |
Ctrl+Alt+X |
解释选中代码 |
Ctrl+Alt+C |
打开 Codex 侧栏 |
6. 侧栏面板
Codex IDE 扩展提供侧栏面板,功能类似 App 版的对话窗口:
- 输入任务描述
- 查看执行过程
- 审查修改
- 确认或拒绝操作
(1) 与编辑器联动
TEXT
📖 仅展示
1. 在侧栏输入 "修复当前文件的类型错误"
2. Codex 自动读取当前编辑器打开的文件
3. 直接在编辑器中展示 diff
4. 点击 Apply 应用修改
7. 配置
(1) VS Code Settings
JSON
{
"codex.model": "gpt-5-codex",
"codex.sandboxMode": "workspace-write",
"codex.autoApply": false,
"codex.contextFiles": ["AGENTS.md", "tsconfig.json"],
"codex.excludePatterns": ["node_modules/", "dist/"]
}
(2) 自动上下文
IDE 扩展会自动包含以下上下文:
| 上下文来源 | 说明 |
|---|---|
| 打开的文件 | 当前编辑器中打开的文件 |
| 选中的文本 | 你选中的代码片段 |
| 工作区结构 | 项目文件树 |
| 诊断信息 | 编辑器中的错误和警告 |
8. IDE vs CLI 对比
| 维度 | IDE 扩展 | CLI |
|---|---|---|
| 集成度 | 深度集成编辑器 | 独立终端 |
| 上下文 | 自动获取(打开文件、选中代码) | 手动添加 |
| 可视化 | Diff 视图、内联编辑 | 文本输出 |
| 自动化 | 中等 | 更强(Full Auto) |
| 适用场景 | 日常编码、代码审查 | 批量操作、自动化脚本 |
❓ 常见问题
Q IDE 扩展和 CLI 可以同时用吗?
A 可以,但不建议同时操作同一项目,可能产生文件冲突。
Q IDE 扩展支持离线使用吗?
A 不支持,需要连接 OpenAI API。
Q Cursor 自带的 AI 和 Codex 扩展冲突吗?
A 不冲突,两者独立运行。Cursor AI 侧重代码补全,Codex 扩展侧重 Agent 操作。
Q 如何在 IDE 中切换模型?
A 在 VS Code Settings 中修改
codex.model,或在侧栏面板的设置中切换。Q IDE 扩展的审批策略在哪设置?
A 在 VS Code Settings 中设置
codex.sandboxMode,或通过全局 config.toml 配置。📖 小节
- 支持 VS Code、Cursor、Windsurf 等 IDE
- 核心功能:内联编辑、代码生成、审查、解释
- 自动获取上下文:打开文件、选中代码、诊断信息
- IDE 侧重编码体验,CLI 侧重自动化
- 快捷键大幅提升操作效率
📝 作业
- 基础题(难度⭐):在 VS Code 中安装 Codex 扩展,用内联编辑修改一段代码。
- 进阶题(难度⭐⭐):用 IDE 扩展完成代码审查,记录 Codex 发现的问题。
- 挑战题(难度⭐⭐⭐):对比 IDE 扩展和 CLI 完成同一任务的体验差异,写一份对比报告。