下载 Magpie AI
根据你的操作系统选择最合适的方式，支持菜单栏应用、Homebrew、终端 TUI 及一行命令脚本安装。
终端一行命令极速安装
官方自动化脚本自动识别系统架构（macOS / Linux / Termux），一键配置本地守护进程与 CLI
适用于 macOS 及主流 Linux 发行版，自动侦测 CPU 架构并部署 magpie 守护进程
Windows 版
支持 Windows 10/11 桌面环境，提供便携式可执行程序与 Windows Terminal 深度支持，支持作为系统后台服务运行。
macOS 版 (推荐)
原生适配 Apple Silicon (M1/M2/M3/M4) 与 Intel 架构。支持常驻顶部菜单栏，一键点选切换当前模型的首选体验。
Linux / Termux 版
轻量静态编译二进制，完美适配 Ubuntu、Debian、Arch 等发行版，支持纯终端 TUI 模式与 Docker 容器化部署。
安装与网关配置常见排查
收录了首次安装、权限放行、本地网关监听及智能体接管过程中的常见疑问。
最推荐的安装方式是什么？国内访问慢怎么解决？
推荐优先使用官方自动化脚本或 Homebrew 一键安装。国内网络如遇超时，可为脚本追加代理参数 `--proxy` 加速，或在下载弹窗中选择网盘镜像。
macOS 打开时提示“无法验证开发者”怎么办？
由于开源客户端未购买商业证书签名，首次打开如遇拦截，请打开系统「设置 -> 隐私与安全性」，在页面下方点击「仍要打开」即可正常运行。
本地 3425 网关端口是否可以自定义？
可以。如果 3425 端口已被占用，可在设置中修改端口或启动时配置 `MAGPIE_PORT` 环境变量，Magpie 会自动同步更新被接管工具的配置。
Linux 服务器无图形界面，如何使用？
可以直接使用 `magpie tui` 启动终端交互界面，或通过 `magpie provider add` 等原生 CLI 命令完成配置管理，完全不依赖图形桌面环境。
智能体如何恢复原生的官方配置？
只需在 Magpie 菜单栏选中对应工具并点击「Unmanage」，或在终端执行 `magpie reset [agent-name]`，即可一键无损还原原生初始配置。
更新 Magpie 客户端会丢失我已经保存的 Key 和配置吗？
完全不会。Magpie 的供应商密钥、路由组与账号配置均保存在用户主目录的独立数据文件夹中，覆盖升级二进制文件绝不会影响已有数据。