Atrium 实战指南：用持久化工作区管理 AI 编码 Agent 会话
当 Agent 会话中断，你失去的不只是代码
你是不是也有过这样的经历：Claude Code 正在跑一个复杂的重构任务，终端突然崩溃了——系统重启、SSH 断连、或只是不小心关掉了窗口。重新打开后，Agent 需要重新理解项目上下文，之前已经跑了一半的分析结果全部丢失，你只能从头再来。
这个问题在使用 AI 编码 Agent（Claude Code、Codex、Gemini CLI）时尤其突出。它们的 session 状态完全绑定在终端进程上，一旦中断，所有上下文、思考链、中间结果就消失了。对于一个 30 分钟以上的复杂任务，这可能是灾难性的。
Atrium 就是为解决这个问题而生的——一个 macOS 原生工作区管理器，让 AI 编码 Agent 的会话像 IDE 一样可以保存、恢复、分屏、协作。
什么是 Atrium？
Atrium（getatrium.dev）是一个由 Jonny Asmar 开发的 macOS 桌面应用，定位是”人与 AI Agent 的共享开发环境”。它解决了 CLI 编码 Agent 最大的痛点：会话不可持久化。
核心设计是 Room（房间）——每个 Room 是一个独立的、可持久化的 Agent 工作空间。Room 可以包含多个窗格（Pane）、分支（Branch）、终端历史记录、笔记和快照。关闭应用再打开，所有 Room 的状态完好如初。
支持开箱即用的 Agent：
- Claude Code
- OpenAI Codex CLI
- Google Gemini CLI
- Cursor CLI
- Antigravity
- OpenCode
- Pi.dev
安装与上手
Atrium 目前仅支持 macOS，提供 DMG 安装包。从官网下载后拖入 Applications 即可。
首次启动后，你会看到空白的 Room 面板。创建一个新 Room 并启动 Agent：
claude codex atrium ps
这就是 Atrium 的第一重价值——将所有 Agent 的终端整合到一个窗口，告别满桌面的终端窗口。
核心功能详解
1. Room：会话的原子单元
Room 是 Atrium 的基本单位。你可以为每个项目创建一个 Room，在 Room 中启动多个 Agent 窗格。
atrium room create my-project atrium room switch my-project
每个 Room 完全隔离，拥有独立的终端历史、工作目录和 Agent 实例。这意味着你可以同时维护一个前端重构 Room 和一个后端测试 Room，互不干扰。
2. Snapshot：会话的时光机
Snapshot 是 Atrium 最强大的功能——把整个 Room 的状态冻结成一个快照，随时可以恢复。
atrium snapshot save "pre-refactor-state" atrium snapshot list atrium snapshot restore pre-refactor-state
这在做大型重构时特别有用。比如你让 Claude Code 尝试两种不同的数据库迁移方案，可以先保存快照 A，运行方案一；再恢复到快照 A，运行方案二。最终比较两个方案的结果。
3. 分支与恢复
Atrium 支持在 Room 内创建分支（Branch），类似于 git branch 的概念：
atrium branch create experiment-optimization atrium branch switch main atrium branch list
分支与 Snapshot 配合使用，可以形成一个完整的 Agent 会话管理策略。主分支做稳定开发，实验分支跑危险的 Agent 操作，即使搞砸了系统，切换回主分支即可。
4. 窗格管理
多 Agent 协作是 Atrium 的亮点。你可以将不同 Agent 放在不同窗格中，实时对比它们的输出：
atrium pane split-h atrium pane split-v atrium pane right -- codex atrium pane bottom -- tail -f /tmp/claude-output.log
想象一个实际场景：左侧窗格跑 Claude Code 做代码生成，右侧窗格跑 Codex 做代码审查，底部窗格看测试日志——所有 Agent 的输出尽收眼底。
与工具对比
| 特性 | Atrium | tmux | macOS Terminal |
|---|---|---|---|
| 持久化会话 | ✅ 自动持久化 | ✅ 需手动 detach | ❌ 关闭即丢失 |
| 快照/恢复 | ✅ 原生支持 | ❌ | ❌ |
| 分支管理 | ✅ 内置 | ❌ | ❌ |
| 多 Agent 分屏 | ✅ 优雅 UI | ✅ 但配置复杂 | ✅ 但窗口零散 |
| macOS 原生 | ✅ 原生体验 | ❌ 需安装 | ✅ |
| 快捷键 | ✅ Intuitive | ❌ 学习曲线陡 | ✅ |
如果你已经在用 tmux，Atrium 并不完全是替代品——tmux 更适合远程服务器会话管理，而 Atrium 聚焦于本地开发中的 AI Agent 协作体验。
实际使用场景
场景一：长期重构任务
让 Claude Code 重构一个大型模块的重构可能需要 15-30 分钟甚至更久。万一中间中断，Agent 可能已经分析了 80% 的代码结构。用 Atrium 的 Snapshot，可以随时保存进度：
atrium snapshot save "before-refactor" claude "refactor the auth module to use the new middleware pattern" atrium snapshot save "refactor-50-percent" atrium snapshot restore "before-refactor"
场景二：多 Agent 代码审查
用 Claude Code 写功能代码，同时用 Codex CLI 做审查，可以并行进行：
atrium pane split-h atrium pane right -- codex "review the code in src/ -- find potential bugs"
场景三：实验环境隔离
创建一个专门用于”危险操作”的 Room，限制 Agent 的权限：
atrium room create experiment atrium room switch experiment claude "try migrating the database to PostgreSQL then back" atrium snapshot restore "clean-state"
最佳实践
- 每个项目一个 Room：同一项目相关的所有 Agent 任务在同一 Room 中，避免上下文碎片化
- 关键节点打 Snapshot：在每次值得信赖的 Agent 操作前保存快照，形成「后悔药」网络
- 使用分支分离风险：实验性操作在分支中进行，稳定后 merge 到主分支
- 窗格分配策略：左侧写代码的 Agent、右侧做审查的 Agent、底部运行测试——这是经过验证的布局
- 热键优先：Cmd+N 新建 Room、Cmd+S 保存 Snapshot、Cmd+W 关闭窗格，减少鼠标操作
注意事项
- 目前仅支持 macOS（Linux 和 Windows 版本在 roadmap 上）
- 早期访问阶段（v0.159.0），功能仍在快速迭代中
- 所有数据存储在本地
~/.atrium/，不上传云端——数据安全有保障 - 遥测默认为关闭状态，需要手动开启
总结
Atrium 填补了 AI 编码 Agent 生态中一个被严重忽视的空白：会话持久化。如果你每天都要打开多个 Claude Code 或 Codex 会话，或者经常因为终端崩溃丢失 Agent 进度，Atrium 值得一试。它更像是一个专为 AI Agent 时代设计的”IDE 窗口管理器”——让 Agent 会话像代码文件一样可以被保存、恢复和版本管理。
对于高频使用 AI 编码工具的开发者来说，这可能是继 Agent 本身之后，最能提升日常开发体验的工具之一。