codex 分岐で迷う人へ、/sideと/forkの違いまで一気にわかる実用ガイド

codex 分岐と検索している人が知りたいのは、おそらく「Codexで作業中に話題や作業環境を分けたいとき、どの機能を使えばいいのか」という点です。Codexには、会話を横道に逃がす /side、作業環境ごと分ける /fork、実装前に考えを整理する /plan、長い作業を整理する /compact など、分岐やセッション管理に関わる機能が複数あります。名前だけ見ると似ていますが、使いどころはかなり違います。

この記事では、2026年5月19日時点で確認した公開情報をもとに、codex 分岐の基本、/sideと/forkの違い、Plan modeとの関係、AGENTS.mdやSkillsとの使い分け、失敗しにくい運用ルールまで整理します。体験談ではなく、「検索してきた人が次に何を押せばよいか」を判断できるように、実務寄りにまとめます。

この記事のポイント
✅ codex 分岐でまず見るべき答えは「会話だけ分けるか、作業環境も分けるか」
✅ /side は一時的な別相談、/fork は作業スレッドやワークツリーの分岐として使う
✅ codex 入門 の段階では、分岐より先にGoal・Context・Constraints・Done whenを固める
✅ 長時間作業では、Plan mode、/compact、AGENTS.md、Skillsを組み合わせると迷いにくい

codex 分岐で最初に押さえるべき基礎知識

1. codex 分岐の答えは「会話だけ分けるなら/side、作業ごと分けるなら/fork」である
2. codex 入門では分岐より先に目的と完了条件を固定する
3. /sideは今の作業を汚さず横道の相談をする機能である
4. /forkは別アプローチや大きな変更を作業環境ごと試す機能である
5. Plan modeは分岐前に作業の地図を作るために使う
6. /compactは分岐ではなく長くなった文脈を軽くする整理機能である
7. セッション分岐で迷ったら「戻す可能性」と「共有する必要性」で判断する

codex 分岐の答えは「会話だけ分けるなら/side、作業ごと分けるなら/fork」である

codex 分岐で最初に理解したいのは、分岐には大きく2種類あるということです。ひとつは「今の会話の流れを壊さず、横道の相談だけしたい」場合。もうひとつは「別の作業スレッドや別のワークツリーで、本格的に違う方向を試したい」場合です。

前者に近いのが /side です。調査したCodexのスラッシュコマンド解説では、/side は現在の会話から一時的に分岐して別相談を始めるコマンドとして紹介されています。つまり、メイン作業を進めながら「この設計、別案もありえる？」といった寄り道をしたいときに向いています。

一方で、後者に近いのが /fork です。/fork は現在のチャットをローカルまたは新しいワークツリーに分岐するものとして説明されています。大きなリファクタリング、別アプローチの検証、実験的な機能追加など、実際のファイル変更まで別ルートで持ちたいときに使うイメージです。

🧭 分岐コマンドのざっくり比較

やりたいこと	向いているコマンド	理由
いまの作業は続けつつ、別案だけ聞きたい	/side	会話の横道として扱いやすい
別実装を本格的に試したい	/fork	作業スレッドやワークツリーを分けやすい
実装前に方針を整理したい	/plan	分岐前の判断材料を作れる
会話が長くなりすぎた	/compact	文脈を圧縮して作業を続けやすい

ここで重要なのは、/side と /fork は「どちらが上位」という話ではない点です。会話の分岐なのか、作業の分岐なのかで使い分けると、かなり迷いにくくなります。

たとえば「このバグ修正中だけど、ついでにUI改善案も聞きたい」という程度なら /side が合いやすいです。反対に「今の実装案Aとは別に、設計案Bでコードを書かせて比較したい」なら /fork が候補になります。

参考：Codexのスラッシュコマンドまとめでは、/side は一時的な別相談、/fork はチャットやワークツリーの分岐として整理されています。
https://note.com/npaka/n/n87a5c4364154

✅ 判断の合言葉

質問	Yesなら
ファイル変更なしで相談だけしたい？	/side
別の実装として残したい？	/fork
まだ実装方針が曖昧？	/plan
ただ文脈が重いだけ？	/compact

このように考えると、codex 分岐は難しい機能ではありません。むしろ、作業を散らかさないための整理道具です。最初に「どこまで分けたいのか」を決めることが、いちばんの近道になります。

---

codex 入門では分岐より先に目的と完了条件を固定する

