## 一句话回答

把 Codex 接入 CUMOB 这类中转站，本质上只需要改三处：**provider 与 base_url**、**远端模型目录**、**API Key 认证**。CUMOB 一键安装器把这套配置自动化：获取很小的入口文件 → 双击运行 → 选择客户端 → 粘贴 CUMOB API Key → 重启客户端。最短流程：**获取入口 → 双击安装 → 选择客户端 → 输入 API Key → 重启 Codex**。

## 一、Codex 接入中转站，到底要改什么

Codex 默认指向官方端点。要换成中转站，需要在本地配置里完成以下动作：

1. 在 `config.toml` 增加一个 provider 段（安装器使用 `cumob`），指定 `base_url`、`wire_api` 以及模型目录地址 `model_catalog_url`；
2. 把顶层 `model_provider` 指向该 provider，并设置默认 `model` 与 `model_reasoning_effort`；
3. 在 `auth.json` 写入中转站签发的 Key（字段为 `OPENAI_API_KEY`）；
4. 开启 `api_key_model_discovery`，让 Codex 从远端目录拉取可用模型，而不是依赖本地预置清单；
5. 可选：安装媒体生成 Skill，让 Codex 能直接出图 / 出视频。

手工改容易出现漏项、TOML 重复键、旧 provider 段残留、旧本地目录文件仍被引用等问题。安装器的策略是**先备份、再删除受管段、再合并写入**，重复运行不产生重复键。

## 二、安装前准备

- 已安装 OpenAI Codex 和 / 或 Claude Code；
- 网络可访问 GitHub 与所选 CUMOB HTTPS 端点；
- 已有一个 CUMOB API Key；
- 图片 / 视频生成建议准备 Node.js 18+ 或 Python 3；Windows 缺少运行时时，安装器可自动安装 Node.js LTS。

### 如何获取 CUMOB API Key

安装器本身**不提供密钥**，需要你先到 CUMOB 平台自行创建：

1. 打开 CUMOB 平台入口；
2. 注册账号，或使用已有账号登录；
3. 在 API Key 页面创建并复制 API Key；
4. 回到安装器，按提示粘贴该 Key（输入时不显示字符，属正常现象；若本机已配置过可直接回车跳过）。

如果平台页面里的菜单名称与描述不完全一致，以控制台实际文案为准，只要能创建并复制 API Key 即可。

## 三、一键安装（推荐）

### macOS

1. 从 github cumob-oneclick-installer 安装器发布页获取 `install-macos.command`；
2. 双击运行；若系统提示无法打开，右键文件选择「打开」，或到「系统设置 → 隐私与安全性」中允许运行；
3. 按提示输入 CUMOB API Key；
4. 看到 `Installation finished` 后关闭窗口；
5. 重启 Codex / Claude Code，或新建一个任务。

### Windows

1. 从 github cumob-oneclick-installer 安装器发布页获取 `install-windows.cmd`；
2. 双击运行；若被 SmartScreen 拦截，选择「仍要运行」；
3. 按提示选择 Codex / Claude Code / 两者都装；
4. 按提示输入 CUMOB API Key；
5. 看到 `Installation finished` 后按任意键关闭；
6. 重启 Codex，或新建一个任务。

注意客户端实现差异：`install.sh` 支持 Codex、Claude Code 或两者同时安装；Windows 的 `install-windows.cmd` / `install.ps1` 当前主要负责 Codex 配置与 Windows 图片运行时。**Windows 用户如需安装 Claude Code，请在 Git Bash 或 WSL 中运行 `bash install.sh`。**

即使只获取入口文件，安装器也会从 GitHub 拉取最新安装逻辑、最新配置模板与最新 Skill。

### 从源码安装

也可从源码运行安装脚本：macOS / Linux 使用 `bash install.sh`，Windows PowerShell 使用 `.\install.ps1`。

## 四、安装器会自动写入什么

默认写入位置优先使用环境变量 `CODEX_HOME`；未设置时 macOS 为 `~/.codex`，Windows 为 `%USERPROFILE%\.codex`。受限 shell 解析失败时可显式传 `--codex-home`。

