DeepClaude

GitHub
2.8k 498 简单 1 次阅读 昨天MIT图像开发框架Agent
AI 解读 由 AI 自动生成,仅供参考

DeepClaude 是一款开源的 AI 模型编排工具,旨在通过组合不同大模型的优势,实现"1+1>2"的效果。它巧妙地将擅长逻辑推理的 DeepSeek R1 作为“架构师”,负责深度思考与规划;再衔接擅长代码生成或内容创作的 Claude 3.7 Sonnet、Gemini 2.5 Pro 等模型作为“执行者”,输出高质量结果。这种架构不仅解决了单一模型在复杂任务中推理能力或表达能力不足的问题,还显著降低了使用顶级模型的成本,部分组合甚至可实现免费高效运行。

DeepClaude 特别适合开发者、技术研究人员及需要处理复杂编程或创意内容的用户。其核心亮点在于完全兼容 OpenAI 接口标准,这意味着用户无需修改现有代码或应用配置,即可无缝接入这一强大的模型组合。此外,工具支持流式与非流式输出,提供便捷的图形化配置界面和 Docker 一键部署方案,让技术门槛大幅降低。无论是构建智能编程助手,还是打造高性能内容创作平台,DeepClaude 都能让用户以更低成本体验到当前业界领先的 AI 综合能力。

使用场景

某全栈开发团队正在紧急重构一个遗留的电商后台系统,需要在极短时间内完成复杂业务逻辑的代码迁移与新功能开发。

没有 DeepClaude 时

  • 推理与表达割裂:单独使用 DeepSeek R1 虽能理清复杂算法逻辑,但生成的代码注释晦涩、变量命名不规范,后续维护成本高;而单用 Claude 3.7 Sonnet 处理深层数学运算或复杂架构设计时,偶尔会出现逻辑幻觉。
  • 成本与性能难以平衡:为了兼顾逻辑深度和代码质量,团队不得不分别调用两个模型的 API 并手动拼接结果,导致开发流程断裂,且双重计费使单次任务成本飙升。
  • 工作流繁琐低效:开发者需要在不同聊天窗口间切换,手动复制“思考过程”和“最终代码”,不仅容易出错,还无法利用现有 IDE 插件(如 Cursor、Aider)的自动化能力。

使用 DeepClaude 后

  • 强强联合的无缝体验:DeepClaude 自动让 DeepSeek R1 担任“架构师”进行深度推理,再交由 Claude 3.7 Sonnet 作为“编辑”输出高质量、符合规范的代码,一次性获得逻辑严密且易读的完整方案。
  • 极致性价比:通过内部优化调度,该组合在达到超越 o1 模型基准测试效果的同时,成本仅为之前的 1/14,让团队能无压力地大规模运行自动化重构任务。
  • 原生兼容现有工具:凭借 OpenAI 兼容接口,团队无需修改任何配置,直接在熟悉的编程助手插件中调用 deepclaude 模型,实现了从“思考”到“落地”的流式极速响应。

DeepClaude 通过将顶级推理模型与最强代码模型深度融合,以极低门槛和成本为开发者提供了当前业界最优的“思考 + 执行”一体化解决方案。

运行环境要求

操作系统
  • Linux
  • macOS
  • Windows
GPU

未说明 (本项目为 API 代理/编排服务,非本地模型推理,通常无需 GPU)

内存

未说明 (取决于 Docker 容器基础运行需求,通常 512MB-1GB 即可)

依赖
notes1. 推荐使用 Docker 部署(支持 docker run 或 docker-compose),无需在宿主机手动安装 Python 环境。 2. 核心功能是组合不同模型的 API(如 DeepSeek R1 + Claude/Gemini),自身不运行大模型,因此对本地硬件无特殊要求。 3. 需自行准备第三方 API Key(DeepSeek、Anthropic/Claude、Google/Gemini)。 4. 默认访问地址为 http://localhost:8000,配置界面位于 /config,默认 API 密钥为 123456(云端部署建议修改)。 5. 客户端对接时需注意:Cherry Studio/ChatBox 直接连接根路径,LobeChat 需连接 /v1 路径。
python未说明 (通过 Docker 镜像部署,内部使用 uv 管理,具体版本对宿主透明)
FastAPI
uv
Docker
DeepClaude hero image

快速开始

