跳到正文
下载中心 →

CC Switch 使用指南

添加、切换和检查客户端 Provider。

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

使用平台账户配置

使用项目控制台创建的 Key，API 根地址为 https://gateway.mosshubs.com。在客户端或 CC Switch 中选择自定义服务，按本页填写。
已下载的一键助手可能带有原有服务预设；平台配置按本页手动填写，不直接沿用旧服务地址。

适用范围与配置前提

先安装 CC Switch 和目标客户端，从 网关控制台 获取对应分组的 Key、模型 ID。下面列出本站主备线路的完整地址。
Claude 与 Codex 要分别建立 Provider，并使用各自协议可用的 Key。
配置 Codex 桌面版时，使用 桌面版 CC Switch 专用步骤；命令行用户可查看 Codex CLI 配置。

安装 CC Switch

  • 从 CC Switch 下载页 选择与你电脑匹配的系统与架构。普通 Intel / AMD Windows 电脑选 x64，骁龙电脑选 ARM64。
  • Windows 推荐 MSI 安装包；ZIP 便携版解压后运行。macOS 推荐 DMG，将应用拖入“应用程序”。
  • Linux 按发行版选择 DEB、RPM 或 AppImage；AppImage 可先在文件属性中允许执行。安装完成后，继续添加下面的主线路与备用线路。
  • 升级前备份现有配置。3.20.4 含数据库迁移，说明见 官方发布记录。

推荐方式：CC Switch

  • 先按 CC Switch 安装指引 下载并安装。
  • 选择 Claude 或 Codex，添加名为“MossHubs 主线路”的 Provider，按下方表格填写主地址、Key 和模型。
  • 复制此 Provider 为“MossHubs 备用线路”，只把地址改为表格中的备用地址。
  • 平时启用主线路；遇到线路连接问题时切换备用，随后重开对应客户端。

Provider 参数

客户端 / 配置项主线路回退备选
Claude / ANTHROPIC_BASE_URLhttps://gateway.mosshubs.comhttps://gateway.mosshubs.com
Codex / base_urlhttps://gateway.mosshubs.com/v1https://gateway.mosshubs.com/v1

连接异常时

先核对平台地址、模型权限与账户额度，再 查看服务状态。只有平台明确公布了备用线路时才切换；结果未知的任务先查询原记录。

升级、更换配置与卸载

升级前保留当前可用配置和必要作品。从 下载中心 获取适用的版本；不要覆盖正在执行任务的工具。
更换 Key 或服务后重新检查连接。换电脑时按本指南重新安装与配置，配置文件可能包含 Key，不要上传到公开位置。
卸载应用或工具前确认输出文件保存位置；如需恢复原客户端配置，先找到安装/配置过程保留的备份，再按对应手动配置步骤处理。