Tmux Agents

在tmux会话中管理后台编码代理,可启动Claude Code等代理、检查进度并获取结果。

安装

概览

什么是Tmux Agents

Tmux Agents 是一款专为开发者设计的命令行工具,通过在 tmux 会话中运行后台编码代理,实现高效的多任务并行开发体验。它允许用户在终端中启动并管理多个 AI 驱动的编程助手,这些代理可以在后台持续工作,而用户可自由切换至其他任务或窗口继续自己的开发流程。无论是修复 Bug、重构代码还是撰写文档,Tmux Agents 都能将复杂任务拆解为可监控的异步进程,显著提升工作效率。该工具支持多种主流 AI 模型,包括云端 API(如 Claude Code、OpenAI Codex、Google Gemini)和本地部署模型(通过 Ollama 调用),兼顾性能与成本优势。所有代理均基于持久化 tmux 会话运行,即使终端断开连接也不会中断任务,确保长时间任务的稳定性。

核心功能特点

  1. 支持在后台运行多个编码代理,实现多任务并行处理
  2. 兼容云端 AI 模型(Claude、Codex、Gemini)和本地 Ollama 模型
  3. 提供一键创建、状态检查、实时查看和终止会话的完整生命周期管理
  4. 利用 tmux 持久化特性,保障代理在终端断开后仍可继续运行
  5. 本地代理无需 API 费用,适合预算敏感或实验性项目
  6. 支持混合使用云代理与本地代理,灵活应对不同任务需求

适用场景

Tmux Agents 特别适合需要长时间运行或高负载编码任务的场景。例如,当开发者需要对一个大型项目进行深度重构时,可以启动一个 ollama-claude 代理在后台执行,同时自己继续处理前端界面或其他模块的开发工作。由于本地代理不消耗 API 额度且能调用 GPU 加速,非常适合进行耗时较长的实验性代码重写或单元测试生成。对于紧急但简单的 Bug 修复,则可快速启用 claude 云代理,利用其强大的推理能力迅速定位并解决问题。此外,团队协作中若需多人并行处理不同功能模块,可通过 spawn.sh 脚本同时启动多个异构代理(如一个云代理负责后端逻辑,一个本地代理负责文档编写),并通过 status.sh 统一监控进度。整个系统天然适配 DevOps 流程,尤其适合那些需要自动化、可复现且可追溯的软件开发环境。