codex 入門の段階でいきなり分岐コマンドを使いこなそうとすると、少し混乱しやすいです。なぜなら、分岐は便利な一方で、元の作業の目的が曖昧なままだと、分けた先でも迷いが増えるからです。

Codexのベストプラクティスとして紹介されている考え方では、プロンプトに含めたい要素として「Goal」「Context」「Constraints」「Done when」が挙げられています。これはかなり実用的です。日本語にすると、目的、背景、制約、完了条件です。

つまり、分岐の前にまず「何を達成したいのか」「どのファイルやログが重要なのか」「守るべきルールは何か」「何ができたら完了なのか」を短く固定します。これがない状態で /fork しても、分岐先のCodexが別方向に走る可能性があります。

📝 codex 入門で先に固定する4項目

項目	書く内容	例
Goal	達成したいこと	ログイン失敗時のエラー表示を直す
Context	見るべき情報	auth.ts、エラーログ、再現手順
Constraints	守る条件	既存UIを大きく変えない
Done when	完了条件	テストが通り、再現手順で直る

この4つがあるだけで、分岐の質が変わります。/side で別案を聞く場合も、/fork で別実装を試す場合も、Codexが判断しやすくなるためです。

特に初心者がやりがちな失敗は、「なんとなく別案を試したい」とだけ伝えてしまうことです。これだと、Codexはそれっぽい案を出せますが、元のゴールからどれくらいズレているかを判断しにくくなります。

✅ 分岐前チェックリスト

チェック	内容
✅ 目的は1文で言えるか	長い説明より、まず短いゴール
✅ 触ってよい範囲は明確か	関係ないファイル変更を防ぎやすい
✅ 完了条件はあるか	「どこで終わるか」が決まる
✅ 比較したい観点はあるか	速度、保守性、影響範囲など

codex 入門としては、まずスラッシュコマンドを全部覚えるより、よい依頼文を作ることのほうが効果が出やすいです。分岐はその次に覚えると、かなり扱いやすくなります。

参考：CodexのBestPracticeを学ぶ会では、Goal / Context / Constraints / Done whenを含める考え方が紹介されています。
https://zenn.dev/microsoft/articles/codex_best_practice

---

/sideは今の作業を汚さず横道の相談をする機能である

/side は、codex 分岐の中でもかなり軽い使い方に向いています。イメージとしては、メインの作業机はそのままにして、横に小さなメモ用紙を出すようなものです。

たとえば、バグ修正中に「この命名、もっと良い案ある？」と聞きたい場面があります。あるいは、実装中に「この仕様、利用者目線だとどう見える？」と相談したいこともあります。こうした寄り道をメインスレッドに混ぜすぎると、後から文脈が重くなります。

/side は、そのような一時的な相談に向いています。調査した情報では、/side は「現在の会話から一時的に分岐して、別の会話を始める」ためのコマンドとして説明されています。メインの作業を壊さず、アイデア出しや比較検討をしたいときに便利です。

💬 /sideが向いている相談

相談内容	/side向きの理由
別名の候補を出してほしい	本実装に直接入らない
UI文言だけ相談したい	メイン作業と分けやすい
別案のメリットだけ聞きたい	ファイル変更が不要
実装前に軽く壁打ちしたい	本流を止めにくい

ただし、/side は万能ではありません。もし「その別案で実際にコードを書いて比較したい」となった場合は、/fork のほうが合う可能性があります。/side はあくまで軽い横道です。

📌 /sideを使う前の見極め

状況	判断
相談だけで終わる	/side が合いやすい
実装まで試す	/fork を検討
方針が決まっていない	/plan も候補
ログ調査が必要	メインスレッドで続けるほうが自然な場合あり

特に、プロジェクト全体に影響する設計判断を /side だけで済ませるのは注意が必要です。横道で出たよい案を採用するなら、メインスレッド側に戻して「この方針で進める」と明示すると、文脈のズレを減らせます。

参考：スラッシュコマンド解説では、/side はメインの作業スレッドを汚さず、アイデア出しや比較検討をしたいときに便利と説明されています。
https://note.com/npaka/n/n87a5c4364154

/side のコツは、短く聞いて、短く持ち帰ることです。横道の相談が長くなりすぎたら、それはもう別作業かもしれません。その場合は、/fork や新しいタスクスレッドを考えるとよいでしょう。

---

/forkは別アプローチや大きな変更を作業環境ごと試す機能である

