Appearance
在 VS Code 中安装 Codex 插件并接入应天AI
Codex 插件可以把 AI 编程能力直接带入 VS Code。你可以在编辑器侧边栏中询问项目结构、解释代码、生成修改建议，并在确认后让 Codex 协助调整文件。
本文介绍如何安装 OpenAI 官方 Codex 插件，并通过 CC Switch 将应天AI Provider 提供给插件使用。整个流程不需要手动编辑 Codex 配置文件。
Codex 插件能够读取当前工作区，也可能申请修改文件或运行命令。首次使用时建议打开测试项目，并在批准操作前检查影响范围。
网络提示： Codex 插件运行时需要访问 Codex 相关服务。使用前请确保当前网络环境能够正常访问所需服务；如果所在网络无法直接连接，需先准备可用的网络代理或其他合规的网络访问方式。CC Switch 只负责切换 Provider，不会替代网络连接能力。
一、开始前准备
请准备以下内容：
| 项目 | 说明 |
|---|---|
| VS Code | 已安装并能正常打开扩展市场 |
| Codex 插件 | 本文将安装 OpenAI 发布的官方扩展 |
| CC Switch | 用于导入和启用应天AI Codex Provider |
| 应天AI账号 | 用于创建 API Token 和查看调用日志 |
| 模型名称 | 以应天AI模型广场当前显示为准 |
如果尚未安装 CC Switch，请先完成 CC Switch 安装与首次配置，确认它的主窗口可以正常打开，再返回本页继续操作。
常用入口：
二、安装 OpenAI 官方 Codex 插件
- 启动 VS Code。
- 点击左侧活动栏中的“扩展”图标。
- 也可以使用快捷键
Ctrl+Shift+X；macOS 使用Cmd+Shift+X。 - 在扩展市场中搜索
Codex。 - 选择名称为 Codex – OpenAI’s coding agent 的扩展。
- 核对发布者为 OpenAI，然后点击“安装”。
搜索结果中可能存在名称相似的第三方扩展。安装前应同时核对扩展名称和发布者，避免误装非官方插件。
安装完成后，VS Code 的活动栏或编辑器右侧会出现 Codex 入口。如果暂时没有显示，可以重新加载窗口或重启 VS Code。
安装完成后建议立即检查：
- 扩展名称为
Codex – OpenAI’s coding agent - 发布者显示为
OpenAI - 扩展状态为“已启用”
- 当前 VS Code 窗口没有禁用该扩展
如果扩展市场访问较慢，可以先在浏览器打开 Visual Studio Code 官网，确认 VS Code 版本和系统架构，再返回编辑器安装扩展。
三、创建 Codex 专用 API Token
建议为 VS Code Codex 插件单独创建一枚 Token，方便限制模型权限、查看用量和随时停用：
不要把真实 Token 填入 ChatGPT 账号登录页面，也不要将 Token 放入代码、截图或公开仓库。
四、从应天AI打开 CC Switch
在 API 密钥列表中找到刚创建的 Token：
- 打开该 Token 右侧的操作菜单。
- 选择 CC Switch。
- 在配置窗口中选择 Codex。
- 填写容易识别的配置名称，例如
应天AI VS Code。 - 从列表中选择当前可用模型。
- 点击“打开 CC Switch”。
浏览器可能询问是否允许打开外部应用。确认目标应用为 CC Switch 后选择允许。
如果没有任何反应，请先手动启动 CC Switch，再回到浏览器重试。仍无法打开时，请查看 CC Switch 安装教程 中关于 ccswitch:// 协议的排查说明。
五、确认导入 Provider
CC Switch 打开后会显示待导入的 Provider 信息。导入前请核对：
- 应用类型为
Codex - Provider 名称便于识别
- API 端点属于应天AI
- API 密钥已经脱敏显示
- 模型名称与控制台一致
确认信息正确后点击“导入”。如果应用类型或模型不正确，先取消导入，返回应天AI配置窗口重新选择。
六、在 CC Switch 中启用配置
导入完成后：
- 在 CC Switch 顶部选择 Codex 分类。
- 找到刚导入的 Provider，例如
My Codex或自定义名称。 - 点击该 Provider，将它设为当前使用配置。
- 确认界面高亮显示目标 Provider，或出现“使用中”等状态。
如果列表里同时存在 OpenAI Official、default 和应天AI配置，请确认当前选中的是应天AI Provider，而不是旧配置。
七、重新加载 VS Code
Codex 插件通常在启动时读取 Provider 配置。CC Switch 切换完成后，需要让 VS Code 重新加载：
- 保存当前正在编辑的文件。
- 完全关闭 VS Code 后重新打开。
- 或使用命令面板执行“Developer: Reload Window”。
- 重新打开需要测试的项目目录。
以后每次在 CC Switch 中切换 Codex Provider，如果插件仍然使用旧服务，也应先重新加载 VS Code。
八、打开 Codex 面板
VS Code 重新启动后，点击界面中的 Codex 小图标，打开插件面板。
如果看不到图标，请检查：
- Codex 扩展是否已启用
- 当前 VS Code 窗口是否禁用了该扩展
- 活动栏图标是否被隐藏
- 是否需要重新加载窗口
首次打开工作区时，VS Code 可能询问是否信任当前目录。只对来源明确、内容可信的项目授予工作区信任。
九、发送第一条测试消息
打开 Codex 面板后，先发送一条不会修改文件的简单请求：
text
请分析当前项目的目录结构，只说明主要目录的用途，不要修改文件。确认插件能够正常返回后，再发送最小验证消息：
text
请只回复：VS Code Codex 接入成功
如果 Codex 请求修改文件或运行命令，请先检查操作内容，再选择允许或拒绝。不要在首次测试时直接批准大范围修改。
十、检查应天AI调用日志
- 请求时间是否与测试时间一致
- 实际调用模型是否正确
- 请求状态是否成功
- Token 消耗是否符合预期
VS Code 中有回复且控制台能看到对应日志，才说明 Codex 插件已经通过应天AI Provider 发起请求。
常见问题
安装了错误的 Codex 扩展
卸载名称相似的第三方扩展，重新在扩展市场搜索 Codex，并核对发布者为 OpenAI。
安装后没有 Codex 图标
确认扩展已启用，然后重新加载 VS Code。也可以右键活动栏，查看 Codex 入口是否被取消显示。
插件一直显示登录页面
先确认 CC Switch 中应天AI Codex Provider 已经启用，再重新加载 VS Code。不要把应天AI API Token 输入 ChatGPT 账号登录页面。
CC Switch 已启用，但插件仍使用旧服务
完全关闭所有 VS Code 窗口，再重新打开项目。如果电脑中同时运行多个 VS Code 窗口，应全部关闭，避免后台扩展进程继续使用旧配置。
导入后 CC Switch 中没有 Provider
确认导入时选择的是 Codex，而不是 Claude 或 Gemini。可以重新从应天AI API 密钥页面发起导入。
返回 401 或 API Key 无效
检查 Token 是否完整、是否已过期或停用，以及 Token 前后是否混入空格、换行或引号。不要把应天AI Token 填到 ChatGPT 登录页面，也不要把账号密码当作 API Token 使用。
返回 403 或模型无权限
检查当前 Token 是否允许访问所选模型、是否设置了 IP 白名单，以及账号余额或 Token 配额是否充足。可以在应天AI模型广场确认当前可用模型。
返回 404 或接口地址错误
确认 Provider 使用的是应天AI提供的 Codex 兼容接口，不要把控制台网页地址当作 API 地址，也不要重复拼接 /v1。如果是手动修改过 Provider，请优先重新从应天AI Token 页面导入。
插件有回复，但应天AI没有日志
这通常表示请求没有到达应天AI，或者当前 VS Code 使用的不是目标 Provider。检查 CC Switch 中的当前配置、VS Code 是否已重载，以及本机代理和网络设置。
日志中模型名称不正确
重新打开模型广场，复制模型的完整标识。修改 Provider 后重新启用配置，再完全关闭并打开 VS Code。
使用建议
- 第一次使用时，建议打开一个测试项目，不要直接操作重要生产仓库。
- 先发送只读分析请求，再尝试修改文件或运行命令。
- 对扩展提出的文件修改、终端命令和网络操作逐项确认。
- 在 CC Switch 切换 Provider 后，重新加载 VS Code，避免扩展继续使用旧配置。
- 定期查看应天AI使用日志，及时发现异常调用。