コンテンツにスキップ

Claude Code Teams

チェック

  • [ ] 本文を確認した
  • [ ] 概要を確認した
  • [ ] タグを確認した
  • [ ] inbox/ 直下へ移行した

概要

cmuxでClaude CodeのAgent Teams機能を起動するためのドキュメント。 cmux claude-teams は、Claude Codeがtmux内で動いているように見せるshimを作り、Claudeのチームメイトペイン操作をcmuxのネイティブスプリットへ変換する。 tmux互換レイヤー、環境変数、対応するtmuxコマンドの対応表が実装上のポイント。

本文

cmux claude-teams は、Claude Codeのチームメイトエージェントをcmux上で扱えるようにする起動コマンド。

基本の使い方は次の通り。

cmux claude-teams
cmux claude-teams --continue
cmux claude-teams --model sonnet

claude-teams の後ろに渡した引数はClaude Codeへ転送される。コマンド側ではteammate modeをautoにし、Claudeがcmuxスプリットを使うための環境を整える。

仕組みはtmux互換のshim。Claude Codeがtmux内で動いていると認識するように環境変数を設定し、Claudeがtmuxコマンドでペインを操作しようとしたら、shimがcmuxのソケットAPI呼び出しへ変換する。

作成される/使われる要素は次の通り。

~/.cmuxterm/claude-teams-bin/tmux
  tmuxコマンドをcmux __tmux-compatへリダイレクトするshim

~/.cmuxterm/tmux-compat-store.json
  tmux互換バッファやhookの永続ストレージ

重要な環境変数。

TMUX
  cmuxワークスペースとペインを表す偽のtmuxソケットパス

TMUX_PANE
  現在のcmuxペインに対応する偽のtmuxペインID

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS
  Claude CodeのAgent Teams機能を有効化する

CMUX_SOCKET_PATH
  shimが接続するcmuxコントロールソケット

対応するtmuxコマンドの例。

new-session / new-window
  新しいcmuxワークスペースを作成

split-window
  現在のcmuxペインを分割

send-keys
  cmuxサーフェスへテキストを送信

capture-pane
  cmuxサーフェスからターミナルテキストを読み取る

select-pane / select-window
  cmuxペインまたはワークスペースにフォーカスする

kill-pane / kill-window
  cmuxサーフェスまたはワークスペースを閉じる

list-panes / list-windows
  cmuxペインまたはワークスペースを一覧する

要するに、Claude Code側にはtmuxがあるように見せ、実際のUI/ペイン管理はcmuxに寄せる統合。tmux前提のAgent Teamsを、cmuxの分割UI、サイドバー、通知に乗せたいときに使う。

要点

  • cmux claude-teams はClaude CodeのAgent Teamsをcmuxスプリットで扱うためのラッパー。
  • 実体はtmux shimで、Claude Codeのtmux操作をcmux APIへ変換する。
  • TMUX、TMUX_PANE、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS、CMUX_SOCKET_PATH が重要。
  • split-window や send-keys などのtmux操作がcmux操作にマッピングされる。
  • Claude Codeのチームメイトエージェントを、tmuxではなくcmuxのUIで扱いたい場合の統合。

タグ

claude-code #cmux #multi-agent #tmux #agent-teams #tooling