MiniCode

轻量级终端AI编码助手，让你快速上手Claude Code式工作流

MiniCode 是一个轻量级的终端编码助手，旨在模仿 Claude Code 的工作流、工具循环和 TUI 架构，但保持极简设计，适合学习和实验。它用 TypeScript 实现，同时提供 Python 和 Rust 版本，支持多语言。项目解决的核心问题是：让开发者能快速理解 AI 编码助手的内部机制，并基于此进行二次开发或定制。其核心能力包括：命令行交互界面、工具调用循环、与 AI 模型（如 Claude）的集成，以及可扩展的架构。通过精简代码和清晰模块划分，MiniCode 降低了学习门槛，使开发者能轻松上手，探索 AI 辅助编程的底层逻辑。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1116

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队LiuMengxuan04

所属国家

官网地址https://liumengxuan04.github.io/MiniCode

GitHubhttps://github.com/LiuMengxuan04/MiniCode

定价模式free

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai-agent,cli,coding-agent,developer-tools,nodejs,terminal,tool-calling,tui,typescript

GitHub 星标★ 1116

30天Star增速

HF 下载量

上线时间2026-03-31 00:00:00

最近更新2026-09-23 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Node.js 与 npm（用于安装依赖和运行脚本）
git（用于克隆仓库）
一个 Anthropic 兼容的模型服务，需准备模型名、ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN
可用的终端环境

安装与启动步骤

1克隆仓库

从 GitHub 拉取 MiniCode 源码并进入项目目录，后续命令都在该目录执行。
```
git clone https://github.com/LiuMengxuan04/MiniCode.git
cd MiniCode
```
2安装依赖

在项目根目录安装 npm 依赖，需联网，耗时取决于网络速度。
```
npm install
```
3本地安装并配置

运行本地安装脚本，按提示依次输入模型名称、ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN，生成配置与启动器。
```
npm run install-local
```
4启动终端助手

直接调用安装好的启动器进入交互界面，与 Claude Code 类似的终端工作流。
```
minicode
```
5开发模式运行

以开发模式启动，便于改代码后调试，适合学习内部实现。
```
npm run dev
```
6离线演示模式

不接入真实模型，用 mock 模式体验界面与工具循环，适合没有 Token 时试用。
```
MINI_CODE_MODEL_MODE=mock npm run dev
```

关键配置

配置项	必填	说明	示例
`ANTHROPIC_BASE_URL`	是	模型服务的基础地址，安装时由提示输入	`https://api.anthropic.com`
`ANTHROPIC_AUTH_TOKEN`	是	调用模型服务的鉴权令牌，安装时由提示输入	`sk-xxxxxxxx`
`模型名称`	是	安装时由提示输入，指定要使用的模型	`claude-sonnet-4-20250514`
`MINI_CODE_HOME`	否	覆盖默认配置目录（默认 ~/.mini-code）	`/your/path/.mini-code`
`MINI_CODE_BIN_DIR`	否	覆盖启动器安装目录	`/your/path/bin`
`MINI_CODE_MODEL_MODE`	否	设为 mock 时进入离线演示模式	`mock`

如何确认成功

终端出现 MiniCode 的交互界面并接受你的请求，即表示启动成功；配置已写入 ~/.mini-code/settings.json。

常见问题

Q：配置信息保存在哪里？

A：保存在 ~/.mini-code/settings.json 和 ~/.mini-code/mcp.json 中，安装脚本会自动生成。

Q：想换一个配置目录怎么办？

A：设置环境变量 MINI_CODE_HOME 指向目标目录即可覆盖默认的 ~/.mini-code。

Q：没有 API Token 能先体验吗？

A：可以，运行 MINI_CODE_MODEL_MODE=mock npm run dev 进入离线演示模式，无需真实模型服务。

Q：启动器安装到别的目录了怎么运行？

A：启动器目录可用 MINI_CODE_BIN_DIR 覆盖，若自定义了该目录，请从该目录调用启动器。

注意事项

ANTHROPIC_AUTH_TOKEN 属于敏感凭据，不要提交到公开仓库或截图分享。
配置项均通过 npm run install-local 的交互提示写入，README 未提供非交互式的替代参数。
README 未说明 Node.js 最低版本要求，建议使用较新的 LTS 版本。

核心亮点

多语言实现（TS/Python/Rust），便于对比学习不同语言下的AI代理架构
代码精简，模块清晰，适合作为学习AI编码助手的入门项目
支持工具循环和TUI，复刻了Claude Code的核心交互体验

不足之处

功能相对简单，可能缺少生产级编码助手的复杂特性（如多文件编辑、上下文管理）
文档/社区待观察

适用场景

学习AI代理与工具调用机制的教学场景
快速搭建定制化终端编码助手的原型开发
对比不同语言实现同一架构的参考案例

替代项目

Claude Code、OpenHands、Aider

项目介绍

MiniCode 是编程开发领域的开源项目，由 LiuMengxuan04 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,116）位列前 30%，在编程开发分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,050 增加到 1,116，净增 66。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-23。MIT许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：学习AI代理与工具调用机制的教学场景。同类可对比的替代方案包括 Claude Code、OpenHands、Aider。

上一篇：Mysti

下一篇：spec_driven_develop