Codex を法人で導入する際、最初に迷いやすいのが「Local・Worktree・Cloud のどれで実行するか」です。実行モードは、作業場所だけでなく、レビューの流れ、Git 運用、並行作業のしやすさにも影響します。本記事では、公式ドキュメントに記載された範囲に沿って、3 つのモードの違い、データの流れ、承認・レビューの考え方、業務別の判断基準を整理します。

i

本記事の結論: まずは「日常の修正は Local、並行検証は Worktree、バックグラウンド実行や外部連携起点は Cloud」という仮説で設計し、機密性・Git 運用・レビュー体制に合わせて調整します。

Local・Worktree・Cloud の基本的な違い

Codex では、ChatGPT デスクトップアプリで Codex を開き、新しい Codex チャットを始める際に実行場所を選択します。公式ドキュメントでは、Local は現在のプロジェクトディレクトリで直接作業するモード、Worktree は Git worktree によって変更を分離するモード、Cloud は設定済みのクラウド環境でリモート実行するモードと説明されています。また、Local と Worktree のチャットはいずれも利用者のコンピューター上で実行されるとされています。Codex environments

法人導入で重要なのは、「どれが優れているか」ではなく、業務フローに対してどの実行場所が合うかです。Local は現在の作業ディレクトリを直接扱うため、普段の開発環境や IDE で確認しながら進めたい場合に検討しやすい選択肢です。一方で、同じプロジェクトで複数の作業を並行させたい場合、現在の作業状態と混ざらない設計が必要になります。

Worktree は、同じ Git リポジトリ内で独立した作業領域を作る考え方です。Codex の Worktree は、複数の独立したチャットを同じプロジェクトで走らせても互いに干渉しにくくするために使われます。Worktrees

Cloud は、クラウド側に設定した環境でタスクを実行します。公式ドキュメントでは、GitHub または GitLab を接続し、リポジトリに対して環境を作成し、依存関係・ツール・環境変数・シークレットなどを設定してタスクを開始する流れが示されています。Codex cloud

モード 実行場所の考え方 主な使いどころの候補
Local 現在のプロジェクトディレクトリで直接作業 手元の IDE・既存環境で確認しながら進めたい作業
Worktree Git worktree で変更を分離 同じリポジトリで並行作業・比較検証をしたい作業
Cloud 設定済みクラウド環境でリモート実行 バックグラウンド実行、外部連携起点、並列タスク

データの流れは「作業場所」と「レビュー場所」を分けて見る

実行モードを選ぶ際は、データの流れを「コードがどこにあるか」「コマンドがどこで実行されるか」「結果をどこでレビューするか」に分けて整理すると判断しやすくなります。Local は現在のプロジェクトディレクトリで直接作業するモードです。Worktree は Git worktree を使って別のチェックアウトを作り、そこで作業を分離します。公式ドキュメントでは、Worktree においてリポジトリ、worktree、コマンドは、プロジェクトを含むコンピューターまたはリモート開発環境に残ると説明されています。Worktrees

ただし、「Local や Worktree はコンピューター上で実行される」という説明だけで、データが外部に出ないと判断するのは適切ではありません。法人では、実行場所の説明と、入力内容・対象ファイル・接続先・社内規程上の取り扱いを分けて確認する必要があります。機密情報、個人情報、顧客データ、未公開の設計情報を扱う場合は、情報システム部門やセキュリティ担当と利用範囲を定義してから運用するのが現実的です。ガバナンス面の整理は、本文中でも後述するように /blog/codex-security-governance-for-enterprise も併せて確認するとよいでしょう。

Cloud の場合は、設定済みのクラウド環境で実行されます。公式ドキュメントでは、GitHub または GitLab を接続し、Codex がアクセスできるリポジトリやプロジェクトを選び、環境を作成してからタスクを開始する流れが示されています。環境には、タスクに必要な依存関係、ツール、環境変数、シークレットを設定できます。Codex cloud

法人では、Cloud を検討する際に「どのリポジトリを接続するか」「どの環境変数・シークレットを設定するか」「誰が結果をレビューするか」をセットで設計することが重要です。実行場所だけでなく、リポジトリ接続やレビュー手順まで含めて、業務フローとして扱う必要があります。

