Claude Code 零改动接入 DeepSeek V4

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 配置，下面会展开），它会自动走一个交互引导：

1. 让你贴 DeepSeek 的 API Key（隐藏输入）；
2. 问要不要把 deepseek 设成默认 profile；
3. 自动跑一次 doctor 自检，发一个最小请求，确认这家服务真的按 Anthropic 协议响应；
4. 探活通过，自动 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。