乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > 根据官方文档和个人使用经验整理,Codex 安装保姆级教程

根据官方文档和个人使用经验整理,Codex 安装保姆级教程

当前时间： 2026-06-02 19:04:04 更新时间： 2026-06-02 分类：软件教程 评论(0)

根据官方文档和个人使用经验整理,Codex 安装保姆级教程

最近我重新整理了一遍 Codex 官网。
我发现第一次接触 Codex 的人，很容易卡在第一个问题：
Codex 到底怎么安装？
是下载桌面软件？
还是装 VS Code 插件？
还是打开终端，输入一行命令？
表面上看，这只是一个安装问题。
但本质上，真正容易把人劝退的，是入口太多。
所以这篇不讲复杂功能。
只做一件事：
帮你把 Codex 安装好，然后跑通第一个小任务。

第一步：先选一个入口

根据 OpenAI 官方 Quickstart，Codex 目前有几种入口：
  1. Codex App：桌面应用。
  2. IDE 扩展：安装到 VS Code、Cursor、Windsurf 等编辑器中。
  3. Codex CLI：在终端中使用。
  4. Codex Cloud：在浏览器中使用。
如果你第一次使用，我的建议很直接：
先装 Codex App。
官方 Quickstart 也把 App 标记为推荐选项。
它更直观。
不要求你先熟悉终端命令。

你可以像打开一个普通桌面软件一样，选择项目文件夹，然后直接开始对话。

第二步：Windows 用户安装 Codex App

Windows 用户有两种安装方式。

方法一：Microsoft Store

如果你不想碰命令行，直接打开官方商店页面：
[在 Microsoft Store 中打开 Codex]
然后点击安装。
安装完成后，从开始菜单打开 Codex。

方法二：winget 命令

如果你会使用 PowerShell 或 Windows Terminal，打开终端，输入：
winget install Codex -s msstore
按回车，等待安装完成。
Windows 版 Codex App 的界面大致如下：

第三步：Mac 用户安装 Codex App

macOS 用户先确认自己的芯片。
点击屏幕左上角苹果图标，再点击“关于本机”。
如果看到 Apple M1、M2、M3、M4 等字样，下载 Apple Silicon 版本：
[下载 macOS Apple Silicon 版本]
(https://persistent.oaistatic.com/codex-app-prod/Codex.dmg)
如果看到 Intel，下载 Intel 版本：
[下载 macOS Intel 版本]
(https://persistent.oaistatic.com/codex-app-prod/Codex-x64.dmg)
下载完成后：
  1. 双击 `.dmg` 文件。
  2. 将 Codex 拖入 Applications 文件夹。
  3. 打开 Codex。
—

第四步：登录，然后跑通第一个任务

安装完成后，打开 Codex，使用 ChatGPT 账号登录。
然后先选一个练习项目。
不要一上来就让它修改几十个文件。
先让它做一个足够小的动作。
例如：
请先阅读这个项目，然后用简单的话告诉我：1. 这个项目是做什么的？2. 主要文件有哪些？3. 如果我要开始修改，应该先看哪个文件？
这里有一个很重要的习惯：
先让 Codex 解释，再让 Codex 修改。
先确认它理解项目。
再让它改一个文件。
最后检查它改了什么。
这比一上来研究所有功能更有效。

第五步：需要时，再安装 IDE 扩展

如果你平时经常在 VS Code、Cursor 或 Windsurf 中写代码，可以再安装 Codex IDE 扩展。
步骤很简单：
  1. 打开编辑器。
  2. 打开扩展市场。
  3. 搜索 `Codex`。
  4. 安装 OpenAI 提供的 Codex 扩展。
  5. 按照提示登录 ChatGPT 账号。
IDE 扩展适合这些动作：
  • 解释当前文件。
  • 修改一个具体函数。
  • 生成测试。
  • 根据当前上下文继续写代码。

第六步：熟悉终端后，再安装 CLI

如果你习惯终端，可以安装 Codex CLI。
先确保电脑已经安装 Node.js 和 npm。
然后输入：
npm install -g @openai/codex
安装完成后，输入：
codex
第一次启动时，按照提示使用 ChatGPT 账号或 API key 登录。
macOS 用户也可以使用 Homebrew：
brewinstall--caskcodex
需要注意：
OpenAI 官方文档目前仍将 Windows 上的 Codex CLI 标记为实验性支持。
如果你主要使用 Windows，优先安装 App。
如果你确实要在 Windows 中使用 CLI，官方建议在 WSL 工作区中使用。

最后：不要把安装变成新的拖延

我现在越来越觉得，AI 工具最容易出现一个问题：
收藏了很多。
研究了很多。
真正跑通的任务却很少。
所以安装 Codex 的最小版本，不是把 App、IDE、CLI 全部装一遍。
而是今天先完成这 5 步：
选择入口 -> 安装 App -> 登录账号 -> 打开一个练习项目 -> 让 Codex 解释 README
先跑通。
再慢慢加复杂度。