VS Code配置Codex教程:安装扩展并接入自定义API

视频演示VS Code安装OpenAI官方Codex扩展、打开config.toml、配置88API自定义模型服务,并说明Remote SSH服务器环境的配置区别。

VS Code 中使用 Codex,首先要安装 OpenAI 官方 Codex 扩展,然后根据登录方式选择 ChatGPT 账号登录或自定义 API。本文按视频演示,介绍扩展安装、config.toml 配置、88API 接入和远程服务器环境下的注意事项。

先确认用途:ChatGPT账号登录使用会员权益;自定义 API 使用 API 服务商余额。本文演示的 88API 地址为 https://88api.ai/v1,两种计费体系互不通用。

第一步:安装官方Codex扩展

  1. 打开 VS Code 左侧“扩展”面板。
  2. 搜索 Codex
  3. 确认发布者为 OpenAI,安装“Codex - OpenAI's coding agent”。
  4. 安装完成后,侧栏会出现 Codex 入口。

第二步:打开Codex配置文件

进入 Codex 设置中的 Configuration,点击打开 config.toml。如果设置页没有入口,也可以在当前系统用户的 ~/.codex/config.toml 中进行配置。

第三步:填写自定义API配置

下面是与视频流程对应的示例。模型名要根据 88API 控制台实际开放情况调整,API Key 必须替换成自己的:

model = "gpt-5.5"
model_provider = "88api"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.88api]
name = "88API"
base_url = "https://88api.ai/v1"
api_key = "sk-替换成你自己的API密钥"
wire_api = "responses"
不要直接照抄模型名:如果你的 Key 分组没有 gpt-5.5 权限,请使用控制台真实显示的 Codex 兼容模型,否则会提示模型不存在或没有权限。

第四步:重载VS Code并打开项目

保存配置后,执行 VS Code 的“Developer: Reload Window”,或者完全退出再打开。随后用“打开文件夹”载入项目,进入 Codex 侧栏新建会话,发送一个简单的代码解释或文件检查任务测试连接。

远程服务器环境需要注意什么?

如果使用 Remote SSH 连接服务器,扩展和配置可能需要安装、保存到远程环境,而不是本地电脑。确认扩展页面显示“安装到 SSH 主机”,并检查远程用户的 ~/.codex/config.toml。本地配置不会自动等同于服务器配置。

常见问题

VS Code里搜索到很多Codex扩展,应该装哪个?

优先安装发布者为 OpenAI 的官方 Codex 扩展,避免只根据名称选择第三方同名插件。

保存配置后为什么没有生效?

确认修改的是当前运行环境对应用户的配置文件,然后重载 VS Code。Remote SSH 场景要特别检查本地和远程配置是否混淆。

提示401或认证失败怎么办?

检查 API Key 是否完整、是否启用,以及 Base URL 是否为 https://88api.ai/v1

提示模型不可用怎么办?

在 88API 控制台核对当前 Key 分组可用模型,把 model 改成准确的模型 ID。

需要查看更完整的一键脚本和手动配置说明,可继续阅读 Codex如何配置API登录