主题
Codex插件安装
先确认你已经安装好 VScode
这篇教程是在 VScode 里面安装 Codex 插件。
如果你还没有安装 VScode，请先看本分组里的“安装教程”，把 VScode 安装好以后再继续。
还要确认 Codex 已经通过 CC-Switch 配置好。
如果你已经按 CC-Switch 分组里的 Codex配置 做过配置，后面打开插件后一般不需要再登录。
如果你还没有配置 CC-Switch，请先去看 Codex配置，配置完成后再回来安装和使用这个插件。
第一步：打开 VScode
先打开 VScode。
Windows 用户可以在开始菜单里搜索 Visual Studio Code。
Mac 用户可以在“应用程序”里找到 Visual Studio Code。
打开后，看到 VScode 主界面就可以继续下一步。
第二步：进入扩展页面
在 VScode 左侧工具栏里，点击 扩展 图标。
这个图标通常长得像几个小方块。鼠标放上去会看到“扩展”或“Extensions”。
进入扩展页面后，在搜索框里输入：
text
codex搜索结果里找到：
text
Codex - OpenAI's coding agent请确认发布者是 OpenAI。
确认没有选错以后，点击插件右侧或详情页里的 安装 按钮。
第三步：确认插件安装成功
安装完成后，插件详情页上的按钮会发生变化。
如果你看到下面这些内容，说明 Codex 插件已经安装成功：
- 原来的 安装 按钮不见了。
- 页面上出现 禁用 按钮。
- 页面上出现 卸载 按钮。
- 页面里可以看到 自动更新。
看到这些按钮后，就说明插件已经装好了，不需要再点“安装”。
第四步：打开 Codex 面板
安装完成后，VScode 右上角会出现 Codex 的图标。
Codex 图标通常是黑白的 OpenAI 标志，旁边可能还有其他插件图标。
点击这个 Codex 图标，打开 Codex 面板。
第五步：查看 Codex 面板
点击图标后，右侧会打开 Codex 面板。
如果你能看到右侧出现 CODEX 面板，说明插件已经可以在 VScode 里正常打开。
面板里一般会看到这些内容：
- 顶部有 CODEX 字样。
- 下方有输入框。
- 输入框里可能会显示
Ask Codex anything...。 - 底部可以看到当前模型，例如
gpt、5.5 Medium。
如果看到这些内容，说明 Codex 插件已经打开成功。
第六步：如果看到登录或设置提示怎么办
如果你已经按 CC-Switch 分组里的 Codex配置 做过配置，正常情况下不需要在 VScode 里再点 Sign In 登录。
如果 VScode 顶部出现 Sign In 按钮，通常说明 Codex 插件还没有正确使用到你的 CC-Switch 配置。
这时不要直接点 Sign In。请先打开 Codex配置，检查 CC-Switch 里的 Codex 配置是否已经完成。
如果 Codex 面板里提示：
text
Set up Agent sandbox to continue也先不要急着点 Set up。请先回到 Codex配置，确认配置已经保存并可以正常使用。
确认 CC-Switch 配置没问题后，再回到 VScode，重新打开 Codex 面板。
如果输入框可以正常输入内容，就说明已经可以开始使用。
安装完成后怎么判断成功
你可以用下面几个方式判断：
- 在扩展页面里，Codex 插件显示 禁用 和 卸载 按钮。
- VScode 右上角能看到 Codex 图标。
- 点击 Codex 图标后，右侧能打开 CODEX 面板。
- 没有要求你额外点击 Sign In 登录。
- 输入框可以正常输入内容。
满足前面几条，就说明 Codex 插件已经安装好了。
常见问题
搜索不到 Codex 插件怎么办？
先确认你在左侧点击的是 扩展 页面。
然后在搜索框里输入：
text
codex如果还是搜不到，可以检查网络是否正常，或者稍后再试。
搜索结果有很多，应该安装哪一个？
优先选择：
text
Codex - OpenAI's coding agent并确认发布者是：
text
OpenAI不要随便安装名称相似但来源不清楚的插件。
安装后没有看到 Codex 图标怎么办？
可以先关闭 VScode，再重新打开。
如果还是没有看到，回到扩展页面，确认 Codex 插件是否已经安装成功。
如果插件页面还显示 安装，说明还没有安装成功，需要重新点击安装。
为什么会出现 Sign In？
如果你已经看过并完成了 CC-Switch 里的 Codex配置，正常情况下不应该再走 VScode 插件里的 Sign In。
看到 Sign In 时，先不要点它。
请回到 Codex配置，重点检查下面几项：
- CC-Switch 是否已经安装并打开。
- GPT中转站 的 API 密钥是否已经导入到 CC-Switch。
- CC-Switch 里是否能看到“GPT中转站”配置。
- 配置是否已经保存。
检查完成后，再回到 VScode 重新打开 Codex 面板。
为什么会提示 Set up？
如果已经按 Codex配置 做过 CC-Switch 配置，优先不要在这里直接点 Set up。
请先回到 Codex配置，确认 CC-Switch 配置已经完成。
确认配置没问题后，再回到 Codex 面板继续使用。