Codex 怎么下载:四种官方安装方式
Codex 目前的主体形态是 Codex CLI —— 一个跑在终端里的编码智能体,支持 macOS、Linux 和 Windows。桌面端已不再单独发布,入口并入 ChatGPT 桌面客户端,登录后从左上角切到 Codex 模式;另有 VS Code 等编辑器的 IDE 插件。
方式一:一键安装脚本(推荐)
macOS / Linux:
curl -fsSL https://chatgpt.com/codex/install.sh | shWindows(PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"方式二:npm
需要 Node.js 18 或更高版本:
npm install -g @openai/codex国内网络下这一步容易卡在 fetching @openai/codex,换镜像源:
npm install -g @openai/codex --registry=https://registry.npmmirror.com方式三:Homebrew
brew install --cask codex方式四:手动下载二进制
从 GitHub Release 页面直接取对应架构的包:macOS 选 Apple Silicon(arm64)或 x86_64,Linux 选 x86_64 或 arm64。适合无法用包管理器的受限环境。
装完统一验证:
codex --version能打印版本号即安装成功。提示 command not found 时,重启终端,或检查 npm 全局 bin 目录是否在 PATH 里。
下载是最容易的一步,登录才是门槛
安装包能拉下来,不代表 Codex 能跑起来。镜像源解决的是「取到程序文件」,模型请求仍然要打到 OpenAI 的服务器。国内用户实际会依次撞上四道关。
第一道:终端网络。 浏览器能开 ChatGPT 不等于终端能连。需要给终端配 HTTP_PROXY / HTTPS_PROXY,或使用全局模式的代理工具。公司网络若部署了企业 TLS 代理和私有根证书,还要额外指定证书包:
export CODEX_CA_CERTIFICATE=/path/to/corporate-root-ca.pemcodex login第二道:账号。 首次运行 codex 会让你在「Sign in with ChatGPT」和 API Key 之间选。前者需要 Plus / Pro / Business / Edu / Enterprise 订阅,注册环节的手机号验证对国内号码不友好;后者要把密钥写进 ~/.codex/auth.json,配错格式直接 401。
第三道:支付。 订阅和 API 充值都走海外信用卡,这一关把大量人挡在门外。
第四道:额度。 这是很多人装好之后才发现的问题。Codex 的限额按 5 小时滚动窗口计算,从你发出第一条消息开始计时,触顶后要等窗口过去才逐步恢复。按 2026 年年中的官方定价页数据,Plus / Business 档下旗舰模型每个 5 小时窗口只有 15–80 条消息额度 —— 一次多文件重构就可能在三小时内打空。Pro 档(100 美元 / 200 美元月付,约为 Plus 的 5 倍和 20 倍额度)能缓解,但成本跳了一个量级。触顶后 Plus / Pro 用户可以单独购买 Credits 续用,注意 Codex 与 ChatGPT Work、ChatGPT for Excel 共享同一个 agentic 用量池,别的 Agent 任务也会吃掉你的编码额度。
把这四关加起来,「Codex 怎么下载」这个问题的真实答案是:下载花 2 分钟,跑通花 45 到 90 分钟,而且每个月还要为网络和订阅持续付费。
路线 A:留在 Codex 里,把模型换成国内可直连的
如果你已经习惯了 Codex 的交互,改动最小的方案是保留 CLI、只把后端模型指向国内云厂商。阿里云百炼和火山引擎都提供了官方接入文档,做法是编辑 ~/.codex/config.toml,把 model_provider、base_url、env_key 指向国内网关,再配好对应的 API Key 环境变量。
这条路有两个必须提前知道的坑:
- 协议要对齐。 只有支持 Responses API 的模型能配最新版 Codex。走 Chat/Completions 的模型必须降级 CLI,比如阿里云文档里明确要求
npm install -g @openai/codex@0.80.0。版本一错就是各种莫名其妙的报错。 - 换掉模型之后,干活的已经不是 GPT-5.x 了。 你留下的是 Codex 的交互外壳和工具链,实际推理能力取决于你接的国产模型。把这条路当成「用 Codex 的手感 + 国产模型的可达性」来评估,预期才不会落空。
路线 B:换掉整套工具,直接下载能用的
第二条路是换一个从设计之初就假设「用户在国内网络环境」的工具。NewMax 是这个方向的一个选择,它和 Codex 的核心差别在三处。
下载路径没有前置条件
官网 https://newmax.cc/download 提供 macOS(Apple 芯片 M1–M5 与 Intel)、Windows 10 64 位及以上、Linux x86_64(Ubuntu 22.04+ / Debian 12+ / Fedora / Arch)三平台安装包。系统要求是 macOS 12+、Linux glibc 2.31+,4GB 可用内存、约 1GB 磁盘空间。全程不需要代理、不需要海外手机号、不需要外币信用卡,个人版免费。
对照上一节的四道关:网络、账号、支付三关直接消失。
模型自选,额度不撞墙
NewMax 不绑定单一模型商。你可以填自己的 key 接 Claude、OpenAI、DeepSeek、Kimi、Qwen、智谱、MiniMax、Grok、Ollama 本地模型;也可以用内置的 N币走 NewMax Gateway 调用国内模型,100 N币 = ¥1,按 token 实际消耗扣费(N币的用法见 N币是什么?怎么用到 NewMax 的模型上)。
这带来的体验差异是结构性的:订阅制的 5 小时窗口意味着你的工作节奏由额度决定,重活干到一半被打断;按量计费意味着你的工作节奏由自己决定,代价是要盯着花销。哪种更好取决于使用强度,但「任务做到一半被限流」这件事本身,在按量模式下不会发生。
覆盖面超出写代码
Codex 的能力中心是代码仓库。NewMax 的定位是本地优先的 AI 工作助手,工具面铺得更宽:
- 本地文件:读写和生成 PDF、Office 文档、代码、图像、音视频,数据留在本机
- 浏览器自动化:直接驱动 Chrome 完成网页上的实际操作
- 定时任务:把一次性对话变成每天/每周自动跑的流程
- Skill 系统:把可复用的工作规范外置成脚本化剧本,写作、分析、内容生产都能沉淀(这套方法论见 AI Skills 最佳实践)
- 长期项目:跨会话保留计划、任务看板和记忆
界面和文案是中文优先的,跑国内工具链(微信、飞书、国产云服务)时不需要在中英文语境之间反复翻译。
两条路怎么选
| 你的情况 | 建议 |
|---|---|
| 已有稳定代理 + ChatGPT 订阅,主要写代码 | 直接装 Codex CLI,别折腾 |
| 有订阅但天天被 5 小时窗口打断 | 评估 Pro 5x/20x,或切 API Key 按量计费 |
| 没有海外支付渠道,但想要 Codex 的交互 | 路线 A:Codex CLI + 国内云厂商网关,注意 API 协议与 CLI 版本对齐 |
| 需求超出编码:文档、表格、浏览器、定时任务 | 路线 B:换成覆盖面更宽的本地 Agent |
| 处理敏感数据,有数据出境合规要求 | 路线 B,且优先选本地模型或国内网关 |
| 想给团队里的非技术同事配一套 | 路线 B:安装和登录环节不能有门槛 |
更完整的对比维度(交付确定性、成本可预测性、模型自由度)在 WorkBuddy 和 Codex 怎么选 里基于真实用户评论展开过。
常见问题
Codex 有免费版吗? Codex 本身随 ChatGPT 订阅提供,Plus 是入门档(20 美元/月)。也可以用 OpenAI API Key 按量计费,绕开订阅额度上限,但按 token 付费,且同样需要海外支付渠道。
codex --version 提示 command not found 怎么办?
先重启终端。仍然不行,检查 npm 全局 bin 路径是否在 PATH 中(npm bin -g 查看路径)。Windows 用户注意 PowerShell 和 CMD 的环境变量可能不同步,新开窗口再试。
npm 卡在 fetching @openai/codex? 换 npmmirror 镜像源。这只解决安装包下载,模型请求仍需要网络条件。
装好了一运行就报 401?
多数是凭证问题:~/.codex/auth.json 必须是严格的单行 JSON,无注释、无多余逗号、无中文引号;用中转平台的密钥时还要确认密钥类型选的是 codex 分组。
国内中转 API 值得用吗? 云厂商官方网关(阿里云百炼、火山引擎)有 SLA 和文档支持,风险可控。来路不明的中转站要慎重:你的代码和 prompt 会完整经过它们的服务器。
小结
「Codex 怎么下载」这个问题,命令层面一行就能答完;真正决定你能不能用起来的,是登录、支付和额度这三件下载之后的事。想留在 OpenAI 生态就准备好稳定的网络和订阅,想省掉这些前置条件就换一套按国内网络环境设计的工具。判断依据只有一条:把你未来一个月真正要做的任务写下来,看哪条路上你不会被卡住。