クラウドMac デュアルAIエージェント構成：Claude Code + Codex CLI 分離（worktree・tmux・MCP）| kvmboot ブログ

要点

Claude Code と Codex CLI は同一ホスト可だが作業ディレクトリ共有禁止—git worktree で硬隔離。
三層：設定 → worktree → tmux；MCP Server は 1 つ、パスを worktree に合わせる。
Claude Code は長セッション・多ファイル；Codex はスクリプト/OpenAI 向け。
16GB は「1 長 + 1 短」；二つの長セッション並行は 24GB + memory_pressure。
受け入れ：tools/call ≥95%、黄 ≥2h 連続なし、worktree 交叉 0。

クラウドMac デュアルAIエージェント：Claude Code と Codex CLI 隔離 — 隔離 setup の実戦ガイド（CLI インストール記事ではない）。

1. なぜクラウドMac デュアルAIエージェントか

2026 上半期、kvmboot のクラウドMac問い合わせは「SSH できるか」から「1 台に何 Agent」へ移った。デュアルAIエージェント構成では、Claude Code（Hooks・長コンテキスト）と Codex CLI（OpenAI スクリプト）を同一スプリントで並行させるケースが多い。ノート PC は蓋を閉じると止まる—Macレンタルした mini 上でノートはリモコンだけにする。

コストは 24GB Mac mini をレンタルし、トークンだけ従量にする方が管理しやすいことが多い。前段：Claude Code をクラウドMac へ、MCP 配置；本稿は二つの CLI が干渉しない第三層。

公式：Claude Code · Codex · worktree。

tmux / worktree / MCP が初めて？ 一文で覚える：2 Agent = リポ副本 2 + ターミナル 2 + MCP 1。以下でディレクトリ・絶対パス・定量受け入れを展開します。

2. 五つの失敗パターン（サポートで最多）

「デュアル Agent を入れたが動かない」—2 項目当たれば機能開発より隔離の再設計を優先してください。

同一ディレクトリで .git/index 競合：Claude が main を編集し Codex が同ツリーで checkout—変更消失はFS レースです。
MCP パスがローカル PC のまま：SSH 先のクラウドMacと不一致—Agent ごとに別障害になり調査が二倍。
tmux 混在：1 window に 2 Agent—Codex 操作だと思ったら Claude の残シェル。
API キー / クォータの混在：export 汚染で誤モデル・誤課金。
16GB で二つの長セッション：memory_pressure 黄→遅延→「MCP 故障」と誤認。

対策は「より賢いモデル」ではなく境界（リポ・セッション・設定）です。

3. 役割マトリクス

観点	Claude Code	Codex CLI
得意	長セッション・多ファイル refactor・Hooks・MCP Git	小タスク・スクリプト一括・OpenAI スタック
不向き	同一ディレクトリでの並行書き込み	codesign/Xcode 全工程の単独代替
典型スロット	`cc-main` + `feature/refactor`	`codex-hotfix` + `hotfix/config`
コスト	トークン課金・長セッションは上限設定	トークン課金・ループに注意

両方が「全リポ理解 + 大規模改修」ならトークン二重・スループット単一。長走は 1 Agent に絞り、もう一方は狭いタスクへ。AI Coding 三層・ECC 参照。

4. 三層トポロジ

クラウドMac デュアルAIエージェントの視覚アンカー：2 本の Agent チェーンが単一 MCP Serverに合流します。

Claude Code → worktree A → tmux A；Codex → B → tmux B；MCP は 1 台。

5. 隔離 setup：ディレクトリ・worktree・tmux

5.1 設定層：HOME を絡めない

クラウドMac上で論理設定ルートを分ける（同一 Unix ユーザーでも起動 env で分離可）：

Claude Code：例 CLAUDE_CONFIG_DIR=/Users/agent/.claude-cc（Hooks / MCP JSON）。
Codex CLI：認証と config.toml を別フォルダ—Claude settings.json と混在禁止。

SSH・キーチェーン：Macレンタル開通チェック。

