
deepclaude架构剖析两个Shell脚本加一个本地代理如何换掉Claude Code的大脑【免费下载链接】deepclaudeUse Claude Codes autonomous agent loop with DeepSeek V4 Pro, OpenRouter, or any Anthropic-compatible backend. Same UX, 17x cheaper.项目地址: https://gitcode.com/gh_mirrors/deepc/deepclaudedeepclaude 是一个极简的开源项目只用两个 Shell 启动脚本加一个本地 Node.js 代理就能把 Claude Code 的大脑从昂贵的 Anthropic 模型换成 DeepSeek V4 Pro、OpenRouter 等 Anthropic 兼容后端——同样的自主编程体验成本最高降低 17 倍。本文带你完整拆解这套架构脚本改了什么、代理拦了什么、流量如何分流。 deepclaude 项目结构一览整个仓库非常小每个文件职责单一文件作用deepclaude.shmacOS/Linux 启动脚本约 278 行deepclaude.ps1Windows PowerShell 启动脚本proxy/model-proxy.js本地代理核心分流、重映射、记账proxy/start-proxy.js代理启动入口支持热切换模式proxy/README.md代理设计文档 核心思路保留身体换掉大脑Claude Code 的架构可以拆成两部分CLI 本身是身体工具循环、文件读写、bash 执行、git 操作模型 API 是大脑负责思考和决策。deepclaude 的哲学就是身体不动只换大脑你的终端 └── Claude Code CLI工具循环、文件编辑、bash、git —— 完全不变 └── API 调用 → DeepSeek V4 Pro$0.87/M而非 Anthropic$15/M这可行的前提是Claude Code 允许通过环境变量指定 API 地址和模型名而 DeepSeek 恰好提供了 Anthropic 协议兼容端点。于是换模型退化成了一次环境变量重定向完全不用改 Claude Code 一行代码。⚙️ Shell 脚本架构只做三件事以 deepclaude.sh 为例它的全部工作流只有三步1️⃣ 解析参数—— 支持--backendds/or/fw/anthropic、--remote、--status、--cost、--benchmark、--switch等选项。2️⃣ 设置会话级环境变量—— 这是换大脑的关键动作环境变量作用ANTHROPIC_BASE_URL把 API 请求指向 DeepSeek / OpenRouter / FireworksANTHROPIC_AUTH_TOKEN对应后端的 API KeyANTHROPIC_DEFAULT_OPUS_MODEL/_SONNET_MODEL/_HAIKU_MODEL各档位任务使用的模型名CLAUDE_CODE_SUBAGENT_MODEL子代理subagent使用的模型3️⃣ 启动并交接—— 用exec claude直接把进程替换成 Claude Code见 deepclaude.sh 启动逻辑退出即结束Windows 版则会在会话结束后显式清理这些变量保证你的原始配置不被污染。默认后端 DeepSeek 的映射规则在 resolve_backend 中Opus/Sonnet 档位都映射到deepseek-v4-proHaiku 档位和子代理映射到更快的deepseek-v4-flash。 本地代理架构为什么还需要一个 proxy普通启动模式其实只靠脚本就够了——但远程控制模式--remote用手机浏览器操作 Claude Code有个特殊问题它存在两条独立通道Bridge 通道WebSocket 硬编码连向 Anthropic必须走 Anthropic 的 OAuth 登录模型 API 通道通过ANTHROPIC_BASE_URL可配置。如果直接把认证 Token 换成 DeepSeek 的 KeyBridge 就会断掉。所以 deepclaude 启动了一个监听在127.0.0.1:3200的本地代理来拆分流量设计说明见 proxy/README.mdclaude remote-control ├── Bridge WebSocket → Anthropic保持 OAuth 登录 └── 模型 API 调用 → localhost:3200本地代理 ├── /v1/messages → DeepSeek$0.87/M └── 其他一切 → Anthropic透明透传代理由 start-proxy.js 拉起端口被占用时会自动尝试1顺延会话结束时由脚本的退出钩子cleanup_proxy自动关闭不残留任何进程。 代理内部细节四个关键机制model-proxy.js 看似只有一个文件却藏着四个让换脑真正可用的工程细节模型名重映射Claude Code 请求claude-opus-4-6代理在转发前改写成deepseek-v4-pro见 MODEL_REMAP对 CLI 完全透明。清洗 thinking 块DeepSeek 会拒绝它没生成过的思考块代理会把请求体里的 thinking 内容块剥掉避免上游返回 400。补齐 usage 字段DeepSeek 的流式响应可能缺少 token 用量字段会导致 Claude Code 崩溃代理里的UsageNormalizer流式转换器会即时补上见 UsageNormalizer。成本记账每路请求的 input/output token 都被记录访问/_proxy/cost即可拿到真实花费、Anthropic 等价花费和节省金额。此外还有/_proxy/mode热切换后端和/_proxy/status当前模式与运行时长两个控制端点且/mode端点会校验请求来源仅限本机防止被外部调用。 实测会话中热切换模型后端得益于/_proxy/mode端点你可以在不重启Claude Code 的情况下随时换后端——在终端或 VS Code 插件里输入/deepseek斜杠命令即可deepclaude 在终端中通过本地代理热切换 DeepSeek 模型后端日常任务跑 DeepSeek 省钱遇到复杂推理难题时切回 Anthropic Opus 兜底--backend anthropic或/anthropic命令一键完成。 deepclaude 成本对比DeepSeek 的自动上下文缓存命中价 $0.004/M比未缓存便宜 120 倍让多步 Agent 循环变得极其便宜使用强度Anthropic Maxdeepclaude (DeepSeek)节省轻度10 天/月$200/月有上限约 $20/月90%重度25 天/月$200/月有上限约 $50/月75%带自动循环$200/月有上限约 $80/月60%四个后端的价格与定位DeepSeek默认支持自动缓存、OpenRouter最便宜、Fireworks最快、Anthropic难题兜底。 远程控制浏览器里跑 DeepSeek 版 Claude Codedeepclaude --remote会打印一个claude.ai/code/...链接用手机、平板或任意浏览器打开即可操作本机会话——而模型调用走的是本地代理转发到 DeepSeek前提条件已登录 Claude Code、有 claude.ai 订阅Bridge 依赖 Anthropic 基础设施、Node.js 18。⚖️ 适用场景与已知局限正常工作 ✅受限功能 ⚠️文件读写、bash 执行、Glob/Grep 搜索图像/视觉输入DeepSeek 端点不支持多步自主工具循环、子代理MCP 服务器工具Git 操作、/init项目初始化Anthropic 的cache_control缓存标记被忽略官方给出的定位很诚实约 80% 的常规编码任务DeepSeek V4 Pro 与 Claude Opus 表现相当剩下约 20% 的复杂推理任务建议切回--backend anthropic。 快速上手2 分钟获取一个 DeepSeek API Key克隆仓库git clone https://gitcode.com/gh_mirrors/deepc/deepclaude设置环境变量export DEEPSEEK_API_KEYsk-你的KeyWindows 用setx DEEPSEEK_API_KEY赋予执行权限并启动chmod x deepclaude.sh ./deepclaude.sh用deepclaude --status检查后端状态--cost查看价格对比--benchmark测各家延迟更完整的选项说明见 README.md 与 deepclaude.sh 帮助信息。总结deepclaude 用不到 1000 行代码演示了一个优雅的技巧利用 Claude Code 的环境变量扩展点做无侵入换脑再用一个轻量本地代理解决协议兼容性和远程控制的双通道问题。如果你的日常是常规编码任务而非极限推理这套两个脚本 一个代理的方案值得放进工具箱。【免费下载链接】deepclaudeUse Claude Codes autonomous agent loop with DeepSeek V4 Pro, OpenRouter, or any Anthropic-compatible backend. Same UX, 17x cheaper.项目地址: https://gitcode.com/gh_mirrors/deepc/deepclaude创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考