/fork は、codex 分岐の中でも「本格的に分ける」ための機能です。調査した情報では、/fork は現在のチャットをローカルまたは新しいワークツリーに分岐するためのコマンドとして説明されています。

使いどころは、大きめのリファクタリング、別アプローチの検証、実験的な機能追加などです。つまり、単なる相談ではなく、実際にコードを変える可能性がある別ルートを持ちたいときに使います。

たとえば、ある機能を「既存の構造に最小変更で足す案」と「設計を少し整理してから足す案」で比較したいとします。このとき同じスレッドで両方を混ぜると、差分が複雑になりがちです。/fork を使えば、別ルートとして試しやすくなります。

🧪 /forkが向いている作業

作業	/forkが向いている理由
大きなリファクタリング	元の作業と混ぜると戻しにくい
別設計の検証	A案・B案を比較しやすい
実験的な機能追加	失敗しても本流への影響を抑えやすい
複数ファイル変更	差分の独立性を保ちやすい

ただし、/fork を使えば何でも安全というわけではありません。ワークツリーを分けても、同じリポジトリや同じブランチ運用に戻すときには、差分の統合が必要になります。特に複数の分岐で同じファイルを触ると、後で比較やマージが面倒になるかもしれません。

⚠️ /forkで注意したいこと

注意点	対策
同じファイルを複数分岐で触る	変更範囲を先に決める
目的が曖昧なまま試す	/plan で方針を出してから分ける
どの案が本流か分からなくなる	分岐名やメモを残す
差分を見ずに採用する	レビューやテストを挟む

/fork は、強力なぶん管理も必要です。特にチームやAIエージェントと並行作業する場合は、「この分岐は何を試すものか」を短く残しておくと、後で混乱しにくくなります。

参考：CodexのBestPracticeを学ぶ会では、Git worktreeを使わずに同じファイルで複数のライブスレッドを走らせることが、よくある失敗として挙げられています。
https://zenn.dev/microsoft/articles/codex_best_practice

実務的には、/fork は「戻すかもしれない大きな試行錯誤」に向いています。軽い相談なら /side、実装を伴う別案なら /fork。この線引きを持っておくと、codex 分岐はかなり扱いやすくなります。

---

Plan modeは分岐前に作業の地図を作るために使う

Plan modeは、厳密には分岐そのものではありません。しかし、codex 分岐をうまく使ううえでかなり重要です。なぜなら、分岐する前に「何を比較するのか」「どの順番で進めるのか」を整理できるからです。

調査したCodexベストプラクティスでは、複雑なタスクではいきなりコードを書かせるのではなく、まず計画を立てさせることが有効とされています。Plan modeでは、Codexが文脈を集め、必要に応じて確認質問をし、実装前に計画を作ると説明されています。

これは、/fork の前に特に効きます。たとえば「既存の認証まわりを整理したい」という依頼だけでは、どこをどう分けて試せばよいか曖昧です。先にPlan modeで影響範囲や手順を整理すれば、「A案は最小修正」「B案は構造整理」といった分岐が作りやすくなります。

🗺️ Plan modeと分岐の関係

状況	先にPlan modeが向く理由
変更範囲が広い	どこを触るか整理できる
影響範囲が不明	リスクを先に洗い出せる
複数案がある	比較軸を作れる
ユーザー側も迷っている	Codexに質問役をさせやすい

Plan modeは、特に「やりたいことはあるが、どう説明すればよいか分からない」場面でも使いやすいです。調査情報でも、Codexに質問役をさせる使い方が紹介されています。曖昧なアイデアを具体化してから実装へ進む流れです。

✅ Plan modeで作らせたいもの

作らせるもの	役割
影響範囲リスト	どこが壊れそうか見える
実装手順	作業の順序が見える
比較案	forkする価値があるか見える
完了条件	どこで終わるか決まる

ただし、Plan modeで作った計画をそのまま信じ切る必要はありません。Codexが見落とす可能性もあるため、重要な作業ではログ、テスト、既存ドキュメント、差分レビューを組み合わせるのが現実的です。

参考：CodexのBestPracticeを学ぶ会では、Plan modeを /plan または Shift+Tab で切り替えられると紹介されています。
https://zenn.dev/microsoft/articles/codex_best_practice

まとめると、Plan modeは「分岐する前の地図」です。地図なしで分岐すると迷いやすく、地図を作ってから分けると比較しやすくなります。大きな作業ほど、/plan → 必要なら /fork という順番が扱いやすいでしょう。

---

