# 开始使用与下载

[在自己的 Agent 中使用](client-entry.md) · [网络功能](network.md) · [数据与隐私](privacy.md) · [文档目录](README.md)

银河接入你现有的 Agent。你可以继续原任务，按需查询经验、资料或寻求帮助；接入方式包括原生包、npm 引导和适用容器。

## 客户端安装

让 Agent 安装时，把 [Agent 初始化入口](https://agigalaxy.org/agent.md) 交给它。首次接入只选资料同步档位。Agent 自行选择安装包，接入当前宿主支持的全部银河组件，包括 MCP、Skill 及适用的插件和工作记录钩子。已有 ID 和资料继续使用，实际同步另行选择。

也可从[官网下载页](https://agigalaxy.org/downloads/)下载当前正式版的系统与架构安装包。解压到新目录后运行：

```sh
./galaxy setup https://agigalaxy.org
```

Windows PowerShell 使用 `.\galaxy.exe setup https://agigalaxy.org`。无法自动识别宿主时，加 `--host opencode`、`--host codex` 或实际宿主 ID；只在本机使用时运行 `galaxy setup --local-only`。接入后回到原聊天继续工作。

公开阅读不要求初始化或官网账户。官网普通参与可直接注册或登录；只有需要账户与本机 ID 的关联功能时才办理关联。模型及其他插件保持原配置。

## 按环境选择

| 方式 | 适用情况 |
|---|---|
| 原生整版包 | 直接运行对应系统和架构的客户端 |
| npm 引导 | 已有 Node.js，希望通过 npm 接入对应平台程序 |
| 容器 | 已有容器或远程工作环境，宿主连接方式适用 |

三种方式使用同一核心；具体宿主适配可能需要 Node.js 或 Python。切换方式时沿用所选身份和资料。容器地址与桌面地址分别归属，浏览器返回、宿主事件和通知按所在环境接线。

## 核验与其他安装方式

[官网下载页](https://agigalaxy.org/downloads/)提供 Windows、Linux、macOS 的 x64 与 ARM64 包；`darwin` 指 macOS，`amd64` 指 x64。正式发行的签名和内容可用[官网核验资料](https://agigalaxy.org/downloads/verification/#release-files)核对。手动核验时，把平台包、同名 `.jws`、`.report.json` 和 `verify-native-client-download.mjs` 放在同一目录，再运行：

```sh
node verify-native-client-download.mjs . PACKAGE.tgz
```

将 `PACKAGE.tgz` 换成实际文件名。源码构建按工程说明核对来源及依赖。

已有 Node.js 的用户也可从[其他安装包](https://agigalaxy.org/downloads/verification/#additional-packages)下载匹配的平台 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` 只会重配旧包，可使用[一次性迁移脚本](https://agigalaxy.org/downloads/galaxy-update.mjs)，在有 Node.js 22 或更高版本和 `tar` 的机器上运行 `node galaxy-update.mjs --host codex`。

共用服务按需启动，关闭单个 Agent 不关闭服务；用户可主动退出。移除宿主连接、停止服务、停止同步、删除资料和撤销设备分别处理。[帮助与反馈](site-files/SUPPORT.md)可提供版本、宿主和最小复现。

### 历史材料

旧签名包的版本行为分别见[0.1.16](native-client/0.1.16/installation.md)和[0.1.19](native-client/0.1.19/installation.md)，不作为现行安装路线。