多端安装共存

6.1 桌面 App 安装

Codex 桌面应用(也叫 Codex App)是 OpenAI 推出的图形化客户端,支持 macOS 和 Windows。

macOS

• 从 chatgpt.com/codex 下载 dmg 安装包
• 或从 Mac App Store 搜索安装

Windows

• 从 Microsoft Store 搜索 “Codex” 安装
• 或从官网下载安装包

桌面 App 在 2026 年的更新中已从纯 AI 编程工具进化为支持 Computer Use、插件市场、内置浏览器的“超级 App”。

6.2 IDE 插件安装

Codex 提供 IDE 扩展,支持主流编辑器:

• VS Code:在扩展市场搜索 “Codex” 安装
• Cursor:同样搜索 Codex 扩展
• Windsurf:支持 Codex 集成

从 IDE 打开 config.toml

1. 点击编辑器右上角的齿轮图标
2. 选择 Codex Settings(Codex 设置)
3. 选择 Open config.toml(打开 config.toml)

💡 CLI 与 IDE 扩展共用同一个 config.toml 文件,配置互通,不需要重复设置。

6.3 CLI 与桌面版共存配置

CSDN 教程指出,桌面版和 CLI 可以共存安装,但需要注意:

1. 先安装 CLI,再装桌面版,避免冲突
2. 两者共用 ~/.codex/ 目录下的配置和 token
3. 不要同时在两端操作同一个项目的同一个文件(用 git worktree 隔离,见第 20 章)

6.4 Codex Companion 插件(IDE ↔ CLI 联动)

编程指北推荐的 Codex Companion 插件,可以让 IDE 与 CLI 深度联动:

• 在 IDE 侧边栏用 @codex 直接对话
• Alt+G 把 IDE 中选中的代码扔进 CLI,无需复制粘贴
• IDE 编辑与 CLI 命令无缝衔接

适合“在 IDE 里看代码,在 CLI 里跑 Codex”的混合工作流。

6.5 中文界面设置

部分教程提到 Codex 可以设置中文回复。在 ~/.codex/config.toml 中可以加入指令让 Codex 用中文交流(具体配置项见第 7 章)。也可在 AGENTS.md 中写明:

## 语言约定
- 所有回复使用中文
- 代码注释使用中文
- 变量名、函数名保持英文

6.6 首次启动流程

无论哪个端,首次启动的通用流程:

1. 打开 Codex(CLI 输入 codex / IDE 启动扩展 / 桌面打开 App)
2. 用 ChatGPT 账号登录(见第 5 章)
3. 进入交互界面
4. 用 /model 切换模型(默认是 gpt-5-codex medium)
5. 输入第一个 prompt 测试

CLI 下的首个命令示例:

codex "写一个下载文件的 Python 脚本"

资料来源

• 编程指北 csguide.cn——VS Code 联动与 Codex Companion 插件
• CSDN《Codex 桌面版与 CLI 共存安装全攻略》——先 CLI 后桌面版
• 头条《Codex 零基础实战教程》——桌面 App 进化为超级 App
• 官方文档 developers.openai.com/codex——IDE 扩展打开 config.toml 路径