GitHub worktree確認

Codex作業前にGitHubのworktreeを確認する考え方

作業場所が混ざると、Codexの変更も人間の変更も追いにくくなります。作業前にworktreeと未コミット差分を確認します。

このサイトはGitHub公式サイトではありません。GitHubやCodexの画面、機能、料金、提供状況は変わる可能性があるため、重要な判断では提供元の最新情報も確認してください。

このページでわかること

  • 今いる作業場所とブランチを確認する
  • 未コミットの変更が誰のものか分ける
  • 別作業のファイルを巻き込まない

最初に結論

作業場所が混ざると、Codexの変更も人間の変更も追いにくくなります。作業前にworktreeと未コミット差分を確認します。 作業を急ぐより、対象、承認、確認方法を分けるほうが安全です。

使い分けの基本

相談や要件整理はChatGPTやGPT系のページで行い、コードやファイル変更はCodex、GitHub、IDE、CLIなどの作業場所で確認します。どのAIを使う場合も、変更範囲、触らないファイル、停止条件、公開前確認を先に決めておきます。

注意が必要なこと

AIの回答や作業結果は、そのまま公開・送信・mergeしないでください。個人情報、会社情報、顧客情報、APIキー、パスワード、認証情報、DB情報、FTP情報、検索の計測や広告の確認タグが混ざっていないかを確認します。

作業前チェック

  • 対象URLと対象ファイルを決めた
  • 触らないファイルと設定を決めた
  • 削除、公開、push、mergeの承認条件を決めた
  • スマホ表示、リンク、title、description、canonical、robotsを確認する
  • 秘密情報が含まれた時は作業を止める

git worktreeの仕組みと主なコマンド

git worktreeは、同じリポジトリにひも付いた作業ディレクトリを複数持つための仕組みです。git initやgit cloneで最初に用意される作業場所をmain worktree、あとから足したものをlinked worktreeと呼びます。1つのリポジトリにmain worktreeは1つ(bareリポジトリでない場合)、linked worktreeは0個以上あります。

  • git worktree add <path>:指定した場所に作業ディレクトリを作ります。ブランチ名を指定しないと、パスの最後の要素と同じ名前の新しいブランチを作って切り替えます(公式の例では git worktree add ../hotfix で hotfix ブランチ)。
  • -b <新ブランチ名>でブランチ名を決められ、--detach を付けるとHEADを切り離した状態で作ります。-b は同名のブランチがあると失敗し、-B で上書きできます。
  • すでに別のworktreeで使っているブランチを指定すると、addは既定で拒否されます。--forceで回避できますが、同じブランチを2か所で動かすと変更が混ざるので、Codexに任せる作業では別名のブランチを使うのが無難です。
  • git worktree list:main worktreeが先頭に出て、続いてlinked worktreeが並びます。locked(ロック中)やprunable(prune可能)の注記が付くことがあり、スクリプトで読むなら --porcelain を使います。
  • git worktree remove:未追跡ファイルや追跡ファイルの変更が残っていない「きれいな」worktreeだけ削除できます。変更が残るものは --force が必要で、main worktreeは削除できません。
  • git worktree prune:作業ディレクトリがなくなったworktreeの管理情報($GIT_DIR/worktrees 内)を整理します。-n で消す対象を確認だけでき、公式は手で消した場合の後始末として説明し、次回からはremoveを使うよう書いています。

公式は、複数checkoutは全般にまだ実験的で、サブモジュールの対応は不完全だとも書いています。スーパープロジェクトで複数checkoutを作ることは勧めていません。

出典: git-worktree Documentation(git-scm.com)/確認日 2026年11月2日

Codexアプリのworktreeの扱い

Codexアプリにも、タスクごとにworktreeを使う機能があります。公式の説明で確かめられた点は次のとおりです。

  • worktreeが使えるのは、Gitリポジトリの一部になっているプロジェクトだけです。
  • 作成場所は既定で $CODEX_HOME/worktrees です。Settings の Worktrees にある Worktree root で変えられます。
  • 作られたworktreeはブランチではなく、detached HEADの状態です。開始地点は選んだブランチのHEADのコミットで、そのブランチの未コミットの変更も反映されると公式は説明しています。
  • 公式は「Gitは1つのブランチを同時に1か所でしかcheckoutできない」と説明しています。worktreeで使っているブランチをローカルでも使いたいときは、会話ヘッダーの Hand off でローカルに移します。worktreeの内容をブランチにするには「Create branch here」を使います。
  • .gitignore されたファイルは、引き継ぎでは移りません。リポジトリ直下に .worktreeinclude を置き、コピーしたい無視ファイル(例:.env)のパターンを書くと、一致するものだけコピーされます。追跡ファイルは書かないとされています。この仕組みはデスクトップアプリが管理するローカルのworktree向けで、自分でgitで作ったworktreeには働きません。
  • 既定では、Codexが管理するworktreeのうち最新の15個が残ります。ピン留めした会話や進行中の会話に結びつくものは削除されず、削除の前には作業内容のスナップショットが保存されます。

出典: Worktrees(Codex公式ドキュメント)/確認日 2026年11月2日

関連ページ