/compactは分岐ではなく長くなった文脈を軽くする整理機能である

/compact は、codex 分岐と混同されやすいですが、役割は別です。分岐して別ルートを作るのではなく、長くなった会話の文脈を圧縮して、作業を続けやすくする機能として紹介されています。

長時間Codexを使っていると、過去のやり取り、読み込んだコード、実行結果、判断メモなどがどんどん増えます。その状態でさらに作業を続けると、文脈が重くなり、応答が散らかることがあります。/compact は、重要な情報だけを残すための整理機能です。

ここでのポイントは、/compact は「別案を試す」ためのものではないということです。別案を試したいなら /side や /fork、実装前に整理したいなら /plan が候補です。/compact は、今の流れを維持しながら会話を軽くするものです。

🧹 /compactの役割

機能	目的
/compact	長い会話を要約して続けやすくする
/side	一時的な別相談をする
/fork	別スレッド・別作業環境へ分ける
/plan	実装前に方針を整理する

たとえば、数時間にわたってバグ調査をして、原因、試したこと、残タスクが溜まってきたとします。このとき新しい方向に分けたいわけではなく、今の調査を続けたいだけなら /compact が合います。

📌 /compactを使いやすいタイミング

タイミング	理由
会話がかなり長くなった	重要情報だけに整理しやすい
いったん区切りがついた	次の作業に移りやすい
同じタスクを続けたい	分岐せず文脈を保てる
過去ログが多すぎる	ノイズを減らせる

ただし、圧縮後は細かいニュアンスが落ちる可能性もあります。重要な決定、未完了TODO、検証結果などは、必要に応じてドキュメントやメモに残しておくとよいでしょう。特にチーム作業では、チャット内だけに情報を閉じ込めないほうが安全です。

参考：Codexのスラッシュコマンドまとめでは、/compact は長くなった会話のコンテキストを圧縮するコマンドとして説明されています。
https://note.com/npaka/n/n87a5c4364154

つまり、/compact は分岐ではなく「整頓」です。作業を分けたいのか、会話を軽くしたいのかを分けて考えると、使いどころを間違えにくくなります。

---

セッション分岐で迷ったら「戻す可能性」と「共有する必要性」で判断する

codex 分岐で迷うときは、コマンド名から考えるより、戻す可能性と共有する必要性から考えると実務的です。戻す可能性が高い大きな変更なら、分けておいたほうが扱いやすいです。共有する必要がある判断なら、チャットだけでなくドキュメントやGitの差分に残すほうがよいでしょう。

たとえば、単なる命名相談は戻すほどのものではありません。/side で十分です。一方、認証設計を変更する、DBスキーマに触る、複数画面の状態管理を変えるといった作業は、戻す可能性も影響範囲も大きくなります。この場合は /fork やPlan modeを検討します。

また、AIエージェントやチームメンバーと並行作業する場合は、分岐の意図を共有できる形にしておくことが重要です。Codexの中だけで判断が進むと、あとから別の人や別エージェントが見たときに「なぜこの差分になったのか」が分かりにくくなるかもしれません。

🧭 分岐判断マトリクス

戻す可能性	共有の必要性	おすすめ
低い	低い	メインスレッドで続行
低い	高い	メモやドキュメントに残す
高い	低い	/side または軽い別相談
高い	高い	/fork と計画メモ

このマトリクスは、厳密なルールではありません。ただ、迷ったときの初期判断には使いやすいです。特に、コード変更を伴う場合は「あとで戻す可能性があるか」を考えるだけで、分岐すべきか見えやすくなります。

✅ 実務での目安

作業例	判断
文言案の比較	/side
小さなバグ修正	メインスレッドで続行
大きな設計変更	/plan → /fork
長時間作業の整理	/compact
チーム共有が必要な判断	メモやGitに残す

Codexは、単発のチャットというより「作業スレッド」として使う場面が増えています。調査情報でも、セッションは文脈、意思決定、行動が蓄積される作業スレッドとして扱う考え方が紹介されています。

参考：CodexのBestPracticeを学ぶ会では、ひとまとまりの作業ごとに1スレッドにする考え方が紹介されています。
https://zenn.dev/microsoft/articles/codex_best_practice

最終的には、分岐を増やしすぎないことも大切です。分けるほど管理コストは増えます。小さな相談は軽く、大きな変更は明確に分ける。このバランスが、codex 分岐を実用的に使うコツです。

codex 分岐を実務で失敗しにくくする運用設計