DeepClaude 🐬🧠 - 与 OpenAI 兼容(deepclaude & deepgemini)

灵感源自 getasterisk/deepclaude

GitHub 许可证 兼容

特别说明:
在最新的 1.0 版本,我们已经实现了配置界面,部署更简单。 1.编程:推荐 DeepSeek r1 + Claude Sonnet 4 组合,效果最好; 2.内容创作:推荐 DeepSeek r1 + Gemini 2.5 Flash 或 Gemini 2.5 Pro 组合,效果最好,并且可以完全免费使用。
对于不太会部署,只是希望使用上最强组合模型的朋友,可以直接访问 Erlich 个人网站自助购买按量付费的 API:https://erlich.fun/deepclaude-pricing 也可以直接联系 Erlich(微信号:geekthings)

赞助商:问小白 https://www.wenxiaobai.com (丝滑使用 DeepSeek r1 满血版, 支持联网、上传文件、图片、AI 创作 PPT 等)

友情链接:Ten Agent: https://github.com/TEN-framework/TEN-Agent

更新日志: 2025-05-29.2:更新 Docker Image 运行平台支持,可以通过 `docker pull erlichliu/deepclaude ` 拉取到本地运行,自动选择合适的平台版本。

2025-05-29.1:feat:系统配置添加 deepseek r1 的 max_tokens 设置,降低成本。

2025-05-27.2:支持配置文件的导入导出模式,方便升级或部署后反复进行配置。

2025-05-27.1:适配 Gemini API 流式响应上的结束标记处理顺序问题。

2025-05-22.3:优化 openai 兼容格式返回结束标志,改善近期 deepgeminipro 中断回复的问题。

2025-05-22.2:优化组合模型之间的衔接 Prompt,提高不同模型本身的能力表达。

2025-05-22.1:支持可关闭 gemini 2.5 flash 的思考,节省 tokens 消耗,针对 gemini 2.5 pro 采用提示词优化的方式也可以平均每次降低 30% 的成本消耗。

2025-05-16.1:支持更友好的多段落报错返回,尤其是针对超过上下文长度的报错返回,可以更好的适配前端界面的报错。

2025-03-22.1:支持根据不同模型设置是否开启代理,提高运行效率。

2025-03-10.1:deepseek r1 推理部分 max_token 改为 5,节省输出 Tokens 消耗;非流式输出部分增加 reasoning_content 数据字段的返回;将非流式输出设置为缺省值,方便 dify 等工具使用。

2025-03-05.1:更改docker compose配置,使用volume将容器配置文件绑定至本地,避免重启容器时丢失配置。同时设置失败自动重启。

2025-03-02.1:更新 1.0 版本,支持图形化配置界面,取消 .env 配置,预配置模板,配置更方便

2025-02-25.1:添加 system message 对于 Claude 3.5 Sonnet 的支持

2025-02-23.1:重构代码,支持 OpenAI 兼容模型,deepgeminiflash 和 deepgeminipro 配置更方便(请详细查看 READEME 和 .env.example 内的说明)。

2025-02-21.1:添加 Claude 这段的详细数据结构安全检查。

2025-02-16.1:支持 claude 侧采用请求体中的自定义模型名称。(如果你采用 oneapi 等中转方,那么现在可以通过配置环境变量或在 API 请求中采用任何 Gemini 等模型完成后半部分。接下来将重构代码,更清晰地支持不同的思考模型组合。)

2025-02-08.2:支持非流式请求,支持 OpenAI 兼容的 models 接口返回。(⚠️ 当前暂未实现正确的 tokens 消耗统计,稍后更新)

2025-02-08.1:添加 Github Actions,支持 fork 自动同步、支持自动构建 Docker 最新镜像、支持 docker-compose 部署

2025-02-07.2:修复 Claude temperature 参数可能会超过范围导致的请求失败的 bug

2025-02-07.1:支持 Claude temputerature 等参数;添加更详细的 .env.example 说明

2025-02-06.1:修复非原生推理模型无法获得到推理内容的 bug

2025-02-05.1:支持通过环境变量配置是否是原生支持推理字段的模型,满血版本通常支持

2025-02-04.2:支持跨域配置,可在 .env 中配置

2025-02-04.1:支持 Openrouter 以及 OneAPI 等中转服务商作为 Claude 部分的供应商