Worktree は「並行作業」と「安全な受け渡し」を設計するモード

Worktree は、Codex に複数の作業を並行して任せたい場合に検討しやすいモードです。公式ドキュメントでは、Worktree により同じプロジェクトで複数の独立したチャットを実行でき、互いに干渉しにくくなると説明されています。また、Git リポジトリであることが前提で、Git worktree を内部で利用します。Worktrees

Worktree の考え方は、非エンジニアにも「同じ資料フォルダをもう 1 つ作り、別案をそこで編集する」イメージで説明できます。ただし実際には Git の仕組みを使うため、ブランチやチェックアウトの制約があります。たとえば、Git では同じブランチを複数の worktree で同時にチェックアウトできません。公式ドキュメントでも、ある worktree でブランチを作成した場合、そのブランチをローカルチェックアウトなど別の worktree で同時にチェックアウトできない点が説明されています。Worktrees

Worktree では、Handoff によってチャットを Local と Worktree の間で移動できます。公式ドキュメントでは、Handoff はチャットとコードを移動し、Codex が必要な Git 操作を扱うと説明されています。たとえば、最初は Worktree で背景作業として進め、確認段階で Local に Hand off して普段の IDE で差分を読む、といった流れが考えられます。Worktrees

1. Worktree で分離して開始 — 既存作業に影響を与えにくい形で、別チェックアウト上の作業として始めます。

2. 結果を確認 — Worktree 上で確認するか、必要に応じて Local に Handoff して、普段の IDE や開発サーバーで検証します。

3. ブランチ化・PR 化を判断 — Worktree 上でブランチを作成して進めるか、Local に移して確認するかを Git 運用に合わせて選びます。

チームで Worktree を使う場合は、誰がどの粒度のタスクを投げるか、結果をどのように確認するか、並列作業の数をどう管理するかも設計対象になります。関連する実務設計は /blog/codex-skills-automations-worktrees-for-teams でも整理しています。

Cloud はバックグラウンド実行・外部連携起点で検討する

Cloud は、ローカルマシンを占有せずに、設定済みのクラウド環境でタスクを進めたい場合に検討しやすいモードです。公式ドキュメントでは、Codex cloud は分離されたクラウド環境でコーディングタスクを実行し、並行作業を行い、Web、GitHub、GitLab、Linear、Slack から作業を開始できると説明されています。Codex cloud

Cloud の導入判断では、まず「作業がどこから発生するか」を見ます。たとえば、開発タスクが GitHub の pull request、GitLab の merge request や issue、Linear の issue、Slack のチャンネルやスレッドから発生する運用であれば、Cloud の外部連携起点は検討材料になります。公式ドキュメントでも、GitHub pull request、GitLab merge request と issue、Linear issue、Slack チャンネルやスレッドから Codex cloud に作業を開始できる旨が示されています。Codex cloud

次に見るべきなのは、環境の再現性です。Cloud では、リポジトリごとに必要な依存関係、ツール、変数、セットアップ手順を設定する考え方が示されています。開発者の手元環境に依存しやすい作業を、一定の環境で動かしたい場合には、この観点が重要になります。Codex cloud

ただし、Cloud を選べば常に最適というわけではありません。リポジトリ接続、環境変数、シークレット、レビュー権限、PR 作成の流れなど、組織として決める項目が増えます。特に情報システム部門は、「誰が環境を作成できるか」「どのリポジトリを対象にするか」「Cloud で扱ってよい情報の範囲はどこまでか」を事前に定義しておくと、運用開始後の混乱を抑えやすくなります。

承認・レビューはモードごとに「人が確認する地点」を決める

Codex の実行モードを選ぶ際、承認やレビューをどこに置くかは重要です。公式ドキュメントでは、Worktree について、ChatGPT モバイルアプリの Remote を使うと、接続されたコンピューター上の worktree チャットを開始、ガイド、承認、レビューできると説明されています。ただし、Worktree はスマートフォン上でローカル実行されるわけではなく、接続されたコンピューター、またはそのコンピューターが利用するリモート開発環境でリポジトリと worktree が保持されます。Worktrees

