跳转到主要内容
Codex VS Code 插件可以复用 Codex CLI 的本机配置。你需要先按 Codex CLI 页面写入 config.toml 和 auth.json，再安装 Codex 的 VS Code 插件。 如果你已经按 Codex 页面完成配置，可以直接安装插件并重启 VS Code。无需重新创建 API Key。

​
准备工作

  • 已完成 创建账号。
  • 已完成 获取 API Key。
  • 已安装 VS Code。
  • 已按 Codex 页面完成 Codex CLI 配置。
  • 已从控制台打开目标 API Key 的 使用密钥 弹窗。
auth.json 中的 API Key 是明文保存的本机凭证。不要把 ~/.codex/auth.json、截图或终端输出提交到仓库，也不要发到聊天工具里。

​
安装 Codex CLI 配置

先完成 Codex CLI 配置。这一步会把 4096bytes 的接入参数写入 Codex 的本机配置目录。
系统config.tomlauth.json
macOS / Linux~/.codex/config.toml~/.codex/auth.json
Windows%USERPROFILE%\.codex\config.toml%USERPROFILE%\.codex\auth.json
model、review_model、base_url 和 API Key 都以控制台显示为准。字段含义见 Codex 页面。 如果你在 WSL 中使用 VS Code Remote - WSL，请把配置写入 WSL 用户目录下的 ~/.codex/。

​
安装 VS Code 插件

1

打开 VS Code 扩展面板

在 VS Code 中打开 Extensions 面板。
2

安装 Codex 插件

搜索 OpenAI 发布的 Codex 插件，并点击 Install。
3

重启 VS Code

安装完成后关闭所有 VS Code 窗口，再重新打开项目。
4

使用 Codex

在 VS Code 中打开 Codex 插件入口。插件会读取本机 Codex 配置。

​
验证

打开一个本地项目，在 VS Code 的 Codex 插件里发送一个低风险任务： 
请用一句话说明当前项目用途，不要修改文件。
如果插件可以正常回复，并且没有认证失败或找不到模型的错误，说明配置已生效。

​
常见问题

不需要。Codex VS Code 插件读取同一套 ~/.codex/ 配置。安装插件后重启 VS Code 即可。
确认新的配置放在 config.toml 文件开头。保存后关闭所有 VS Code 窗口，再重新打开。
检查 auth.json 是否是合法 JSON。确认 API Key 没有漏字符、换行或多余空格。
如果项目运行在 WSL 环境，配置 WSL 的 ~/.codex/，不要只改 Windows 的 %USERPROFILE%\.codex\。