2025-02-03.3:支持 OpenRouter 作为 Claude 的供应商,详见 .env.example 说明

2025-02-03.2:由于 deepseek r1 在某种程度上已经开启了一个规范,所以我们也遵循推理标注的这种规范,更好适配支持的更好的 Cherry Studio 等软件。

2025-02-03.1:Siliconflow 的 DeepSeek R1 返回结构变更,支持新的返回结构

简介

最近 DeepSeek 推出了 DeepSeek R1 模型,在推理能力上已经达到了第一梯队。但是 DeepSeek R1 在一些日常任务的输出上可能仍然无法匹敌 Claude 3.5 Sonnet。Aider 团队最近有一篇研究,表示通过采用 DeepSeek R1 + Claude 3.5 Sonnet 可以实现最好的效果

deepseek r1 and sonnet benchmark

R1 as architect with Sonnet as editor has set a new SOTA of 64.0% on the aider polyglot benchmark. They achieve this at 14X less cost compared to the previous o1 SOTA result。

本项目受到该项目的启发,通过 fastAPI 完全重写,经过 15 天大量社区用户的真实测试,我们创作了一些新的组合使用方案。

1.编程:推荐使用 deepclaude = deepseek r1 + claude 3.7 sonnet; 2.内容创作:推荐使用 deepgeminipro = deepseek r1 + gemini 2.0 pro (该方案可以完全免费使用); 3.日常实验:推荐 deepgeminiflash = deepseek r1 + gemini 2.0 flash (该方案可以完全免费使用)。

项目支持 OpenAI 兼容格式的输入输出,支持 DeepSeek 官方 API 以及第三方托管的 API、生成部分也支持 Claude 官方 API 以及中转 API,并对 OpenAI 兼容格式的其他 Model 做了特别支持。

🔥推荐使用方法: 1.用户可以自行运行在自己的服务器,并对外提供开放 API 接口,接入 OneAPI 等实现统一分发。

2.接入你的日常大语言模型对话聊天使用。

实施

image-20250201212456050

如何运行

项目支持本地运行和服务器运行,推荐使用服务器部署,实现随时随处可访问的最强大语言模型服务,甚至可以完全免费使用。

1. 获得运行所需的 API

  1. 获取 DeepSeek API,推荐采用 PPIO(派欧云)最新的 DeepSeek R1 0528,点击链接注册,新用户可以获得 15 元免费额度,再邀请人还可以获得 30 元:https://ppio.cn/user/register?invited_by=TXTPQF
  2. 获取 Claude 的 API KEY:https://console.anthropic.com。(也可采用其他中转服务,如 DMXapi、Openrouter 以及其他服务商的 API KEY)
  3. 获取 Gemini 的 API KEY:https://aistudio.google.com/apikey (有免费的额度,日常够用)

2. 开始运行(使用 Docker)

** 强烈推荐 Zeabur,通过 Zeabur 购买新加坡或日本的服务器最为划算,仅需 2 美元即可。如果你是新用户,可以点击:https://zeabur.com/referral?referralCode=ErlichLiu,我们都能获得奖励额度 **

✅ 第一步:安装 Docker

请确保你已经安装了 Docker Desktop(适用于 macOS 和 Windows),或 Docker Engine(适用于 Linux)。

Windows 下载安装地址:https://docs.docker.com/desktop/setup/install/windows-install/ macOS 下载安装地址:https://docs.docker.com/desktop/setup/install/mac-install/

安装完成后,确保在终端中运行以下命令没有报错:

docker --version

🚀 第二步:拉取镜像并运行项目

打开终端或命令行,输入以下命令:

docker run -p 8000:8000 erlichliu/deepclaude:latest

运行后你可以访问:

http://localhost:8000/config

即可使用该服务。

📦 可选:后台运行 + 自动重启(建议部署时使用)

docker run -d --restart unless-stopped -p 8000:8000 erlichliu/deepclaude:latest

🧪 开发者:如果你想构建自己的镜像(而不是用已有镜像)

git clone https://github.com/ErlichLiu/DeepClaude.git
cd DeepClaude
docker build -t deepclaude:dev .
docker run -p 8000:8000 deepclaude:dev

