VSCode 使用 Codex 教程：安装插件、配置 Key 与登录问题解决

01. VS Code 是什么？

VS Code（Visual Studio Code） 是 Microsoft 推出的免费代码编辑器。你可以把它理解为一个专门用于写代码和管理项目的工作台。

它本身不局限于某一种语言，而是通过插件支持：

• 前端开发（HTML / CSS / JavaScript）
• 后端开发（Python / Node.js / Go 等）
• 脚本与自动化
• Web、桌面应用等多类项目

VS Code 的特点是轻量、灵活、扩展性强，非常适合和 AI 编程助手搭配使用。

02. Codex 是什么？

Codex 是面向编程场景的 AI 编程助手与代码能力组合，相比普通聊天助手，更擅长：

• 理解代码结构和上下文
• 根据需求生成完整代码
• 修改、补全、重构已有代码
• 解释代码逻辑与报错原因

在 VS Code 中使用 Codex 后，你可以直接在编辑器里：

• 用自然语言描述功能需求
• 让 AI 生成或补全代码
• 基于当前项目做定向修改

你可以把它理解为一个随时可用的编程助手，帮助你更快把想法变成可运行的代码。

03. VSCode 安装 Codex（插件安装）

1. 打开 VS Code。
2. 进入左侧扩展市场（Extensions）。
3. 在扩展商店搜索：Codex – OpenAI’s coding agent，然后点击安装。
4. 安装完成后，右侧活动栏会出现 Codex 图标。

如果此时还无法正常使用，通常是因为还没完成后面的环境配置。

04. Codex 接入 VSCode（Key 与配置）

4.1 先获取可用 Key

安装后必做：先配置 Key，插件才能真正使用。国内网络建议使用中转 Key。

https://codex.dakeai.cc/register?promo=DKAI

4.2 中转站创建密钥并覆盖配置

注册登录后，在 API 密钥页面创建 Codex 分组密钥。然后在“使用密钥”页面，使用“覆盖配置脚本”方法覆盖 Codex 配置，即可开始使用 Codex 插件。

这套方法对 Claude Code 的 VS Code 扩展同样适用，但要注意 Claude Code 应选择对应的 Claude 分组，不要和 Codex 分组混用。

4.3 新建 auth.json

Windows 用户在 C:\Users\你的用户名\.codex\ 目录新建 auth.json，填入：

{
  "OPENAI_API_KEY": "你的API_KEY"
}

4.4 新建 config.toml

依旧在 C:\Users\你的用户名\.codex\ 目录新建 config.toml，填入：

model_provider = "codex"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.codex]
name = "codex"
base_url = "https://codex.dakeai.cc/v1"
wire_api = "responses"
requires_openai_auth = true

保存后重启 VS Code，即可调用成功。

如果 DKAI 控制台提供的 Base URL 或模型名与示例不同，请优先使用控制台实时展示的内容。

05. VSCode 中使用 Codex（最小验证）

重启 VS Code 后，进入 Codex 面板，输入一个最小任务：

请用中文在当前项目中创建一个 hello 接口，并附上调用示例。

如果能正常返回并给出可执行代码，说明 VSCode 中使用 Codex 已经跑通。

06. VSCode Codex 无法登录 / 登录卡住排查

如果你遇到 VSCode Codex 无法登录、登录卡住、回调异常等问题，优先按下面顺序处理：

1. 先确认 auth.json 与 config.toml 路径和内容无误。
2. 确认 OPENAI_API_KEY 是否有效、是否有可用额度。
3. 重启 VS Code 再重试。
4. 仍不稳定时，优先使用 API Key + 中转 URL 方式，减少网页登录链路依赖。

更完整的通用排查可以继续查看 Codex API Key 常见问题，或回到 Codex 国内中转站图文配置教程 检查密钥分组和覆盖配置脚本。

07. 常见使用建议

• 把需求写清楚（输入、输出、边界条件），生成质量会明显更高。
• 先让 Codex 生成最小可运行版本，再逐步迭代。
• 关键代码提交前，自己再做一次审查和本地验证。