如何5分钟安装运行MiniCode:终端AI编程快速上手教程

原创2026-10-14 18:04:271,362 阅读
文章标签:人工智能AI Agent代码智能体工具调用MCP ClientsCLI开发工具AI 技能

如何5分钟安装运行MiniCode:终端AI编程快速上手教程

MiniCode 是一款轻量级终端 AI 编程助手(terminal coding assistant),提供类 Claude Code 的工作流与工具循环:在终端里直接下达任务,它会检查项目、调用工具、修改文件并返回结果。本文带你用 5 分钟左右完成 MiniCode 安装与首次运行,全程只需 Node.js 和几条命令,无需任何复杂配置。

MiniCode 是什么?为什么值得装一个 🤔

MiniCode 的定位可以用一句话概括:把 AI 编程能力装进你熟悉的终端里。它的核心工作流是:

  1. 接收你的自然语言请求
  2. 自动检查当前工作区(列文件、搜索、读代码)
  3. 需要时调用内置工具(读写文件、执行命令、联网搜索)
  4. 修改文件前先展示 diff 供你确认(review-before-write)
  5. 在同一个终端会话中返回最终结果

相比大型 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 初始化项目规则,再丢一个真实小任务试试它的多步工具执行能力吧!

登录后查看全文
MiniCode