第四步:开始配置——打开浏览器访问 http://localhost:8000/config,输入默认 API 密钥:123456。如果你是在云端运行,请尽快登录并在系统设置中更改密钥,以避免被他人盗用;如果是本地运行,则无需更改。 配置授权页面

按照提示,在“推理模型”一栏配置一个火山云引擎的 API 密钥,点击编辑,粘贴 API 密钥后保存即可。 配置火山云引擎的 API 密钥

“是否支持原生推理”选项控制着两种针对推理模型返回思考内容的方式:

  • 支持原生推理:推理模型会在 reasoning_content 字段中返回推理内容,在 content 字段中返回回答内容。例如:
    • DeepSeek 官方的 deepseek-reasoner
    • Siliconflow 的 deepseek-ai/deepseek-r1
  • 不支持原生推理:推理模型会将推理内容以 <think>...</think> 标签包裹后,直接放在 content 字段中返回。例如:
    • 派欧算力云的 deepseek/deepseek-r1deepseek/deepseek-r1/communitydeepseek/deepseek-r1-turbo
    • AiHubMix 的 aihubmix-DeepSeek-R1
    • Cluade 3.7 Sonnet Thinking

大多数服务商提供的 DeepSeek R1 都支持原生推理,因此建议默认开启。如果不确定,可以在外部使用聊天框架(Chatbox)测试模型响应内容。若出现 <think>...</think> 标签,则需要关闭“支持原生推理”选项。

不支持原生推理的 DeepSeek R1 可能需要特定的 prompt 来触发思考。如果日志中显示推理内容长度一直为 0,且出现了 <think> 字样,则应考虑检查这一因素:

image

按照提示,在“目标模型”中配置一个 Claude 3.7 Sonnet 的 API 密钥以及一个 Gemini 的 API 密钥。Gemini 的 API 密钥可在:https://aistudio.google.com/apikey 获取。 配置 Claude 3.7 Sonnet 的 API 密钥 同样地,也可以分别为 DeepGeminiflash 和 DeepGeminipro 配置 Gemini 的 API 密钥。 配置 Gemini API 密钥

