claude-squad

Q: 想用 Codex 或 Gemini 怎么办？

Codex 先导出 OPENAI_API_KEY，再用 cs -p ＂codex＂ 或 cs -p ＂gemini＂ 启动对应代理。

一个终端管多个 AI 编码代理，切换查看不混乱

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署自动化工作流 🍴 复刻 634 🐛 待处理 52 👀 关注 29

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 8810

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，Go语言实现，需自行部署

项目预览

claude-squad 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类自动化工作流

开发团队smtg-ai

官网地址https://smtg-ai.github.io/claude-squad

GitHubhttps://github.com/smtg-ai/claude-squad

定价模式🏷️完全免费

价格说明开源免费，Go语言实现，需自行部署

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议AGPL-3.0

主要语言Go

技术栈/模型claude-code,cli,codex,opencode,vibe-coding

GitHub 星标★ 8810

上线时间2025-03-09 00:00:00

代码更新2026-11-13

仓库体积3.4 MB

本站数据更新2026-11-15

维护状态活跃

收录时间2026-11-15

浏览次数0

项目介绍

claude-squad 是一个用 Go 编写的终端工具，用于统一管理多个 AI 编码代理进程，支持 Claude Code、Codex、OpenCode、Amp 等主流命令行代理。它解决的核心问题是：当开发者同时运行多个 AI 代理处理不同任务时，终端窗口混乱、进程难以追踪、上下文容易丢失。claude-squad 提供类似 tmux 的多会话管理能力，让每个代理在独立会话中运行，可随时切换、查看输出、暂停或恢复，并集中展示各代理的运行状态。它面向重度使用 AI 编码助手的开发者，把零散的终端会话组织成可管理的工作台，减少手动开窗和上下文切换成本，提升多任务并行时的可控性。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-11-15 · 当前星标 ★ 8810

技术标签

claude-code cli codex opencode vibe-coding

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

macOS 或 Linux 终端环境
Homebrew 方式安装需先有 brew 命令
至少安装一个 AI 编码代理 CLI，如 claude、codex、gemini、aider
使用 Codex 时需准备 OPENAI_API_KEY

安装与启动步骤

1Homebrew 安装

README 推荐 Homebrew 安装，装完可执行文件名为 claude-squad
```
brew install claude-squad
```
2创建 cs 软链接

安装后需手动建立 cs 软链接，后续命令才能用 cs 调用
```
ln -s "$(brew --prefix)/bin/claude-squad" "$(brew --prefix)/bin/cs"
```
3脚本方式安装

不使用 Homebrew 时可按 README 给出的脚本地址下载安装程序执行
```
curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh
```
4确认安装结果

用 version 子命令确认 cs 可正常调起
```
cs version
```
5查看配置路径

debug 子命令会打印配置文件路径，便于后续修改默认程序
```
cs debug
```
6启动多会话终端

直接运行 cs 进入管理界面，默认程序为 claude，建议用最新版
```
cs
```
7指定其他代理

用 -p 参数指定要运行的代理程序，如 codex、gemini、aider
```
cs -p "codex"
```
8运行 Codex 前设密钥

使用 Codex 需先导出 OpenAI API Key 环境变量
```
export OPENAI_API_KEY=sk-xxxxxxxx
cs -p "codex"
```

关键配置

配置项	必填	说明	示例
`config.json`	否	主配置文件，实际路径用 cs debug 查看	`~/.claude-squad/config.json`
`默认程序`	否	在配置文件中修改，改变 cs 启动时的默认代理	`codex`
`OPENAI_API_KEY`	否	使用 Codex 代理时需要设置的环境变量	`sk-xxxxxxxx`
`--autoyes / -y`	否	实验性选项，自动接受 claude code 与 aider 的提示	`cs -y`
`--program / -p`	否	指定新实例中运行的程序	`aider --model ollama_chat/gemma3:1b`