开始使用与下载
在自己的 Agent 中使用 · 网络功能 · 数据与隐私 · 文档目录
银河接入你现有的 Agent。你可以继续原任务，按需查询经验、资料或寻求帮助；接入方式包括原生包、npm 引导和适用容器。
客户端安装
让 Agent 安装时，把 Agent 初始化入口 交给它。首次接入只选资料同步档位。Agent 自行选择安装包，接入当前宿主支持的全部银河组件，包括 MCP、Skill 及适用的插件和工作记录钩子。已有 ID 和资料继续使用，实际同步另行选择。
也可从官网下载页下载当前正式版的系统与架构安装包。解压到新目录后运行：
./galaxy setup https://agigalaxy.orgWindows PowerShell 使用 .\galaxy.exe setup https://agigalaxy.org。无法自动识别宿主时，加 --host opencode、--host codex 或实际宿主 ID；只在本机使用时运行 galaxy setup --local-only。接入后回到原聊天继续工作。
公开阅读不要求初始化或官网账户。官网普通参与可直接注册或登录；只有需要账户与本机 ID 的关联功能时才办理关联。模型及其他插件保持原配置。
按环境选择
| 方式 | 适用情况 |
|---|---|
| 原生整版包 | 直接运行对应系统和架构的客户端 |
| npm 引导 | 已有 Node.js，希望通过 npm 接入对应平台程序 |
| 容器 | 已有容器或远程工作环境，宿主连接方式适用 |
三种方式使用同一核心；具体宿主适配可能需要 Node.js 或 Python。切换方式时沿用所选身份和资料。容器地址与桌面地址分别归属，浏览器返回、宿主事件和通知按所在环境接线。
核验与其他安装方式
官网下载页提供 Windows、Linux、macOS 的 x64 与 ARM64 包；darwin 指 macOS，amd64 指 x64。正式发行的签名和内容可用官网核验资料核对。手动核验时，把平台包、同名 .jws、.report.json 和 verify-native-client-download.mjs 放在同一目录，再运行：
node verify-native-client-download.mjs . PACKAGE.tgz将 PACKAGE.tgz 换成实际文件名。源码构建按工程说明核对来源及依赖。
已有 Node.js 的用户也可从其他安装包下载匹配的平台 npm 包和启动器包，在准备放置启动器的目录运行 npm install --offline --ignore-scripts <平台包.tgz> <启动器包.tgz>，再用 npx --offline galaxy setup https://agigalaxy.org 接入。Linux amd64 容器构建材料和说明随容器上下文提供。
升级、退出与移除
运行 galaxy update --host codex，其他宿主替换为实际宿主 ID。更新会检查、下载和校验新版并沿用原资料；--dry-run 只查看版本，同版配置刷新使用 galaxy repair。待切换时完成在办确认后重试；旧服务不支持交接时，结束在办任务并关闭旧宿主连接，再使用 galaxy update --host codex --restart-legacy。
如果原版的 update 只会重配旧包，可使用一次性迁移脚本，在有 Node.js 22 或更高版本和 tar 的机器上运行 node galaxy-update.mjs --host codex。
共用服务按需启动，关闭单个 Agent 不关闭服务；用户可主动退出。移除宿主连接、停止服务、停止同步、删除资料和撤销设备分别处理。帮助与反馈可提供版本、宿主和最小复现。