Codex VSCode 使用指南

推荐

建议使用 CC-Switch 可视化管理工具进行配置，无需手动编辑配置文件，一键完成 OpenToken 接入。

前提条件

在阅读下列指南前，请保证你已经按照对应系统配置好了 Codex CLI 并可以正常使用。

(一) VSCode 安装（版本 >= 1.75.2）

  • 访问 VSCode 官网 下载所需版本

  • 在扩展中安装Codex – OpenAI's coding agent

  • 到 .codex 文件夹下创建 auth.json 和 config.toml 文件（如果没有这两个文件，请自行创建）

Windows 下路径为： C:/Users/你的用户名/.codex

Linux 或 macOS 系统中通常位于： ~/.codex

auth.json

{
  "OPENAI_API_KEY": "你的API密钥"
}

config.toml

model_provider = "opentoken"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
[model_providers.opentoken]
name = "opentoken"
base_url = "https://opentk.ai/v1"
wire_api = "responses"
env_key = "key88"
requires_openai_auth = true

注意 env_key 只能是环境变量中的名称，不能放完整的令牌（密钥），令牌要放到环境变量中。

如果你放了完整的令牌（密钥）使用时会报错找不到令牌或者令牌配置错误。

requires_openai_auth = true 可以让你在插件中切换模型。

(二) 设置环境变量

在你的环境变量中设置 key88="你的API密钥"：

Linux/Mac：

export key88='你的API密钥'

Windows：

$env:key88 = "你的API密钥"

永久设置方法参考 Windows、Linux、Mac 的配置指南。

配置文件说明

文件用途
auth.json存储 API 密钥
config.tomlCodex 配置（模型、提供商等）

确保两个文件都正确配置后，VSCode 扩展即可正常使用。