LiuMengxuan04/MiniCode

这是什么？

核心功能

• 01单轮内支持多步工具调用，形成模型、工具、模型的循环
• 02全屏终端界面，支持输入历史、斜杠命令菜单和审批流程
• 03文件修改需先审阅再写入，并检查路径与命令权限
• 04按项目持久化会话，支持恢复、重命名、分叉和压缩
• 05通过 SKILL.md 加载本地技能，并经 stdio 或 HTTP 接入 MCP 工具、资源与提示词
• 06最多 3 个只读子 Agent 并发运行，由根 Agent 统一管理代码修改

适用场景

• 学习类似 Claude Code 的编程 Agent 循环与终端界面的实现方式
• 基于一个小而易读的代码库，定制自己的终端编程助手
• 在终端 Agent 中试验 MCP 服务和本地 SKILL.md 技能
• 使用 mock 模型模式离线演示 Agent 的工作流程

快速上手

1. 1

   克隆仓库

   git clone https://github.com/LiuMengxuan04/MiniCode.git
2. 2

   进入项目目录

   cd MiniCode
3. 3

   安装依赖

   npm install
4. 4

   运行安装脚本，填写模型名称、ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，然后用 minicode 启动

   npm run install-local

使用前须知

• !使用真实模型需要兼容 Anthropic 的 API 地址和鉴权令牌。
• !它定位为小型学习与实验代码库，而非完整的生产级平台。

收录于专题

标签

常见问题

MiniCode 是什么？

一个轻量级终端编程助手，复现类似 Claude Code 的工具调用循环与 TUI，代码精简，便于学习和二次开发。 MiniCode 是一个面向本地开发的终端编程助手。它接收用户请求后会检查工作区、调用读文件、搜索、编辑和执行命令等工具，并在写入文件前让用户审阅修改，最后在同一个终端会话中给出回复。

MiniCode 可以免费使用吗？用的什么许可证？

MiniCode 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

MiniCode 还在维护吗？

活跃维护中。MiniCode 最近一次提交是在 2026年10月9日。

MiniCode 适合用来做什么？

学习类似 Claude Code 的编程 Agent 循环与终端界面的实现方式 基于一个小而易读的代码库，定制自己的终端编程助手 在终端 Agent 中试验 MCP 服务和本地 SKILL.md 技能 使用 mock 模型模式离线演示 Agent 的工作流程

MiniCode 怎么安装和运行？

克隆仓库: git clone https://github.com/LiuMengxuan04/MiniCode.git 进入项目目录: cd MiniCode 安装依赖: npm install 运行安装脚本，填写模型名称、ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，然后用 minicode 启动: npm run install-local

在哪里获取 MiniCode？

源代码和安装说明在 GitHub 上：https://github.com/LiuMengxuan04/MiniCode