快速开始

本页介绍如何下载安装 cc-router，并把它接入 Claude Code。

前置要求

操作系统：macOS、Windows 或 Linux
已安装 Claude Code
至少一个支持的大模型厂商账号与 API Key（如智谱 GLM、DeepSeek、Kimi、MiniMax、阿里百炼等，完整列表见 README）

下载安装

按系统和架构选择安装包。两个下载源内容完全相同，中国大陆用户选「中国下载」更快；链接始终指向最新版本，历史版本见 Releases 页面，也可以在下载页查看。

macOS

架构	安装包	下载
Apple Silicon（M 系列芯片）	`cc-router_macOS-arm64.dmg`	全球下载 · 中国下载
Intel	`cc-router_macOS-x64.dmg`	全球下载 · 中国下载

不确定是哪种：点屏幕左上角的苹果菜单 → 关于本机，显示「芯片 Apple M…」选 Apple Silicon，显示「处理器 … Intel …」选 Intel。

下载 .dmg 后双击挂载，把 cc-router 拖入「应用程序」。

Windows

架构	安装包	下载
x64	`cc-router_windows-x64-setup.exe`	全球下载 · 中国下载
x64（MSI）	`cc-router_windows-x64.msi`	全球下载 · 中国下载
ARM64	`cc-router_windows-arm64-setup.exe`	全球下载 · 中国下载

个人电脑推荐 setup.exe；需要通过组策略或软件分发批量部署时用 .msi。下载后双击运行安装向导。在 Windows 上配合 Claude Desktop 使用，见与 Claude Desktop 集成（Windows）。

Linux

架构	安装包	下载
x64 · AppImage	`cc-router_linux-x64.AppImage`	全球下载 · 中国下载
x64 · deb	`cc-router_linux-x64.deb`	全球下载 · 中国下载
ARM64 · AppImage	`cc-router_linux-arm64.AppImage`	全球下载 · 中国下载
ARM64 · deb	`cc-router_linux-arm64.deb`	全球下载 · 中国下载

.AppImage（推荐，支持应用内自动更新）：chmod +x cc-router_linux-*.AppImage && ./cc-router_linux-*.AppImage
.deb（Debian / Ubuntu）：sudo apt install ./cc-router_linux-*.deb，升级时需要手动重新下载安装

配置虚拟模型

首次启动 cc-router 会进入 Onboarding 引导：

添加订阅 —— 选择厂商 → 选择接入点（订阅 / 按量 API） → 填入 API Key，cc-router 会自动抓取该订阅可用的模型列表
绑定虚拟模型 —— 把抓到的真实模型分配到 opus / sonnet / haiku 三个虚拟槽位
选择调度模式 —— 同一槽位下挂多个订阅时，可选顺序（前一个用完/失败再切下一个）或轮询（请求间轮转）

如需新增厂商或调整槽位，可在主界面模型页随时修改。

接入 Claude Code

cc-router 启动后会在本机起一个监听 127.0.0.1:23456 的代理服务。打开 cc-router 的设置页，复制完整的 env snippet，粘贴到 ~/.claude/settings.json 的 env 字段：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:23456",
    "ANTHROPIC_AUTH_TOKEN": "填写app里给你的真实token",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_MODEL": "model-opus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "model-sonnet",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "model-opus",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "model-haiku"
  }
}

model-opus、model-sonnet、model-haiku 就是你配置到 cc-router 的模型名字，这是 app 提供给你的接口和虚拟模型名字。app 会自动把虚拟模型名转成真实模型名。

如果你的模型支持 1M 上下文，你可以写 model-opus[1m]，这是 Claude Code 支持的写法。

端口被占用

默认端口 23456 若被占用，cc-router 会自动 +1 递增。请始终从”设置”页复制最新的 snippet，确保端口号一致。

保存配置后重启 Claude Code，即可通过 cc-router 路由到你配置的真实模型。

下一步

在 cc-router 主界面查看 请求日志，验证 Claude Code 的请求是否正确路由
想新增不在内置列表里的厂商？参考 README 的”添加新 provider”章节，可在 Claude Code 中执行 new-provider skill 自动生成