Codexのワークツリーを使う

今の作業をそのままにして、Codexに別の修正を試してもらいたい。そんなときに使えるのがワークツリーです。同じGitリポジトリの履歴を共有しながら、別の作業フォルダーで変更を進められます。

この記事は、デスクトップのCodexでGit管理されたプロジェクトを扱う人向けです。元のフォルダーと別の作業場所を区別し、結果を確認して残すところまで説明します。

ブランチとの違いを押さえる

ブランチは履歴の流れを分ける名前です。ワークツリーは、別の内容を同時に開いて作業するための場所です。履歴は共有しますが、ファイルの作業状態は場所ごとに分かれます。

用語	このページでの意味
Local	普段使っている元の作業フォルダー
Worktree	同じリポジトリから作る別の作業フォルダー
Handoff	タスクとコードの作業場所をLocalとWorktreeの間で移す機能

ワークツリーは、外部サービスまで完全に分離する仕組みではありません。同じデータベースや公開先に接続すれば、その対象は共有されます。別フォルダーであることと、本番へ影響しないことを同じ意味にしないようにします。

Gitリポジトリのプロジェクトが必要です。作業をどのブランチから始めるか、現在の未コミット変更を含めるかを確認します。既存の変更を含めないつもりなら、選択した開始状態を見直します。

初めは文章やREADMEの小さな修正など、外部接続が不要な作業で試すと、作業場所の違いを確認しやすくなります。

各段階で確認してから、次の操作へ進みます。

図解Codexのワークツリーを使う：進める順番

具体的な依頼と、結果の確かめ方は本文にあります。

元のフォルダーを変えたつもりでも、実際にはワークツリーだけに変更がある場合があります。保存場所と結果の取り込み先を最後まで確認します。

2026年9月12日の公式案内では、新しいタスクの入力欄の下で Worktree を選び、開始するブランチを指定して依頼を送ります。初期状態は特定のブランチ名へ直接結び付かない detached HEAD になる場合があります。

detached HEADは「壊れた状態」ではなく、特定のコミットを起点に作業している状態です。成果を残す段階でブランチを作成する方法があります。利用中の版で表示が異なる場合は、公式ワークツリー資料の画面を確認してください。

このワークツリーでREADMEの開き方を読みやすくしてください。
最初に作業フォルダーと開始状態を確認してください。
README以外の変更と、外部への送信は行わないでください。
変更後は差分を示し、どの作業場所に保存されたかを報告してください。

作成後は、タスクの作業場所がWorktreeであることを確かめ、そこでファイルやターミナルを開きます。同じ名前のファイルがLocalにもあるため、パスを確認する習慣が役立ちます。

ワークツリー内で確認を続けるなら、タスクの Create branch here からブランチを作る方法が公式資料にあります。変更を確認し、必要な履歴を保存してから取り込み方を選びます。

普段の環境で確認したい場合は、Hand off でLocalへ移す方法があります。移動先の変更と競合しないかを確認し、表示される案内に従います。手作業で二つのフォルダーを上書きし合う前に、どちらが今の作業場所かを整理します。

ワークツリーにソースがあっても、無視された設定ファイルや依存パッケージがすべて揃うとは限りません。

通常、同じブランチを複数のワークツリーで同時にチェックアウトできません。強制的に回避する前に、使っている場所を確認します。

ワークツリー内の成果が、必要なブランチや取り込み先へ残っているかを確かめます。タスクのアーカイブや管理設定によって作業場所の扱いが変わるため、フォルダーの存在だけを唯一の保存先にしないようにします。

公式資料で仕組みと操作を照合していますが、この記事ではアプリ上の新規作成・Handoffを実機検証していません。まず小さな変更で場所を確認し、差分の確認へ進んでください。

開始前にLocal・Worktree・Cloudの違いを確認すると、保存先を選びやすくなります。