跳到主要内容

Codex VSCode 使用指南

前提条件

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

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

  1. 访问 VSCode 官网 下载所需版本

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

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

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

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

auth.json​

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

config.toml​

model_provider = "bytecatcode"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.bytecatcode]
name = "bytecatcode"
base_url = "https://bytecatcode.org/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 扩展即可正常使用。