Knowledge path · download center
安装方式
Codex CLI 推荐通过 Node.js / npm 安装;如果网络受限,可以先用清华 Node.js Release 镜像获取 Node.js,再把 npm registry 切到 npmmirror。
- 先安装 Node.js 20+,安装后打开新终端确认:
node -v
npm -v通过 npm 安装 Codex CLI
官方 npm 包名为 @openai/codex。网络正常时直接安装;国内网络不稳定时可临时使用 npmmirror registry。
# 默认源
npm install -g @openai/codex
# 如果 npmjs 访问慢,可临时使用 npmmirror
npm install -g @openai/codex --registry=https://registry.npmmirror.com
# 检查
codex --version如果连 Node.js 官网也打不开,可到清华 Nodejs Release 镜像下载对应 Windows x64 安装包或压缩包:清华 Nodejs Release 帮助。npm 包镜像可参考 npmmirror。
遇到问题
下载、安装、配置过程中有任何问题,可以加 QQ 群 417577720 找站长要对应包或协助排查。
CONFIG
推荐:安装后运行配置辅助脚本
脚本会检测 codex 是否在 PATH 中,然后引导填写 MossHubs API Key 或自己的 OpenAI-compatible 凭据。执行前必须输入 I AGREE。
写入范围
- 写入位置:
%USERPROFILE%\.codex\mosshubs.config.toml - API Key 写入用户环境变量
MossHubs_OPENAI_API_KEY - 已有 profile 会先备份为
mosshubs.config.toml.bak-时间戳
检查
codex --version
codex --profile mosshubs默认模型:gpt-5.5;默认网关:https://api.mosshubs.com/v1。