```
<CODEX_HOME>/
├── auth.json
├── config.toml
├── skills/
│   └── cumob-media-generation/
└── backups/
    └── cumob-installer-YYYYMMDD-HHMMSS/
<CLAUDE_HOME>/
├── settings.json
├── skills/
│   └── cumob-media-generation/
└── commands/
    └── cumob-media.md
```

按所选客户端的具体动作：

- **Codex**：写入 CUMOB provider、默认模型与模型目录；把 Key 写入 `auth.json` 的 `OPENAI_API_KEY`；安装 `skills/cumob-media-generation/` 及图片 / 视频脚本。
- **Claude Code**：合并或创建 `settings.json`（保留原有设置），写入 `CUMOB_API_KEY`、`CUMOB_BASE_URL`、`OPENAI_API_KEY`、`OPENAI_BASE_URL`；安装同名 Skill；创建 `commands/cumob-media.md`，可在 Claude Code 中用 `/cumob-media` 调用媒体 Skill；检测到 `claude` CLI 时会优先尝试 `claude plugin install`，失败自动回退到本地复制安装。

受管配置的默认值示例（模型名以远端目录接口返回为准）：

```
model_provider = "cumob"
model = "<远端目录返回的默认模型>"
disable_response_storage = true
model_reasoning_effort = "high"
[model_providers.cumob]
name = "cumob"
wire_api = "responses"
image_api = "images"
image_model = "gpt-image-2.5"
video_api = "videos"
video_model = "minimax-h3-2k"
requires_openai_auth = true
base_url = "<所选 CUMOB 端点>/v1"
model_catalog_url = "<所选 CUMOB 端点>/v1/codex/models"
[features]
api_key_model_discovery = true
```

## 五、线路选择：.com 还是 .cn

| 用途 | 线路 |
| --- | --- |
| 平台入口（注册、获取密钥、账户管理） | CUMOB 平台入口 |
| API 接入（环太平洋） | .com 端点 |
| API 接入（东亚地区） | .cn 端点 |

安装时会交互选择端点：`1` = .com 线路（默认），`2` = .cn 线路。15 秒内无操作会自动选择默认 .com；`--no-prompt` / 非交互安装直接使用默认 .com；也可用环境变量 `CUMOB_BASE_URL` 强制指定并跳过选择。生图脚本始终读取 Codex provider 的 `base_url`，不会写死域名。

## 六、怎么确认接入成功

Codex：

- 模型列表里能看到 CUMOB 模型；
- 可以调用媒体 Skill `cumob-media-generation`；
- 生成图片时不再提示缺少 API Key / provider。

Claude Code（使用 `install.sh` 安装时）：

- `~/.claude/settings.json` 中存在 CUMOB 环境变量；
- `~/.claude/skills/cumob-media-generation/SKILL.md` 存在；
- 可以使用 `/cumob-media` 命令。

如果客户端里看不到变化，先**完全退出再打开**，或新建一个任务后检查。

## 七、重复安装即升级

以后 Skill 或配置有更新时，再次双击同一个安装入口即可：安装器会重新拉取最新版本并覆盖升级，其他 Codex 配置会保留，旧文件会自动备份。

配置策略细节：不整文件覆盖 `config.toml`；先备份旧配置、旧 auth、旧模型目录、旧 Skill；升级时备份并移除旧名称 `cumob-image-generation4codex`，避免两个 Skill 并存；删除旧的 CUMOB provider 段与本安装器受管段；写入随所选域名生成的 `model_catalog_url`，移除顶层 `model_catalog_json`，启用 API Key 模型发现；旧本地目录文件若存在则备份保留、不再引用；发现影响 CUMOB 的 profile 覆盖配置时会在修改前退出并提示；其他 provider、MCP、插件、桌面设置与项目权限保留。

需要注意：升级旧安装时必须移除生效的 `model_catalog_json`，否则它会阻止远程获取。为避免损坏 TOML，内联 `features = {...}` 或除发现开关外的顶层点号 `features` 配置，需要先整理成 `[features]` 表。

