---
title: "概览"
description: "agent-manager 是什么，会话是什么，以及各部分在哪里。"
canonical: "https://agent-manager.dev/zh-cn/docs/"
last-updated: "2026-11-02"
section: "Documentation"
language: "zh-CN"
source: "agent-manager"
---

# 概览

agent-manager 是一个运行在 tmux 之上的 Go TUI。你启动的每个智能体都是一个真实的 tmux 会话，所以管理器只是观察它们的窗口，而不是它们栖身的容器。退出管理器，它们照样继续工作。

![会话列表：二十多个智能体会话按 backend（含 api 子分组）、frontend 和 infra 分组，每个都带有按颜色区分的实时状态，右侧预览中是一份真实的 Claude Code 对话记录，左下角是机器资源仪表。](/assets/screenshot-sessions.webp)

_二十三个会话，四个项目，一个嵌套子分组。预览中是一个真实的 Claude Code 面板。_

## 首次运行

不需要写配置，也不需要启动守护进程。安装之后运行：

```bash
agent-manager
```

还没有存过版本号的第一次启动会打开[首次设置](/zh-cn/docs/setup/)。它选择智能体、布局、密度和主题，浏览按键，也可以导入 CLI 已经保存的对话。设置里有一行可以再走一遍。其余可以修改的选项都在设置（`s`）里：按键、编辑器、主题以及其他选项。Claude Code、OpenCode、Codex、Grok Build、Gemini CLI、Antigravity CLI、Pi、Command Code、Hermes Agent、Muse Code、Oh My Pi 和 Cursor CLI 均已内置，规则也一并内置，所以第一次启动智能体之前不需要额外定义任何东西。

| 按键 | 作用 |
| --- | --- |
| n | 新建会话：名称、工具、该工具提供的模型、推理强度和 profile、目录、可选的已保存提示词和起始提示词，以及分组。 |
| g | 新建分组。 |
| space | 向选中的智能体发送提示词，或在选中的分组中启动一个智能体。 |
| C | 添加 SSH 连接，让另一台机器上的会话加入列表。 |
| ? | 查看所有按键，无需离开应用。 |

鼠标在每个界面都可用。单击聚焦会话，双击折叠分组，滚轮移动光标，拖动 `⠿` 手柄可以移动行，`[…]` 打开该行的操作菜单，列表和预览之间的分隔线也可以拖动。全屏布局下单击选中、双击聚焦。

## 会话在哪里运行

智能体会话运行在一个名为 `agentmgr` 的私有 tmux 服务器上，位于 `am_*` 命名空间中，所以它们不会和你自己运行的 tmux 混在一起，在你自己的 socket 上执行 `kill-server` 也不会影响它们。要从普通 shell 访问某个会话，需要指定这个服务器：

```bash
tmux -L agentmgr ls
tmux -L agentmgr attach -t am_<id>
```

> **在会话内部** 当终端没有占用 `ctrl+q` 时，按它可以退出（detach）回到管理器；`ctrl+\` 是备用键。聚焦会话时 `ctrl+c` 会发送给智能体，管理器保持运行。`ctrl+r` 打开审查，`F3` 在编辑器中打开会话的目录。这些绑定只作用于受管理的会话，在其他地方会原样透传。

## 接下来看什么

| 页面 | 内容 |
| --- | --- |
| [安装](/zh-cn/docs/install/) | Homebrew、Scoop、安装脚本、AUR、mise、Go 或二进制文件。 |
| [首次设置](/zh-cn/docs/setup/) | 首次运行的选择、按键导览，以及把 CLI 已经保存的对话带进来。 |
| [状态](/zh-cn/docs/status/) | 某一行为什么是橙色，以及这个判断从何而来。 |
| [快速提示](/zh-cn/docs/prompt/) | 无需进入（attach）即可回复被阻塞的智能体。 |
| [审查模式](/zh-cn/docs/review/) | 整文件 diff，行评论会发回给智能体。 |
| [会话](/zh-cn/docs/sessions/) | worktree、shell、结束与恢复、其他机器、全屏。 |
| [按键](/zh-cn/docs/keys/) | 和 `?` 浮层显示的按键相同。 |
| [MCP](/zh-cn/docs/mcp/) | 智能体能做什么，以及如何从脚本启动。 |
| [配置](/zh-cn/docs/config/) | 设置、按键表、十二个内置 CLI、已保存的提示词和主题。 |
| [环境](/zh-cn/docs/environments/) | 会话或分组启动时使用的命名环境配置。 |
| [社区](https://discord.gg/ecS88An7pF) | 在 Agent Manager Community Discord 上，#help 频道解答问题和配置求助，#workflows 频道分享配置。Bug 和功能请求请提交到 [GitHub issues](https://github.com/wainmann/agent-manager/issues/new/choose)。 |
