Claude Squad

Claude Squad 是一款终端应用程序，可在独立的工作空间中管理多个 Claude Code、Codex、Gemini（以及其他本地代理，包括 Aider），从而允许您同时处理多项任务。

亮点

• 在后台完成任务（包括 yolo / 自动接受模式！）
• 在一个终端窗口中管理实例和任务
• 在应用更改前审查，推送前先检出更改
• 每个任务都有自己的隔离 git 工作区，因此不会发生冲突

https://github.com/user-attachments/assets/aef18253-e58f-4525-9032-f5a3d66c975a

安装

无论是通过 Homebrew 还是手动安装，Claude Squad 都会以 cs 的名称安装到您的系统中。

Homebrew

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

手动

您也可以通过运行以下命令来安装 Claude Squad：

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

这会将 cs 二进制文件放置在 ~/.local/bin 中。

如果您想为二进制文件使用自定义名称：

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

先决条件

• tmux
• gh

使用方法

用法：
  cs [flags]
  cs [command]

可用命令：
  completion  为指定的 shell 生成自动补全脚本
  debug       打印配置路径等调试信息
  help        关于任何命令的帮助
  reset       重置所有存储的实例
  version     打印 Claude Squad 的版本号

标志：
  -y, --autoyes          [实验性] 如果启用，所有实例将自动接受 Claude Code 和 Aider 的提示
  -h, --help             Claude Squad 的帮助
  -p, --program string   在新实例中运行的程序（例如 'aider --model ollama_chat/gemma3:1b'）

通过以下命令运行应用程序：

cs

注意：默认程序是 claude，我们建议使用最新版本。

使用 Claude Squad 与其他 AI 助手：

• 对于 Codex：请使用 export OPENAI_API_KEY=<your_key> 设置您的 API 密钥。
• 使用特定助手启动：
  • Codex：cs -p "codex"
  • Aider：cs -p "aider ..."
  • Gemini：cs -p "gemini"
• 您可以通过修改配置文件（使用 cs debug 查找位置）将其设置为默认。

菜单

屏幕底部的菜单显示了可用的命令：

实例/会话管理

• n - 创建新会话
• N - 带提示创建新会话
• D - 杀死（删除）所选会话
• ↑/j、↓/k - 在会话之间导航

操作

• ↵/o - 附加到选定的会话以重新提示
• ctrl-q - 从会话分离
• s - 提交并推送到 github
• c - 检出。提交更改并暂停会话
• r - 恢复暂停的会话
• ? - 显示帮助菜单

导航

• tab - 在预览标签和差异标签之间切换
• q - 退出应用程序
• shift-↓/↑ - 在差异视图中滚动

配置

Claude Squad 将其配置存储在 ~/.claude-squad/config.json 中。您可以通过运行 cs debug 找到确切的路径。

配置文件

配置文件允许您定义多个命名的程序配置，并在创建新会话时在它们之间切换。当定义了多个配置文件时，会话创建界面会显示一个配置文件选择器，您可以用 ←/→ 导航。

要配置配置文件，请在您的配置文件中添加一个 profiles 数组，并将 default_program 设置为您希望默认选择的配置文件名称：

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

每个配置文件包含两个字段：

字段	描述
name	在配置文件选择器中显示的名称
program	用于启动该配置文件对应代理的 Shell 命令

如果未定义任何配置文件，Claude Squad 将直接使用 default_program 作为启动命令（默认为 claude）。

常见问题解答

无法启动新会话

如果您遇到类似 无法启动新会话：等待 tmux 会话超时 的错误，请将底层程序（例如 claude）更新到最新版本。

工作原理

1. tmux 为每个代理创建隔离的终端会话
2. git worktrees 隔离代码库，使每个会话在其自己的分支上工作
3. 简单的 TUI 界面便于导航和管理

许可证

AGPL-3.0

星标历史

Claude Squad 快速上手指南

Claude Squad 是一款终端应用，允许你在隔离的工作区中同时管理多个 AI 编程助手（如 Claude Code、Codex、Gemini、Aider 等），从而实现多任务并行开发。

环境准备

在开始之前，请确保你的系统已安装以下前置依赖：

• tmux: 用于创建隔离的终端会话。
  • macOS: brew install tmux
  • Linux (Ubuntu/Debian): sudo apt-get install tmux
• gh (GitHub CLI): 用于代码分支管理。
  • macOS: brew install gh
  • Linux: 参考 GitHub CLI 安装文档
• AI 助手: 确保已安装你想要使用的工具（默认需要 claude，即 Claude Code）。

安装步骤

你可以通过 Homebrew 或官方脚本进行安装。安装后，命令行工具名称为 cs。

方式一：Homebrew (推荐 macOS 用户)

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

方式二：手动安装 (通用)

运行以下脚本将 cs 二进制文件安装到 ~/.local/bin：

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

注意：如果安装后无法直接运行 cs，请将 ~/.local/bin 添加到你的环境变量 PATH 中。

若需自定义二进制文件名，可使用：

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

基本使用

1. 启动应用

在终端输入以下命令即可启动，默认运行 claude (Claude Code)：

cs

2. 切换不同的 AI 助手

你可以通过 -p 参数指定要运行的 AI 工具：

• 使用 Codex:

  export OPENAI_API_KEY=<your_key>
  cs -p "codex"
  

• 使用 Aider:

  cs -p "aider ..."
  

• 使用 Gemini:

  cs -p "gemini"
  

提示：若要永久修改默认程序，可编辑配置文件（路径可通过 cs debug 查看），或配置 profiles（详见高级配置）。

3. 核心操作快捷键

启动后，你将进入一个 TUI 界面，底部菜单显示了可用命令：

会话管理

• n: 创建新会话
• N: 带提示语创建新会话
• D: 删除选中的会话
• ↑/j, ↓/k: 在不同会话间导航

任务执行

• ↵ 或 o: 附加到选中会话以重新输入提示
• ctrl-q: 从会话分离（让其在后台运行）
• s: 提交更改并推送到 GitHub
• c: 暂存会话（Commit 并暂停）
• r: 恢复暂停的会话

其他

• tab: 在预览视图和差异视图间切换
• q: 退出应用
• ?: 显示帮助菜单

工作原理简述

Claude Squad 利用 tmux 为每个 AI 代理创建独立的终端会话，并使用 git worktrees 隔离代码库，确保每个任务都在独立的分支上运行，互不冲突。