1. AGENTS.mdは分岐後もCodexの判断を揃えるための共通ルールになる
2. Skills化は何度も繰り返す分岐作業を定型化する方法である
3. Automationsは安定した作業だけを定期実行に回す仕組みである
4. ログ駆動の依頼は分岐先でも原因特定の精度を上げる
5. UIやアプリ開発では仕様分岐を最後に入れると崩れにくい
6. Git worktreeと/forkは複数案を比較する場面で相性がよい
7. 総括：codex 分岐のまとめ

AGENTS.mdは分岐後もCodexの判断を揃えるための共通ルールになる

codex 分岐を使ううえで、意外と重要なのがAGENTS.mdです。これは、Codexに対してプロジェクト固有のルールや実行方法、テスト方法、やってはいけないことなどを伝えるためのファイルとして紹介されています。

分岐を増やすと、各スレッドで少しずつ判断がズレる可能性があります。たとえば、あるスレッドではテストを重視し、別のスレッドでは見た目の修正を優先する、といったズレです。AGENTS.mdに共通ルールを書いておけば、分岐後もCodexが同じ前提を参照しやすくなります。

特にチームや複数AIで作業する場合は、チャット内の暗黙知に頼ると危ういです。Codexの会話は便利ですが、別スレッドや別エージェントから見えない情報もあります。共有したいルールは、リポジトリ内のAGENTS.mdや関連ドキュメントに置くほうが安定します。

📄 AGENTS.mdに書きたい内容

項目	例
実行方法	npm test、python scripts/check.py
テスト方針	変更箇所に関連するテストを実行
禁止事項	無関係なリファクタをしない
完了条件	lint、型チェック、動作確認
レビュー観点	既存挙動を壊していないか

AGENTS.mdは、長ければよいわけではありません。調査情報でも、曖昧なルールを長々と書くより、短く正確なAGENTS.mdのほうが役に立つとされています。分岐が多い環境ほど、ルールは短く具体的なほうが機能しやすいです。

🧩 分岐とAGENTS.mdの関係

分岐の課題	AGENTS.mdでの対策
スレッドごとに判断がズレる	共通の完了条件を書く
テスト方法が分からない	コマンドを明記する
触ってはいけない範囲を変えてしまう	制約を書く
レビュー観点が毎回違う	チェック項目を揃える

/fork で別案を試す場合も、AGENTS.mdがあると比較しやすくなります。どの案も同じテスト、同じ制約、同じ完了条件で評価できるためです。

参考：CodexのBestPracticeを学ぶ会では、AGENTS.mdはCodexにどう動いてほしいかを定義する場所として紹介されています。
https://zenn.dev/microsoft/articles/codex_best_practice

つまり、AGENTS.mdは「分岐後も同じ地図を持たせる」ための仕組みです。codex 分岐を本格的に使うなら、スラッシュコマンドだけでなく、共通ルールの整備もあわせて考えるとよいでしょう。

---

Skills化は何度も繰り返す分岐作業を定型化する方法である

codex 分岐を使っていると、同じような作業を何度も繰り返すことがあります。たとえば、PRレビュー、ログ調査、リリースノート作成、移行計画、インシデント要約などです。こうした作業は、毎回プロンプトに長く書くより、Skills化するほうが扱いやすい場合があります。

調査情報では、SkillはSKILL.mdファイル、コンテキスト、補助ロジックをまとめて、Codexに一貫して適用させる仕組みとして紹介されています。つまり、繰り返し使う作業手順をパッケージ化するイメージです。

分岐との関係で見ると、Skillsは「分岐先でも同じやり方を再現する」ために役立ちます。たとえば、/fork でA案とB案を作ったあと、どちらも同じレビューSkillでチェックすれば、比較の観点を揃えやすくなります。

🧰 Skills化しやすい作業

作業	Skills化が向く理由
ログのトリアージ	見る順番を固定しやすい
PRレビュー	チェック観点を揃えやすい
リリースノート作成	出力形式を定型化しやすい
移行計画	手順とリスク整理を再利用しやすい
インシデント要約	重要項目が毎回似ている

ただし、何でもSkillにすればよいわけではありません。調査情報では、各Skillは1つの仕事に絞るのが大切とされています。大きすぎるSkillは、かえって使いどころが曖昧になるかもしれません。

🧪 Skill化の判断基準

