Claude Code Agent TeamsはZellijに未対応 — 現状と回避策

このTipsでできること

Agent Teamsのsplit-pane表示は、対応するターミナルがtmuxとiTerm2(it2 CLI付き)に限られています。Zellijでのネイティブなsplit-pane表示は、2026年3月に登録されたfeature requestの段階にとどまっています。Zellijユーザーが現状どこまで使えるか、コミュニティ製プラグインでの回避策、導入前に知っておくべき制約をまとめます。

Zellij内で今できること・できないこと

Zellij内でClaude Codeを起動すること自体に制約はありません。Agent Teams機能そのものも通常どおり動きます。制約があるのは表示モードだけです。既定のin-process表示は「どの端末でも動く」とドキュメントに明記されており、Zellijのペイン内でもteammateはメインターミナルのエージェントパネルに表示され、上下矢印キーで選択してやり取りできます。

対応していないのは、teammateごとに専用のペインを割り当てるsplit-pane表示です。teammateModeをautoやtmuxに設定しても、Zellijセッション内では前提条件(tmuxまたはiTerm2)を満たさないため、エラーを出さずにin-process表示へ切り替わります。「設定したのにペインが分かれない」と感じたら、まずこのフォールバックを疑うのが近道です。

split-pane対応はtmuxとiTerm2に限定されている

Claude Codeのドキュメントは、Agent Teamsの表示モードについて次のように明記しています。

iTerm2のネイティブsplit-pane対応はteammateMode: "iterm2"としてバージョン2.1.186(2026年6月22日)で追加されました。it2 CLIのインストールとiTerm2側でのPython API有効化が前提です。tmuxは各OSのパッケージマネージャーからインストールする一般的な経路で、iTerm2からtmux -CC経由で入る使い方がドキュメントの推奨経路として挙げられています。

Limitations節では対応端末をさらに絞り込んでおり、VS Codeの統合ターミナル・Windows Terminal・Ghosttyでのsplit-pane表示は非対応と明記されています。Zellijはこのリストにすら登場しません。対応外というより、そもそも検討対象のリストに載っていない段階です。

現在使えるかどうかをコマンドで確認するには、Zellijセッション内で次を実行します。$ZELLIJが設定されていればZellij内で動いていることが分かり、which tmuxでtmuxがインストール済みかを確認できます。

echo $ZELLIJ
which tmux

Zellij対応のfeature requestは何を求めているか

該当のissueは2026年3月7日にGitHubへ登録され、ラベルはenhancement area:tui area:agentsです。要望は3点に分かれています。Agent Teamsのteammate起動先としてZellijをtmuxの代替にすること、/terminal-setupの対応端末一覧にZellijを追加すること、ZellijがサポートするKitty keyboard protocolでのキー入力を正しく扱うことです。

提案されている実装アプローチは、tmuxが$TMUX環境変数で検出されているのと同じように$ZELLIJ環境変数でセッションを検出し、zellij action new-tab --name <agent>とzellij action write-charsでteammateを起動し、独立したコマンド実行にはzellij run --を使う、というものです。tmux側の実装を踏襲すればよいという主張で、実装の難度自体はそれほど高くないと投稿者は述べています。

issueには3件のコメントが付いており、いずれもAgent Teamsのsplit-pane表示をZellijで使いたいという要望です。ある投稿者は、tmuxのカスタムレイアウト文字列がチェックサム計算を要求する仕様のために「メイン1カラム+2×3グリッド」のような配置を組むのに手間取ると述べ、Zellijのレイアウト定義ファイル(KDL形式)なら同じ配置を宣言的に書けると指摘しています。別の投稿者は、Ghosttyユーザーにとってはsplit-pane teamsを使う唯一の経路がZellij経由になっている(Ghostty自体もsplit-pane非対応のため)と説明し、日常的に約10件のリポジトリをまたいでZellijセッションを使っていると述べています。

コミュニティ製プラグインでの回避策

