deepclaude 用 DeepSeek 跑 Claude Code 行不行

deepclaude 把 Claude Code 的 agent loop 接到 DeepSeek V4 Pro，保留工具链、换便宜后端。本文给适用决策表和最小试用步骤，并说明 MCP、视觉和 ToS 边界。

deepclaude 用 DeepSeek 跑 Claude Code 行不行

想用 DeepSeek V4 Pro 驱动 Claude Code 的 agent loop，技术上可行，但不是全功能平替。开源项目 deepclaude 通过改写 ANTHROPIC_BASE_URL 等环境变量，让 Claude Code CLI 把推理请求转发到 DeepSeek 的 Anthropic 兼容端点；文件读写、bash、多步工具循环、子代理等核心能力保留，代价是 MCP、图像输入和部分缓存语义会降级或失效。

deepclaude 到底做了什么

deepclaude 不改 Claude Code 本体，只在启动前临时注入一组 API 路由变量，会话结束后恢复：

变量 作用
ANTHROPIC_BASE_URL 指向 DeepSeek / OpenRouter / Fireworks 等后端
ANTHROPIC_AUTH_TOKEN 对应后端的 API Key
ANTHROPIC_DEFAULT_*_MODEL 把 Opus/Sonnet/Haiku 档位映射到 DeepSeek 模型名
CLAUDE_CODE_SUBAGENT_MODEL 子代理使用的模型

架构可以理解为「换脑不换身」：终端里仍是 Claude Code 的工具循环和 UX，HTTP 请求落到 DeepSeek V4 Pro（项目 README 标称输出约 $0.87/M token，相对 Anthropic 官方 Opus 档约 $15/M 有数量级价差）。项目还支持 --backend or（OpenRouter）、--backend fw（Fireworks）、--backend anthropic 一键切回官方，以及会话中 /deepseek、/anthropic 等 slash 命令热切换。

按项目 README 标注仍正常工作的能力：Read/Write/Edit、bash、Glob/Grep、多步自主循环、子代理、git、/init、thinking mode。

已知降级或不可用（以仓库当前说明为准）：

功能 状态 原因
图像/视觉输入 不可用 DeepSeek Anthropic 兼容端点不支持
MCP 工具 不可用 兼容层未透传
Anthropic cache_control 被忽略 DeepSeek 有自己的自动缓存机制
复杂推理（约 20% 任务） 弱于 Opus 项目自述，需 --backend anthropic 切回

这和 DeepSeek vs Claude Opus 4.8 的能力边界 一致：日常单文件、CRUD、算法题 DeepSeek 能打；跨文件重构、架构级判断仍建议保留 Opus 通道。

什么场景值得试、什么场景别硬上

下面这张决策表按你的首要约束划分，不是「能不能装」，而是「装了会不会返工成本更高」。

你的首要约束 建议 理由
月费/额度吃紧，任务以读写文件、跑测试、小范围修改为主 值得试 工具循环不变，token 单价低；可参考 Claude Code 配额消耗排查 对照节省空间
重度依赖 MCP（数据库、浏览器、自定义 server） 别硬上 deepclaude README 明确 MCP 不经过兼容层
需要截图/UI 视觉理解 别硬上 视觉输入不可用
大型仓库重构、多模块联合 debug 混合模式 80% 日常用 DeepSeek，复杂段 --backend anthropic 切 Opus
公司代码不能出网、必须本地推理 不适用 deepclaude 仍走云端 API，只是换了供应商
担心账号/ToS 合规 先读条款再决定 非官方路由，Anthropic 与 DeepSeek 用户协议各自约束；见下文合规节

不适用清单（踩了会浪费时间）：

  • 把 deepclaude 当「免费 Claude Code Max」——远程控制（--remote）仍要 claude.ai 订阅和 Anthropic bridge
  • 期望 MCP 生态零改动迁移
  • 在 CI 无人值守长跑复杂 agent loop 且不做检查点——参见 AI 代理自主循环风险

最小试用步骤（约 10 分钟）

目标：验证「你的典型任务」在 DeepSeek 后端下工具调用是否稳定，而不是跑通安装就宣告成功。

1. 准备 DeepSeek API Key

在 platform.deepseek.com 注册并充值（项目 Quick Start 建议 $5 起）。Key 只放环境变量，别写进仓库。

2. 安装 deepclaude 启动器

