← 返回目录

MiniClaude

社区

非标准 Server

轻量级本地 AI 编程助手，基于 Claude Code 精简改造

这不是典型的可直接连接的 MCP Server，使用前请先阅读源仓库说明。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 391 / 438
Stars: ★ 171 热门
传输方式: stdio（本地进程）
运行环境: Bun 1.3.11+
凭据: 需要 API Key / 凭据
许可证: 其他 / 未声明
最近提交: 5 个月前

35FMRS · D

由社区开发者 txl16095 创建，基于 Claude Code 精简，代码量约为原版的 20%。

最强项 · 维护活跃度 10/20 最弱项 · 安全与权限 4/20

可靠性

5/20

安全与权限

4/20

维护活跃度

10/20

文档质量

8/20

安装易用性

8/20

查看各项评分依据

可靠性 5/20: 证据显示这是一个基于 Claude Code 的完整客户端应用，但服务器清单未缓存，且 README 中未提供明确的 MCP 服务器起点或工具列表。项目声称支持 MCP 协议，但无具体实现细节。未发现测试或 CI 配置。从静态审查来看，无法验证其能正常启动并完成 MCP 握手。因此，可靠性得分较低。
安全与权限 4/20: 红色警戒线：项目许可为 NOASSERTION，且 README 声称已移除遥测，但安装示例中包含占位 API 密钥（sk-your-api-key-here），虽为示例，但存在风险。未发现明显的恶意代码，但缺乏安全审计。由于没有明确的安全披露机制，且许可不明，安全得分受限。
维护活跃度 10/20: 仓库有 174 星，0 个开放问题，未归档。README 显示活跃开发，但缺少版本发布信息。许可证为 NOASSERTION，存在法律风险。因此，维护得分中等。
文档质量 8/20: README 提供了安装和配置的详细指南，包括 settings.json 和 .env 示例。还有官网和文档链接。但缺少针对 MCP 服务器本身的文档，未说明如何作为 MCP 服务器连接。因此，文档质量良好但不够全面。
安装易用性 8/20: README 提供了清晰的安装步骤，使用 Bun 和 Git。对于 MCP 服务器，需要配置 settings.json 或 .env。但未提供主流 MCP 客户端的配置示例。因此，安装相对简单但缺少客户端集成示例。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络控制浏览器

适合谁

注重隐私和本地化开发的开发者
需要轻量级替代 Claude Code 的团队或个人
喜欢使用 Bun 和 TypeScript 技术的开发者

不适合谁

需要团队协作和云同步功能的用户
需要官方支持和技术维护的企业用户
使用 Windows 且不熟悉命令行操作的用户

所需权限

读取和写入项目文件
执行 Shell 命令（Bash/PowerShell）
访问 Git 仓库
使用网络服务（调用 AI API）

风险与副作用

使用第三方 API 时需注意数据隐私，代码可能被发送到外部模型服务
项目非官方，可能存在安全漏洞或功能不完整
依赖于 Bun 运行时，需要保证环境稳定性

安装接入

准备工作

运行环境：Bun 1.3.11+

ANTHROPIC_AUTH_TOKEN 必填密钥所选模型服务商的 API 密钥（如 DeepSeek 控制台生成），写入 settings.，属敏感信息。

其他可选配置项（2 个）

ANTHROPIC_BASE_URL 可选模型 API 的 Anthropic 兼容端点，如 DeepSeek 的 https://api.deepseek.com/anthropic，写入 ~/.claude/settings. 的 env 块。

ANTHROPIC_MODEL 可选要使用的模型名称，例如 deepseek-v4-pro[1m]，可同时配置在 env 与 model 字段。

前置要求：Bun >= 1.3.11 和 Git。安装构建：

git clone https://github.com/txl16095/MiniClaude.git && cd MiniClaude
bun install
bun run build

然后复制配置文件：

cp settings.example.json ~/.claude/settings.json

并根据需要编辑，例如配置 DeepSeek：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key-here",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]"
  },
  "model": "deepseek-v4-pro[1m]"
}

验证是否装好

构建后运行 ./cli 启动 MiniClaude，若能进入对话并使用 /provider 命令列出可用 Provider，说明安装和配置成功。

常见排障

如果构建失败，请确保 Bun >= 1.3.11 并重新运行 bun install
如果 AI 功能不工作，请检查 settings.json 中的 API 密钥和基础 URL 是否正确
如果执行环境有问题，可以尝试复制 .env.example 并使用 bun run dev 开发模式

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我阅读这个项目的代码并总结项目结构
把这个文件里的函数重构一下并直接写入文件
运行测试并修复失败的用例
提交当前的 Git 改动

使用场景

本地 AI 编程辅助，无需云服务

使用第三方模型（如 DeepSeek）进行代码生成和项目理解

通过 MCP 协议扩展工具功能

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

MiniClaude 是从 Claude Code 精简而来的轻量级本地 AI 编程助手，移除了云服务、遥测和协作代码（共约 92,000 行），保留了 AI 对话、代码生成、文件操作、Git、MCP、插件和技能系统等核心开发功能。它支持使用多种 AI 模型（如 DeepSeek）并通过 settings.json 进行配置。