質問	YesならSkill候補
同じプロンプトを何度も使っているか	✅
同じ修正手順を繰り返しているか	✅
出力形式を毎回揃えたいか	✅
1つの明確な仕事に切り出せるか	✅

codex 入門の段階では、いきなりSkillを作る必要はありません。まずは手作業で何度か回し、手順が固まってからSkill化するほうが自然です。手順がまだ揺れている段階でSkill化すると、あとで頻繁に直すことになります。

参考：CodexのBestPracticeを学ぶ会では、同じプロンプトを何度も使っているならSkillにすべきという考え方が紹介されています。
https://zenn.dev/microsoft/articles/codex_best_practice

分岐は「作業を分ける」仕組みで、Skillsは「作業のやり方を固定する」仕組みです。この2つを組み合わせると、複数案を試しながらも、評価軸や出力のばらつきを抑えやすくなります。

---

Automationsは安定した作業だけを定期実行に回す仕組みである

Automationsは、分岐そのものではありません。しかし、Codexを長く使ううえでは、分岐・Skills・Automationsの関係を理解しておくと便利です。調査情報では、Automationsはプロジェクト、プロンプト、実行頻度、実行環境を選び、繰り返しタスクを設定できる機能として紹介されています。

重要なのは、Automationsは「まだ人の誘導が必要な作業」には向きにくいという点です。まだ毎回判断が変わる作業は、まず通常のCodexセッションやSkillで安定させるほうがよいでしょう。安定してから自動化するほうが、失敗時の影響を抑えやすいです。

調査情報では、「Skillsはやり方を定義し、Automationsは実行スケジュールを定義する」と整理されています。これは非常に分かりやすい考え方です。分岐は試行錯誤、Skillsは手順化、Automationsは定期実行と考えると混乱しません。

⏱️ 分岐・Skills・Automationsの役割

仕組み	役割
/side	軽い別相談
/fork	別作業ルート
Skills	手順の定型化
Automations	安定作業の定期実行

Automationsに向く作業としては、最近のコミット要約、バグらしきもののスキャン、リリースノートのドラフト作成、CI失敗の確認、スタンドアップ用サマリー作成などが挙げられています。どれも、ある程度やることが決まっている作業です。

✅ Automation化しやすい作業

作業	向いている理由
コミット要約	入力と出力が安定しやすい
CI失敗確認	見る場所が決まりやすい
リリースノート下書き	形式を固定しやすい
定期分析	頻度と手順を決めやすい

反対に、仕様がまだ揺れている新機能開発や、大きな設計判断を含む作業は、いきなりAutomation化しないほうがよいかもしれません。まずはPlan modeや分岐で試し、必要ならSkill化し、その後にAutomation化する流れが自然です。

参考：CodexのBestPracticeを学ぶ会では、手動で安定していない定型作業を早すぎる段階でAutomation化することが、よくある失敗として挙げられています。
https://zenn.dev/microsoft/articles/codex_best_practice

まとめると、Automationsは「うまくいくと分かっている作業」を任せる仕組みです。codex 分岐で試し、Skillで固め、Automationで回す。この順番を意識すると、Codex運用全体が整理しやすくなります。

---

ログ駆動の依頼は分岐先でも原因特定の精度を上げる

Codexで分岐を使うとき、ログやエラー内容をどのスレッドに渡すかはかなり重要です。調査したアプリ開発事例では、ログを渡すと原因特定の精度が上がるという趣旨の説明がありました。これは、一般的な開発作業でもかなり当てはまります。

「動かない」「エラーになる」とだけ伝えるより、実際のエラーログ、再現手順、期待する動作、実際の動作を渡したほうが、Codexは原因を絞りやすくなります。分岐先でも同じです。/fork で別修正を試す場合でも、ログがなければ推測中心になりやすいです。

特に、モバイルアプリやWebアプリ、API連携、Docker、環境設定などは、症状だけでは原因が複数考えられます。ログ、curl結果、バックエンドログ、フロントエンドログなどをセットで渡すと、分岐先の作業品質が上がりやすいです。

🔍 分岐先に渡したい情報

情報	役割
エラーログ全文	原因候補を絞る
再現手順	同じ状態を作る
期待する動作	何が正しいか分かる
実際の動作	差分を見つける
試したこと	重複作業を減らす

分岐を使うと、元スレッドにはログがあるのに、分岐先では文脈が薄くなることがあります。この場合、分岐先のCodexは過去の細かい経緯を十分に持っていない可能性があります。重要なログや判断材料は、明示的に渡すほうが無難です。

