Unityをgit worktreeで分けて、2つのAIに同時に作らせる

同じ仕様書で Claude Code と Codex に並行で作らせるため、git worktree でフォルダを2つに分けました。.gitignore と .meta の扱い、エディター2つ分のポート、実際に踏んだ罠まで。

Libra

公開 2026年9月16日

この記事の要点5項目

git worktree なら同じリポジトリのまま、別ブランチを別フォルダに展開できる。 AI を2つ同時に走らせる土台になる。

残り4つの要点を読む

Unity エディターを2つ開くと、操作用のローカル API のポートが 7800 と 7801 に分かれる。必ずプロジェクトを指定して叩く。
Library / Temp / Builds はコミットしない。追跡しているのは126ファイルだけだった。
.meta は必ずコミットする。落とすと参照が切れる。
AI に撮らせたスクショが Assets の下に入り、そのまま git の対象になった。相対パスは Assets 基準だった。

目次7章

検証した環境最終確認 2026年9月16日

Unity 6.6（6000.6.0f1）
git（Windows 版）・Git Bash
Unity CLI 1.0.0-beta.9 / com.unity.pipeline 0.7.0-exp.1
Windows 11

書いてあるのは、この環境で実際に試した結果です。ツールの仕様や料金は変わるので、重要な判断の前には公式の情報も確認してください。

同じ仕様書で、Claude Code と Codex に同じゲームを作らせて比べる。これをやるには、同じ起点から始まる作業フォルダが2つ要ります。

クローンを2つ作るのは面倒です。git worktree を使いました。

作業フォルダ

履歴は1つのまま

7801

2つ目のエディターのポート

1つ目は 7800

126

git が追跡するファイル

フォルダ全体は数万

0回

AI がしたコミット

3回の無人実行で

手順：worktree で2つ目のフォルダを作る

git worktree add ../breakout-codex -b codex/v1 6110383

これで、6110383（仕様書だけが入ったコミット）を起点にした codex/v1 ブランチが、隣のフォルダに展開されます。履歴は1つのままなので、あとで両方のブランチを並べて見られます。

手順 01
起点コミット
仕様書だけが入った状態
手順 02
claude/v1
元のフォルダ・エディター①
手順 03
codex/v1
worktree・エディター②

同じ起点から2本に分かれます。どちらも Unity プロジェクトとして完全な形です。

エディターはフォルダごとに開きます。2つ目のエディターは、操作用のローカル API のポートが自動的に 7801 になりました（1つ目は 7800）。

⚠️ プロジェクトの指定を毎回付ける

エディターが2つ動いていると、CLI はどちらに繋ぐか自分では決められません。--project-path か UNITY_PROJECT_PATH を毎回付けてください。付け忘れると、意図しないほうのエディターを操作します（実際に一度やりました）。

Unity の .gitignore で何を外すか

Unity が作り直せるものは入れない。

入れない

Library/ … インポート結果のキャッシュ。数GB・環境依存

Temp/ … 実行中の一時ファイル

Builds/ … ビルド成果物（今回は 7〜10MB）

Logs/ UserSettings/ … ログと個人の設定

*.csproj *.sln … Unity が再生成する

必ず入れる

Assets/ の中身 … 本体

.meta ファイル … ファイルと GUID の対応。落とすと参照が切れる

ProjectSettings/ … ビルド・入力・品質の設定

Packages/manifest.json … 使っているパッケージの一覧

結果として、このブロック崩しで git が追跡しているのは126ファイルです。Unity プロジェクトのフォルダを丸ごと見ると数万ファイルありますが、意味があるのはこれだけでした。

.gitignore は公式のものから始める

GitHub が配っている Unity.gitignore をそのまま使うのが早いです。今回はこれを元に、日本語のコメントを付けて使っています。

AI に触らせたときに紛れ込んだもの

スクショが Assets の下に入った

Unity CLI の capture_game_view で、AI にゲーム画面を撮らせました。保存先に Temp/shots/01.png を指定したところ、実際に保存されたのは Assets/Temp/shots/01.png でした。相対パスは Assets/ 基準です。

しかもプロジェクトのフォルダ外は指定できません。

unity command capture_game_viewエラー

Pipeline server returned 400 Bad Request:
Parameter Validation Failed. Path '…' is outside the project root

スクショは必ず Assets/ の下に落ちる。

そのまま git の対象になり、アセットとしてインポートもされます。撮ったら消すか、.gitignore に入れておく必要があります。

AI はコミットしない

指示文に書かなければ、エージェントはコミットしません。今回、無人実行を3回やってコミットは0回でした。作業が中断したとき、履歴は空のままです。

保存するのは人間の仕事として組んでおくのが安全です。

worktree の片付けで踏んだところ（原因と対処）

実行が中断した2回目の状態を残したくて、フォルダを別名に移そうとしました。

Git Bashエラー

$ git worktree move ...
Permission denied

原因は単純で、自分のシェルの作業フォルダがその中にあったからです。Windows は開いているフォルダを移動できません。リポジトリのルートに戻ってから実行したら通りました。

AI エージェントに操作させていると、「どこにいるか」を見落としがちです。移動・削除の前にルートへ戻す、と決めておくと楽です。

まとめ

git worktree なら、同じ履歴のまま作業フォルダを2つに分けられる。AI を並行で走らせる土台になる
エディターを2つ開くと操作用のポートが分かれる。CLI は必ずプロジェクトを指定して叩く
Library Temp Builds は入れない。.meta は必ず入れる
AI に撮らせたスクショは Assets/ の下に落ちる。git に紛れ込む
コミットは人間がやる。AI は指示しなければ1回もしない

よくある質問

なぜクローンを2つ作らずに worktree なのですか？

履歴が1つのままだからです。あとで2つのブランチを見比べたり、同じ起点から作り直したりするのが簡単になります。クローンを分けると、比較のたびにリモート越しの操作が要ります。

Library フォルダはコミットしないと、2つ目のフォルダで作り直しになりませんか？

なります。2つ目のエディターは Library の作成に数分かかり、メモリも2GB ほど使いました。それでもコミットすべきではありません。環境に依存する生成物で、サイズも桁が違います。

Git LFS は要りますか？

画像や音を入れるなら要ります。ただし置き場所のサーバー側が古いと使えないことがあるので、素材を増やす前に置き場所の git のバージョンを確認しておくほうが安全です。今回の題材は画像素材ゼロなので、まだ入れていません。

シーンやプレハブの衝突はどうしますか？

Unity 付属の UnityYAMLMerge を mergetool に設定します。今回は2つのブランチを合流させない方針（別々の成果物として残す）なので、実際には使っていません。

エディターを2つ開いて重くないですか？

重いです。Library の作成中は特に食います。ただ、片方がビルド中でももう片方でテストを回せるので、待ち時間は減りました。

出典

01Unity.gitignoreGitHubUnity 用 .gitignore の元ネタ
02Smart mergeUnity Documentationシーン・プレハブの衝突を解決する UnityYAMLMerge の設定

この記事は役に立ちましたか？