Windows上安装Codex CLI完整指南
OpenAI的Codex CLI是强大的终端智能体，但Windows安装有差异。
💡 你将学到
OpenAI的Codex CLI是强大的终端智能体，但Windows安装有差异。
📜 目录
Codex CLI 在 Windows 2026 上的使用：完整安装指南（OpenAI 编程代理）
OpenAI 的 Codex CLI 将驱动 ChatGPT Codex 的编程代理带入了你的终端。它是开源的（Apache-2.0 许可证），目前在 GitHub 上已获得 102,900 颗星。在 Windows 上安装会遇到一些小坑——以下是经过验证的可行路径。
第一步：环境准备
- Node.js 20 或更高版本（用于 npm）
- Windows 版 Git（用于仓库操作）
- OpenAI API 密钥（部分方案也可使用 ChatGPT Plus 订阅）
第二步：安装
npm install -g @openai/codex
codex --version
第三步：身份验证
codex login
这会打开浏览器窗口，让你授权 OpenAI 账户。在 Windows 上，如果浏览器没有自动打开，请手动复制终端中显示的 URL。
第四步：Windows 专属配置
打开终端（建议使用 Git Bash 或 Windows Terminal——普通 cmd 也能用，但 Git Bash 处理路径更可靠）：
codex
然后尝试输入："列出此目录中的文件并总结 README"。
Windows 常见问题排查
| 问题 | 解决方法 |
|---|---|
| codex 无法识别 | 重新安装 Node，确认 %APPDATA%\npm 已加入 PATH |
| 登录窗口无法打开 | 运行 codex login --headless 并手动粘贴 URL |
| 仓库路径报错 | 改用 Git Bash 而非 cmd |
| 防火墙拦截 | 在 Windows Defender 防火墙中允许 Node.js |
| 首次运行缓慢 | Codex 会在首次启动时下载模型和架构文件 |
Codex CLI 的优势
- 以"先规划后执行"的方式完成多步骤编程任务
- 沙盒化命令执行（需审批确认）
- 读取整个仓库以获取上下文
- 通过 API 支持 GPT-5 级别模型
常见问题
Codex CLI 免费吗？ CLI 本身是开源的。API 使用按 OpenAI 标准费率计费；Plus 订阅用户每月有有限的免费额度。
Codex CLI 和 Claude Code 有什么区别？ 两者都是终端代理；Codex 绑定 OpenAI，Claude Code 绑定 Anthropic。选择哪个取决于你更偏好哪家的模型。
可以运行本地模型吗？ 不可以——Codex CLI 专为 OpenAI 模型设计。
相关文章
❓ 常见问题
Is Codex CLI free?
The CLI is open source. API usage is billed at OpenAI rates; Plus subscribers get limited monthly usage.
Codex CLI vs Claude Code?
Both are terminal agents; Codex is OpenAI-tied, Claude Code is Anthropic-tied. Choose by which model you prefer.
Can it run local models?
No - Codex CLI is designed for OpenAI models.
本站文章由编辑人工撰写，收录的工具均经过实测或公开资料核验。文中链接指向工具官网或 GitHub 仓库，仅作信息参考，不构成付费推广。
