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

如果你不想使用命令行工具，也可以在 IDE 里通过插件来使用 Codex。本文就专门讲清楚如何在 VS Code 里完成安装、配置和调用。

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，CLI 才能真正使用。国内网络建议（推荐）

由于网络原因，部分国内用户可能无法稳定连接官网地址，建议使用中转 Key。
https://codex.dakeai.cc/register?promo=DKAI

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

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

这套方法对 Claude Code 的 VS Code 扩展同样适用。

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，即可调用成功。

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 国内用户登录失败解决办法（官网登录卡住/localhost 拒绝连接）

07. 常见使用建议

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

08. 继续阅读

推荐继续阅读

Codex CLI 常用命令详解（含示例）