Agent of Empires快速上手:3条命令搭建第一个AI代理会话,关掉终端也不会中断
【免费下载链接】agent-of-empiresManage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile. Also supports Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, Factory Droid Coding.项目地址: https://gitcode.com/gh_mirrors/ag/agent-of-empires
Agent of Empires 是一款面向 Linux / macOS 的开源 AI 编码代理会话管理工具,让你并行运行 Claude Code、Codex CLI、OpenCode、Gemini CLI 等多个 AI 代理,通过终端 TUI 或浏览器统一管理。它的核心亮点是:所有会话都跑在 tmux 持久化后台里,关掉终端、断开 SSH,AI 任务照样继续执行。这篇快速上手教程只需 3 条命令,带你跑通第一个 AI 代理会话。
1️⃣ 一条命令安装 Agent of Empires
前置要求:必须先安装 tmux,Docker(或其他容器运行时)可选,仅在使用沙箱隔离时需要。
# macOS:Homebrew 一键安装 brew install aoe # Linux:运行官方安装脚本(见 docs/installation.md) aoe --version # 验证安装成功安装脚本位于仓库的 scripts/install.sh,更多安装方式(Nix、源码编译等)可查阅 docs/installation.md。
2️⃣ 三条命令搭建第一个 AI 代理会话
第 1 条命令:打开会话指挥中心
aoe这条命令启动 TUI 主界面:左侧是所有 AI 代理会话列表,右侧是预览区,底部状态栏实时显示当前可用的快捷键。界面为空时,按n可以直接在 TUI 里新建会话。
第 2 条命令:创建一个运行 Claude Code 的会话
aoe add --cmd claude会话会出现在 TUI 列表中(状态为Idle),选中它按Enter即可进入该 AI 代理的终端。想换其他代理也很简单:
aoe add -c opencode . # 用 OpenCode 代理创建会话 aoe agents # 查看本机已安装、可用的全部 AI 工具💡 小技巧:按t可在 AI 代理视图和配套终端之间切换,在旁边跑构建、git 命令,不干扰代理工作。
第 3 条命令:启动 Web 仪表盘,手机也能看
aoe serve # 仅本机 localhost 访问 aoe serve --remote # 通过 HTTPS 隧道暴露,手机可访问 aoe serve --daemon # 后台守护进程方式运行终端会打印一个带鉴权 token 的 URL,任何浏览器打开即可看到与 TUI 完全相同的会话、实时终端和 Diff 面板,还能安装成 PWA 获得 App 般的体验。远程访问与手机配对的完整玩法见 docs/guides/web-dashboard.md。
3️⃣ 为什么关掉终端也不会中断?
这是 Agent of Empires 与普通终端脚本最大的区别:每个 AI 代理都运行在独立的 tmux 会话中。
- 关闭
aoeTUI、断开 SSH、甚至终端崩溃,后台的代理会话都继续运行,不会被杀掉; - 会话只有在你主动删除时才会被移除;
- 重新运行
aoe,一切都在你离开时的状态; - 在代理会话内按
Ctrl+b d可脱离(detach)当前会话回到 TUI 总览,随时再Enter切回。
SSH 远程场景同样适用:断开后重新连接,再运行aoe即可接回所有会话。
4️⃣ TUI 常用快捷键速查表
| 按键 | 功能 |
|---|---|
n | 新建 AI 代理会话 |
b | 从已保存的项目新建会话 |
Enter | 进入(attach)选中会话 |
Ctrl+b d | 脱离当前 tmux 会话,回到 TUI |
t | 切换 代理视图 / 配套终端 |
D | 打开 Diff 视图审查代码改动 |
/ | 搜索会话 |
d | 删除会话 |
? | 查看完整快捷键表 |
完整说明见 docs/quick-start.md。
5️⃣ 下一步:让效率再翻倍
- Git worktree 并行:为不同分支各开一个目录、一个代理,互不冲突:
aoe add . -w feat/my-feature -b详见 docs/guides/worktrees.md;
- 恢复上次对话:进入 Claude 会话后执行
/resume,Agent of Empires 会自动捕获并持久化会话 ID,下次启动自动重连,见 docs/guides/session-resume.md; - 容器沙箱:
aoe add --sandbox .让 AI 代理跑在隔离容器里,见 docs/guides/sandbox.md; - 全部 CLI 命令与参数:查阅 docs/cli/reference.md。
三条命令走完,你就拥有了一个"关不掉"的 AI 代理工作台:本地 TUI 全速操控,手机浏览器随时监工。🚀
【免费下载链接】agent-of-empiresManage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile. Also supports Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, Factory Droid Coding.项目地址: https://gitcode.com/gh_mirrors/ag/agent-of-empires
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考