CodexとGitのブランチ | GPT Master Guide

Codexで別の案を試したいとき、今の完成版を保ちながら変更の履歴を分けられると便利です。Gitのブランチは、コミットの履歴に名前を付け、作業の流れを分ける仕組みです。

この記事では、すでに一度コミットした練習用リポジトリで、新しいブランチを作って戻る方法を説明します。Git自体が初めてなら、先にGitの基本を試してください。

ブランチはフォルダーのコピーではない

同じフォルダーでも、切り替えたブランチの履歴に合わせてファイルの内容が変わります。ブランチを作っただけでは、未保存・未コミットの変更が別の保管庫へ移るわけではありません。

特に未コミットの変更は、条件によって別のブランチへ持ち越されることがあります。最初の練習では変更がない状態から始め、切り替える前にコミットしておくと理解しやすくなります。

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

図解CodexとGitのブランチ：進める順番

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

この図は、元のブランチから試作を始め、確認した結果を履歴へ残して戻る流れです。試作の内容を元へ取り込む操作は、別の段階になります。

ターミナルで練習用リポジトリのフォルダーを開き、次を実行します。

git status
git branch --show-current

git status で変更がないことを確認し、二つ目で表示された元のブランチ名をメモします。名前は必ずしも main ではありません。すでに変更がある場合は、内容を確認して保存するか、作業を整理してから試します。

ここでは練習用の名前 practice-title を使います。同じ名前がすでにある場合は、既存の目的を確認し、別の未使用名を選びます。

git switch -c practice-title
git branch --show-current

表示が practice-title なら、そのブランチへ切り替わっています。-c は新しく作る指定です。大文字の -C とは意味が異なるため、この例では小文字を使います。

Codexに依頼する場合は、たとえば次のようにできます。

まず現在のブランチ名と未コミットの変更を確認してください。
変更がなければ、新しいpractice-titleブランチを作って切り替えてください。
同名が存在する場合は上書きせず、状態を教えてください。
この段階ではファイルの編集や外部への送信は行いません。

練習用の note.txt を一行だけ変更した場合は、差分を見て対象ファイルをコミットします。

git diff -- note.txt
git add note.txt
git diff --cached -- note.txt
git commit -m "Try another title"
git status

コミットは今いるブランチの履歴へ追加されます。git diff が空でも、すでにステージした変更は git diff --cached で確認する点は同じです。GitHubなどへ送信する push は、この練習では行いません。

変更がコミットされ、作業中の差分がないことを確認したら、控えた元の名前を使います。次の 元のブランチ名 は自分の名前に置き換えます。

git switch 元のブランチ名
git branch --show-current

元のブランチで note.txt を開き、試作前の内容であることを確認します。再び git switch practice-title とすれば、試作のコミットを含む内容へ戻れます。エディターが古い内容を表示している場合はファイルを読み直します。

ローカルの変更が失われる可能性があると、Gitは切り替えを止める場合があります。強制する前に git status と差分を確認し、何を残すかを決めます。

ブランチの削除、強制的な切り替え、履歴のリセットは、この入門の手順に含めません。元の作業を残したい場面で、名前だけを見て削除しないようにします。

試作がよければ、元のブランチへ取り込む方法と差分を確認します。ブランチを切り替えること自体は、試作を元へ合流させる操作ではありません。

コードの別案を試すときはリファクタリング、変更後の結果を確かめるときはテスト入門も使えます。コマンドの意味はGit公式資料で照合しています。共同作業中のリポジトリでは、そのチームのブランチ運用に合わせてください。

Windows・Git 2.53.0.windows.1の専用練習フォルダーで、ブランチ作成・コミット・元への復帰・別案への再切り替えを確認しました。これはGit操作の確認で、Codexのモデル実行を検証したものではありません。

別の作業フォルダーを同時に使いたい場合は、CodexのワークツリーでLocalとの違いを確認できます。

取り込み時に変更が競合したら、Gitの競合を解決する手順で両方の意図を確かめてから進めます。