首页 / 资讯中心 / 文章详情

如何安装 AIO Coding Hub:Windows、macOS、Linux 三平台完整安装指南(附 macOS 拦截与 Wayland 白屏避坑)

如何安装 AIO Coding Hub:Windows、macOS、Linux 三平台完整安装指南(附 macOS 拦截与 Wayland 白屏避坑) ★ FEATURED ARTICLE
【免费下载链接】aio-coding-hub一个All In One的本地AI工具, 支持Win/Mac/Linux项目地址https://gitcode.com/gh_mirrors/ai/aio-coding-hub点击查看免费下载如果你正在寻找一款本地 AI 工具希望把 Claude Code、Codex、Gemini CLI 的请求统一走一个入口那么AIO Coding Hub值得装一个。它是 All In One 的本地 AI CLI 统一网关 桌面管理台支持 Windows / macOS / Linux 三大平台数据全部保存在本机。本文提供三平台完整安装步骤并专门解决新手最容易卡住的两个坑macOS 首次打开被 Gatekeeper 拦截、Linux Wayland 下白屏或启动崩溃。AIO Coding Hub 是什么一句话概括一个 All In One 的本地 AI 工具核心是把三个 CLI 的 API 请求统一代理到本机网关默认127.0.0.1:37123并附带一整套管理能力统一网关三个 CLI 共用一个本机入口各 CLI 可独立开关代理️智能路由多供应商排序模板 自动故障转移 熔断保护全链路可观测Token 用量统计、花费估算、请求 Trace、热力图️工作区隔离按项目管理 Prompts、MCP、Skill 配置✅模型验证多维度模板验证上游渠道真伪安装完成后你会看到类似上图的首页热力图、用量统计、各 CLI 的代理开关与实时请求记录。安装方式速览三平台官方安装包对照表官方发布覆盖 4 个目标平台详见 README.md 的安装矩阵安装前先对号入座平台官方安装包推荐方式Windows x64.msi/-portable.zipmsi 标准安装支持自动更新macOS Intel.zipHomebrew CaskmacOS Apple Silicon.zipHomebrew CaskLinux x64.deb/.AppImage/-wayland.AppImageArch 用 AUR其他用 deb/AppImage 官方支持矩阵内的 4 个目标都接入自动更新通道mac:universal、win:arm64仅保留本地构建命令不发布官方包。macOS 安装Homebrew 一条命令搞定推荐方式一Homebrewbrew tap dyndynjyxa/aio-coding-hub brew install --cask aio-coding-hub后续升级只需brew update brew upgrade --cask aio-coding-hubHomebrew 发布流程可参考 docs/release-homebrew.md。方式二手动下载下载对应芯片的.zipApple Silicon 选armIntel 选intel解压后把AIO Coding Hub.app拖入「应用程序」文件夹即可。macOS 提示已损坏或无法验证开发者怎么办⚠️ 这是本文重点避坑项。由于当前 macOS 安装包未经 Apple 开发者证书签名与公证Gatekeeper 必然拦截首次启动属预期行为。任选一种方式处理只需执行一次① 移除隔离属性推荐一条命令sudo xattr -cr /Applications/AIO Coding Hub.app② 系统设置放行首次双击被拦截后打开「系统设置 → 隐私与安全性」在页面底部点击「仍要打开」。③ 本地自签名可选一劳永逸用 ad-hoc 签名替换无效签名之后系统升级也不会再提示sudo codesign --force --deep --sign - /Applications/AIO Coding Hub.appWindows 安装MSI 标准版或免安装便携版下载 Windows x64 安装包二选一.msi标准安装包双击运行安装向导支持自动更新推荐-portable.zip便携版解压即用不写注册表适合 U 盘携带或权限受限的办公机安装完成后在开始菜单或桌面找到AIO Coding Hub图标即可启动。Linux 安装deb / AppImage / AUR 三种途径Debian / Ubuntu下载.deb安装包sudo dpkg -i安装或双击 deb 文件通用发行版下载.AppImage赋予可执行权限后直接运行Arch Linux推荐走 AUR使用系统库兼容性最好paru -S aio-coding-hub-bin # 或 yay -S aio-coding-hub-binLinux Wayland 白屏 / 启动崩溃避坑⚠️ 第二个重点避坑项。应用在 Wayland 下启动时会自动检测并注入WEBKIT_DISABLE_COMPOSITING_MODE1来规避 EGL 冲突崩溃但部分环境下仍会白屏。解决办法优先改用 Release 中附带的*-wayland.AppImage它已剥离内置 EGL/Mesa 库改用系统版本白屏概率大幅降低或手动对已有 AppImage 重打包./scripts/repack-linux-appimage-wayland.sh aio-coding-hub-linux-amd64.AppImage重打包脚本见 scripts/repack-linux-appimage-wayland.sh。X11 用户通常不受影响。安装后首启验证三步确认网关已就绪装好不等于跑起来建议花 1 分钟验证启动应用首页左下角「网关」状态显示「运行中」、端口37123命令行验证curl http://127.0.0.1:37123/health # 返回 {status:ok} 即正常添加供应商并打开代理进入「供应商」页添加上游官方 API / 自建代理回首页打开目标 CLI 的「代理」开关之后在终端照常使用 CLI 即可默认网关端口定义在 src/constants/gateway.tsDEFAULT_GATEWAY_PORT 37123。一切正常后「用量」页会按 CLI / 供应商 / 模型维度持续统计 Token、缓存命中率、耗时与花费从源码构建 AIO Coding Hub进阶可选想尝鲜最新功能或参与贡献可以本地构建。前置条件Node.js 18、pnpm、Rust 1.90见 src-tauri/rust-toolchain.toml另外Windows安装 Microsoft C Build Tools勾选使用 C 的桌面开发macOSxcode-select --installDebian/Ubuntusudo apt-get install -y libasound2-dev libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf然后git clone https://gitcode.com/gh_mirrors/ai/aio-coding-hub cd aio-coding-hub pnpm install pnpm tauri:dev # 开发模式 pnpm tauri:build # 构建当前平台构建运行后还可以用内置的「模型验证」功能对上游渠道做 Token 截断、Extended Thinking 等多维度鉴别确认供应商返回的模型名与签名是否真实。常见问题 FAQ我的 API Key 和请求数据会上传吗不会。网关只监听127.0.0.1本机回环地址所有配置与统计数据保存在本地 SQLite 数据库不做公网部署、远程访问或多租户。哪些版本支持自动更新官方支持矩阵内的 4 个目标Windows x64、macOS Intel / Apple Silicon、Linux x64均接入自动更新便携版 zip 与 AUR 用户通过各自渠道升级。Windows / Linux 需要单独配置吗不需要。安装后首次启动会自动完成初始化只需按上文首启验证三步添加供应商、打开代理开关即可。按照本文步骤你应该已经成功在任一平台跑起了 AIO Coding Hub 的本地网关。后续可以接着探索排序模板、工作区隔离与插件系统把三端 CLI 的体验再拉高一档。赞分享【免费下载链接】aio-coding-hub一个All In One的本地AI工具, 支持Win/Mac/Linux项目地址https://gitcode.com/gh_mirrors/ai/aio-coding-hub点击查看免费下载相关推荐qutebrowser安装教程Windows/macOS/Linux三平台快速安装与避坑指南qutebrowser安装教程Windows/macOS/Linux三平台快速安装与避坑指南 qutebrowser 是一款 基于 Python 和 Qt 打桌面应用如何快速安装Codex-XWindows/macOS/Linux三平台安装完整指南如何快速安装Codex XWindows/macOS/Linux三平台安装完整指南 Codex X 是一款面向 OpenAI Codex 桌面端 / CodeAI 应用人工智能开发工具桌面应用提示工程AI 技能/插件desigma安装教程macOS/Windows/Linux三平台快速上手指南附首次启动避坑desigma安装教程macOS/Windows/Linux三平台快速上手指南附首次启动避坑 desigma 是一款用 Rust 编写的免费开源界面设计工上一篇同是开源 4K 生图FLUX 3 klein 与同期新模型谁更值得本地跑下一篇如何 5 分钟集成 TEAChartCocoaPods 安装 iOS 图表库的完整教程创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
阅读完成 · 觉得有帮助?
咨询建站