大家好，其实，最近 Claude Code 大火。但作为一个硬核开发者，怎么能只停留在“用”的层面？难道你不想了 Claude Code 的底层架构，并用 TypeScript 纯手工复刻了一个开源版本 —— mini-cc！

今天我就来为大家演示一下 mini-cc 已经实现的几个杀手级主要功能。

看完这篇，你不仅能学会如何使用它。更能看懂目前最顶级的 AI 编程助手的底层设计模式。

主要功能演示教程

🛡️ . BashTool：不仅能跑命令，还能防 AI“作恶”

普通的 AI 助手给你一个 exec 就不管了但 mini-cc 的 BashTool 实现了极强的安全与防爆机制。你是否曾经担心AI助手执行恶意命令？BashTool可以帮你解决这个问题。怎么说呢，

演示提示词：

预期效果：你会在终端看到 拦截到阻塞主线程的 sleep 调用 的黄色警告。这是因为 mini-cc 在源码中通过正则表达式精准识别了长时的“孤狼” sleep 命令。大模型有时会为了等编译完成而傻傻地 sleep这会导致我们的主进程被无意义阻塞。拦截后引擎会提示 AI 改用后台监控或其他工具。按理说，

🧠 . 大道至简的记忆管理器

很多 AI Agent 喜欢挂一个沉重的向量数据库。但在 mini-cc 中，我们采用了 Claude Code 同款的纯文件程序两步走法则。

预期效果：你会看到在项目的 `.ai_memory/MEMORY.md` 文件中，当记录超过 行时触发了记忆防爆机制。程序会打印 ` 索引超长... 触发强制截断`。不过，它会自动丢弃最老的记忆。并在文件末尾贴上大字报警告 `> WARNING: MEMORY.md is lines...`。老实说，这种设计确保了注入给大模型的上下文永远精简且不超 Token！怎么说呢，

🥷 . AgentTool：影分身之术与安全沙盒

当你在重构代码。遇到一个可能破坏环境的子任务时你可以让 `mini-cc` 派生一个子代理去探路。

预期效果： 通过 `isolation: "worktree"` 参数，你会看到终端自动执行了 `git worktree add -b agent-sandbox-xxx /tmp/mini-cc-worktree-xxx`。子代理会在这个完全平行、物理隔离的沙箱目录中执行任务，主分支毫发无损！任务完成后还会自动清理 `git worktree remove`。

🔌 . 终极 ：MCP 插件程序与透明代理

这是本次开源复刻最硬核的部分。mini-cc 完全支持官方的 Model Context Protocol ！怎么说呢，如果你也想为自己的AI助手建立丰富的插件环境。这将是你的不二选择，

我们在 `examples/mcp-servers/` 目录下准备了一个极简的 `wear.js` MCP 插件。

如何演示：

1. 确保你的 `.mini-cc/settings.json`中配置了：

{ "mcpServers": { "wear": { "command": "node","args": } } }

1. 运行 `npx ts-node tests/mcp/test_mcp.ts`。

预期效果： 你会看到引擎通过 stdio 跨进程启动了 Node.js 插件，并利用透明代理将远端工具封装成了 `mcp__wear__get_wear`。大模型就像调用本地内置函数一样丝滑地获取到了“北京”的天气信息，实现了跨语言、跨进程的零耦合

为什么你要关注 mini-cc？

在重构 `mini-cc` 的过程中。我们做了一个关键的架构决策：全面抛弃了 Class 类组件，采用了纯函数式架构！

1. 消灭烦人的 this；
2. 真正的私有化；还有
3.  极简的代码体积。

 消灭了烦人的  this  再也不用担心回调函数里的上下文丢失。

 真正的私有化 闭包让内部状态对外部绝对不可见，安全性拉满。

**极简的代码体积**︰完美的 Tree-shaking 支持。

如果你也对 AI 编程助手的底层原理感兴趣，欢迎来翻阅mini-cc .的源码。

每一行都加了详尽的中文注释，绝对是学习 Agent 架构的教科书级项目！

mini-cc.raingpt.top/ github.com/you-want/mi…

未完，继续迭代中....

---