AionUi 安装教程：3 条命令跑起本地 AI 图形化界面-港品优选

AionUi 安装教程：3 条命令跑起本地 AI 图形化界面

【免费下载链接】AionUiOpen-source 24/7 Cowork app for OpenClaw, Hermes, Claude Code, Codex, OpenCode and 20+ more CLI Agent | Customize your assistants | Team them up｜Star if you like it!项目地址: https://gitcode.com/GitHub_Trending/ai/AionUi

给 Gemini CLI、Claude Code 这类命令行 Agent 配个图形界面，是不少人的刚需。AionUi 就是干这件事的：免费、本地运行、开源，把多个 CLI 工具和 LLM 收进一个聊天窗口。这篇 AionUi 安装指南带你从零部署，跑完 3 条命令，再配上多模型聊天和 WebUI 远程访问。

先花 10 秒体检环境 🩺

依赖	版本要求	说明
Git	任意可用	拉取代码
Node.js	v16+	运行时
npm 或 yarn	随 Node 附带	装依赖

先跑两条命令确认状态：

node -v git --version

两条都吐出版本号，说明环境就绪。哪项缺了也别慌，Ubuntu / Debian 一条命令补齐：

sudo apt update && sudo apt install git nodejs npm -y

等进度条走完、提示成功，重新查一遍版本号即可。

三条命令，把 AionUi 跑起来 🚀

git clone https://gitcode.com/GitHub_Trending/ai/AionUi cd AionUi

跑完会多出一个 AionUi 文件夹。

安装依赖：

npm install

这一步耗时全看网速，快的话两分钟出头，慢的耐心等。

启动应用：

npm start

窗口大约 1 分钟弹出，长这样：左侧是对话列表，右侧聊天区居中显示欢迎语，输入框待命。

给 AionUi 接上模型大脑 🧠

界面有了，还得喂它模型，路径很短：

点开左上角菜单，进「设置」
找到「模型管理」，点「添加模型」
从下拉里挑平台：Gemini、OpenAI、Anthropic 等
把 API 密钥粘进对应输入框
点确认

模型随即挂进列表，可以立刻调用。

进阶两招：多模型同场对战 & 别的设备也能开 🎮

多模型聊天：

点「发起新对话」开一局
输入框下方的模型选择器负责切换 Gemini、OpenAI 等不同模型
同一问题分别发给两个模型，回答风格与侧重点对比一眼可见
适合做方案评审、翻译校对这类需要第二视角的活

WebUI 远程访问：

进设置，打开 WebUI 开关
记下它显示的本地地址，默认是http://localhost:25808
局域网内另一台设备打开浏览器，访问该地址即可使用
手机、平板都能接着同一批对话继续聊，无需额外配置

翻车急救包：按症状对号入座 🩹

症状	常见原因	处理办法
启动提示端口被占用	25808 被其他程序占了	改配置文件里的端口号，换一个空闲值
依赖报错、装到一半失败	node_modules 损坏或版本冲突	删掉 node_modules 目录，重新 npm install
模型调用被拒绝	API 密钥错误或权限不足	回对应平台核对密钥、确认套餐与访问权限

收尾

装好之后别停，先去 docs/index.html 把功能地图过一遍，顺手试一把多模型对战——同一句话丢给两个模型，答案差异比想象中大。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析