issueのコメントでは、Zellij向けのサードパーティ製統合が2つ紹介されています。

1つはzellij-workflowというClaude Codeプラグインです。MITライセンスで公開されており、タブ/ペインの作成・Claude Codeセッションの起動・タブ名へのステータスアイコン表示(準備完了・作業中・入力待ち・圧縮中)・PreToolUse/PostToolUse/StopフックによるリアルタイムのタブステータスをWASMプラグインと組み合わせて実現しています。導入は/plugin install zellij-workflow@dapiの1行です。

もう1つはzellij-claude-teamsという、tmux前提のsplit-pane検出をZellij上でも通すためのシムです。2026年7月5日付けのコメントによれば、当時issueには53件の👍リアクションが付いており、コメント投稿者自身もこのシムでsplit-paneを動かせたと報告しています。

導入前に確認しておきたいこと

コミュニティ製プラグインは動きますが、内部の仕組みは相応に無理をしています。同じ2026年7月5日のコメントが、実装上の弱点を具体的に挙げています。

つまりこの回避策は、Claude Code側の実装変更で予告なく壊れる前提のものです。CIや本番相当のワークフローに組み込む前に、まずは単発のテストタスクで動作を確認しておくのが実務的です。/pluginでインストールしたら、まずin-process表示との挙動差を確かめます。ペインが正しく閉じるか、teammateが増減したときに配置が崩れないか。ここを先に見ておくと、後から原因調査に時間を取られずに済みます。

Zellijユーザーが取れる3つの選択肢

Zellij対応は「実装コストが低いのに止まっている」タイプの要望です。tmuxの実装パターンをなぞるだけでよいと提案者自身が説明しており、コミュニティのシムがすでに同等の機能を2つ独立に作り上げている実績もあります。一方でiTerm2は2026年6月にネイティブ対応が追加されており、要望が具体的な実装アプローチとともに提示され、かつ需要が一定数まとまった機能から順に採用されている流れが見えます。Zellijの需要はissue上の反応数だけでは実装着手の確約にはなりませんが、対応候補として名前が挙がっている段階ではあります。

今のところZellijユーザーが取れる選択肢は3つです。in-process表示のまま使う(セットアップ不要で全機能が動く)、tmuxを別途インストールしZellijを離れてtmuxセッションでsplit-pane表示を使う(Zellij内にtmuxをネストする構成は公式に想定されていません)、またはサードパーティ製プラグインでZellij上のsplit-pane表示を試す。いずれもtmux/iTerm2対応ほどの安定性は保証されないため、split-pane表示が必須でない作業ではin-process表示を既定にしておくのが無難です。

よくある質問

split-paneが使えないとAgent Teams自体が使えませんか

使えます。teammate同士の連携やタスク分担といったAgent Teamsの中核機能は表示モードに関係なく同じで、変わるのは画面の見え方だけです。

/terminal-setupを実行すればZellijでもShift+Enterなどが有効になりますか

ドキュメントのShift+Enter対応表にZellijは列挙されていません。tmuxを併用する場合は~/.tmux.confにallow-passthroughなどの設定を追記する必要があり、詳しくはClaude Code tmux設定にまとめています。

まとめ

Agent Teamsのsplit-pane表示は、tmuxとiTerm2(it2 CLI付き)にしか対応しておらず、Zellijは2026年3月に登録されたfeature requestが今もopenのままです。実装アプローチとしては$ZELLIJ環境変数の検出とtmux相当のコマンド呼び出しに落とし込めると提案されており、サードパーティ製プラグインが同等機能をすでに2つ独立に作っています。ただしどちらもAnthropicが配布・保守しているものではなく、Claude Code側の実装変更に弱い作りです。split-pane表示が必須でなければ、追加設定が要らないin-process表示のままで運用し、teammateModeの設定内容やAgent Teamsのトラブルシューティングと合わせて必要な場面だけ回避策を検討するのが現実的です。