cc-use

用 DeepSeek、Kimi、Qwen、GLM、MiniMax、火山方舟、BytePlus ModelArk、OpenRouter 等第三方 Anthropic 兼容服务启动 Claude Code —— 国内厂商和它们的国际站都覆盖。默认复用原生 ~/.claude/ 上下文；cc-use isolate 用于显式隔离会话。

安装

npm install -g cc-use

要求 Node ≥ 18，且已装 Claude Code（npm install -g @anthropic-ai/claude-code）。在 macOS / Linux 上充分测试；Windows 只在 CI 跑了 build + test，交互流程没有人工跑过，best-effort 支持。

使用

cc-use init                       # 交互式：选模板、输入 API Key
cc-use deepseek                   # 用 DeepSeek 启动，复用原生 ~/.claude（默认日常使用）
cc-use auto                       # 自动选择可用 profile，复用原生 ~/.claude
cc-use deepseek -p "审查 X"       # 一次性查询（profile 后的参数全部透传给 claude）
cc-use with deepseek              # 显式共享上下文启动 DeepSeek
cc-use with auto                  # 共享 auto 的兼容别名
cc-use isolate deepseek           # 用 DeepSeek 启动，显式隔离会话
cc-use isolate auto               # 自动选择可用 profile，隔离会话
cc-use                            # 用默认 profile 启动（共享上下文）

cc-use ls                         # 列已配置的 profile
cc-use status                     # 查看 auto routing 的最近可用性状态
cc-use remove deepseek            # 移除 profile 配置（--delete-session 同时删除隔离会话历史）
cc-use default [profile]          # 显示 / 设置默认 profile
cc-use doctor [profile]           # 校验 profile（--all 校验所有）
cc-use import-history [profile]   # 把当前项目的 ~/.claude/ 历史拷进 profile
cc-use --help                     # 完整命令参考

[profile] 可省略，不传则使用默认 profile。

import-history 默认原样拷贝历史。DeepSeek 或其他 provider 无法恢复 Claude thinking / 工具调用历史时，追加 --sanitize；它会保留可读文本，删除 Claude thinking 块，并把历史工具调用 / 媒体 / 工具结果块转成普通文本标记后再写入 ~/.cc-use/sessions/<profile>/。

profile 配置存在 ~/.cc-use/providers/<name>.json（chmod 600）。cc-use <profile> 为推荐日常用法 —— 复用原生 ~/.claude/ 上下文（聊天记录、skills、projects）。cc-use isolate <profile> 使用独立的 CLAUDE_CONFIG_DIR=~/.cc-use/sessions/<name>/。

自动路由

cc-use auto 会在启动 Claude Code 前选择第一个可用 profile。调度单位是 profile，不是 provider，也不是 model。

在 ~/.cc-use/config.json 中配置 auto routing：

{
  "default": "deepseek",
  "auto": {
    "cacheTtlSeconds": 60,
    "fallbackOrder": ["deepseek", "mimo"],
    "profiles": {
      "deepseek": {
        "mode": "payg",
        "check": { "kind": "probe" }
      },
      "mimo": {
        "mode": "token_plan",
        "check": { "kind": "manual_availability", "available": true }
      }
    }
  }
}

支持的检查方式：

• probe：发送一次 max_tokens: 1 的最小 Anthropic-compatible Messages 请求，判断当前 profile 是否能完成一次轻量模型调用。
• manual_availability：读取配置里的布尔值。
• api：预留给显式实现的各平台余额 adapter；未实现的 adapter 会按 check_failed 处理。

status.json 只保存最近一次可用性缓存。TTL 内的成功 probe 可以复用；过期或不可用状态会在路由前重新检查。probe 成功不保证长任务一定跑完，cc-use 也不会在任务中途自动切换 provider。

recordUsage 是给未来 pay-as-you-go 余额快照预留的字段。当前 MVP 只做兼容解析，不会写入用量账本。

内置 provider

| 模板 | 提供商 | 端点 | |---------------|----------------------------------|-----------------------------------------------| | deepseek | DeepSeek V4（直连） | api.deepseek.com/anthropic | | kimi | Moonshot Kimi K2.6（直连，CN） | api.moonshot.cn/anthropic | | kimi-plan | Moonshot Kimi Coding Plan | api.kimi.com/coding/ | | glm | 智谱 GLM 5.1（CN） | open.bigmodel.cn/api/anthropic | | glm-intl | 智谱 GLM 5.1（国际，z.ai） | api.z.ai/api/anthropic | | qwen | 阿里百炼 DashScope（直连，CN） | dashscope.aliyuncs.com/apps/anthropic | | qwen-plan | 阿里百炼 Token Plan（CN） | token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic | | qwen-intl | 阿里 Model Studio（国际） | dashscope-intl.aliyuncs.com/apps/anthropic | | minimax | MiniMax M2.7（CN） | api.minimaxi.com/anthropic | | minimax-intl| MiniMax M2.7（国际） | api.minimax.io/anthropic | | volcengine-plan | 火山方舟 Coding Plan（CN） | ark.cn-beijing.volces.com/api/coding | | byteplus-plan | BytePlus ModelArk Coding Plan（字节给海外起的另一个品牌，跟 Volcengine 是同一套技术） | ark.ap-southeast.bytepluses.com/api/coding | | mimo | 小米 MiMo V2.5 Pro（直连） | api.xiaomimimo.com/anthropic | | mimo-plan | 小米 MiMo Token Plan（CN） | token-plan-cn.xiaomimimo.com/anthropic | | openrouter | OpenRouter | openrouter.ai/api | | custom | 自定义（你来填） | （手动） |

带 -plan 的是订阅入口（Coding Plan / Token Plan），通常是厂商专门给 Claude Code 适配的那条路，按月固定费、不按 token 计。

MiMo: CN vs 国际

• mimo —— 走公开 pay-as-you-go Anthropic endpoint（api.xiaomimimo.com/anthropic）。公开文档当前只暴露这一个通用 endpoint；计费方式按账户区域区分，不按模板区分。
• mimo-plan —— 走中国区 Token Plan endpoint（token-plan-cn.xiaomimimo.com/anthropic）。国际 Token Plan 用户（新加坡/欧洲）的 endpoint 不是公开常量 —— 去订阅控制台确认实际的 Anthropic URL，再 cc-use init mimo-plan 并手动修改生成 profile 的 ANTHROPIC_BASE_URL。

模板里都不带 API Key，运行 cc-use init 时再输入。

开发

git clone https://github.com/leechen298/cc-use.git
cd cc-use
pnpm install        # npm/yarn 也能用；仓库只提交 pnpm-lock.yaml
pnpm build
pnpm test

License

MIT © leechen298