Codex IDE 扩展安装与登录

IDE 扩展适合你正在编辑器里看代码、选代码、改局部逻辑的时候使用。

前置教程：什么时候优先用 IDE 或 Cloud
如果你还不知道 IDE 扩展适合什么任务，先完成前置教程。

依据来源：OpenAI Codex 官方手册中的 Codex IDE extension、IDE settings、Configuration、Authentication 等章节。

你会学到什么

完成本篇后，你应该能做到：

在 VS Code 或 Cursor 里安装 Codex 扩展。
找到 Codex 侧边栏入口。
完成登录。
知道 IDE 扩展和 CLI、桌面版共享配置层。
知道第一次不要直接让它改文件。

第 1 步：确认你适合用 IDE 扩展

IDE 扩展适合这些场景：

解释当前文件。
解释选中的代码。
修改当前文件的一小段逻辑。
根据当前打开文件提问。
在编辑器里边看边问。

如果你的任务是完整项目交付，比如读项目、改多个文件、跑构建、提交前检查，CLI 或桌面版会更稳。

第 2 步：打开扩展市场

打开 VS Code 或 Cursor。

找到左侧的扩展入口。

常见方式：

点击左侧扩展图标。
在搜索框输入：

Codex

找到 OpenAI Codex 相关扩展。
点击安装。

只安装官方来源的 Codex 扩展。不要安装来路不明、名字相似的第三方扩展。

第 3 步：找到 Codex 侧边栏

安装完成后，在 VS Code 中，Codex 通常会出现在侧边栏。

如果你用的是 Cursor 或其他 VS Code 兼容编辑器，Codex 可能不会自动出现在你熟悉的位置。

你可以检查：

左侧活动栏。
右侧侧边栏。
命令面板。

官方手册提到，在 VS Code forks 里，可能需要把 Codex 图标手动拖到右侧边栏。

第 4 步：打开项目文件夹

不要在空窗口里测试。

请打开一个安全练习项目。

建议用你前面准备的目录：

D:\codex-lab\hello-codex

或者你自己的练习项目。

要求：

不包含真实 API Key。
不包含客户数据。
改坏了可以重来。
最好有 Git。

第 5 步：完成登录

打开 Codex 面板后，如果提示登录，就按页面提示完成登录。

常见登录方式：

ChatGPT 账号登录。
OpenAI API Key 登录。

新手优先选择 ChatGPT 账号登录。

API Key 登录适合你已经清楚费用、权限和密钥管理边界的情况。

第 6 步：理解它和 CLI、桌面版的配置关系

Codex IDE 扩展不是完全独立的一套配置。

官方手册说明，IDE 扩展使用和 CLI 相同的 agent，并共享配置层。

你需要记住：

~/.codex/config.toml

这个文件会影响：

CLI。
IDE 扩展。
桌面版。

常见共享内容包括：

默认模型。
provider 配置。
审批和沙箱相关偏好。
MCP 等配置。

如果你已经完成了：

那么 IDE 扩展通常可以复用这些配置。

第 7 步：确认能打开配置文件

在 IDE 扩展里，通常可以从齿轮或设置入口打开 config.toml。

你要找类似：

Codex Settings。
Open config.toml。
MCP settings。
设置。

如果找不到，也可以在资源管理器里打开：

C:\Users\你的用户名\.codex\config.toml

第 8 步：第一次不要直接改文件

安装和登录完成后，不要马上说：

帮我优化这个项目。

这太大了。

第一次只做只读验证：

请只读说明当前打开的项目是什么类型。
不要修改任何文件。
请告诉我你能看到哪些打开文件或选中代码上下文。

如果 Codex 能正常回答，说明 IDE 扩展已经可以开始使用。

常见问题

我装了 CLI，还需要装 IDE 扩展吗

不一定。

如果你经常在编辑器里对当前文件提问，IDE 扩展很有价值。

如果你主要做完整项目任务，CLI 和桌面版已经够用。

IDE 扩展和 Cursor 自带 AI 有什么区别

本站只讲 Codex 的使用方法。

你可以把 Codex IDE 扩展当成一个在编辑器里的 Codex 入口。它的优势是能和 Codex 的本地配置、模型、审批和沙箱体系结合。

IDE 扩展能用国内大模型配置吗

可以按 Codex 配置层思路复用。

但和桌面版一样，IDE 扩展不一定继承终端里的临时环境变量。需要密钥时，优先检查 ~/.codex/.env 和 ~/.codex/config.toml。

本篇验收

完成后，你应该得到这些结果：

IDE 扩展已安装。
你能找到 Codex 面板。
已完成登录。
已打开一个练习项目。
已完成第一次只读验证。

下一篇看：IDE 里第一次解释当前文件。