平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Claude Code零改动接入DeepSeek V4的详细过程”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

目录

• 30 秒接入 DeepSeek V4
• 关键点：为什么不动~/.claude/
• 把已有的项目记录搬过来
• 常用命令
• 内置的 provider
• 适合什么人

理解这一步时，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 时再填：

带 -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 就够了。

结合项目来看，以上就是Claude Code零改动接入DeepSeek V4的详细过程的详细内容，更多关于Claude Code接入DeepSeek V4的资料请关注脚本之家其它相关文章！