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。
npminstall-gcc-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 Keycc-use deepseek# 用 DeepSeek 启动 Claude Code(profile 不存在会自动 init)cc-use deepseek-p"审查 X"# 一次性查询(profile 后的参数全部透传给 claude)cc-use# 用默认 profile 启动cc-usels# 列已配置的 profilecc-use default[profile]# 显示 / 设置默认 profilecc-use doctor[profile]# 校验 profile(--all 校验所有)cc-use import-history[profile]# 把当前项目的 ~/.claude/ 历史拷进 profilecc-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,自己复制一份customprofile 改改就行。
适合什么人
- 已经在用 Claude Code(无论订阅还是手工配的 env),想把 DeepSeek V4 或其他第三方 provider 作为备用 / 比对加进来;
- 多个 provider 之间频繁切换、又不想自己维护 env 变量的;
- 想在不同项目用不同 provider,但希望历史记录隔离的。
如果是从零开始、只想用 DeepSeek 配一个客户端、不在乎现有~/.claude/配置的话,那 cc-use 就是过度设计,直接export ANTHROPIC_BASE_URL就够了。
链接
- npm:https://www.npmjs.com/package/cc-use
- GitHub:https://github.com/leechen298/cc-use
- DeepSeek 官方 Anthropic 兼容端点文档:https://api-docs.deepseek.com/zh-cn/
MIT,欢迎 PR。