如何 5 分钟本地跑起 AionUi：部署与上手完整指南

如何 5 分钟本地跑起 AionUi部署与上手完整指南【免费下载链接】AionUiOpen-source 24/7 Cowork app for OpenClaw, Hermes, Claude Code, Codex, OpenCode and 20 more CLI Agent | Customize your assistants | Team them upStar if you like it!项目地址: https://gitcode.com/GitHub_Trending/ai/AionUiAionUi 是一个免费开源的 AI 桌面应用核心价值在于把 Gemini CLI、Claude Code、Codex、Qwen Code 这些只能在终端里敲命令的 AI 工具统一装进一个图形化的聊天界面。你不需要再记各家 CLI 的参数装上它、配置好模型就能直接对话、管理对话和文件还能接入 MCP 生态。本文带你完成 AionUi 本地运行的最短路径从环境检查到模型接入再到 WebUI 远程访问全程只有几条必须执行的命令。环境清单动手前先确认手头工具是否齐全缺什么补什么依赖版本要求用途Git任意近期版本拉取 AionUi 源码Node.jsv16 及以上运行构建与启动脚本npm 或 yarn随 Node.js 附带安装项目依赖 安装提示LinuxUbuntu/Debian用户一条命令即可补齐基础依赖sudo apt update sudo apt install git nodejs npm -ymacOS 或 Windows 用户没有对应包管理器命令也没关系按常规方式安装 Node.js会自带 npm和 Git 即可装完用node -v确认版本不低于 16。从零到运行工具就绪后整个安装过程就是拉代码 → 装依赖 → 启动三段依次在终端执行git clone https://gitcode.com/GitHub_Trending/ai/AionUi cd AionUi接着安装依赖这一步会下载大量包耗时取决于你的网速通常几分钟npm install最后启动应用npm start窗口打开后就是 AionUi 的初始界面左侧一栏是对话列表和操作入口右侧留给聊天区顶部能看到当前连接的模型状态。第一次配置模型界面跑起来不等于能聊先给 AionUi 接上一个模型。从左侧边栏进入设置找到模型管理页点击右上角的Add Model。弹窗里先选平台——内置了 Gemini、OpenAI、Anthropic、New API也可以选 Custom 填自己的接口地址——然后按提示粘贴对应的 API Key确认保存即可。之后发起对话时输入框上方的选择器里就会出现这个模型。进阶玩法想同时对比多个模型把几个平台的 Key 都配好后点发起新对话在输入框下方的模型选择器里切换不同的 AI同一个问题分别丢给不同模型横向比较回答质量。模型多了以后管理页会按平台分组列出全部可用模型方便你启停和维护。想在别的设备上打开AionUi 自带 WebUI 模式在设置的 WebUI 入口开启后页面上会给出本地访问地址通常是http://localhost:25808。同一局域网内的手机或另一台电脑浏览器打开这个地址局域网内把localhost换成本机 IP就能直接使用。涉及公网访问、SSH 隧道等更复杂的远程场景仓库里的 docs/guides/webui.md 有完整写法。卡点排查现象启动或访问时报端口被占用可能原因25808 端口或其他服务端口已被别的程序占用。解决办法先停掉占用端口的进程或在配置中改为其他端口后重新启动WebUI 场景可参考 docs/guides/deploy-server.md 的故障排除一节。现象依赖安装后启动报错、行为异常可能原因依赖没装全或安装中途被网络中断污染了node_modules。解决办法删除node_modules目录和锁文件缓存重新执行npm install再启动。现象对话无响应或提示鉴权失败可能原因API Key 抄错、过期或该 Key 没有对应模型的调用权限。解决办法回模型管理页重新粘贴一遍 Key并到服务商后台确认该 Key 的有效性和权限范围。 更多细节都可以先在仓库文档里查入口是 docs/README.md用户向指南集中在docs/guides/目录。写在最后到这里AionUi 已经在你的电脑上完整跑起来了本地部署、模型接入、WebUI 远程访问三件事都落地。下一步可以顺手探索的方向给不同任务配置专属助理、试用多智能体协作或在packages/desktop/源码目录里看看界面是怎么组织起来的。【免费下载链接】AionUiOpen-source 24/7 Cowork app for OpenClaw, Hermes, Claude Code, Codex, OpenCode and 20 more CLI Agent | Customize your assistants | Team them upStar if you like it!项目地址: https://gitcode.com/GitHub_Trending/ai/AionUi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考