這篇少廢話，跟著做就好。

Claude Squad 有兩個前置工具要先裝好，然後才是 Claude Squad 本身。整個流程大概五分鐘，前提是你有 Homebrew——沒有的話先去 brew.sh 裝一下。

前置工具：tmux

Claude Squad 底層用 tmux 管理 session，所以你的機器上一定要有它：

brew install tmux

裝完驗證一下：

tmux -V

有版本號出來就對了，tmux 3.x 以上都可以用。

前置工具：gh CLI

Claude Squad 在 push branch 到 GitHub 的時候需要 gh，這是 GitHub 的官方 CLI 工具：

brew install gh

裝完要登入 GitHub 帳號：

gh auth login

跟著提示走，選 GitHub.com → HTTPS → 瀏覽器驗證。完成之後跑一下：

gh auth status

看到 Logged in to github.com 就好了。

這個步驟不能跳：Claude Squad 的 s（push to GitHub）功能需要 gh 的授權。沒裝好的話，那個功能按下去會直接報錯。

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

第二行建立 cs 這個短指令的 symlink，這樣你就能直接用 cs 而不是每次打 claude-squad。

如果你不用 Homebrew，跑這行：

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

這會把 cs binary 裝到 ~/.local/bin。確保這個路徑在你的 PATH 裡：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

如果你偏好其他名稱（例如 squad），可以這樣安裝：

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

cs version

應該會看到類似 claude-squad version 0.x.x 的輸出。

再確認一下設定檔位置：

cs debug

這個指令會印出設定檔路徑（通常是 ~/.claude-squad/config.json）和 log 路徑，下一篇設定 profiles 的時候會用到。

跑這個快速檢查清單：

# tmux 有沒有裝
tmux -V
 
# gh 有沒有登入
gh auth status
 
# Claude Squad 版本
cs version

三個都有輸出，環境就準備好了。

cs: command not found

Homebrew 安裝的話，確認 symlink 有沒有建好：

ls -la $(brew --prefix)/bin/cs

沒有的話把 ln -s 那行再跑一遍。

手動安裝的話，確認 ~/.local/bin 在 PATH 裡：

echo $PATH | grep local

failed to start new session: timed out waiting for tmux session

這個錯誤通常是你用的 AI 代理人（例如 claude）版本太舊。更新一下：

npm install -g @anthropic-ai/claude-code@latest

或者你用的其他工具的更新指令。

gh auth 失敗

確認你的 GitHub 帳號有 2FA 設定好，然後重新跑 gh auth login，選瀏覽器驗證方式通常最穩。

裝好了，下一步是學會 TUI 的操作——那幾個鍵位，熟悉了就能開始真正使用 Claude Squad。