介绍
# Tmux Agents
在持久化的 tmux 会话中运行编码代理。它们会在后台运行，同时你可以做其他事情。
## 可用代理
### ☁️ 云代理（需要 API 积分）
| 代理 | 命令 | 最适合 | |-------|---------|----------| | **claude** | Claude Code | 复杂编码、重构、完整项目 | | **codex** | OpenAI Codex | 快速编辑、自动批准模式 | | **gemini** | Google Gemini | 研究、分析、文档编写 |
### 🦙 本地代理（通过 Ollama 免费使用）
| 代理 | 命令 | 最适合 | |-------|---------|----------| | **ollama-claude** | Claude Code + Ollama | 长时间实验、大量重构 | | **ollama-codex** | Codex + Ollama | 扩展编码会话 |
本地代理使用 Mac 的 GPU —— 无 API 费用，非常适合实验！
## 快速命令
### 生成新的代理会话 ```bash ./skills/tmux-agents/scripts/spawn.sh <name> <task> [agent]
# Cloud (uses API credits) ./skills/tmux-agents/scripts/spawn.sh fix-bug "Fix login validation" claude ./skills/tmux-agents/scripts/spawn.sh refactor "Refactor the auth module" codex ./skills/tmux-agents/scripts/spawn.sh research "Research caching strategies" gemini
# Local (FREE - uses Ollama) ./skills/tmux-agents/scripts/spawn.sh experiment "Rewrite entire test suite" ollama-claude ./skills/tmux-agents/scripts/spawn.sh big-refactor "Refactor all services" ollama-codex ```
### 列出运行中的会话 ```bash tmux list-sessions # or ./skills/tmux-agents/scripts/status.sh ```
### 检查会话状态 ```bash ./skills/tmux-agents/scripts/check.sh session-name ```
### 附加以实时查看 ```bash tmux attach -t session-name # Detach with: Ctrl+B, then D ```
### 发送额外指令 ```bash tmux send-keys -t session-name "additional instruction here" Enter ```
### 完成后终止会话 ```bash tmux kill-session -t session-name ```
## 何时使用本地或云端代理
| 场景 | 建议 | |----------|----------------| | 快速修复、时间紧迫 | ☁️ 云端（更快） | | 昂贵的任务、预算有限 | 🦙 本地 | | 长时间实验、可能失败 | 🦙 本地 | | 生产代码审查 | ☁️ 云端（更智能） | | 学习/探索 | 🦙 本地 | | 大量重构 | 🦙 本地 |
## 并行代理
同时运行多个代理：
```bash # Mix and match cloud + local ./scripts/spawn.sh backend "Implement user API" claude # Cloud ./scripts/spawn.sh frontend "Build login form" ollama-codex # Local ./scripts/spawn.sh docs "Write API documentation" gemini # Cloud ./scripts/spawn.sh tests "Write all unit tests" ollama-claude # Local ```
一次性检查所有： ```bash ./skills/tmux-agents/scripts/status.sh ```
## Ollama 设置
本地代理需要安装 Ollama 并配备编码模型：
```bash # Pull recommended model ollama pull glm-4.7-flash
# Configure tools (one-time) ollama launch claude --model glm-4.7-flash --config ollama launch codex --model glm-4.7-flash --config ```
## 提示
- 即使 Clawdbot 重启，会话也会保持 - 使用本地代理处理有风险/实验性的工作 - 使用云端代理处理生产关键型任务 - 检查 `tmux ls` 查看所有活动工作 - 完成后终止会话以释放资源