EN中
在 GitHub 上查看

$ cat zh/blog/install-agent-island

Guide4 分钟

安装 Agent Island：macOS 与 Windows

从官方 GitHub Release 安装当前稳定版，然后启动一个真实会话验证本地状态信号。

Agent Island 是 Claude Code 和 Codex 的开源本地状态伴侣。当前稳定版为 v1.7.1，macOS 与 Windows 安装包都从同一个 GitHub Releases 页面获取。

macOS

brew install tristan666666/tap/agentisland

也可以下载最新 DMG。首次打开若 macOS 弹出安全提示，请在 Finder 中右键应用并选择“打开”。支持 macOS 13 及以上版本。

Windows

从 最新 Release 下载 AgentIsland-1.7.1-win-x64.zip，解压后运行 AgentIsland.exe。这是自包含构建，不要求另外安装 .NET Runtime。

验证状态信号

  1. 打开 Agent Island。
  2. 在 Claude Code 或 Codex 中启动一个真实回合。
  3. 确认状态栏显示正在运行。
  4. 等当前回合结束或明确请求输入，确认状态随本地事件变化。

状态出现问题时，先确认会话确实由受支持的工具写入本地记录，再在 GitHub Issue 中附上操作系统、Agent Island 版本和工具版本，不要上传含 prompt 或源码的 transcript。

从源码构建

源码和构建说明在 GitHub 仓库。从源码安装适合需要审计或参与开发的用户；普通使用优先选择 Release 资产。

安装后的隐私检查

Agent Island 不要求创建产品账号。状态来自本机现有会话记录；不要为了排错把完整 transcript 上传到公开 Issue。若系统没有任何 Claude Code 或 Codex 会话，应用保持空闲是正常结果，不代表安装失败。

常见问题

macOS 首次打开被阻止时，确认下载来自官方 Release，再通过右键“打开”完成系统授权。Windows 若解压后无法启动，先保留完整目录结构并确认下载的是 win-x64 资产。两个平台都应以 Release 页面标注的当前版本为准，不从第三方镜像下载未知构建。