並列実行 on hdknr blog

dmux

Wed, 15 Apr 2026 00:00:00 +0000

AI エージェント（Claude Code / Codex 等）の並列実行を安全に管理するツール。git worktree + branch の自動隔離でファイル競合を防ぐ

dmux：Claude Code / Codex を安全に並列実行するための git worktree 管理ツール

Wed, 15 Apr 2026 00:00:00 +0000

AI エージェントを並列実行する際に起きがちなファイル競合問題を、git worktree を活用して自動解決するツール「dmux」を紹介する。

背景：AI エージェント並列実行の落とし穴

Claude Code や OpenAI Codex などの AI コーディングエージェントを複数同時に走らせると、次のような問題が起きやすい。

共通ファイルの同時上書き：複数エージェントが同じファイルを編集し、片方の変更が消える
変更の消失：あるエージェントが直したコードを、別のエージェントが元に戻してしまう

ターミナルを複数開いたり、tmux でペインを分割して並列実行する方法は手軽だが、全エージェントが同一のワーキングディレクトリを共有しているため、この問題は常に起きうる。

dmux とは

dmux は、AI エージェントの並列実行環境を安全に管理するための CLI ツール。内部的には git worktree + branch の自動隔離 を行い、各エージェントが独立したディレクトリ・ブランチで作業できる環境を自動でセットアップする。

主な特徴

自動隔離：難しい設定なしに git worktree + ブランチを自動作成し、エージェントごとに完全に分離した環境を提供する
衝突の自動解決：マージ競合が発生した場合、AI が自動で解決を試みる
エージェント切り替え：Claude Code、Codex、Claude Opus、Composer など任意のエージェントを簡単に切り替え可能
A/B テスト：複数エージェントの出力を比較検証できる

git worktree によるエージェント隔離の仕組み

git worktree は、同一リポジトリを複数のディレクトリに展開する Git 標準機能。通常の git clone とは異なり、リポジトリのデータを共有しながら、異なるブランチを別ディレクトリでチェックアウトできる。

リポジトリ
├── (メインディレクトリ) ← ブランチ: main
├── .worktrees/agent-1/ ← ブランチ: agent/task-a ← エージェント1
└── .worktrees/agent-2/ ← ブランチ: agent/task-b ← エージェント2

dmux はこの仕組みを自動化し、各エージェントを専用の worktree に割り当てる。エージェント同士は別ブランチで動くため、同一ファイルへの同時書き込みが発生しない。