MiniCode
面向本地开发的轻量级终端编程助手，提供工具调用与审阅后写入流程。
- Star 数
- ★ 1.2k
- 最近更新
- 29 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 50/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 希望研究 Claude Code 风格工具循环与终端交互架构的开发者，可用它阅读和修改较小的 TypeScript 实现。
- 不适合
- 需要开箱即用、不想配置模型名与 Anthropic 连接参数的团队
- 需要生产级可靠性、性能或部署保障的用户
- 希望用非 Anthropic 模型提供方直接接入的用户
- 源码审查
- 50/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
MiniCode 是面向本地开发工作流的轻量级终端编程助手，主仓库采用 TypeScript。它以全屏终端 UI 承载输入、转录记录、斜杠菜单、审批流程与会话操作。一次请求可进入“模型→工具→模型”的循环，检查工作区、执行所需工具，并在同一终端会话中返回最终回复。项目支持本地 Skills 与 MCP，并提供会话持久化、上下文压缩和大工具结果落盘预览等机制。它的运行边界是本地终端和项目文件；安装器将模型及 Anthropic 连接配置写入用户配置目录。
MiniCode 接收终端中的用户请求，检查当前工作区，并调用内置的文件、搜索、编辑、命令执行、网页抓取/搜索及澄清提示工具。写入文件前会经过审阅，并执行路径与命令权限检查；过大的工具结果会写入磁盘，只在上下文中保留简短预览和文件路径。通过 /init 可创建当前项目的 .mini-code/ 与 MINI.md，通过 /tools、/skills、/mcp、/status、/memory 查看运行状态；/resume、/compact 处理会话恢复和上下文压缩。流程结束后，它在同一个终端会话中输出最终回复。
- 希望研究 Claude Code 风格工具循环与终端交互架构的开发者，可用它阅读和修改较小的 TypeScript 实现。
- 在本地项目中需要由终端助手检查文件、搜索内容、执行命令并在写入前进行审阅的个人开发者。
- 需要为特定项目保存会话，并使用 /resume、重命名、分叉或 /compact 管理长对话的开发者。
- 想通过 SKILL.md 为本地项目发现技能，或通过 stdio、远程 HTTP 接入 MCP 工具、资源和提示词的工具构建者。
- 需要在不连接模型时演示终端流程的学习者，可使用 MINI_CODE_MODEL_MODE=mock 运行开发模式。
如何安装或部署这个 Agent？
在仓库目录执行：
cd mini-code
npm install
npm run install-local安装器会要求填写模型名称、ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，并将配置写入 ~/.mini-code/settings.json 与 ~/.mini-code/mcp.json。可用 MINI_CODE_HOME 修改配置目录、用 MINI_CODE_BIN_DIR 修改启动器目录。
如何使用这个 Agent？
安装后运行 minicode。开发模式运行 npm run dev；离线演示可运行 MINI_CODE_MODEL_MODE=mock npm run dev。进入后可先使用 /help，随后按需使用 /tools、/skills、/mcp 和 /status；/init 会为当前项目创建 .mini-code/ 和 MINI.md。
这个 Agent 有哪些优点和局限？
- 以紧凑的 TypeScript 实现呈现“模型→工具→模型”循环，适合学习、实验和二次定制。
- 全屏 TUI 已包含输入历史、转录滚动、斜杠菜单和审批流程，而不是只提供单条命令入口。
- 对长会话提供持久化、恢复、重命名、分叉、自动压缩、上下文折叠与 snip compact。
- 内置文件、搜索、编辑、命令、网页和澄清工具，并支持本地 Skills 与 MCP 扩展。
- 安装流程要求提供模型名称、ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN；提供的证据未说明其他模型提供商路径。
- 需要本地终端、文件系统和 npm；源码未给出 Node.js 版本要求。
- 其定位明确偏向学习、实验和自定义工具，提供的材料没有生产部署、可靠性或性能保证。
- Rust、Python、Go 与 Java 版本以独立链接仓库形式列出，不能据此视为本仓库可直接切换的运行时。
这个 Agent 与同类方案有什么区别？
项目将自身描述为采用 Claude Code 类似的工作流与架构思路，但实现规模更小，目标是让控制流、工具模型和 TUI 行为更易理解和扩展。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| MiniCode 当前 | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.2k | 29 天前 | TypeScript | Claude API |
| Pi 工具显示增强 | 60 · 存在缺口 | Agent 插件 / 技能免费 | ★ 304 | 4 个月前 | TypeScript | — |
| zerostack | 57 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.7k | 3 天前 | Rust | OpenAI API · Claude API |
| Pi Agent Harness | 42 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 120k | 今天 | TypeScript | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示有权限检查（路径和命令权限检查）、用户确认流程（审批流程）、数据流透明度（工具结果预览和磁盘存储）、敏感数据处理（配置存储位置）、依赖安全（依赖较少且无已知漏洞）、外部影响（命令执行工具）、回滚（会话恢复和分叉）、来源归属（作者列表）。但均为描述性，缺乏具体实现细节，且未验证。
自洽性：README、架构文档和测试文件描述一致，但测试文件存在断言不完整（如auto-compact测试中条件性断言）。依赖可用性：依赖较少，但未提供锁定文件或完整性校验。失败消息：测试中模拟了API错误，但未展示用户可见的错误处理。
受众明确（学习、实验、定制工具），场景清晰（终端编码助手）。能力边界：README列出核心能力，但未明确限制。触发精度：命令和工具定义清晰。环境适配：支持多语言版本，但未提供系统要求。
信息架构：文档齐全（README、USAGE、ARCHITECTURE等）。安装说明：提供安装命令和配置说明。命名稳定性：版本0.1.0，未承诺稳定。示例和FAQ：有使用指南，但无FAQ。已知限制：未明确列出。许可证：MIT。版本变更日志：未提供。维护责任：作者列表明确，但未说明维护策略。
输出可用性：终端UI和工具调用设计合理。边际价值：轻量级替代方案，有学习价值。成本效益：依赖少，安装简单，但未提供性能数据。
声明可追溯：README中的功能描述与代码结构基本一致，但未提供具体实现链接。跨来源佐证：多语言版本存在，但未交叉验证。事实与推断分离：文档中区分了功能描述和架构说明，但未明确标注推断。
- 测试文件中的断言不完整，可能无法有效验证功能。
- 未提供依赖锁定文件，存在供应链风险。
- 未明确列出已知限制，用户可能对功能边界有误解。
- 未提供版本变更日志，难以追踪更新。
你是这个项目的维护者？把 FARS 徽章加到 README
[](https://followagents.com/zh/agents/minicode)<a href="https://followagents.com/zh/agents/minicode"><img src="https://followagents.com/badge/minicode.svg?lang=zh" alt="FARS 评测"></a>