Claude Squad

Claude Squad 是一款终端应用程序，用于管理多个 Claude Code、Codex、Gemini（以及包括 Aider 在内的其他本地 Agent），通过独立的工作区，让你能够同时处理多项任务。

Claude Squad 截图

特性亮点

在后台完成任务（包含 yolo / 自动接受模式！）
在单个终端窗口内管理多个实例和任务
在应用更改前进行审查，并在推送前检出（checkout）更改
每个任务拥有独立的 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 <自定义名称>

前置要求

tmux
gh

使用方法

Usage:
  cs [flags]
  cs [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  debug       Print debug information like config paths
  help        Help about any command
  reset       Reset all stored instances
  version     Print the version number of claude-squad

Flags:
  -y, --autoyes          [experimental] If enabled, all instances will automatically accept prompts for claude code & aider
  -h, --help             help for claude-squad
  -p, --program string   Program to run in new instances (e.g. 'aider --model ollama_chat/gemma3:1b')

启动应用程序：

cs

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

与其他 AI 助手配合使用：

对于 Codex：使用 export OPENAI_API_KEY= 设置你的 API key。
使用指定助手启动：
- Codex: cs -p "codex"
- Aider: cs -p "aider ..."
- Gemini: cs -p "gemini"
如需将其设为默认，请修改配置文件（通过 cs debug 查看位置）。

菜单

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

实例/会话管理

n - 创建新会话
N - 创建带提示词（prompt）的新会话
D - 结束（删除）所选会话
↑/j, ↓/k - 在会话间切换

操作

↵/o - 进入所选会话并发送指令
ctrl-q - 从会话中脱离
s - 提交（Commit）并将分支推送到 GitHub
c - 检出（Checkout）。提交更改并暂停会话
r - 恢复暂停的会话
? - 显示帮助菜单

配置

Claude Squad 的配置文件存储在 ~/.claude-squad/config.json 中。你可以运行 cs debug 查看确切路径。

配置文件 (Profiles)

通过 Profile，你可以定义多个已命名的程序配置，并在创建新会话时进行切换。当定义了多个 Profile 时，会话创建界面会显示一个选择器，你可以通过 ←/→ 进行导航。

要配置 Profile，请在配置文件中添加 profiles 数组，并将 default_program 设置为默认选中的 Profile 名称：

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

每个 Profile 包含两个字段：

字段	说明
`name`	在 Profile 选择器中显示的名称
`program`	用于启动该 Profile 对应 Agent 的 Shell 命令

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

常见问题解答

无法启动新会话

如果你遇到类似 failed to start new session: timed out waiting for tmux session 的错误，请更新底层程序（例如 claude 或 aider）。