DeepClaude — Claude Code 多后端代理
用 DeepSeek V4 Pro、OpenRouter 等任意 Anthropic 兼容后端驱动 Claude Code,同等体验,成本降低 17 倍。
证据显示:脚本设置环境变量并启动代理,但未明确最小权限原则;用户需手动设置API密钥,但代理自动启动可能未明确确认;数据流图清晰展示代理路径,但未说明日志或数据保留;API密钥作为环境变量处理,但未提及加密或安全存储;依赖未列出,无法评估安全性;代理可能修改系统环境变量,但未说明影响范围;退出时恢复原始设置,但未提供回滚机制;作者身份未验证,但README和LICENSE提供了归属。扣分原因:缺少权限最小化、用户确认、敏感数据处理细节、依赖安全、外部影响范围、回滚机制和来源验证。
证据显示:README描述一致,但未提供测试或验证;依赖未列出,无法确认可用性;错误处理未详细说明。扣分原因:缺乏测试证据、依赖可用性未验证、错误消息不明确。
证据显示:明确目标用户为开发者,场景包括终端和VS Code;能力边界清晰列出支持和不支持的功能;触发方式明确(命令行和斜杠命令);环境支持Windows、macOS、Linux,但未提及特定版本要求。扣分原因:环境适配未详细说明版本兼容性。
证据显示:README结构清晰,包含安装、使用、配置;安装步骤详细;命名稳定但未提及版本控制;提供示例和FAQ;已知限制明确列出;MIT许可证完整;无版本历史或变更日志;维护责任未明确。扣分原因:缺少版本控制、变更日志和维护责任说明。
证据显示:输出为终端命令和代理响应,格式清晰;提供成本节省和性能对比,边际价值明显;成本效益分析详细,但未提供实际测试数据。扣分原因:缺乏实际运行验证。
证据显示:README中的声明未提供外部来源;无交叉验证;事实和推断混合,如性能比较未注明来源。扣分原因:缺乏可追溯性、交叉验证和事实推断分离。
- 代理会拦截所有API调用,可能引入中间人风险,需确保代理来源可信。
- API密钥以环境变量存储,未提及加密或安全存储,存在泄露风险。
- 依赖未列出,无法评估供应链安全。
- 作者身份未验证,需谨慎使用。
这个 Agent 能做什么,适合哪些场景?
DeepClaude 是一个让 Claude Code 的自主代理循环使用更便宜模型后端的工具。它通过设置环境变量(如 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN)将 Claude Code 的 API 调用重定向到 DeepSeek V4 Pro、OpenRouter 或 Fireworks AI,同时保留完整的工具调用能力(文件编辑、bash 执行、子代理)。项目包含 shell/PowerShell 脚本(deepclaude.sh/deepclaude.ps1)、一个本地代理(localhost:3200,用于实时切换后端和成本追踪)以及远程控制功能(--remote),可在浏览器中使用。支持通过 slash 命令、CLI 标志或 VS Code 任务在会话中切换后端。
DeepClaude 启动 Claude Code,通过设置环境变量指向替代后端。它提供 CLI 命令,如 deepclaude --backend or(OpenRouter)和 deepclaude --cost(价格对比)。本地代理位于 localhost:3200,拦截 API 调用,并通过 /_proxy/mode 端点实现实时切换,通过 /_proxy/cost 端点追踪 token 使用和成本节约。远程控制功能(--remote)启动一个代理,将模型调用路由到 DeepSeek,同时保持 Anthropic 桥接 WebSocket。脚本验证 API 密钥(DEEPSEEK_API_KEY 等),并支持子代理模型映射。
- 个人开发者希望以较低成本使用 Claude Code 的自主代理,同时希望使用 DeepSeek V4 Pro 的模型。
- 团队希望在 Claude 订阅的固定成本之外,通过按 token 付费的后端来节省大量代理使用成本。
- 用户需要在会话中频繁切换模型,例如从 DeepSeek 切换到 Anthropic 处理复杂推理任务,而无需重启 CLI。
- 希望从浏览器或移动设备远程控制 Claude Code 会话的用户,同时将模型调用路由到更便宜的后端。
- 需要监控 token 使用和成本节约的开发者,通过代理的 /_proxy/cost 接口实现。
- 希望将工具流程(如 OpenRouter)用于其多模型路由,而非单一模型提供商的代理。
这个 Agent 有哪些优点和局限?
- 显著成本降低:DeepSeek 输出约 $0.87/M token,对比 Anthropic $15/M,约 17 倍便宜。
- 保持 Claude Code 的完整功能,包括文件编辑、bash 执行和子代理启动。
- 支持通过 CLI、slash 命令或 VS Code 任务实时切换多个后端(DeepSeek、OpenRouter、Fireworks)。
- 内置成本追踪,通过 /_proxy/cost 端点量化节约量。
- 提供远程控制选项,可在浏览器中使用,同时将模型远程路由到非 Anthropic 后端。
- 仅支持文本:图像/视觉输入不受支持(DeepSeek 的 Anthropic 端点不支持图像)。
- MCP 服务器工具在兼容层中不受支持。
- Anthropic 的 cache_control 被忽略;仅 DeepSeek 自动缓存适用。
- 复杂推理(约 20% 的工作)仍需要 Anthropic Opus,可能抵消部分节约。
- 安装需要手动的 PATH 修改和符号链接,对非技术用户可能造成障碍。
如何安装或部署这个 Agent?
在 Windows 上,将 deepclaude.ps1 复制到 PATH 目录,或添加到 PATH。在 macOS/Linux 上,chmod +x deepclaude.sh 并符号链接到 /usr/local/bin/deepclaude。安装前需获取 API 密钥:在 DeepSeek 平台注册并添加 $5 余额,设置环境变量 DEEPSEEK_API_KEY(Windows 使用 setx,macOS/Linux 使用 export)。可选地,设置 OPENROUTER_API_KEY 或 FIREWORKS_API_KEY。需要 Node.js 18+ 用于代理。
如何使用这个 Agent?
在终端中运行 deepclaude 以使用 DeepSeek V4 Pro 启动 Claude Code。使用 --backend 标志选择后端:deepclaude --backend or(OpenRouter)、--backend fw(Fireworks AI)、--backend anthropic(Anthropic)。在会话中,通过添加自定义 slash 命令(~/.claude/commands/deepseek.md 等)或运行 deepclaude --switch ds 实时切换。远程控制:deepclaude --remote。通过 curl http://127.0.0.1:3200/_proxy/cost 查看成本。
这个 Agent 与同类方案有什么区别?
该仓库明确对比了 Anthropic 的 Claude Opus 与替代后端(DeepSeek、OpenRouter、Fireworks)的价格和智能差异。它定位为更便宜的替代方案,应用于常规任务,而 Claude Opus 保留用于复杂推理。