Codex: Codex IDE 扩展

最后更新:2026-08-31

Codex IDE 扩展让你在熟悉的开发环境中直接使用 Codex,无需切换窗口。

📋 前置知识:了解 VS Code 基本操作

1. 你将学到


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 配置。

📖 小节


📝 作业

  1. 基础题(难度⭐):在 VS Code 中安装 Codex 扩展,用内联编辑修改一段代码。
  2. 进阶题(难度⭐⭐):用 IDE 扩展完成代码审查,记录 Codex 发现的问题。
  3. 挑战题(难度⭐⭐⭐):对比 IDE 扩展和 CLI 完成同一任务的体验差异,写一份对比报告。
Web-Tutorial.com

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核,确保内容准确可靠。如发现任何问题,欢迎向我们反馈。

100%

🙏 帮我们做得更好

我们是刚上线的编程教程站,几个人的小团队,精力有限。页面虽经检查,难免还有疏漏——链接失效、排版错乱、内容有误、语言生硬……

如果您发现了,麻烦告诉我们,我们会在收到反馈后第一时间进行修复,再次感谢您的光临 🙏