5.2 リポ層：worktree ファーム（必須）

本体は read-only または fetch のみ。各 Agent に絶対パスを 1 つ：

# On the cloud Mac — example paths
/opt/worktrees/my-app-cc-refactor    # Claude Code only
/opt/worktrees/my-app-codex-hotfix   # Codex CLI only

git worktree add /opt/worktrees/my-app-cc-refactor feature/refactor
git worktree add /opt/worktrees/my-app-codex-hotfix hotfix/config

農場レイアウト：worktree 短期レンタル。起動前に必ず cd—tmux スクリプトに固定。

5.3 セッション層：tmux は 1 Agent 1 window

tmux new-session -s agents -n cc -c /opt/worktrees/my-app-cc-refactor
tmux new-window -t agents -n codex -c /opt/worktrees/my-app-codex-hotfix

ノートから tmux attach -t agents。蓋閉めはローカル Client のみ切断—クラウドMac 上のセッションは継続。launchd は FAQ 参照、専用 worktree 必須。

6. MCP：Server 1、Client 2

デュアル Agent ≠ MCP 乱立。安定パターン：

クラウドMacで MCP Git Server 1 つ—--repository は worktree 親、または worktree ごとにポート（どちらかを文書化）。
Claude / Codex のパスはSSH 先の絶対パス—MCP とリポ同機。
禁止：Claude→VPS MCP、Codex→ローカル stdio。

受け入れ：各 tmux window で「直近 3 コミット」—tools/call と各 worktree のブランチ名一致。

7. 16GB vs 24GB

Apple Silicon 統一メモリはインデックス/LS と併用で圧迫されます：

16GB：「1 長 + 1 短」または Agent 1 + MCP 読取のみ；Xcode/Docker 二重は厳しい。
24GB：二つの対話的長セッション；メモリ監視継続。

初日から地域固定しない—リージョン/RTT を日租で測り memory_pressure を圧試験。

8. クラウドMac デュアル Agent 受け入れチェックリスト

48 時間の日租を再現可能な基準に：タイムラインは手順、表は合否。ホスト上にマスク済みログを残すと「実際にやった」が伝わります。

指標	合格線	測り方（クラウドMac）
tools/call	≥ 95%	48h で各 Agent ≥20 回の MCP 呼び出し、正しいブランチ/コミットが返る
memory_pressure	≤ 2h	`while sleep 300; do memory_pressure; done`、16GB で要監視
worktree cross-write	= 0	A/B 間の `cd` 禁止、`git -C` で監査

8.1 48 時間タイムライン

0–2h Setup：SSH；worktree A/B；tmux cd 固定；MCP 絶対パス。
2–8h Isolation：Claude は A のみ refactor；Codex は B のみ小コミット；交叉 cd=0。
8–16h MCP：両 window でコミット質問；tools/call 成功率。
16–32h Resilience：蓋閉め/オフライン ≥8h 後 attach で生存確認。
32–48h Decision：3 指標；memory のみ NG→24GB または 2×16GB；全 OK→Macレンタル 月次。

Pass：3 指標 + RTT 許容。Fail 先：共ディレクトリ・MCP がクラウドMac 外—その後モデル。

9. FAQ

9.1 worktree 共有？

厳密直列のみ（一方が完全終了してから另一方）。対話的並行は不可—データ損失は「直列のつもりが並行」が大半。

9.2 二台のクラウドMac？

二長 + それぞれ Xcode：2×16GB が 1×24GB より楽なことが多い。一長一短なら24GB 1 台で足りる場合が多い。

9.3 Codex は macOS 必須？

Codex 自体は非必須。codesign / notarization / Xcode を含むならClaude と同じクラウドMacが Linux+Mac 分裂より運用が軽い。

10. まとめ

クラウドMac デュアルAIエージェントは小規模マルチテナント：Claude Code + Codex CLI が worktree + tmux、MCP は単一。図で認識を揃え、感覚ではなく 3 指標で—合格後に Macレンタル の月次とメモリを確定。

要点