第五步:将程序配置到你的 Chatbox 中(推荐 Cherry StudioNextChatChatBoxLobeChat

如果你的客户端是 Cherry Studio 或 Chatbox(选择 OpenAI API 模式,注意不是 OpenAI 兼容模式) API 地址为 http://127.0.0.1:8000 API 密钥为默认的 123456,如果你在系统设置内进行了修改,则使用你修改后的密钥即可。 需要手动配置三个模型,分别为 DeepClaude、DeepGeminiflash 和 DeepGeminipro。

如果你的客户端是 LobeChat API 地址为:http://127.0.0.1:8000/v1 API 密钥为默认的 123456,如果你在系统设置内进行了修改,则使用你修改后的密钥即可。 支持获取模型列表,可以同时获取到 DeepClaude、DeepGeminiflash 和 DeepGeminipro 模型。

注:本项目采用 uv 作为包管理器,这是一种更快速、更现代的管理方式,用于替代 pip。你可以在此了解更多

自动分叉同步

项目已支持 Github Actions 自动更新分叉项目的代码,使你的分叉版本与当前 main 分支保持一致。如需开启,请先分叉,然后在 Settings 中启用 Actions 权限即可。

技术栈

星标历史

星标历史图

请我喝杯咖啡

微信赞赏码

关于我

常见问题

相似工具推荐

openclaw

OpenClaw 是一款专为个人打造的本地化 AI 助手,旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚,能够直接接入你日常使用的各类通讯渠道,包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息,OpenClaw 都能即时响应,甚至支持在 macOS、iOS 和 Android 设备上进行语音交互,并提供实时的画布渲染功能供你操控。 这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地,用户无需依赖云端服务即可享受快速、私密的智能辅助,真正实现了“你的数据,你做主”。其独特的技术亮点在于强大的网关架构,将控制平面与核心助手分离,确保跨平台通信的流畅性与扩展性。 OpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者,以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力(支持 macOS、Linux 及 Windows WSL2),即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你

349.3k|★★★☆☆|2周前
Agent开发框架图像

n8n

n8n 是一款面向技术团队的公平代码(fair-code)工作流自动化平台,旨在让用户在享受低代码快速构建便利的同时,保留编写自定义代码的灵活性。它主要解决了传统自动化工具要么过于封闭难以扩展、要么完全依赖手写代码效率低下的痛点,帮助用户轻松连接 400 多种应用与服务,实现复杂业务流程的自动化。 n8n 特别适合开发者、工程师以及具备一定技术背景的业务人员使用。其核心亮点在于“按需编码”:既可以通过直观的可视化界面拖拽节点搭建流程,也能随时插入 JavaScript 或 Python 代码、调用 npm 包来处理复杂逻辑。此外,n8n 原生集成了基于 LangChain 的 AI 能力,支持用户利用自有数据和模型构建智能体工作流。在部署方面,n8n 提供极高的自由度,支持完全自托管以保障数据隐私和控制权,也提供云端服务选项。凭借活跃的社区生态和数百个现成模板,n8n 让构建强大且可控的自动化系统变得简单高效。

184.7k|★★☆☆☆|今天
数据工具开发框架Agent

AutoGPT

AutoGPT 是一个旨在让每个人都能轻松使用和构建 AI 的强大平台,核心功能是帮助用户创建、部署和管理能够自动执行复杂任务的连续型 AI 智能体。它解决了传统 AI 应用中需要频繁人工干预、难以自动化长流程工作的痛点,让用户只需设定目标,AI 即可自主规划步骤、调用工具并持续运行直至完成任务。 无论是开发者、研究人员,还是希望提升工作效率的普通用户,都能从 AutoGPT 中受益。开发者可利用其低代码界面快速定制专属智能体;研究人员能基于开源架构探索多智能体协作机制;而非技术背景用户也可直接选用预置的智能体模板,立即投入实际工作场景。 AutoGPT 的技术亮点在于其模块化“积木式”工作流设计——用户通过连接功能块即可构建复杂逻辑,每个块负责单一动作,灵活且易于调试。同时,平台支持本地自托管与云端部署两种模式,兼顾数据隐私与使用便捷性。配合完善的文档和一键安装脚本,即使是初次接触的用户也能在几分钟内启动自己的第一个 AI 智能体。AutoGPT 正致力于降低 AI 应用门槛,让人人都能成为 AI 的创造者与受益者。

183.6k|★★★☆☆|今天
Agent语言模型插件

stable-diffusion-webui

stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面,旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点,将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。 无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师,还是想要深入探索模型潜力的开发者与研究人员,都能从中获益。其核心亮点在于极高的功能丰富度:不仅支持文生图、图生图、局部重绘(Inpainting)和外绘(Outpainting)等基础模式,还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外,它内置了 GFPGAN 和 CodeFormer 等人脸修复工具,支持多种神经网络放大算法,并允许用户通过插件系统无限扩展能力。即使是显存有限的设备,stable-diffusion-webui 也提供了相应的优化选项,让高质量的 AI 艺术创作变得触手可及。

162.1k|★★★☆☆|2周前
开发框架图像Agent

everything-claude-code

everything-claude-code 是一套专为 AI 编程助手(如 Claude Code、Codex、Cursor 等)打造的高性能优化系统。它不仅仅是一组配置文件,而是一个经过长期实战打磨的完整框架,旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。 通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能,everything-claude-code 能显著提升 AI 在复杂任务中的表现,帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略,使得模型响应更快、成本更低,同时有效防御潜在的攻击向量。 这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库,还是需要 AI 协助进行安全审计与自动化测试,everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目,它融合了多语言支持与丰富的实战钩子(hooks),让 AI 真正成长为懂上

161.7k|★★☆☆☆|今天
开发框架Agent语言模型

opencode

OpenCode 是一款开源的 AI 编程助手(Coding Agent),旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件,而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码,还是排查难以定位的 Bug,OpenCode 都能通过自然语言交互高效完成,显著减少开发者在重复性劳动和上下文切换上的时间消耗。 这款工具专为软件开发者、工程师及技术研究人员设计,特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构,这意味着用户可以审查代码逻辑、自定义行为策略,甚至私有化部署以保障数据安全,彻底打破了传统闭源 AI 助手的“黑盒”限制。 在技术体验上,OpenCode 提供了灵活的终端界面(Terminal UI)和正在测试中的桌面应用程序,支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具,安装便捷,并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客,还是渴望提升产出的独立开发者,OpenCode 都提供了一个透明、可信

144.3k|★☆☆☆☆|4天前
Agent插件