Claude Squad

Claude Squad 是一个终端应用程序，用于在独立的 workspace 中管理多个 Claude Code、Codex、Gemini 以及其他本地代理（包括 Aider），使你能够同时处理多个任务。

Claude Squad Screenshot

亮点

在后台完成任务（包括 yolo / 自动确认模式！）
在同一个终端窗口中管理多个实例和任务
在应用更改前进行审查，在推送前检出（checkout）更改
每个任务拥有独立的 git workspace，因此不会产生冲突

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，我们建议使用最新版本。

将 Claude Squad 与其他 AI 助手配合使用：

对于 Codex：使用 export OPENAI_API_KEY= 设置你的 API key
使用特定助手启动：
- Codex: cs -p "codex"
- Aider: cs -p "aider ..."
- Gemini: cs -p "gemini"
通过修改配置文件（使用 cs debug 查看路径）将上述配置设为默认值

菜单

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

实例/会话管理

n - 创建新会话
N - 带提示词创建新会话
D - 终止（删除）选定会话
↑/j, ↓/k - 在会话间导航

操作

↵/o - 进入选定会话以重新输入提示
ctrl-q - 从会话中分离（detach）
s - 提交（commit）并推送到 GitHub 分支
c - 检出（checkout）。提交更改并暂停会话
r - 恢复已暂停的会话
? - 显示帮助菜单

配置

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

配置文件（Profiles）

Profiles 允许你定义多个命名的程序配置，并在创建新会话时进行切换。当定义了多个 profile 时，会话创建弹窗会显示一个 profile 选择器，你可以使用 ←/→ 进行导航。

要配置 profiles，请在配置文件中添加一个 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 对应代理的 shell 命令

如果没有定义 profiles，Claude Squad 将直接使用 default_program 作为启动命令（默认为 claude）。

常见问题解答 (FAQs)

无法启动新会话

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