AI Log

新着 › ツールガイド › Codex

ツールガイド ／ Codex ／ 2 毎日つかう

Codex environments：Local・Worktree・Cloud の選び方

公式を確かめた日 2026年10月1日（木） ／ 約8分で読めます

OpenAI の公式の説明（下の「公式のページ」）を、内容を足さずに読みやすい日本語に書き直したものです。公式の翻訳ではなく、OpenAI が作ったものでもありません。公式は予告なく変わるので、使う前に公式のページもご覧ください。

このページで分かること

先に知っておく言葉

3つの場所の違い

ChatGPT デスクトップアプリで、ChatGPT の選択欄から Codex を選び、会話を始めるときに場所を選びます。

Local と Worktree は、どちらも自分のパソコンの上で動きます。入力欄の Work in で This computer か Cloud を選び、Git で記録を取っているプロジェクトなら、それとは別の Worktree の切り替えで、変更を手元と分けられます。

Worktree で始める

Worktree は、Git のリポジトリになっているプロジェクトでだけ使えます。それぞれの Worktree はファイルを一式ずつ持ちますが、変更の記録（.git フォルダ）は共通です。

  1. 新しい会話の画面で、入力欄の下の Worktree を選びます。準備の手順を動かしたいときは、ローカル環境（Worktree を作るときの準備を決めておく設定）を選ぶこともできます
  2. 入力欄の下で、もとにするブランチを選びます。main などのブランチのほか、まだ記録していない変更がある今のブランチも選べます
  3. 指示を送ると、Codex が選んだブランチをもとに Worktree を作ります
  4. 一区切りついたら、Worktree でそのまま続けるか、会話を Local に移すかを選びます

Worktree で続けるか、Local に移すか

公式は、Local を手前の作業、Worktree を裏の作業と考えるとよい、としています。Git では1つのブランチを同時に2か所で開けないため、Handoff が間の Git の操作を引き受けます。

Worktree の片付け

Cloud を使う前に

公式が挙げている使いどころ

公式のページに書いてある向き・使い方だけを並べます。

あわせて読む

公式のページ

確認メモ：2026年10月1日に、上の2つの公式ページ（英語）を開いて、3つの場所の名前、Worktree を始める4つの手順、ボタンの名前、自動で残す Worktree の数、Cloud の環境の作り方を突き合わせました。公式のページに更新日の表示は無いため、この日付は「このサイトが確かめた日」です。スマホの Remote から Worktree の会話を動かす話、決まった時刻に動かす作業（scheduled tasks）が裏の Worktree で動く話、Worktree の置き場所（$CODEX_HOME/worktrees と Settings > Worktrees の Worktree root）、Worktree が「detached HEAD」（どのブランチにも乗っていない状態）で始まること、.worktreeinclude の書き方の細かい決まり、同じブランチを2か所で開けないときに出るエラーの文とその理由は、場所の選び方に要らないため載せていません。Cloud の環境の準備の細かい手順は、公式の Cloud environments のページにあります。「Git」「リポジトリ」「ブランチ」「VPN」「開発用サーバー」の言い換えは、公式の用語集に無く、ふつうの意味を一言で添えたものです。「ローカル環境」は、公式の用語集の Environment (local)（Worktree の準備のしかたを決めるデスクトップアプリの設定）の意味で使っています。題の「environments」は、このページでは作業の場所（Local・Worktree・Cloud）の意味で、用語集の Environment (local) とは指すものが違います。

同じ段のガイド（2 毎日つかう）

Codexの流れの全体を見る →