MiniCode

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 125 🐛 待处理 16 👀 关注 4

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1161

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，可自行部署使用。

项目预览

项目数据

分类智能体

开发团队LiuMengxuan04

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

GitHubhttps://github.com/LiuMengxuan04/MiniCode

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

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

GitHub 星标★ 1161

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

代码更新2026-10-09

仓库体积659 KB

本站数据更新2026-11-09

维护状态维护中

收录时间2026-08-09

浏览次数7

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1161

技术标签

ai-agent cli coding-agent developer-tools nodejs

使用教程

难度：入门约 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`