## 八、远端模型目录与版本要求

Codex 的目录来源为所选 CUMOB 端点下的模型目录接口，请求会携带当前 provider 的认证信息；安装器不会把 API Key 发往 GitHub，也不会跟随目录接口重定向。

安装时会先用本次输入或现有 `auth.json` 中的 `OPENAI_API_KEY` 验证接口，再从可见且支持 API 的模型中按最低 priority 选取初始 `model` 和 `model_reasoning_effort`。没有有效凭据、HTTP 错误、超时、重定向、超过 1 MiB、无效 JSON 或无可用默认模型时，安装器会在改写配置、认证与 Skill **之前退出**，不会退回预置清单。

使用支持 `model_catalog_url` 与 API Key 模型发现的新版 Codex；无法自动识别客户端版本时，可设置 `CUMOB_CODEX_CLIENT_VERSION`（形如 major.minor.patch）指定实际版本。旧的 `CUMOB_MODELS_URL` 选项已移除，目录地址始终由所选端点派生。

## 九、安全与备份

- 发行包与仓库都**不包含真实 API Key**；
- API Key 不作为命令行参数传递，也不写入安装日志；
- Codex 新 Key 只写入 `auth.json` 的 `OPENAI_API_KEY`；Claude Code 新 Key 写入 `settings.json` 的 `CUMOB_API_KEY` 和 `OPENAI_API_KEY`；
- 现有其他 auth / settings 字段保留；不输入 Key 时保留已有认证信息；
- Claude Code 的 Key 会明写在 `settings.json` 的环境变量配置中，请像保护其他本地密钥一样保护该文件；
- Codex 备份目录：macOS `~/.codex/backups/`，Windows `%USERPROFILE%\.codex\backups\`；Claude Code 已有 Skill 目录会先改名为 `cumob-media-generation.bak.YYYYMMDD-HHMMSS`。

## 十、常见问题排查

**安装失败，提示网络错误**：确认能打开 GitHub、没有被公司代理或防火墙拦截，并能访问安装器与 Skill 两个仓库，然后重新双击安装。

**安装成功但客户端没变化**：完全退出 Codex / Claude Code 再打开，或新建任务；Codex 检查模型列表与 Skill，Claude Code 检查 `/cumob-media` 命令与 Skill。

**API Key 输错了**：再次运行安装入口，重新输入正确 Key 即可。

**会不会覆盖原有配置**：不会整份覆盖。只会更新 CUMOB 相关配置、保留其他 Codex provider / 插件 / 桌面设置、合并 Claude Code 的 `settings.json` 环境变量，并在替换前备份。

**高级选项**：只预览不改文件用 `bash install.sh --dry-run` 或 `.\install.ps1 -DryRun`；自定义目录用 `CODEX_HOME` / `CLAUDE_HOME`；非交互安装用 `CUMOB_INSTALL_API_KEY="your-key" bash install.sh --no-prompt`，或在 PowerShell 中设置 `$env:CUMOB_INSTALL_API_KEY` 后运行 `.\install.ps1 -NoPrompt`，完成后再清除该环境变量。

#### 常见问题

**Codex 接入中转站最少要改哪些配置？** 三处：一是 provider 与 base_url，在 config.toml 中新增 CUMOB provider 段并让顶层 model_provider 指向它；二是模型目录，写入 model_catalog_url 并开启 api_key_model_discovery；三是认证，把中转站签发的 API Key 写入 auth.json 的 OPENAI_API_KEY。CUMOB 一键安装器会把这三步连同媒体 Skill 一起自动完成。

**CUMOB 一键安装器怎么用？** 获取对应系统的入口文件（macOS 用 install-macos.command，Windows 用 install-windows.cmd），双击运行，按提示选择 Codex、Claude Code 或两者都装，粘贴 CUMOB API Key，看到 Installation finished 后关闭窗口并重启客户端。安装时它会从 GitHub 拉取最新安装逻辑、配置模板与 Skill。

**需要提前准备 CUMOB API Key 吗？从哪里获取？** 需要。安装器本身不提供密钥：先打开 CUMOB 平台入口，注册或登录后在 API Key 页面创建并复制 Key，再回到安装器按提示粘贴。安装时输入不显示字符属正常现象；如果本机已配置过 Key，可以直接回车跳过。

**安装器会覆盖我原来的 Codex 或 Claude Code 配置吗？** 不会整份覆盖。它会先备份旧 config.toml、旧 auth、旧模型目录和旧 Skill，删除旧的 CUMOB 受管段后合并写入，保留其他 provider、MCP、插件、桌面设置与项目权限。Claude Code 的 settings.json 也是合并式写入环境变量，已有 Skill 目录会先改名备份。

**为什么安装成功后在 Codex 里看不到 CUMOB 模型？** 先完全退出 Codex / Claude Code 再打开，或新建一个任务。Codex 的模型目录由客户端原生从所选 CUMOB 端点的模型目录接口获取，刷新时机与缓存遵循客户端机制。如果服务端下架了当前使用的模型，需要手动选择可用模型，或重新运行安装器重新选取初始默认值。

**Windows 上可以同时安装 Claude Code 吗？** Windows 的 install-windows.cmd / install.ps1 当前负责 Codex 配置和 Windows 图片运行时；如需在 Windows 上安装 Claude Code，请在 Git Bash 或 WSL 中运行 bash install.sh，该脚本支持 Codex、Claude Code 或两者同时安装。

**选择 .com 还是 .cn 线路？** 平台入口与密钥管理统一使用 CUMOB 平台入口；API 接入可选 .com 线路（环太平洋，默认）或 .cn 线路（东亚）。安装时按提示输入 1 或 2 选择，15 秒无操作自动采用默认 .com，也可用环境变量 CUMOB_BASE_URL 强制指定。

**以后 Skill 更新了怎么升级？** 再次双击同一个安装入口即可。安装器会重新拉取最新版本并覆盖升级，保留你的其他 Codex 配置，旧文件自动备份到 backups 目录（如 cumob-installer-YYYYMMDD-HHMMSS），重复运行不会产生重复的 TOML 键。


把 Codex 接入 CUMOB 这类中转站，本质上只需要改三处：provider 与 base_url、远端模型目录、API Key 认证。CUMOB 一键安装器把这套配置自动化：获取很小的入口文件 → 双击运行 → 选择客户端 → 粘贴 CUMOB API Key → 重启客户端。最短流程：获取入口 → 双击安装 → 选择客户端 → 输入 API Key → 重启 Codex。

Codex 怎么接入中转站？用 CUMOB 一键安装器完成 provider、模型目录与 Key 配置

Codex 接入中转站的本质是改三处：provider/base_url、远端模型目录、API Key 认证。CUMOB 一键安装器把这套配置自动化：下载入口文件双击运行，选择 Codex（或 Codex + Claude Code），粘贴 CUMOB API Key，即可写入 config.toml、auth.json 与媒体 Skill，重启客户端后生效。

开发工具

人工智能

Codex接入CUMOB中转站仅需修改三处核心配置：provider与base_url、远端模型目录、APIKey认证。CUMOB一键安装器自动完成整套设置，支持Codex与ClaudeCode双客户端，提供.com/.cn双线路选择，内置安全备份与升级机制，无需手动编辑配置文件。

密钥管理

代码解释

防火墙

Windows

Python

GitHub

Linux

MacOS

JSON

腾讯云双十一大促

tione

热销域名限时优惠，新客首年免费！


domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Codex 怎么接入中转站？用 CUMOB 一键安装器完成 provider、模型目录与 Key 配置-腾讯云开发者社区-腾讯云

Codex 怎么接入中转站？用 CUMOB 一键安装器完成 provider、模型目录与 Key 配置

Codex 怎么接入中转站？用 CUMOB 一键安装器完成 provider、模型目录与 Key 配置

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