🧪 ログ駆動プロンプトの型

要素	例
症状	保存ボタンを押しても反応しない
ログ	TypeError: ...
再現手順	1. 設定画面を開く 2. 保存を押す
期待値	成功メッセージが出る
制約	UIは大きく変えない

調査したiOSアプリ開発記事でも、Flutterログ、バックエンドログ、curlの3点で切り分ける流れが紹介されています。これはCodexに限らず、AIにデバッグを任せるときの実用的な型です。

参考：CodexアプリでiOSアプリを作った記事では、デバッグはログ駆動で進めること、ログを渡すと修正につながりやすいことが説明されています。
https://zenn.dev/za_wave/articles/d738ce0cd599a6

codex 分岐は、ログがあるほど強くなります。別ルートで試すなら、別ルートにも同じ判断材料を渡す。これだけで、無駄な推測や遠回りを減らせる可能性があります。

---

UIやアプリ開発では仕様分岐を最後に入れると崩れにくい

UIやアプリ開発でcodex 分岐を使う場合、仕様分岐を入れるタイミングが大切です。調査したアプリ開発記事では、Free/Pro、広告、制限解除などの仕様分岐は最後にまとめて入れる流れが紹介されていました。これはかなり現実的な考え方です。

最初から分岐仕様を入れすぎると、状態管理、画面遷移、API接続、エラー処理が絡み合いやすくなります。Codexは実装速度が速い一方で、要件が曖昧だったり追加が多すぎたりすると、それっぽい実装が先に進むことがあります。

そのため、UIやアプリ開発では、まず基本導線を通すのが無難です。画面を作る、APIをつなぐ、保存する、表示する。そこまでが安定してから、Free/Proや広告、権限、制限解除などの分岐を入れるほうが、原因切り分けもしやすいです。

📱 アプリ開発での順番

順番	作業	理由
1	要件固定	目的を絞る
2	UIだけ先に通す	画面の完成形を見やすい
3	API接続	データの流れを確認
4	ログ駆動で修正	原因を切り分ける
5	仕様分岐を追加	複雑さを最後に入れる

この考え方は、Codexの分岐運用にもそのまま使えます。最初から /fork を大量に作って、A案、B案、C案で仕様分岐まで入れると、比較が難しくなる可能性があります。まずベースを作り、そのうえで分岐仕様を比較するほうが整理しやすいです。

✅ 仕様分岐を後回しにするメリット

メリット	説明
バグの原因を絞りやすい	基本導線が先に安定する
UIの完成形を確認しやすい	分岐条件に邪魔されにくい
追加仕様の影響が見える	差分として比較できる
forkの目的が明確になる	何を試す分岐か分かりやすい

もちろん、最初から分岐仕様がプロダクトの中心である場合は例外もあります。たとえば課金制限そのものがMVPの核なら、早めに設計へ入れる必要があるかもしれません。ただし一般的には、基本導線が動く前に条件分岐を増やすと、複雑になりやすいです。

参考：CodexアプリでiOSアプリを作った記事では、Free/Pro、広告、制限解除などは最後にまとめて入れる運用が紹介されています。
https://zenn.dev/za_wave/articles/d738ce0cd599a6

UIやアプリ開発でのcodex 分岐は、先に土台、あとで分岐が基本です。ベースが動いていれば、分岐で壊れた箇所も見つけやすくなります。

---

Git worktreeと/forkは複数案を比較する場面で相性がよい

/fork は、Git worktreeの考え方と相性がよい機能として理解できます。調査情報では、/fork は現在のチャットをローカルまたは新しいワークツリーに分岐するイメージとして説明されています。実装案を分けて検証したいときに役立ちます。

Git worktreeとは、一般的には同じリポジトリの別作業ツリーを用意する仕組みです。ここでは詳しいGitコマンド解説には踏み込みませんが、ざっくり言えば「同じプロジェクトで、別の作業場所を持つ」ようなものです。Codexの分岐と組み合わせると、複数案を並行して試しやすくなります。

たとえば、検索機能の改善で「既存SQLを調整する案」と「インデックス設計から見直す案」があるとします。同じ作業場所で両方を混ぜると差分が読みにくくなります。別worktreeやforkを使えば、A案とB案をそれぞれ独立して検証できます。

🌿 複数案比較に向くケース

ケース	分けるメリット
パフォーマンス改善案の比較	ベンチマークしやすい
UIデザイン案の比較	見た目を並べて確認しやすい
設計変更の比較	差分とリスクを比べやすい
大規模リファクタ	元に戻しやすい

