免费试用
各种插件/软件使用教程 / VS Code 中使用 Codex 插件

VS Code 中使用 Codex 插件

本教程介绍如何在 VS Code 中安装 Codex 插件，并通过 QuickRouter API 中转在国内使用 Codex。配置完成后，可在 VS Code 内调用 GPT、Claude 等 400+ 模型进行 AI 编程。

本教程适用场景
  • 想在 VS Code 中使用 Codex 插件进行 AI 编程的用户
  • 希望把 Codex 的请求指向 QuickRouter 中转，实现国内直连
  • 搜索「VS Code Codex 配置」「Codex 中转 API」「Codex config.toml」的用户
说明：QuickRouter 是独立的第三方 API 聚合服务，与 OpenAI、VS Code 等品牌不存在官方隶属或授权关系。Codex 是 OpenAI 提供的编程工具，本教程仅介绍如何在 VS Code 插件中配置 QuickRouter 中转。

一、前置条件

项目说明
VS Code已安装 Visual Studio Code
Codex 插件在 VS Code 扩展市场搜索并安装 Codex
QuickRouter 账号在 api.quickrouter.ai 注册
QuickRouter API Key在控制台「令牌管理」创建 sk-... token
模型权限token 中放行要使用的模型（如 gpt-5.5、claude-opus-4-8）

二、安装 Codex 插件

打开 VS Code，进入扩展市场（左侧边栏的扩展图标，或快捷键 Ctrl+Shift+X / Cmd+Shift+X），搜索 Codex，点击安装。

在 VS Code 扩展市场安装 Codex

三、编辑 Codex 设置

安装完成后，打开 Codex 的设置页面。可以通过命令面板（Ctrl+Shift+P / Cmd+Shift+P）输入 Codex 快速定位设置项。

编辑 Codex 设置

四、配置 config.toml 指向 QuickRouter

这是关键步骤。Codex 使用 config.toml 配置文件（位于用户目录下的 .codex/config.toml）。需要在文件顶部添加 QuickRouter 作为模型提供商。

在 config.toml 顶部添加 QuickRouter 配置

在 config.toml 顶部添加以下配置：

~/.codex/config.toml
model_provider = "quickrouter"

[model_providers.quickrouter]
name = "quickrouter"
base_url = "https://api.quickrouter.ai/v1"
env_key = "OPENAI_API_KEY"
字段说明：model_provider 指定使用 quickrouter 提供商；base_url 填 QuickRouter 的 OpenAI 兼容接口（需带 /v1）；env_key 指定从哪个环境变量读取 API Key。

五、使用 QuickRouter API Key 登录

配置好 config.toml 后，打开 Codex 登录界面。选择「使用 API 密钥」方式登录，不要选择 ChatGPT 登录。

选择使用 API 密钥登录

在 API Key 输入框中填入你的 QuickRouter API Key：

填入 QuickRouter API Key

配置项填写内容说明
API Keysk-你的QuickRouter令牌QuickRouter 控制台创建的 API Key

六、选择模型并开始使用

登录成功后，在 Codex 中选择要使用的模型。常用模型参考：

claude-opus-4-8
claude-fable-5
gpt-5.5
grok-4.5
deepseek-v4-pro
glm-5.2

选择模型后，在 Codex 对话框中输入指令即可开始使用。所有请求会通过 QuickRouter 中转，实现国内直连。

七、常见问题排查

现象常见原因处理方式
401 unauthorizedAPI Key 错误或过期检查填入的 QuickRouter API Key 是否正确
403 / model not allowedtoken 未放行该模型在 QuickRouter token 设置中放行对应模型
连接超时base_url 写错确认 base_url 为 https://api.quickrouter.ai/v1（需带 /v1）
仍然走官方config.toml 未生效重启 VS Code，确认配置文件路径为 ~/.codex/config.toml
登录失败选错了登录方式选择「使用 API 密钥」登录，不要选 ChatGPT 登录

相关文档

VS Code Codex 配置要点

如果你通过搜索「VS Code Codex 配置」「Codex 中转 API」「Codex config.toml」进入本页，核心就两步：编辑 ~/.codex/config.toml 把 base_url 指向 QuickRouter，然后用 API Key 方式登录。多数问题出在 base_url 漏了 /v1、选错了登录方式或 token 没放行模型。

配置项填写内容常见问题
model_providerquickrouter需与 [model_providers.xxx] 的名称一致
base_urlhttps://api.quickrouter.ai/v1必须带 /v1，Codex 走 OpenAI 兼容接口
API KeyQuickRouter 的 sk-... 令牌401 通常是 Key 错误或过期
登录方式使用 API 密钥不要选 ChatGPT 登录

相关入口

← VS Code 中使用 Claude Code 插件 CherryStudio调用cluade MCP →