夜雨聆风《Codex 零基础入门》系列 · 第 02 期
本文约 2300 字 · 阅读约 7 分钟 · 适合人群：准备第一次安装 Codex 的新手
上一期我们讲了 Codex 是什么。这一期开始动手——但在装之前，先回答一个常见困惑：Codex 有那么多入口（终端 CLI、浏览器网页、IDE 插件、桌面 App……），到底该装哪一个？
答案是：看你的使用场景。这一期我们会一次讲清楚：四种入口的区别、账号怎么准备、最快上手路径，以及国内用户最常踩的几个坑。
一、先看四种入口：哪个适合你
Codex 不是单个软件，而是一整套工具，背后共享同一个 ChatGPT 账号。先看一张对比表：
除此之外还有 Chrome 浏览器扩展（在网页里让 Codex 帮你做事）和 Slack 集成（团队里 @ 一下让它接活）。这些都不是必选，新手可以暂时忽略。
一个常见误区：不是说选了一个就不能用别的。这些入口共享同一个账号、同一份配置（config.toml），你可以早上在 IDE 插件里写代码，晚上在网页版让它跑长任务，并不冲突。
二、账号准备：一个 ChatGPT 订阅就够了
好消息是：Codex 已经包含在 ChatGPT Plus、Pro、Business、Edu、Enterprise 计划里。不需要单独申请、也不需要 API Key——直接用你的 ChatGPT 账号登录就行。
用量方面（大致参考，可能变化）：
•Plus 用户：约每 5 小时 30–150 条本地消息，另有周限。
•Pro 用户：约每 5 小时 300–1500 条本地消息，另有周限。
•企业版：更高额度，可按组织配置。
如果你完全是 Free 用户，需要先升级到 Plus 或以上。如果你是搞 CI/CD、自动化的开发者，也可以选择用 API Key计费——按 Token 走，更适合无人值守的场景，但日常入门用账号登录就够了。
三、最快路径：装 CLI 并跑通登录
如果你只想最快感受一下 Codex 是什么样子，建议从 CLI 开始——它最轻量，能马上看到效果。
macOS（推荐 Homebrew，最省心）：
brew install --cask codex codex --version codex |
或者用 npm（需要先装 Node.js 22+）：
npm install -g @openai/codex codex --version codex |
Windows：原生支持，在 PowerShell 里直接跑，不需要 WSL。也可以用 WSL2 如果你更习惯 Linux 环境。
Linux：用 npm 装即可，方法和 macOS 一样。
第一次运行codex时会弹出登录提示，选Sign in with ChatGPT，它会自动打开浏览器让你登录。完成后回到终端，会话就建立好了。整个过程不需要复制粘贴 API Key。
四、国内用户的几个坑（认真看，能省半天）
•网络是头号问题：Codex 与 OpenAI 服务通信，需要稳定可访问的网络环境。如果连 ChatGPT 都打不开，Codex 也用不了，先解决基础网络再装。
•npm 镜像可以用：如果 npm 下载慢，可以临时改成国内源（如 npmmirror.com）。但要注意——首次登录走的是浏览器 OAuth，那一步必须能访问 OpenAI 的认证页面。
•企业代理/防火墙：如果公司网络对 TLS 做中间人检查，OAuth 登录可能完不成。这种情况下改用 API Key 登录会更稳。
•配置目录：Codex 把配置和凭证放在 ~/.codex/ 目录下（Windows 是用户目录下的对应位置）。如果哪天想重置，删掉这个目录或运行 codex auth logout 就行。
五、其他入口要不要装？
•桌面 App：如果你不熟悉终端，直接装桌面 App 体验也很好。去官方 Codex 页面（chatgpt.com/codex）下载对应平台的版本——macOS 注意区分 Apple Silicon 和 Intel。
•IDE 插件：在 VS Code / Cursor / Windsurf 的扩展商店里搜 “OpenAI Codex” 装上即可。同一个账号登录，和 CLI 完全互通。
•云端网页版：不用装，直接访问 chatgpt.com/codex 就能用。适合派发长任务、用手机也能查看。
建议的顺序：先 CLI 装上跑通，理解工作方式；之后再根据自己日常的工作方式补装 IDE 插件或桌面 App。一次都装齐没必要。
本期小结
•Codex 有四种主要入口（CLI、云端网页、IDE 插件、桌面 App），共享同一账号和配置，可以混用。
•ChatGPT Plus 及以上订阅直接登录即可使用，不需要 API Key。
•最快上手路径：brew 或 npm 装 CLI，跑一次 codex 触发浏览器 OAuth 登录。
•国内用户重点关注网络环境，npm 镜像可换，但 OAuth 登录步骤必须能通到 OpenAI。
下期预告
第 03 期我们正式开跑——《第一次用 Codex：从“会聊天”到“会干活”》，带你跑通从“它读你的项目”到“它帮你改代码”的完整闭环，并讲清楚交互模式、斜杠命令这些必备基础。 |
参考来源（官方）
OpenAI Developers：Codex Quickstart（developers.openai.com/codex/quickstart）
OpenAI Developers：Codex CLI 文档（developers.openai.com/codex/cli）
GitHub：openai/codex 仓库（github.com/openai/codex）
npm：@openai/codex 包页面（npmjs.com/package/@openai/codex）
OpenAI：Codex 产品页（chatgpt.com/codex）
本文基于公开资料整理，Codex 功能更新较快，具体请以官方最新文档为准。