手机也能管好 AI 编码会话：AgentOS 自托管多 Agent 工作台实战
当 Claude Code、Codex、Gemini CLI 和 Aider 同时跑在不同项目里，真正麻烦的往往不是启动它们，而是会话散落、终端断开、任务状态不可见。AgentOS 是一个 MIT 许可的自托管 Web 工作台，把多个 AI 编码 Agent、终端、Git 工作流和手机访问放进同一个界面。
AgentOS 解决什么问题？
AgentOS 的定位不是新的模型，也不是把所有 Agent 重新实现一遍。它更像一个会话编排层：每个工作区可以拥有多个会话，开发者既能在聊天界面发送任务，也能切换到终端继续操作；会话默认运行在 tmux 中，关闭浏览器不会杀掉后台工作。
它的几个实用特点如下：
- 移动优先：手机可以查看会话、发送提示、查看差异和处理审批，而不是只能看一个缩小版桌面页面。
- 多 Agent 并行：README 明确列出 Claude Code、Codex、OpenCode、Pi、Kilo Code、Gemini CLI、Aider、Cursor CLI、Amp 和 Oh My Pi 等适配项，但不同 Agent 的聊天、恢复、分叉能力并不完全相同。
- Git 工作流：支持状态、diff、提交、PR 和 worktree；任务可以在独立 worktree 中执行，并以 PR 作为交付结果。
- 会话持久化：每个会话位于 tmux 中，浏览器重启后仍能重新连接；还可以通过 SSH 使用其他机器上的工作区。
- 计划与审批：聊天里有 Plan 模式，Agent 先读代码并给出计划，确认后再执行；访问级别可以设为先询问、接受编辑或完全访问。
这里有一个重要边界：AgentOS 需要你已经安装至少一个 AI CLI 和对应账号。它是控制面板与会话层，不会替你提供模型额度或登录凭据。
安装与启动
官方 README 推荐 Node.js 20 及以上版本。使用 npm 安装最直接：
npm install -g @saadnvd1/agent-os agent-os install agent-os start
agent-os install 会检查或安装 tmux、ripgrep，并构建应用。也可以使用官方安装脚本：
curl -fsSL https://raw.githubusercontent.com/saadnvd1/agent-os/main/scripts/install.sh | bash agent-os start
如果你想参与开发，则可以克隆仓库并运行开发服务器：
git clone https://github.com/saadnvd1/agent-os cd agent-os npm install npm run dev
官方手动开发示例使用 http://localhost:3011。生产使用时，建议把服务放在 VPN、内网反向代理或其他明确的访问控制之后，不要直接把带有终端权限的控制面板暴露到公网。
第一个工作区怎么用？
启动后，先添加一个项目目录，再从新会话选择器中选择 Agent、模型、权限、基础分支和机器。AgentOS 不会在选择阶段立即创建会话，发送任务后才真正启动，这对手机端尤其重要：可以先把上下文和权限选好，再开始工作。
一个适合试用的任务是让 Agent 只做分析：
请阅读当前项目的 README 和 package.json，列出启动命令、测试命令以及可能缺失的环境变量。先不要修改文件。
将访问级别设为 Ask first，观察它提出的每一次工具请求。确认计划后，再切换到执行阶段。聊天界面可以显示流式回复、计划清单、diff、上下文占用和下一步提示；如果任务更适合传统终端，可以切换到 Terminal，继续同一个会话。
当任务需要隔离时，使用 worktree 让 Agent 在独立分支中工作。完成后从 Git 面板检查 diff、提交记录和 PR，而不是直接让多个 Agent 同时改动主分支。对于重构、依赖升级或批量测试，这个边界尤其有价值。
手机远程使用的安全建议
AgentOS 的便利性来自它拥有真实的终端和 Git 能力，因此安全配置不能省略。
第一，优先使用 VPN 或 SSH 隧道访问服务，不要仅凭一个复杂 URL 保护公网端口。第二，日常工作使用 Ask first 或 Accept edits；只有在隔离工作区、可回滚分支和明确任务范围内，才考虑 Full access。第三，给每个项目单独的工作区，避免把包含密钥的个人目录直接交给 Agent。
还要注意 README 中的适配能力差异。例如 Claude Code 和 Codex 支持聊天、恢复和分叉，但 Gemini CLI 的这些能力并不完整；AgentOS 的新会话选择器会提示 Agent 是否安装以及是否需要先登录。不要因为列表里出现某个 Agent，就默认所有功能都可用。
适合哪些团队？
AgentOS 适合已经在使用多个编码 Agent、希望从手机查看长任务进度，或需要在多台开发机之间切换的人。它把“启动一个 Agent”扩展成了“管理一组可恢复的工程会话”：会话状态、tmux、worktree、Git 和计划审批被放在了同一个工作流里。
如果你只需要偶尔在终端运行一个 Agent，直接使用原生 CLI 会更轻量；如果团队需要集中式权限、审计、多人协作和企业身份管理，则应进一步评估 AgentOS Cloud 或其他专门平台。对个人开发者而言，自托管 AgentOS 的价值在于可控：代码和会话留在自己的机器上，同时获得一个适合手机使用的操作入口。
相关链接