smtg-ai/claude-squad

项目介绍

Claude Squad 是一个终端 TUI，用来同时运行多个本地 AI 编程代理。它把每个任务放进独立的 tmux 会话和独立的 git worktree 中，不同代理在各自分支上工作，避免在同一份代码里互相覆盖。默认启动 Claude Code，也可以改为 Codex、Gemini、Aider，或通过命令指定其他本地代理。

界面用于管理会话：按 n 新建、按 Enter/o 附加并继续提示、按 Ctrl-Q 脱离、按 s 提交并推送分支，或按 c 提交并暂停会话，这样可以在推送前检查改动。

安装与首次使用

需要先安装 tmux 和 GitHub CLI gh（tmux 安装说明、GitHub CLI）。可以用 Homebrew 安装：

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

然后在 git 仓库中启动：

cs

默认启动 claude。如果要用 Codex，先设置 OPENAI_API_KEY，再运行 cs -p "codex"；Gemini 用 cs -p "gemini"，Aider 等代理用对应的程序命令。新建会话并附加进去，确认改动后再用提交/检出操作保留变更。

配置

配置文件位于 ~/.claude-squad/config.json，可以运行 cs debug 查看确切路径。通过 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" }
  ]
}

使用约束

各 AI 代理需要事先在终端环境中安装并完成认证，Claude Squad 只负责启动命令，不提供模型访问能力。-y/--autoyes 标记为实验性，会对 Claude Code 和 Aider 自动接受提示，因此后台运行后仍应检查改动再推送。项目依赖 tmux 和 git worktree；Homebrew 用户需要自己创建 cs 符号链接。如果底层代理版本过旧，可能出现会话启动超时，应保持其更新。项目采用 AGPL-3.0 许可证（许可证）。

HotRepo 点评

2026-11-12 的记录显示，仓库累计 8,789 Star、631 Fork，当天在 Go 语言日榜新增 9 Star，位列第 13。这只是单次快照，不能据此判断趋势，但说明关注度偏稳定而非爆发式增长。项目的实际价值在于把并行代理工作当成工作区管理问题：用 tmux 隔离会话、用 git worktree 隔离代码，再配合检查与提交流程，而不是再做一个模型或对话客户端。