ただし、worktreeやforkを使うときは、比較軸を先に決めることが重要です。比較軸がないまま複数案を作ると、「どちらもそれっぽい」で止まりがちです。速度、実装量、既存影響、テストの通りやすさ、保守性などを先に決めると判断しやすくなります。

📊 比較軸の例

比較軸	見るポイント
変更量	差分が大きすぎないか
既存影響	既存機能を壊していないか
テスト	自動テストで確認できるか
保守性	次の修正がしやすいか
速度	パフォーマンスが改善したか

複数案を比較する場合、最後にどれを採用するかが大切です。採用しない案は、学びだけ残して閉じる判断も必要になります。分岐を増やしたまま放置すると、後でどれが本流か分からなくなるかもしれません。

参考：CodexのBestPracticeを学ぶ会では、Git worktreeを使わずに同じファイルで複数のライブスレッドを走らせることが、避けたい失敗として紹介されています。
https://zenn.dev/microsoft/articles/codex_best_practice

/fork とGit worktreeは、複数案を比べたいときの強い味方です。ただし、分ける前に目的、変更範囲、比較軸、終了条件を決めておくことが重要です。

---

総括：codex 分岐のまとめ

最後に記事のポイントをまとめます。

1. codex 分岐は、会話だけ分けるか、作業環境ごと分けるかで判断するものだ。
2. /side は、今の作業を汚さずに横道の相談をするための機能である。
3. /fork は、別アプローチや大きな変更を作業スレッドやワークツリーごと試すための機能である。
4. codex 入門 の段階では、分岐より先にGoal、Context、Constraints、Done whenを固定することが重要である。
5. Plan modeは、分岐する前に影響範囲、手順、比較軸を整理するための地図である。
6. /compact は分岐ではなく、長くなった文脈を圧縮して続けやすくする整理機能である。
7. AGENTS.mdは、分岐後もCodexの判断を揃えるための共通ルールとして機能する。
8. Skillsは、何度も繰り返す作業手順を定型化し、分岐先でも同じやり方を再現しやすくする仕組みである。
9. Automationsは、手順が安定した作業を定期実行に回すための仕組みである。
10. ログ、再現手順、期待値、実際の動作を渡すことで、分岐先でも原因特定の精度が上がりやすい。
11. UIやアプリ開発では、基本導線を先に通し、Free/Proや広告などの仕様分岐は後から入れるほうが崩れにくい。
12. Git worktreeと/forkは、複数案を比較する場面で相性がよい。
13. 分岐を増やしすぎると管理コストが上がるため、小さな相談は軽く、大きな変更は明確に分けるべきである。
14. codex 分岐で迷ったら、「戻す可能性」と「共有する必要性」で判断するのが実務的である。

記事作成にあたり参考にさせて頂いたサイト

• https://www.reddit.com/r/codex/comments/1r65eza/why_does_plan_mode_force_codex_53_medium_or_is/?tl=ja
• https://note.com/npaka/n/n87a5c4364154
• https://www.reddit.com/r/ClaudeAI/comments/1qx0wr3/with_opus_46_and_codex_53_dropping_today_i_looked/?tl=ja
• https://x.com/y_esnya/status/2051338156654633327
• https://zenn.dev/microsoft/articles/codex_best_practice
• https://qiita.com/oga_aiichiro/items/303da2779ea26b173947
• https://zenn.dev/za_wave/articles/d738ce0cd599a6
• https://www.eigent.ai/ja/blog/openclaw-vs-codex
• https://zenn.dev/geeknees/articles/ac061e452f8435
• https://codex.wordpress.org/Conditional_Tags

当サイトについて

当サイトでは、インターネット上に散らばるさまざまな情報を収集し、AIを活用しながら要約・編集を行い、独自の切り口で見解を交えながらわかりやすい形でお届けしています。 情報の整理・編集にあたっては、読者やオリジナル記事の筆者へご迷惑をおかけしないよう、細心の注意を払って運営しておりますが、万が一、掲載内容に問題がある場合や修正・削除のご要望がございましたら、どうぞお気軽にお問い合わせください。 迅速に対応をさせていただきます。 その際には、該当記事の URLやタイトルをあわせてお知らせいただけますと、より速やかに対応 することができますのでそちらもご協力いただけますと大変幸いでございます。 今後とも当サイトをよろしくお願いいたします。