如何5分钟安装运行MiniCode:终端AI编程快速上手教程
如何5分钟安装运行MiniCode:终端AI编程快速上手教程
MiniCode 是一款轻量级终端 AI 编程助手(terminal coding assistant),提供类 Claude Code 的工作流与工具循环:在终端里直接下达任务,它会检查项目、调用工具、修改文件并返回结果。本文带你用 5 分钟左右完成 MiniCode 安装与首次运行,全程只需 Node.js 和几条命令,无需任何复杂配置。
MiniCode 是什么?为什么值得装一个 🤔
MiniCode 的定位可以用一句话概括:把 AI 编程能力装进你熟悉的终端里。它的核心工作流是:
- 接收你的自然语言请求
- 自动检查当前工作区(列文件、搜索、读代码)
- 需要时调用内置工具(读写文件、执行命令、联网搜索)
- 修改文件前先展示 diff 供你确认(review-before-write)
- 在同一个终端会话中返回最终结果
相比大型 AI IDE 平台,MiniCode 的核心实现只有约 8000 行代码,控制流和工具模型清晰易读,特别适合:
- 🧪 想快速体验终端 AI 编程的新手
- 📚 想研究 agent 架构、学习 Claude Code 设计思路的开发者
- 🔧 想基于开源代码做二次定制的场景
完整功能列表可参考 README.md 的 Core Capabilities 部分,中文说明见 README.zh-CN.md。
安装前准备:确认 Node.js 环境 ✅
MiniCode 是 TypeScript 项目,通过 node 直接运行源码(启动脚本见 bin/minicode),因此只需准备:
| 依赖 | 说明 |
|---|---|
| Node.js | 建议 20 及以上版本 |
| npm | 随 Node.js 自带 |
| 终端 | macOS / Linux / WSL 均可 |
验证环境是否正常:
node -v
npm -v
两条命令都能输出版本号即可开始。
MiniCode 安装 5 步走:clone 到启动一气呵成 ⚡
第 1 步:克隆仓库
git clone https://gitcode.com/gh_mirrors/mi/MiniCode
cd MiniCode
第 2 步:安装依赖
npm install
第 3 步:运行交互式安装器
npm run install-local
安装器(实现见 src/install.ts)会依次询问 3 项配置,直接填入即可:
- Model name:要使用的大模型名称
- ANTHROPIC_BASE_URL:API 地址,默认
https://api.anthropic.com,兼容各类 Anthropic 风格网关 - ANTHROPIC_AUTH_TOKEN:你的 API Token(必填)
配置会保存在独立目录 ~/.mini-code/settings.json,不会影响其他工具的本地配置。
第 4 步:处理 PATH(如提示缺失)
启动器默认安装到 ~/.local/bin/minicode。如果安装器提示 PATH 中还没有 ~/.local/bin,把这行加入 ~/.bashrc 或 ~/.zshrc:
export PATH="$HOME/.local/bin:$PATH"
之后重新打开终端(或执行 source ~/.zshrc)。
第 5 步:启动 MiniCode 🎉
minicode
看到全屏终端界面(TUI)就说明安装成功了。至此,5 分钟安装流程结束。
第一次运行:3 种启动方式
方式一:正式入口(推荐)
minicode
在任意项目目录下执行,MiniCode 会以当前目录为工作区。
方式二:开发模式
在 MiniCode 仓库目录内直接运行源码,方便调试:
npm run dev
方式三:离线演示模式
没有 API Token 也能先体验交互界面:
MINI_CODE_MODEL_MODE=mock npm run dev
上手后常用的入口命令 🧭
进入 TUI 后,输入 / 可唤起斜杠命令菜单,最常用的是:
| 命令 | 作用 |
|---|---|
/help |
查看交互式帮助 |
/tools |
列出当前可用工具 |
/status |
查看会话与上下文状态 |
/init |
为当前项目生成 MINI.md 项目规则文件 |
/model |
查看或切换模型 |
/resume |
恢复历史会话 |
/compact |
手动压缩上下文,释放窗口空间 |
小提示:MiniCode 每个回合结束都会自动保存会话到 ~/.mini-code/projects/,退出时会打印会话 ID,下次用 /resume 即可继续。完整命令参考见 USAGE_ZH.md。
常见问题速查 ❓
Q:输入 minicode 提示 command not found?
检查 ~/.local/bin 是否已在 PATH 中(见第 4 步);也可以直接用绝对路径 ~/.local/bin/minicode 启动确认安装本身没问题。
Q:想换个 API 网关或 Token 怎么办?
重新执行 npm run install-local,已有配置会作为默认值显示,修改后回车确认即可。
Q:想改配置目录?
设置环境变量 MINI_CODE_HOME 可自定义配置目录,MINI_CODE_BIN_DIR 可自定义启动器位置,详见 USAGE.md 的 Installation Details 章节。
Q:如何了解它的工作流架构? 推荐按顺序阅读 ARCHITECTURE_ZH.md 和 CLAUDE_CODE_PATTERNS_ZH.md,核心循环实现在 src/agent-loop.ts,工具注册在 src/tool.ts。
小结
MiniCode 用 5 分钟就能在你的终端里跑起来:git clone → npm install → npm run install-local → minicode。它是体验终端 AI 编程助手的轻量入口,也是研究 agent 工具循环架构的优质源码。装好后,可以先用 /init 初始化项目规则,再丢一个真实小任务试试它的多步工具执行能力吧!