このため、Worktree の承認設計では「誰がチャットの進行を承認するか」と「誰がコード差分をレビューするか」を分けて考えると実務に落とし込みやすくなります。たとえば、DX 推進担当がタスク内容を確認し、実装差分は開発責任者が見る、といった役割分担です。ここでは効果を保証するのではなく、既存の Git レビューやプルリクエスト運用にどう接続するかを設計することが大切です。

Cloud では、公式ドキュメントに「結果のサマリーと diff を確認し、フォローアップ変更を依頼するか、準備ができたら pull request を開く」とあります。また、「Review before you merge」として、マージ前にサマリーと差分を確認できる流れが説明されています。Codex cloud

Local では、現在のプロジェクトディレクトリで直接作業するため、承認の置き場所は組織の開発ルールに合わせて設計する必要があります。たとえば、ローカルで動作確認を行った後、通常のブランチ作成・レビュー・マージの手順に乗せる、といった形です。重要なのは、どのモードでも「Codex が作業したからそのまま反映する」のではなく、人が確認する地点を明示しておくことです。

業務別の使い分けは「断定」ではなく判断基準で決める

法人導入では、業務ごとに最初の実行モードを仮決めし、実際のレビュー負荷やセキュリティ要件に応じて見直す進め方が現実的です。以下は、公式ドキュメントに記載された特徴をもとにした判断基準です。特定の業務に対して常にこのモードが正解、という意味ではありません。

業務・状況 検討しやすいモード 判断の観点
既存の手元環境で小さな修正を確認したい Local 普段の IDE、既存の開発サーバー、現在の作業ディレクトリで確認したいか
同じリポジトリで複数案を並行検証したい Worktree 現在の Local 作業と分離したいか、Git リポジトリで管理されているか
Codex に背景作業を任せ、後で確認したい Worktree または Cloud 手元コンピューター上で進めるか、クラウド環境で進めるか
GitHub、GitLab、Linear、Slack 起点で作業を開始したい Cloud 外部連携を業務フローに組み込むか
環境の再現性を重視したい Cloud 依存関係、ツール、変数、セットアップ手順を環境として管理したいか
通常の開発フローに慎重に接続したい Local または Worktree 差分確認、Handoff、ブランチ運用、レビュー担当を明確にできるか

導入初期は、いきなり全社で統一するよりも、対象リポジトリや業務を限定して運用ルールを検証する方法が向いています。たとえば、情報システム部門が「Local で扱う作業」「Worktree で並行化してよい作業」「Cloud で扱う作業」を分類し、開発責任者がレビュー手順を定義する形です。

その際、セキュリティ・ガバナンスの観点を後回しにしないことが重要です。どのモードでも、利用対象リポジトリ、入力してよい情報、レビュー責任者、成果物の反映手順を明文化しておくと、現場が判断しやすくなります。詳しい観点は /blog/codex-security-governance-for-enterprise も参考にしてください。

まとめ

Codex の Local・Worktree・Cloud は、単なる実行場所の違いではなく、作業分離、並行実行、レビュー、外部連携、環境管理に関わる設計要素です。Local は現在のプロジェクトディレクトリで直接作業するモード、Worktree は Git worktree により変更を分離するモード、Cloud は設定済みクラウド環境でリモート実行するモードとして整理できます。

法人導入では、まず業務を分類し、どのモードで開始するかを仮決めすることが有効です。そのうえで、機密情報の扱い、リポジトリ接続、環境変数やシークレット、レビュー担当、PR やマージの手順を確認します。特に Worktree は Git 運用と Handoff、Cloud は環境設定とレビュー前提の流れを理解したうえで導入することが重要です。

デジライズでは、Codex の法人導入に向けた導入コンサルティングや、AIエージェント・業務自動化の開発支援を行っています。自社の Git 運用、セキュリティ要件、レビュー体制に合わせて Local・Worktree・Cloud の使い分けを設計したい場合は、無料相談で現在の業務フローをお聞かせください。

関連記事