引言在 AI 编程助手领域Claude Code 无疑是最令人期待的产品之一。作为 Anthropic 专为开发者打造的 AI 编程工具它拥有强大的代码理解能力和丰富的工具集。然而由于种种原因Claude Code 目前并未完全开放。这让很多开发者望而却步。还反华想骂人了哈哈同时前段时间源码泄露事件引发了广泛关注和讨论。哈哈笑而不语…于是一个想法诞生了我去学习一下这个优秀的 AI 源码看看 AI 写出的代码到底多优秀同时看能不能打造一个轻量级的个人版本说白了就是一边啃源码一边自己手撸一个轻量级的版本。既能学到东西做出来之后自己也能用上。这就是 mini-cc 的由来。什么是 mini-ccmini-ccMini Claude Code是一个轻量级的 AI 编程助手旨在提供类似 Claude Code 的核心体验但更加开放、灵活、易于定制。核心特性特性说明多模型支持支持 Anthropic、OpenAI、Qwen、DeepSeek 等多种 LLM工具调用内置文件读写、命令执行、代码搜索等工具MCP 协议支持 Model Context Protocol可扩展插件终端 UI基于 Ink/React 的精美终端界面记忆系统支持会话记忆和长期记忆开源免费MIT 许可证完全开源为什么要做 mini-cc1. 学习与研究Claude Code 的源码曝光让我们有机会学习优秀的架构设计。通过复刻我们可以深入理解AI 编程助手的核心架构工具系统的设计模式多模型兼容的抽象层安全沙箱的实现策略2. 定制化需求不同团队有不同的编程习惯和工具栈。mini-cc 提供了高度可定制的架构自定义工具开发自定义技能系统自定义 Provider 接入自定义 UI 组件3. 隐私与安全对于很多企业来说将代码发送到第三方 API 是不可接受的。mini-cc 支持本地模型部署Ollama、llama.cpp私有化部署完全可控的数据流向mini-cc 与 Claude Code 的关系借鉴与致敬mini-cc 大量借鉴了 Claude Code 的架构设计Agent 循环机制工具调用模式MCP 协议支持技能系统设计差异化改进同时mini-cc 也做了一些差异化的改进多模型支持Claude Code 只支持 Anthropic 模型而 mini-cc 支持多种 LLM轻量级去除了一些重量级依赖更容易安装和运行开放生态鼓励社区贡献支持插件扩展项目结构mini-cc/ ├── src/ │ ├── application/ # 应用层业务逻辑 │ ├── infrastructure/ # 基础设施层工具、状态 │ ├── services/ # 服务层Provider、MCP │ ├── components/ # UI 组件 │ ├── commands/ # 命令系统 │ └── skills/ # 技能系统 ├── docs/ # 文档 ├── examples/ # 示例代码 └── tests/ # 测试用例核心架构┌─────────────────────────────────────────────────────────────┐ │ 用户界面 (UI) │ │ (基于 Ink/React 的终端界面) │ └─────────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ Agent 循环 (核心引擎) │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ 思考阶段 │→│ 决策阶段 │→│ 执行阶段 │ │ │ │ (LLM 调用) │ │(工具选择) │ │(工具执行) │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ │ └─────────────────────────────────────────────────────────────┘ │ ┌───────────────┼───────────────┐ ▼ ▼ ▼ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │ Provider │ │ Tools │ │ Memory │ │ (LLM 抽象层) │ │ (工具系统) │ │ (记忆系统) │ └────────────────┘ └────────────────┘ └────────────────┘快速体验现在让我们快速体验一下 mini-cc。根据你的使用场景有两种安装方式方式一全局安装推荐适合直接使用的用户# 全局安装npminstall-gyou-want/mini-cc# 配置环境变量exportPROVIDERopenaiexportOPENAI_API_KEYyour-api-keyexportMODEL_NAMEgpt-4# 启动mini-cc方式二本地开发安装适合开发者或需要修改源码的用户# 克隆仓库gitclone https://github.com/you-want/mini-cc.gitcdmini-cc/typescript# 安装依赖必须使用 pnpmpnpminstall# 构建pnpmbuild# 运行nodedist/cli.js启动后你会看到mini-cc帮我分析一下当前目录的结构接下来在后续的文章中我们将深入探讨架构设计mini-cc 的核心架构和设计原则Agent 循环AI 助手的思考引擎是如何工作的工具系统如何让 AI 拥有动手能力Provider 抽象如何对接多种大模型MCP 协议插件生态的实现原理最后最后说两句mini-cc 算是我个人在 AI 编程助手这个方向上的一个尝试。不管你是想学架构还是单纯想要一个自己能掌控的 AI 助手都可以关注一下。代码写得不一定多牛但至少是认真在做的。欢迎加入如果你对这个项目感兴趣欢迎 Star、Fork、贡献代码GitHub: https://github.com/you-want/mini-cc