Codex CLI 怎么安装？
国内安装 Codex CLI 卡住的原因通常不是 Codex 本身，而是官方安装脚本托管在境外域名、下载经常中断，以及命令行环境与 PATH 差异。本站提供的安装脚本把检测、下载、解压、写入 PATH 与自检串成一步：复制一条命令回车，脚本自动完成，并给出一个诊断码；失败时把诊断码贴回安装页就能看到卡在哪一步、该怎么处理。
最后更新：2026-09-23
先说结论：怎样选更合适？
国内安装 Codex CLI 卡住的原因通常不是 Codex 本身，而是官方安装脚本托管在境外域名、下载经常中断，以及命令行环境与 PATH 差异。本站提供的安装脚本把检测、下载、解压、写入 PATH 与自检串成一步：复制一条命令回车，脚本自动完成，并给出一个诊断码；失败时把诊断码贴回安装页就能看到卡在哪一步、该怎么处理。
哪种订阅方案适合你的场景？
| 使用场景 | 优先考虑 | 判断提醒 |
|---|---|---|
| Windows 10 1809 / 11 用户 | PowerShell 一行命令 | 开始菜单搜索 PowerShell 打开后粘贴回车，不需要管理员权限，脚本会装到用户目录并写入用户级 PATH。 |
| macOS（Apple 芯片或 Intel）用户 | 终端一行命令 | 打开「终端」粘贴回车，脚本默认安装到 ~/.local/bin，并把该目录写进 zsh 配置。 |
| 公司网络或安全软件限制较严 | 先试自动脚本，失败看诊断码 | 脚本会自动换镜像、断点续传；仍失败时按诊断码里的 NET_MIRROR_DOWN、EXEC_BLOCKED 等步骤处理，或加微信 zc2320943144 找客服要离线包。 |
Windows 上怎么安装 Codex CLI？
在开始菜单搜索 PowerShell（不需要「以管理员身份运行」），打开后把这行命令粘贴进去回车即可。脚本会先用官方发布的安装包在用户目录安装 Codex，再把该目录写入用户级环境变量 Path。
安装完成后脚本会执行一次 codex --version 自检并打印实际版本号。如果这里没有报错，说明程序已经就绪；之后新开一个 PowerShell 窗口，codex 命令即可直接使用，不用每次输入完整路径。
整个过程中脚本不会请求管理员权限、不修改系统代理与证书、也不会关闭杀毒软件。若系统或安全软件拦截，脚本会在终端说明被拦截的文件与放行方式。
macOS 上怎么安装 Codex CLI？
打开「终端」，粘贴一行 curl 命令回车。脚本会识别芯片架构（Apple 芯片走 arm64、老款 Intel 走 x64），从国内镜像获取对应版本的官方包，解压后把可执行文件放到 ~/.local/bin。
PATH 的处理是自动的：脚本会把 ~/.local/bin 追加到 ~/.zshrc（若使用 bash 则写入对应配置文件）并在本次会话中生效。安装结束后同样执行 codex --version 自检并输出版本号。
如果首次运行被 macOS 安全策略拦下，脚本会提示需要在「系统设置 → 隐私与安全性」中允许，或用 xattr 去掉下载隔离属性后重试，这些都是标准放行动作，不涉及关闭系统安全功能。
为什么不直接照官网命令装？
官方安装脚本托管在境外域名上，国内网络直连时经常超时或中断；npm 官方源在部分网络下也很慢。本站脚本改为从国内镜像 registry.npmmirror.com 获取官方发布的安装包，安装的是同一个 Codex，只是换了一个可达的下载地址。
除了换源，脚本还做了手动安装容易漏掉的步骤：识别 CPU 架构、校验下载完整性、解压后确认可执行文件存在、写入 PATH、以及最后用 codex --version 做一次真实验证。任何一步失败都会给出明确的错误码与处理建议。
安装失败时怎么排查？
脚本结束时会打印一个 8 位诊断码。回到本站 Codex 安装页，把诊断码粘贴到「卡住了？粘贴诊断码看原因」输入框，就能看到这次安装的失败步骤、错误码含义、脚本已经自动尝试过的修复动作，以及按顺序该做什么。
常见情况：NET_MIRROR_DOWN 表示镜像连不上（换网络或关掉代理拦截后重试）、PATH_NOT_SET 表示命令装好了但新终端还没读到 PATH、EXEC_BLOCKED 表示被安全软件拦截需要放行、VERIFY_FAILED 表示自检没通过需要看终端输出。
如果按建议处理后仍失败，把诊断码连同终端里的输出发给客服即可（微信 zc2320943144），客服在后台可以按诊断码看到同一份报告，不需要你复述过程。
装完之后还需要做什么？
先用新终端执行 codex --version 确认命令可用，然后按自己的使用方式登录：有 ChatGPT 订阅的账号用 codex login 走浏览器授权；使用 API key 的方式则按官方文档配置。安装脚本只负责把命令行程序装好，不包含账号、订阅或额度。
如果你使用的是 Codex 点数额度或需要手机验证码，可以在下方相关商品里查看对应服务；这些属于独立的第三方交付服务，与 OpenAI 没有隶属关系，具体适用条件以商品页说明为准。
当前可查看的相关商品有哪些？
商品价格、库存与交付方式来自实时目录，可能随渠道和运营状态变化。点击商品详情页查看适用条件、售后边界与下单入口。
购买前还有哪些常见问题？
安装 Codex CLI 需要先装 Node.js 吗？
不需要。脚本会先检查机器上有没有 Node 与 npm：有就按标准方式安装，没有就直接下载官方发布的免 Node 安装包，解压后把 codex 命令放进用户目录。
安装需要管理员权限吗？
不需要。全程安装到当前用户目录，不输入密码、不写系统目录、不改系统设置，也不修改系统代理、证书与防火墙。
安装包会上传我的隐私信息吗？
不会上传密钥、令牌、环境变量值，也不带用户名与家目录路径。上报内容只有系统版本、CPU 架构、失败步骤、错误码、自动修复动作与耗时，用于生成诊断码。
官方资料与核对入口
套餐名称、功能、地区价格和账单规则会变化，以下官方资料用于核对最新信息；本站商品是独立的第三方交付服务。
遇到问题怎么联系客服？
🔹 微信客服添加 zc2320943144
把终端里的诊断码（或订单号）一起发过来即可，客服可以按诊断码直接看到这次安装的报告。