cc-cast

使用 cc-cast 配置并切换 CoffeeRouter 的 Claude Code Profile。

接入原理

cc-cast 保存 CoffeeRouter Profile，并在切换时把它写入 Claude Code 的用户设置：

cc-cast Profile
    ↓ 写入环境变量
~/.claude/settings.json
    ↓ Claude Code 直接请求
https://www.coffeerouter.ai/v1/messages

因此 ANTHROPIC_BASE_URL 必须填写站点根地址 https://www.coffeerouter.ai，不要添加 /v1 或 /v1/messages。

准备工作

开始前请确认：

  • 已安装 Node.js 22 或 24 LTS，并可使用 npm。
  • 已安装 Claude Code，并且至少运行过一次。
  • 已登录 CoffeeRouter，在“令牌管理”页面创建可用令牌。
  • 已确认当前令牌允许使用的准确 Claude 模型 ID。
  • 已在关闭 Claude Code 后备份完整的 ~/.claude/settings.json。

Windows 中 ~ 通常代表 C:\Users\你的用户名。

1. 安装 cc-cast

在 PowerShell、Windows Terminal 或 macOS/Linux 终端中运行：

npm install -g cc-cast
ccc --version

如果系统找不到 ccc，请重新打开终端，并确认 npm 的全局可执行目录已经加入 PATH。

安装 cc-cast 并检查版本

2. 初始化 cc-cast

如需中文界面，可以先设置语言，然后初始化：

ccc locale set zh
ccc init

cc-cast 会检查本机配置。如果检测到 ~/.cc-switch/cc-switch.db，会自动使用 CC Switch 的 Claude Provider；否则使用自己的 Profile 存储。两种模式最终都会把当前配置写入 ~/.claude/settings.json。

初始化 cc-cast

3. 添加 CoffeeRouter Profile

运行：

ccc add

按照向导填写：

  1. Profile / Provider 名称输入 CoffeeRouter。
  2. 添加方式选择 1，使用逐步配置。
  3. ANTHROPIC_BASE_URL 输入 https://www.coffeerouter.ai。
  4. ANTHROPIC_AUTH_TOKEN 输入 CoffeeRouter 令牌。
配置项填写内容
Profile / Provider NameCoffeeRouter
ANTHROPIC_BASE_URLhttps://www.coffeerouter.ai
ANTHROPIC_AUTH_TOKENCoffeeRouter 令牌，例如 sk-your-api-key

添加 CoffeeRouter Profile

4. 配置模型映射

继续在向导中填写当前令牌允许使用的准确模型 ID：

配置项建议填写
ANTHROPIC_MODEL默认使用的准确模型 ID
ANTHROPIC_DEFAULT_OPUS_MODELOpus 场景使用的准确模型 ID
ANTHROPIC_DEFAULT_SONNET_MODELSonnet 场景使用的准确模型 ID
ANTHROPIC_DEFAULT_HAIKU_MODELHaiku 场景使用的准确模型 ID

如果令牌只允许一个 Claude 模型，可以把四个字段都填写为同一个准确模型 ID。模型名称必须与 CoffeeRouter 令牌管理页显示的名称完全一致。

向导会显示 JSON 预览；确认无误后保存，并选择立即切换到该 Profile。

配置 CoffeeRouter 模型映射

5. 激活并验证

查看当前 Profile：

ccc current

查看当前 CoffeeRouter Profile

完全退出并重新打开 Claude Code。在 Claude Code 中执行 /status，确认 Base URL 和模型已经切换，然后发送一条测试消息。cc-cast 不需要持续运行。

在 Claude Code 中测试 CoffeeRouter

日常切换

# 查看全部 Profile
ccc ls

# 切换到 CoffeeRouter
ccc use CoffeeRouter

# 修改 CoffeeRouter Profile
ccc modify CoffeeRouter

# 删除 cc-cast 中的 Profile
ccc remove CoffeeRouter

每次切换后都应完全退出并重新打开 Claude Code。如果同时使用 CC Switch，建议切换后关闭并重新打开 CC Switch，避免界面仍显示旧状态。

配置文件、备份与撤销

文件用途
~/.claude/settings.jsonClaude Code 当前实际使用的设置
~/.cc-cast/config.jsoncc-cast 独立模式下保存的 Profile
~/.cc-cast/rc.json别名、语言等 cc-cast 设置
~/.cc-switch/cc-switch.db检测到 CC Switch 时使用的 Provider 数据库

cc-cast 切换时会更新 ~/.claude/settings.json，Profile 中的 env 会替换原有 env。工具不会自动生成完整备份，因此第一次切换前应手动复制完整设置文件。

ccc remove CoffeeRouter 只删除 Profile，不会撤销 CoffeeRouter 令牌，也不保证恢复 Claude Code 的上一份设置；ccc clear 也不会保证清除已经写入 ~/.claude/settings.json 的变量。需要撤销时，应先在 CoffeeRouter 控制台撤销令牌，再关闭 Claude Code 并恢复备份或手动清理相关变量。

安全提示

常见问题

为什么 Base URL 不带 /v1？

cc-cast 把该值写入 ANTHROPIC_BASE_URL，Claude Code 会自行请求 /v1/messages。填写站点根地址可避免重复的 /v1/v1/messages。

为什么出现 401 或鉴权失败？

检查令牌是否复制完整、是否启用、是否过期或额度不足，并确认 IP 白名单等限制允许当前设备访问。修改后重新执行 ccc use CoffeeRouter 并重启 Claude Code。

为什么出现 404 或 /v1/v1/messages？

执行 ccc modify CoffeeRouter，把 ANTHROPIC_BASE_URL 改为 https://www.coffeerouter.ai，删除末尾的 /v1、/messages 和多余斜杠，然后重新切换并重启 Claude Code。

为什么模型不可用或仍在使用旧模型？

确认模型 ID 与令牌管理页完全一致，执行 ccc current 检查当前 Profile，并完全退出所有 Claude Code 窗口后重新打开。项目级设置或系统环境变量也可能覆盖用户设置。

cc-cast 可以和 CC Switch 一起使用吗？

可以。检测到 CC Switch 数据库时，cc-cast 会复用其中的 Claude Provider。切换前请先关闭正在运行的 Claude Code；切换后建议重启 CC Switch 和 Claude Code，避免旧状态或其他工具再次覆盖配置。

为什么网上有 ccm 命令？

ccm 是兼容入口，当前官方命令是 ccc。本文统一使用 ccc，避免与旧工具或旧文档混淆。

官方资料