跳到正文
下载中心 →

Codex 命令行版安装与配置

下载对应系统的中文部署包，完成安装与服务配置；已有客户端可直接配置。

更新于 2026-09-26
本页内容

本页适用的服务

本页保留现有工具的原有中转服务预设。使用平台账户与平台 Key，请先查看 平台 API 接入，客户端按手动配置指南填写平台地址。原有服务的 Key 与额度继续单独管理。

安装与检查

目标电脑系统默认 Windows，可按实际使用的电脑切换

所有系统下载

Codex CLI 部署包
从下方下载适用系统的部署包，解压后按中文向导完成安装；已安装 Codex CLI 时可以跳过安装，继续服务配置。

    一、自动部署（推荐）

    仅支持 CLI 命令行，不支持桌面版。下面的在线命令和下载文件使用同一套中文向导，任选一种即可。使用 ↑/↓ 选择、Enter 确认、Esc 取消；仅 API 地址和 Key 需要输入。
    先准备 Key：打开 中转站控制台 → 注册或登录 → API 密钥 → 创建密钥 → 选择用于 Codex / OpenAI 的分组 → 复制完整 Key。
    • 向导自动检测 Codex CLI；缺少时从主站镜像下载完整 CLI，无需先安装 Node.js。
    • 检测环境 → 安装 CLI → 配置服务 → 完成。MossHubs 地址预先填写，模型列表按当前 Key 的权限提供。
    • Windows、Mac、Linux 均先备份再合并默认 config.toml，保留 MCP、权限、项目设置和 auth.json。完成后重新打开终端，直接输入 codex。
    其他方式：在线命令部署
    Windows：在 PowerShell 中粘贴下面这一行并回车。自动下载单文件 EXE，再进入方向键菜单向导。
    powershell
    irm https://www.mosshubs.com/install/codex.ps1 | iex
    Mac / Linux：在终端粘贴下面这一行并回车。自动识别系统与芯片，下载对应向导。
    bash
    curl -fsSL https://www.mosshubs.com/install/codex.sh | bash
    请在可交互的终端中运行。下载完成后才进入配置；Key 在向导里隐藏输入，不要写入上面的命令。

    解压并运行配置向导

    Windows EXE 尚未做商业代码签名；Mac 尚未公证。按系统提供的来源验证流程处理。Mac 和 ARM64 尚未完成对应真机运行验证，保持预览说明。
    下载的配置向导较小；缺少 CLI 时还需联网下载完整运行包。Windows 继续使用主站约 800 MB 镜像，只提取 CLI 组件；Mac / Linux 使用独立 CLI 包。
    • Windows：解压完整 ZIP，双击“开始配置.exe”。
    • Mac：解压后双击 configure.command。
    • Linux：解压，在文件夹打开终端运行 sh configure.sh。

    配置完成后怎么用

    • 重新打开终端，输入 codex 即可使用所选模型，不需要 --profile。也可使用生成的中文启动入口。
    • 主线路为 https://gmats.mosshubs.com，备用为 https://sub.ai.mosshubs.com。备用启动入口会切换默认线路，恢复时使用主入口。
    • Windows 启动入口直接打开 PowerShell，CLI 报错或退出后保留窗口；Mac / Linux 也提供对应启动入口。
    • 更换 Key、模型或升级：重新运行向导。旧 Mac / Linux 独立 profile 用户重新配置一次，即可改用默认配置。
    • 配置目录优先使用 CODEX_HOME，未设置时为用户目录下的 .codex。原配置备份在 mosshubs-backups；配置和备份含 Key，请勿分享。
    • Mac / Linux 自动设置当前用户的 ~/.local/bin/codex 和终端 PATH；重新打开终端后生效。
    二、手动配置
    适合已安装 Codex CLI、希望自行管理配置的用户。自动部署和手动配置选择一种即可。
    1. 确认 CLI 已安装；缺少时先看 安装与检查。
    2. 从 中转站控制台 创建用于 Codex / OpenAI 的 Key，并确认可用模型 ID。
    3. 按下表找到配置目录。先备份现有 config.toml，再编辑；不存在则创建。已有文件请合并字段，避免重复 model 或同名 provider 表。
    bash
    codex --version
    系统 / 情况配置文件
    Windows%USERPROFILE%\.codex\config.toml
    Mac / Linux~/.codex/config.toml
    设置了 CODEX_HOME使用该目录下的 config.toml
    填写以下内容，将 YOUR_MODEL_ID 替换为该 Key 可用的模型（例如 gpt-6-sol），将 YOUR_API_KEY 替换为完整 Key。服务地址已预填主线路，保持 /v1 只出现一次。
    toml
    model_provider = "mosshubs-openai"
model = "YOUR_MODEL_ID"

[model_providers.mosshubs-openai]
name = "MossHubs API"
base_url = "https://gmats.mosshubs.com/v1"
wire_api = "responses"
requires_openai_auth = false
experimental_bearer_token = "YOUR_API_KEY"
    本示例将第三方 Key 放在对应 provider 内，保留已有 auth.json 登录文件。若原文件顶部存在 profile 默认选择，先备份，再移除该选择或同步修改它指向的配置，以免覆盖新默认项。
    bash
    # Mac / Linux
chmod 600 "${CODEX_HOME:-$HOME/.codex}/config.toml"
    保存文件后重新打开终端，运行以下命令进入 CLI。CLI 会使用默认文件；首次输入实际任务会按服务额度计费。
    bash
    codex
    主线路连接失败时，只把上述 provider 的 base_url 改为下方备用地址，保存并重新启动 CLI。Key 无效、分组不匹配或额度不足时，需要在控制台处理。
    toml
    base_url = "https://sub.ai.mosshubs.com/v1"
    CC Switch 通用配置 · 端点与协议 · 模型与分组 · 问题与支持
    其他方式：通过 npm 安装
    官方 npm 包名为 @openai/codex。网络正常时直接安装；npmjs 访问慢时可临时使用 npmmirror registry。
    bash
    # 默认源
npm install -g @openai/codex

# npmjs 访问慢时临时使用 npmmirror
npm install -g @openai/codex --registry=https://registry.npmmirror.com

# 检查
codex --version