Appearance
Codex CLI 国内安装教程：Windows/Mac 登录、Pro 额度与常见问题
最后更新：2026 年 6 月 26 日。本文面向想在本地终端使用 Codex 的开发者，重点讲安装、登录、额度和常见问题。
Codex CLI 是 OpenAI 的本地命令行编程助手。它可以在你的项目目录中运行，读取代码、提出修改、执行命令并协助验证结果。对开发者来说，CLI 的好处是直接、轻量、适合和 Git、npm、pnpm、pytest、VitePress 等工作流结合。
如果你不想自己处理 ChatGPT Pro、Codex 额度和国内连接问题，可以查看：
zeogpt 当前支持 Codex，适合想使用 ChatGPT Pro 和 Codex 额度的国内用户。
一、安装前准备
建议先准备好：
- Node.js 和 npm
- Git
- 一个可以测试的小项目
- 可用的 ChatGPT 账号或 Codex 连接方案
- 项目代码已经提交到 Git
不要一开始就在重要生产目录里测试。可以先新建一个 demo 项目，确认 codex 命令、登录、读取文件、运行命令都正常。
二、Windows 安装 Codex CLI
方法一：npm 安装
打开 PowerShell 或 Windows Terminal：
powershell
npm install -g @openai/codex检查安装结果：
powershell
codex --version进入项目目录：
powershell
cd D:\your-project
codex如果能看到 Codex 的交互提示，说明安装成功。
方法二：官方安装脚本
OpenAI Codex GitHub 仓库也提供 Windows PowerShell 安装脚本。使用脚本前，建议先确认脚本来源是 OpenAI 官方页面，并了解它会在本机安装什么内容。
Windows 常见问题
| 问题 | 可能原因 | 处理建议 |
|---|---|---|
codex 不是内部或外部命令 | npm 全局目录未加入 PATH | 重新打开终端，检查 npm config get prefix |
| PowerShell 执行受限 | 执行策略限制 | 使用管理员终端或调整执行策略 |
| 登录后回不到终端 | 浏览器授权跳转失败 | 换默认浏览器，重新运行 codex |
| 项目路径读取异常 | 路径权限或中文路径问题 | 用英文路径小项目测试 |
| 命令运行失败 | 项目依赖未安装 | 先运行 npm install 或查看 README |
三、macOS 安装 Codex CLI
npm 安装
bash
npm install -g @openai/codex
codex --versionHomebrew 安装
bash
brew install --cask codex进入项目目录：
bash
cd ~/projects/your-project
codexmacOS 用户如果遇到权限问题，可以检查终端是否有访问项目目录的权限，尤其是桌面、文稿、下载等受系统保护的目录。
四、Linux 安装 Codex CLI
Linux 用户通常用 npm 安装：
bash
npm install -g @openai/codex
codex --version如果是服务器环境，建议注意：
- 不要在生产服务器上直接让 Codex 修改核心代码。
- 不要把私钥、数据库密码、生产环境变量暴露给 AI。
- 先在本地或测试环境跑通流程。
五、Codex CLI 怎么登录？
首次运行：
bash
codex根据提示选择登录方式。
使用 ChatGPT 账号
适合已经有 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 等计划的用户。官方仓库说明推荐用 ChatGPT 账号登录，以便把 Codex 纳入对应计划中使用。
使用 API Key
适合更偏自动化和开发者接口的用户。API Key 方式需要单独配置，计费和 ChatGPT 订阅不是同一套体系。新手不建议一上来就混用两种方式。
使用 zeogpt
如果你主要在国内使用，并且需要 ChatGPT Pro 和 Codex 额度，可以看：
它更适合不想反复处理官网登录、会员开通和额度选择的用户。具体连接方式和套餐以 zeogpt 页面说明为准。
六、Pro 额度怎么选？
Codex CLI 的消耗和普通聊天不同。它可能需要多轮读取文件、生成补丁、运行构建、分析错误，因此开发任务越复杂，额度消耗越明显。
| 用户类型 | 使用方式 | 额度建议 |
|---|---|---|
| 轻度用户 | 偶尔解释代码、改文档 | 先用基础方案试水 |
| 内容站长 | 改 VitePress、写脚本、跑构建 | 关注稳定性和可用额度 |
| 前端开发者 | 高频改页面、修 bug | 选择更高 Codex 额度 |
| 全栈开发者 | 接口、数据库、测试、部署 | 优先考虑 Pro 和补充额度 |
| 团队用户 | 多人协作和长期项目 | 关注账号、权限和用量管理 |
如果你已经确定 Codex 会成为日常开发工具，建议直接把“额度是否够用”放在第一位，而不是只看能不能登录成功。
七、第一次使用建议
先让 Codex 只读项目
text
请先阅读项目结构，不要修改文件。
总结技术栈、启动命令、构建命令、测试命令和主要目录。再让它做小修改
text
请只修改 README，补充本地启动步骤。
不要修改 package.json 和源代码。最后让它验证
text
请运行构建命令并解释结果。
如果失败，不要直接大改，先说明原因。这个流程可以帮你判断 Codex 是否理解项目，也能降低误改风险。
八、常见问题
Codex CLI 和 Codex App 有什么区别？
CLI 更适合终端用户，App 更适合想用桌面界面管理任务的人。开发者如果已经习惯命令行，CLI 上手更快。
Codex CLI 可以在 VS Code 里用吗？
可以在 VS Code 终端里运行 CLI；如果想要更贴近编辑器的体验，也可以查看 Codex IDE 扩展。
国内安装 Codex 最容易卡在哪里？
Windows PATH、PowerShell 执行策略、浏览器登录跳转、账号计划和额度选择。
zeogpt 是官方官网吗？
不是。zeogpt 是第三方服务，但它当前支持 Codex，适合国内用户了解 ChatGPT Pro 和 Codex 额度方案。
九、总结
Codex CLI 适合真正想把 AI 放进开发流程的人。你可以用它读项目、改文件、运行命令、写测试和检查错误。
国内用户建议按这个顺序来：
- 先用 npm 或官方方式装好 Codex CLI。
- 用小项目测试登录和基本命令。
- 明确自己需要的 ChatGPT Pro 和 Codex 额度。
- 如果官方路线太折腾，再了解支持 Codex 的 zeogpt。
把安装跑通只是第一步，真正提升效率的是后续稳定地让 Codex 参与小步开发和验证。