DeepSeek V4 已经开放 Anthropic 兼容的端点 api.deepseek.com/anthropic，意味着可以直接拿 Claude Code 当客户端来跑 V4。
但问题来了：
- Claude Code 现有配置都在
~/.claude/，不管是订阅登录态、还是已经手工配过的 env 与 settings； - 一旦
export ANTHROPIC_BASE_URL=...，所有claude命令都会走 DeepSeek，原有这条路就被覆盖了； - 想切回去？得
unset一堆环境变量，或者重开一个干净的 shell； - 想同时挂 DeepSeek、Kimi、GLM 几个 provider 来回比？env 变量就更乱了。
cc-use 就是为这个场景做的。一句话：它是 Claude Code 的启动器，每次启动只往子进程里注 env，永远不碰 ~/.claude/。
下面用 DeepSeek V4 走一遍。
30 秒接入 DeepSeek V4
前置：Node ≥ 18，已经装了 Claude Code（npm install -g @anthropic-ai/claude-code）。
支持 Linux / macOS / Windows。
npm install -g cc-use
cc-use deepseek
第一次跑 cc-use deepseek，因为本地还没有名为 deepseek 的 profile（一份保存好的 provider 配置，下面会展开），它会自动走一个交互引导：
- 让你贴 DeepSeek 的 API Key（隐藏输入）；
- 问要不要把 deepseek 设成默认 profile；
- 自动跑一次 doctor 自检，发一个最小请求，确认这家服务真的按 Anthropic 协议响应；
- 探活通过，自动
claude启动，进入熟悉的 Claude Code 对话界面。
整个过程不会写任何东西到 ~/.claude/。
API Key 存在 ~/.cc-use/providers/deepseek.json，本地文件，cc-use 不会上传任何东西到外部。
关键点：为什么不动 ~/.claude/
Claude Code 默认把登录态、历史记录、设置都放在 ~/.claude/ 里。直接 export ANTHROPIC_BASE_URL 切到 DeepSeek，相当于拿你原来这一套配置去走另一家服务，混在一起。
cc-use 给每个 provider 单独开一份配置：
- 跑
cc-use deepseek，用的是 DeepSeek 的那份； - 跑
cc-use kimi，又是 Kimi 的另一份； - 跑原生
claude，还是你原来的~/.claude/，一字未动。
各走各的，互不污染。原来的订阅 / 配置怎么用还怎么用。
把已有的项目记录搬过来
配置隔离是好事，但也有个尴尬：当前项目在原生 Claude Code 下已经攒了不少对话记录，新切到 DeepSeek 等于一张白纸开始，上下文都丢了。
cc-use import-history 解决这个：
cd 你的项目
cc-use import-history deepseek
把当前项目在 ~/.claude/ 下的会话历史只读拷贝一份到 DeepSeek 的配置里，原目录一字不动。再跑 cc-use deepseek，对话列表里就能看到旧会话，可以接着聊，也可以挑一段让 DeepSeek 接手 —— 相当于把同一个项目在不同模型之间无痛搬家。
常用命令
cc-use init # 交互式：选模板、输入 API Key
cc-use deepseek # 用 DeepSeek 启动 Claude Code（profile 不存在会自动 init）
cc-use deepseek -p "审查 X" # 一次性查询（profile 后的参数全部透传给 claude）
cc-use # 用默认 profile 启动
cc-use ls # 列已配置的 profile
cc-use default [profile] # 显示 / 设置默认 profile
cc-use doctor [profile] # 校验 profile（--all 校验所有）
cc-use import-history [profile] # 把当前项目的 ~/.claude/ 历史拷进 profile
cc-use --help # 完整命令参考
[profile] 可省略，不传就走默认 profile。
内置的 provider
除了 DeepSeek，cc-use 还内置了几个国内常见的 Anthropic 兼容端点，模板都不带 Key，跑 cc-use init 时再填：
| 模板 | 提供商 | 端点 |
|---|---|---|
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 |
volcengine-intl-plan | BytePlus ModelArk Coding Plan（国际） | ark.ap-southeast.bytepluses.com/api/coding |
openrouter | OpenRouter | openrouter.ai/api |
custom | 自己填 | （手动） |
带 -plan 后缀的是订阅入口（Coding Plan / Token Plan），通常是厂商专门给 Claude Code 适配的那条路，按月固定费、不按 token 计；不带后缀的是按量直连。带 -intl 后缀的是国际站。
想加新的 provider，自己复制一份 custom profile 改改就行。
适合什么人
- 已经在用 Claude Code（无论订阅还是手工配的 env），想把 DeepSeek V4 或其他第三方 provider 作为备用 / 比对加进来；
- 多个 provider 之间频繁切换、又不想自己维护 env 变量的；
- 想在不同项目用不同 provider，但希望历史记录隔离的。
如果是从零开始、只想用 DeepSeek 配一个客户端、不在乎现有 ~/.claude/ 配置的话，那 cc-use 就是过度设计，直接 export ANTHROPIC_BASE_URL 就够了。
链接
- npm：www.npmjs.com/package/cc-…
- GitHub：github.com/leechen298/…
- DeepSeek 官方 Anthropic 兼容端点文档：api-docs.deepseek.com/zh-cn/
MIT，欢迎 PR。
