ErlichLiu/DeepClaude

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

简介

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

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.接入你的日常大语言模型对话聊天使用。

Implementation

How to run

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

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 我们一起获得奖励额度 **

✅ Step 1. 安装 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

🚀 Step 2. 拉取镜像并运行项目

打开终端或命令行，输入以下命令：

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

⸻

Step 4. 开始配置：打开浏览器访问 http://localhost:8000/config 输入默认 api key：123456 （如果你运行在云端，请尽快登录后在系统设置内更改，避免被其他人盗用，本地登录则无需更改）

按照提示在“推理模型这一栏”配置一个火山云引擎的 api key，点击编辑，粘贴进去 api key 后点击保存即可

是否支持原生推理选项控制了两套针对推理模型返回思考内容.

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

大多数服务商提供的deepseek-r1均支持原生推理, 所以推荐默认开启. 如果不确定可以在外部使用聊天框架(Chatbox)测试模型响应内容. 如果出现<think></think>标签则需要关闭支持原生推理选项.

不支持原生推理的deepseek-r1可能需要prompt来触发思考, 若日志中收集到推理内容长度一直为0, 而且出现<think>字样, 则考虑检查此因素:

按照提示在“目标模型”配置一个 Claude 3.7 Sonnet 的 api key 以及一个 Gmeini 的 api key，Gemini 的 api key 可以在：https://aistudio.google.com/apikey 获取 同理，也可以配置一个 Gemini 的 api key 分别到 deepgeminiflash 和 deepgeminipro

Step 5. 配置程序到你的 Chatbox（推荐 Cherry Studio NextChat、ChatBox、LobeChat）

如果你的客户端是 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，你可以在此了解更多

Automatic fork sync

项目已经支持 Github Actions 自动更新 fork 项目的代码，保持你的 fork 版本与当前 main 分支保持一致。如需开启，请 frok 后在 Settings 中开启 Actions 权限即可。

Technology Stack

• FastAPI
• UV as package manager
• Docker

Star History

Buy me a coffee

About Me

• Email: [email protected]
• Website: Erlichliu