Agent Deck实战指南1：AI 工具越来越多，你需要一个总控台（对比 GenHub）

场景还原一下： 你的电脑上装了 Claude Code，跑着两个项目的开发任务；OpenCode 在另一个目录做代码重构；Gemini CLI 在跑一个脚本自动化。 三个终端窗口开着，每个都在等你的回复。你切到第一个窗口，发现它卡在一个 bug 上；切到第二个，它问你"要不要继续？"；切到第三个，它已经跑完了，你完全不知道。 然后你忘了——哪个窗口是哪个项目来着？ 这就是 AI 编程工具越来越多之后，每个人都会遇到的问题：**工具多了，管理工具变成了新麻烦。** Agent Deck 就是来解决这个问题的。

Agent Deck 是什么

一句话：**给 AI 编程工具做的"任务管理器"。** 它是一个终端里的 TUI 界面（文本用户界面），把你在各个项目里跑的 AI 编程会话，全部集中到一个窗口里显示： - 每个会话在哪个项目、用哪个工具、什么状态（运行中/等待/已完成） - 按一个键就能切换进去操作 - 会话在后台继续跑，随时可以回来查看 支持的工具：Claude Code、OpenCode、Gemini CLI、Codex CLI，以及任何命令行里的 AI 工具。

先搞清楚：GenHub 和 Agent Deck 是两回事

很多人会把 Agent Deck 和 GenHub 搞混，其实它俩分工完全不同： GenHub = 配置中心 - 管什么：用什么模型、装什么工具 - 典型操作：切换 Provider、填 API Key、配 MCP - 界面：图形界面 - 解决的问题：配置麻烦、切换费时 Agent Deck = 运行中心 - 管什么：哪些会话在跑、跑得怎么样 - 典型操作：查看会话状态、切换会话、追 Token - 界面：终端 TUI - 解决的问题：多会话混乱、找不到窗口 打个比方： - GenHub 是"武器库"——帮你装好武器、选好弹药（模型），换武器一键搞定 - Agent Deck 是"作战指挥台"——让你看清战场上有几支队伍在行动，随时调度 先用 GenHub 配好环境，再用 Agent Deck 管理运行——这是完整的工作流，两个缺一不可。

安装

Agent Deck 是开源项目，GitHub 上 2,700+ star，MIT 协议，安装很简单。 Linux / macOS： ```bash curl -LSfs https://raw.githubusercontent.com/asheshgoplani/agent-deck/main/install.sh | sh ``` 或者用 Homebrew： ```bash brew install asheshgoplani/tap/agent-deck ``` Windows 用户建议用 WSL 2，在 Linux 环境里使用。

第一次打开

在终端运行： ```bash agent-deck ``` 第一次启动会自动扫描系统里已经安装的 AI 编程工具，把正在运行的会话自动导入。 界面分两个区域： 左侧：会话列表 每个会话一行，显示： - 用的什么工具（Claude Code / OpenCode / 等） - 在哪个项目目录 - 当前状态（颜色标识：绿色=运行中，黄色=等待输入，灰色=已完成） - 已运行时间、已消耗 Token 右侧：会话详情 选中一个会话，右侧显示它的实时输出和最近的日志。可以直接在这里继续输入指令。

三个基础操作

- ↑↓ 选择会话，Enter 进入 - Ctrl+Z 挂起当前会话，回到列表 - Q 退出 Agent Deck（会话继续在后台跑，随时可以回来） 就这么简单。不用记复杂的快捷键，先会用这三个，就能解决 90% 的日常需求。

什么场景下值得用

值得用： - 同时维护 2 个以上项目，每个项目都在跑 AI 工具 - 在 Claude Code 和 OpenCode / Gemini CLI 之间频繁切换 - 需要了解"我的 AI 工具现在都在干什么" 不值得用： - 偶尔开一次 Claude Code 写段代码 - 每次只开一个终端窗口，用完就关

和 GenHub 一起用，才是完整方案

推荐组合： 1. 用 GenHub 安装工具、选好 Provider（比如 DeepSeek）、配好 API Key 2. 打开 Agent Deck，开始多项目并行开发 3. 在 Agent Deck 里看每个会话的 Token 消耗，配合 GenHub 的用量统计了解成本分布 一个管配置，一个管运行。工具不冲突，反而互相补位。

下期预告

这期认识了 Agent Deck 的"总控台"，下期讲怎么用好它：多会话管理实战——同时跑 5 个项目不混乱的操作技巧。