Codex VS Code

本页覆盖 Codex 在 VS Code 工作流中读取默认 .codex 配置的方式。先完成 Codex CLI 与桌面应用 的安装和专用 Key 创建，再安装当前官方发布的 Codex VS Code 扩展或按该版本的官方方式连接 Codex。

准备条件

1. 在控制台创建只供这一台 VS Code 环境使用的 API Key。
2. 用该 Key 请求 GET /v1/models，记录一个实际返回的模型 ID。
3. 不要把 auth.json、Key 或工作区私有提示词写进 .vscode、项目 .env、截图或仓库。

curl 'https://ai.tavonilo.com/v1/models' \
  -H "Authorization: Bearer $AI_SHOP_API_KEY"

系统差异

• Windows：配置位于 %USERPROFILE%\.codex\；使用 Windows 用户目录，不要假定 WSL 配置会自动同步。
• macOS：配置位于 ~/.codex/，属于当前登录用户。
• Linux / WSL：配置位于 Linux 用户的 ~/.codex/；WSL 不读取 Windows 的 %USERPROFILE%。

安装或更新扩展后，完全退出 VS Code 并重新打开窗口。扩展、集成终端和桌面应用可能保留独立进程。

配置

优先使用控制台 API Keys -> 使用密钥 为当前 Codex 版本生成的 config.toml 与 auth.json。典型的协议部分如下，模型必须替换为当前 Key 返回的 ID：

model_provider = "OpenAI"
model = "your-console-model"

[model_providers.OpenAI]
base_url = "https://ai.tavonilo.com"
wire_api = "responses"
requires_openai_auth = true

Codex 使用站点根地址，不填写 /v1 或完整 /responses 地址。auth.json 由控制台生成并保存在同一目录；它是凭据文件，不能提交到工作区。

最小验证与恢复

在 VS Code 中选择当前 Key 可见的模型，发送一条短小、非敏感请求，例如“只回复 connected”。确认基础对话后，再启用编辑、工具和长任务。

• 401：检查 auth.json 是否来自该专用 Key，并完全重启 VS Code。
• 403：检查模型列表、分组、余额与订阅。
• 404：恢复根 Base URL，不要追加第二个 /v1。
• 429：等待并降低并发，不要自动重放长任务。
• 5xx 或超时：记录时间、模型、路由、HTTP 状态和 request ID；取消或超时不等于上游未处理。

参见 Codex、模型列表 和 错误码与排障。