Codex に worktree を作らせる方法と罠|起点・片付け・常駐サーバー

· 火曜 Codex 週次 #codex#worktree#claudecode#ai#git

この記事の要点

Codex 0.162.0 で会話中に worktree を作れるようになった。起点は既定ブランチで、CLI は自動で片付かない。0.162.1 の常駐サーバーの注意点と Claude Code との違いも整理。

OpenAI の Codex CLI は、2026年10月4日〜10日の1週間で GitHub Releases に20本が出ました。うち安定版は rust-v0.160.1〜0.162.1 の4本です。 この記事では、その中から手を動かす価値がある2点、会話中に worktree を作る機能(0.162.0)と、常駐サーバーの設定の扱い(0.162.1)をまとめます。

https://youtu.be/6ezBgl6B50A

今週のリリースの仕分け

20本のうち16本は先行版で、リリースノートが付いていません。安定版4本の中身は次のとおりです。

Codex が worktree を作る(0.162.0)

worktree は、同じリポジトリの別フォルダで別ブランチを動かす git の仕組みです。2つの作業を同じフォルダで同時に任せると変更がぶつかるため、作業場所を分けます。

0.162.0 から、会話の途中で「新しい worktree で」と頼むと Codex が自分で作ります(PR #50148)。作った worktree はタスクに紐づき、再起動後も関連付けが残ります。機能スイッチ worktrees は既定オンです。条件は、信頼済みのプロジェクトを手元で動かしていること。脇道の会話(side conversation)では作れません。置き場所は既定で ~/.codex/worktrees で、~/.codex/config.toml の [desktop] に git-worktree-root を書くと変えられます。

知らないとハマる罠が5つあります。

  1. 起点はリモートの既定ブランチです。今のブランチではありません。続きの作業なら「feature/login から worktree を作って」のようにブランチ名を添えます。
  2. 未コミットの変更は写りません。.env など git 管理外のファイルも新しい worktree にはなく、依存の入れ直しも別に必要です。
  3. CLI では自動の片付けがオフです。git worktree list で確認し、不要なものは git worktree remove <パス> で消します。
  4. 作成直後はブランチなしです。ソース(rust-v0.162.1)を読むと git worktree add –detach で作られるので、コミット前に git switch -c <ブランチ名> を実行します。
  5. submodule は空です。–no-recurse-submodules で展開されるため、使うなら git submodule update –init が要ります。

非対話でも使える codex exec –worktree

codex exec に –worktree を付けると、新しい managed worktree の中でセッションが動きます。これは 0.160.1 の時点で既にあるオプションで、今週の新機能ではありません。

注意点は起点です。TUI で頼んだ場合はリモートの既定ブランチですが、codex exec –worktree は今の HEAD から作ります(codex-rs/exec/src/lib.rs で確認)。codex exec resume / codex exec review、–ephemeral、–ignore-user-config とは併用できず、手元での実行のみです。

上げる前の確認: 常駐サーバーと権限の持ち越し

常駐サーバー: 共有のバックグラウンドサーバーは、再起動するまで機能の設定を持ち続けます。結論は「config.toml の [features] を変えたら、常駐を1回再起動」です。0.162.1 からは、設定ファイルや既定値との食い違いでは警告も再起動の要求も出ません。照合するのは起動時に –enable / –disable を明示したときだけで、食い違えば再起動するかを聞いてきます(PR #52648)。以前は食い違いで起動に失敗することがありました。

常駐につないでいるかは、TUI の /status で Server 欄が Local background server かどうかで分かります。再起動は codex app-server daemon restart です。当方の例では、worktrees = false に書き換えても、常駐が動いている間は前の設定(オン)のままになります。

権限の持ち越し(無人で回す人向け): 0.161.0 から、–yolo など起動時に明示した承認方式・権限が、再接続や新しいセッションでも残ります(PR #49809)。以前は再接続の復旧で抜け落ち、別の設定で動くことがありました。裏を返すと、一度強い権限で起動すればつなぎ直しても強いままです。起動直後と再接続後の2回、/status の Permissions 欄を見て同じか確かめてください。

Claude Code との比較

2026年10月時点の各社公式ドキュメントで並べると、次のとおりです。

項目 Codex Claude Code
作り方 会話で頼む / codex exec –worktree 起動時の -w か会話で頼む
起点 既定ブランチ(exec は今の HEAD) 既定ブランチ(worktree.baseRef で HEAD も可)
置き場所 ~/.codex/worktrees .claude/worktrees
片付け 手動(git worktree remove) 終了時に確認
作業場所 元のフォルダに横付け 作業フォルダごと移る

今週の読みと先週の答え合わせ

先週の読み「OpenAI は Codex の承認を、人から自動レビューへ移している」は外れでした。外れる条件に置いた guardian_conversation_history_tools は、4本の安定版を経た 0.162.1 でも開発中・既定オフのままです。Guardian 関連の変更は 0.161.0 で11件、0.162.0 で21件に増え(変更履歴の題名を当方が集計)、判定比較も opt-in で入りました(PR #50099)。準備は進んでいても、測ってから広げる段階に見えます。

今週の読み(確度: 中)は、OpenAI が Codex を1つの会話で並行作業を回す道具に寄せている、というものです。根拠は、会話中に worktree を作るツール(PR #50148)、Command Center のタスク固定(PR #51500, #50786)、Bedrock でのマルチエージェント V2(PR #49345)の3つです。multi_agent_v2 は 0.162.1 で安定版ですが既定オフなので、確度は中としました。次の3本の安定版でも既定オフのままなら、この読みは外れです。

1週間試すときのチェック表

数は自分の環境で数えてください。当方は未実測です。

見るもの 確かめ方 戻し方・対処
作った worktree の数 git worktree list git worktree remove <パス>
起点で困った回数 頼む文にブランチ名があるか ブランチ名を添えて頼み直す
使用枠の減り方 /status の Limits 欄を毎日 並べる本数を減らす
常駐と権限 /status の Server・Permissions 欄 codex app-server daemon restart
やめるとき ~/.codex/config.toml [features] に worktrees = false

チームに共有するなら、次の3点です。

  1. worktree はブランチ名を添えて頼み、片付けは git worktree remove
  2. [features] を変えたら codex app-server daemon restart
  3. 無人で回す人は、起動直後と再接続後に /status の Permissions を確認

出典

詳細は動画で

スライドと手順の全体は動画にまとめています。次の Codex 週次も、このチャンネルをフォローしておくと追えます。

https://youtu.be/6ezBgl6B50A