git clone https://github.com/aattaran/deepclaude.git
cd deepclaude
chmod +x deepclaude.sh
sudo ln -s "$(pwd)/deepclaude.sh" /usr/local/bin/deepclaude   # macOS/Linux
export DEEPSEEK_API_KEY="sk-..."

Windows 用仓库里的 deepclaude.ps1，逻辑相同。

3. 启动并确认后端

deepclaude --status    # 应列出 ds / or / fw / anthropic 及 Key 是否就绪
deepclaude --cost      # 查看项目内置的单价对照表
deepclaude             # 进入 Claude Code，此时推理走 DeepSeek

4. 跑三个探针任务（各 5 分钟内应能完成）

探针 操作 通过标准
文件编辑 让 agent 修改一个 50 行以内的源文件并保存 diff 正确、无胡乱新建文件
bash 跑项目现有测试命令 命令执行、输出可读
子代理/多步 给一个「先搜索再改两处」的小任务 工具链未中途 hallucinate 路径

任一探针出现工具名乱编、JSON 解析失败、循环空转，记录任务类型——这通常比「模型笨」更像是兼容层边界。

5. 复杂任务对照

用同一 prompt 执行：deepclaude --backend anthropic 与默认 DeepSeek 各跑一遍。若 DeepSeek 版在第二步就偏离计划，说明你的 workload 落在项目自述那 20% 复杂推理区间，应建立「默认 DeepSeek、手动切 Opus」的习惯，而不是放弃 Claude Code 工作流。

工具调用质量与兼容风险

Claude Code 假设下游是 Anthropic Messages API 语义。DeepSeek 提供兼容端点，但兼容不等于等价：

  • 并行工具调用：DeepSeek 端支持多 tool call，但 Claude Code 默认串行发送；体感延迟可能与官方不同。
  • Thinking / extended reasoning：deepclaude 默认开启 thinking；DeepSeek 计费与 Anthropic 不同，长推理仍烧 token，只是单价低。
  • 子代理模型映射：Haiku 档若映射不当，子代理可能比主会话更「飘」；用 --status 核对三档模型名。
  • 输出质量：Routine 任务项目称与 Opus「 comparable」；涉及 如何避免 AI Slop 式垃圾代码 的约束（明确边界、禁止过度抽象）对任何后端都必要，换便宜模型不能省掉 review。

若你已在用 委托模式并行 Codex/Gemini，deepclaude 解决的是「Claude Code 单通道太贵」，两者可叠加：主通道 DeepSeek，复杂子任务仍委派其他 CLI。

合规、ToS 与账号安全

deepclaude 是社区脚本，不是 Anthropic 或 DeepSeek 官方产品。使用前自行确认：

  • Anthropic ToS：通过非官方端点调用 Claude Code 客户端是否构成违规，以 Anthropic 当前条款为准；不确定时保守处理。
  • DeepSeek ToS：API 使用范围、数据留存政策以 DeepSeek 平台说明 为准。
  • 凭证安全：DEEPSEEK_API_KEY 等同生产密钥；代理模式（localhost:3200）只应在本机可信环境运行。
  • 远程控制：deepclaude --remote 依赖 Anthropic bridge WebSocket，模型可走 DeepSeek，但仍需要 claude.ai 订阅——不是绕过官方账号体系。

国内网络环境下，DeepSeek 默认后端服务器在中国，Claude Code 的 bridge/部分 passthrough 仍可能访问 Anthropic 基础设施；全链路可达性以你本机实测为准，仓库 README 未保证每项功能在受限网络下可用。

常见问题

deepclaude 和直接改 Claude Code 环境变量有什么区别？

功能上接近：核心是同一组 ANTHROPIC_* 变量。deepclaude 的价值在于封装多后端切换、会话结束自动恢复、成本对比、--benchmark 延迟测试，以及 remote 模式的本地 proxy；少踩「改完全局 bashrc 忘记还原」的坑。

能不能完全替代 Claude Code Max 订阅？

不能。heavy 用量下项目 README 估算 DeepSeek 仍可能到 ~$50–80/月，但低于 $200 Max cap；然而 MCP、视觉、部分 Anthropic 独有功能缺失，且 remote control 仍要 claude.ai 账号。它是降本通道，不是订阅克隆。

出问题了先查什么？

顺序建议：deepclaude --status（Key 和后端）→ 同一任务 --backend anthropic 对照 → 查仓库 Issues 是否已知兼容限制 → 缩小到最小复现 prompt。工具调用 JSON 格式错误优先怀疑兼容层，而非 Claude Code 本身。

参考资料