Claude Squad 使用与作用总结

1. 工具定位

Claude Squad 是一个终端 TUI 工具，用来在同一个代码仓库中管理多个 AI 编程代理会话。它支持 Claude Code、Codex、Gemini、Aider 等本地命令行代理，并为每个任务创建独立的运行环境。

它的核心价值是：让多个 AI 代理可以并行处理不同任务，同时通过 git worktree 隔离代码改动，避免互相冲突。

适合以下场景：

同时让多个 Claude Code 会话处理不同 bug 或功能
一个任务让 Claude 写代码，另一个任务让 Codex 或 Gemini 做对比实现
后台运行多个 AI 编程任务，主界面统一查看进度和 diff
在应用改动前先预览、检查、选择是否 checkout / commit / push

2. 核心作用

Claude Squad 主要解决三个问题：

2.1 多会话管理

普通使用 Claude Code 时，通常一个终端对应一个任务。Claude Squad 提供一个统一的终端界面，可以创建、切换、进入、删除多个 AI 会话。

每个会话可以看作一个独立任务，例如：

session A：修复登录 bug
session B：重构配置模块
session C：生成测试用例
session D：让另一个模型给出不同实现方案

2.2 代码隔离

Claude Squad 会为每个任务创建独立的 git worktree。这样每个 AI 代理都在自己的工作区和分支上修改代码，不会直接污染当前主工作区，也不会互相覆盖改动。

这对并行 AI 编程很重要：

多个任务可以同时运行
每个任务的 diff 独立查看
不满意的任务可以直接丢弃
满意的任务可以再 checkout、commit 或 push

2.3 统一查看和接管

Claude Squad 使用 tmux 管理底层终端会话，使用 TUI 管理界面展示不同 session 的状态、预览和 diff。

用户可以：

进入某个 session 继续追问
从 session detach 回主界面
在 preview 和 diff 之间切换
查看 AI 产生的修改
对完成的任务执行提交、推送或 checkout

3. 安装前提

Claude Squad 依赖：

tmux：用于创建和管理后台终端会话
gh：GitHub CLI，用于和 GitHub 交互，例如 push / PR 相关流程
至少一个 AI 编程代理命令，例如：
- claude
- codex
- gemini
- aider

注意：Claude Squad 必须在 git 仓库目录中运行，因为它依赖 git worktree 隔离任务。

4. 安装方式

4.1 Homebrew 安装

brew install claude-squad
ln -s "$(brew --prefix)/bin/claude-squad" "$(brew --prefix)/bin/cs"

安装后可以使用 cs 命令启动。

4.2 脚本安装

curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash

默认会把二进制文件安装到：

~/.local/bin

如果想指定自定义命令名：

curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash -s -- --name <your-binary-name>

5. 基本使用

进入一个 git 仓库目录：

cd /path/to/your/repo

启动 Claude Squad：

cs

默认情况下，新建 session 会使用 claude 命令，也就是 Claude Code。

6. 常用命令行参数

6.1 指定代理程序

使用 -p 或 --program 指定新 session 使用的代理命令。

使用 Codex：

cs -p "codex"

使用 Gemini：

cs -p "gemini"

使用 Aider：

cs -p "aider --model ollama_chat/gemma3:1b"

6.2 自动确认模式

cs -y

或：

cs --autoyes

该模式会让支持的代理自动接受提示，适合让任务在后台自动推进。但它会降低人工确认环节，使用前应确认当前仓库和任务风险可控。

6.3 查看配置路径

cs debug

该命令会打印 Claude Squad 的配置文件路径和当前配置内容。

6.4 重置所有 session

cs reset

该命令会清理 Claude Squad 保存的实例、tmux session、worktree 等状态。执行前应确认没有需要保留的任务改动。

6.5 查看版本

cs version

7. TUI 快捷键

启动 cs 后，会进入终端管理界面。

7.1 Session 管理

快捷键	作用
`n`	新建 session
`N`	新建带初始 prompt 的 session
`D`	删除当前选中的 session
`↑` / `j`	选择上一个 session
`↓` / `k`	选择下一个 session

7.2 操作当前 session

快捷键	作用
`Enter` / `o`	进入选中的 session，继续交互或追问
`ctrl-q`	从 session detach，返回 Claude Squad 主界面
`s`	commit 并 push 当前 session 的分支到 GitHub
`c`	checkout 当前任务改动，提交改动并暂停 session
`r`	恢复暂停的 session
`?`	显示帮助菜单

7.3 界面导航

快捷键	作用
`tab`	在 preview 和 diff 之间切换
`shift-↑` / `shift-↓`	滚动 diff 视图
`q`	退出 Claude Squad

8. 配置文件

Claude Squad 的配置文件默认位于：

~/.claude-squad/config.json

也可以通过以下命令查看准确路径：

cs debug

9. Profiles 配置

Profiles 用来配置多个代理程序，创建 session 时可以选择不同 profile。

示例配置：

{
  "default_program": "claude",
  "profiles": [
    { "name": "claude", "program": "claude" },
    { "name": "codex", "program": "codex" },
    { "name": "gemini", "program": "gemini" },
    { "name": "aider", "program": "aider --model ollama_chat/gemma3:1b" }
  ]
}

字段含义：

字段	说明
`name`	profile 显示名称
`program`	创建 session 时实际执行的 shell 命令

如果没有配置 profiles，Claude Squad 会直接使用 default_program。默认值通常是 claude。

10. 推荐使用流程

一个比较稳妥的使用流程：

进入目标 git 仓库。
运行 cs。
按 N 创建带 prompt 的 session。
输入明确任务，例如“修复 xxx 单元测试失败”或“实现 xxx 功能并补充测试”。
回到主界面观察 session 状态。
使用 tab 查看 preview / diff。
如果需要补充要求，按 Enter 或 o 进入 session 继续对话。
修改满意后，再考虑 checkout、commit 或 push。
不满意的 session 可以删除，避免污染主工作区。

11. 和直接使用 Claude Code 的区别

方式	特点
直接使用 Claude Code	简单直接，适合单个任务
使用 Claude Squad	适合多个任务并行、多个代理对比、隔离改动、统一管理

如果只是临时问一个问题，直接使用 Claude Code 更简单。

如果要让 AI 同时处理多个功能、多个 bug，或者希望每个任务都有独立分支和 worktree，Claude Squad 更合适。

12. 注意事项

必须在 git 仓库中运行。
使用 s push 前，应先检查 diff，避免把不期望的修改推到远端。
cs reset 会清理所有 Claude Squad 管理的 session 和 worktree，执行前确认没有需要保留的改动。
--autoyes 适合低风险、可回滚任务；高风险任务建议保持人工确认。
多个 AI 代理并行时，最好给每个任务明确边界，避免它们修改同一批文件。

13. 总结

Claude Squad 可以理解为“AI 编程代理的任务调度台”。它把 Claude Code、Codex、Gemini、Aider 等代理统一管理起来，并通过 tmux 和 git worktree 实现后台运行、任务隔离、diff 预览和会话切换。

它最适合用于：

多任务并行开发
AI 代理方案对比
后台长任务执行
在合并前隔离审查 AI 生成代码

对于频繁使用 AI 编程工具的人来说，它能把单个 AI 助手升级成一组可并行工作的“AI 开发小队”。

Quartz 4

Explorer

ClaudeSquad使用与作用总结