Codex 可以直接在 VS Code 侧边栏中协助你写代码、改 Bug、解释项目和执行命令。

1. 准备工作

开始前请确认：

• VS Code 已更新到较新的稳定版本。
• 你可以正常访问OpenAi网站
• 项目代码已在本地打开（建议使用 Git 仓库）。

2. 安装扩展

1. 打开 VS Code 的扩展市场（Extensions）。
2. 搜索并安装：Codex - Codex - OpenAI's coding agent。
3. 安装完成后，按提示完成登录授权。

3. 打开 Codex 侧边栏

你可以通过任一方式打开：

• 在编辑器右上角点击 Open Codex Sidebar。
• 使用命令面板（Ctrl + Shift + P）搜索 Codex 并打开。

打开后，Codex 会读取当前工作区上下文，进入可对话状态。

4. 常见使用方式

4.1 让它解释代码

示例提示词：

1

请解释这个文件的核心逻辑，并指出最可能出错的 3 个地方。

适合你刚接手旧项目时快速建立全局理解。

4.2 让它实现功能

示例提示词：

1
2

在现有 API 里新增一个 /healthz 健康检查接口，
要求返回版本号和数据库连接状态，并补上基础测试。

建议把“输入约束”和“验收标准”一起写清楚，生成结果会稳定很多。

4.3 让它修复问题

示例提示词：

1
2

这个接口在并发下偶发 500，请先定位根因，再给出最小改动修复方案，
最后列出回归测试点。

先“定位”再“修复”，能减少误改和过度重构。

5. 高质量提示词模板

你可以直接复用下面这个结构：

1
2
3
4
5
6
7

背景：这是一个 <技术栈> 项目，当前目标是 <目标>
约束：不改动 <模块/接口>，兼容 <版本/平台>
输出：
1) 修改文件列表
2) 关键代码说明
3) 验证步骤
4) 风险与回滚方案

这个模板对“多人协作 + 大项目”非常有帮助。

6. 常见问题

6.1 关于免费额度

在对话框输入 ‘' 然后选择 状态会出现 额度 重置时间等相关信息

6.2 改动不符合预期

修改完成后查看审核按钮，查看修改细节，不满意选择撤销按钮，可撤销修改。 在后面的步骤中可以把需求拆小，分成多个步骤分别执行。 使用git等代码管理工具，保持小步提交（small commits），方便回滚。