# cc-use

[![npm version](https://img.shields.io/npm/v/cc-use.svg)](https://www.npmjs.com/package/cc-use)

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

![cc-use 演示](docs/assets/demo.gif)

## 安装

```bash
npm install -g cc-use
```

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

## 使用

```bash
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：

```json
{
  "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` 时再输入。

## 开发

```bash
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