系统要求#

什么是 VS Code？ VS Code（全称 Visual Studio Code）是微软出的免费代码编辑器，程序员最常用的工具之一。如果你还没装，去 https://code.visualstudio.com 下载安装。

方式一：在 VS Code 里搜索安装（最简单）#

1. 打开 VS Code
2. 点击左侧边栏的 扩展图标（看起来像四个方块的图标，从上往下数第 5 个）
   • 或者按快捷键：
     • Windows：Ctrl + Shift + X
     • macOS：Command + Shift + X
3. 在搜索框里输入 “Codex”
4. 找到 “Codex”（开发者是 OpenAI），点 “安装”（Install）
5. 等待安装完成

方式二：用命令安装#

1. 按 Ctrl + P（macOS 是 Command + P）
2. 输入：ext install openai.codex
3. 按 回车
4. 自动安装完成

方式三：从网页安装#

1. 访问 https://developers.openai.com/codex/ide
2. 点击 “Install for VS Code” 按钮
3. 浏览器会弹出提示，允许打开 VS Code
4. VS Code 自动打开并安装插件

界面介绍#

安装 Codex 插件后，VS Code 里会多出：

• 侧边栏 Codex 面板 — 点左侧 Codex 图标打开，显示对话和操作历史
• 底部面板（可选）— 有些版本会在底部显示 Codex 终端输出

基本操作#

1. 打开你的项目

先在 VS Code 里打开你的代码项目：

• 文件 → 打开文件夹 → 选择你的项目目录

2. 跟 AI 对话

• 点左侧 Codex 图标 打开面板
• 在输入框里输入你的需求
• 按 回车 发送

3. 让 AI 改代码

你可以用几种方式让 AI 帮你改代码：

• 直接描述需求：“给这个函数加上错误处理”
• 选中代码再问：先用鼠标选中一段代码，然后问 Codex “帮我优化这段代码”
• 粘贴报错：把报错信息发给它，它帮你修

4. 确认修改

AI 改代码前会给你看修改预览：

• 绿色是新增的代码
• 红色是删除的代码
• 确认没问题后点 “接受”（Accept）

使用技巧#

1. 先保存文件 — 在让 AI 改代码之前，先保存当前文件（Ctrl+S / Command+S）
2. 选中代码再问 — 选中具体的代码段再提问，AI 更容易理解你的需求
3. 描述具体 — “帮我给 login 函数加上输入验证，检查邮箱格式和密码长度” 比 “帮我改一下” 好得多
4. 一次一个小任务 — 不要一次让 AI 做太多事，一个一个来效果更好

找不到 Codex 插件#

• 确认 VS Code 是最新版本（帮助 → 检查更新）
• 搜索时确认输入的是 “Codex” 而不是 “codex desktop”

登录失败#

1. 确认 ChatGPT 账号有 Plus 或 Pro 套餐
2. 先在浏览器里打开 https://chatgpt.com 确认能登录
3. 试试退出登录再重新登录

插件不工作#

1. 重启 VS Code
2. 检查网络连接
3. 在 VS Code 里按 Ctrl+Shift+P（macOS Command+Shift+P），输入 “Codex: Restart” 重启插件

AI 不修改代码#

• 确认已经打开了一个项目文件夹（不是单个文件）
• 确认文件有写入权限
• 试试选中代码再提问

网络问题#

• 确保网络能正常访问 openai.com

遇到问题？ 访问 https://developers.openai.com/codex/ide 查看官方文档。