プロジェクト・複数エージェント・worktreeはどう使う？デスクトップ版Codexの基本を解説【2026年版】
OpenAI CodexCodexにはCLIやIDE拡張だけでなく、macOS・Windowsで使えるデスクトップアプリがあります。
Codexアプリの特徴は、単にチャット形式でコードを書かせることではありません。複数の作業をプロジェクトごとに分け、別々のスレッドでエージェントを動かし、必要に応じて同じリポジトリ上の作業まで並行して進められるところにあります。OpenAIもCodexアプリを、複数のエージェントを管理するための「コマンドセンター」と位置づけています。
そのため、Codexそのものを初めて知るための記事というより、「Codexを使い始めたあと、デスクトップアプリをどう使えば便利なのか」を知りたい人向けの内容です。
この記事では、プロジェクトとスレッドの違い、複数エージェントの使い分け、worktreeが何をしているのか、変更内容の確認方法まで、実際の作業をイメージできるように整理します。
※機能・提供状況などは2026年8月30日時点の情報です。
Codexアプリは、Codexへ開発作業を依頼し、その進行や変更内容をまとめて管理するためのデスクトップアプリです。
macOS版は2026年2月に登場し、その後2026年3月にはWindows版も提供されました。現在はMacとWindowsの両方で利用できます。
CLI版との一番大きな違いは、複数の作業を画面上で管理しやすいことです。
ターミナルでCodexを使う場合も複数の作業はできますが、作業ごとにターミナルを分けたり、どのセッションで何を進めていたのかを自分で追ったりする必要があります。Codexアプリでは、エージェントの作業がプロジェクト単位で整理され、その中に個別のスレッドが並びます。
たとえば、あるWebサイトを開発しているなら、同じプロジェクトの中で「トップページを修正する」「記事ページの表示崩れを直す」「新しい検索機能を追加する」といった作業を、それぞれ別のスレッドとして動かせます。
ひとつの会話にすべての作業を詰め込むのではなく、作業単位で分離できるのがアプリ版の使いやすさです。
また、Codex CLIやIDE拡張で使っていたセッション履歴や設定も、ChatGPTアカウントを通じてアプリへ引き継げます。すでにCodexをCLIやIDEで使っている場合でも、アプリへ移ったからといってすべてを最初から作り直す必要はありません。
Codexアプリを使うとき、最初に理解しておきたいのが「プロジェクト」と「スレッド」の違いです。
プロジェクトは、作業対象となる大きなまとまりです。
たとえば自分がひとつのWebサービスを開発しているなら、そのサービスのリポジトリをひとつのプロジェクトとして扱います。別のアプリを開発するなら、そちらは別のプロジェクトに分ける、という使い方になります。
スレッドは、そのプロジェクトの中でCodexに任せる個別の作業です。
同じWebサービスでも、「ログイン画面を修正する」「決済処理を調査する」「READMEを書き直す」では目的が違います。
これらをひとつの長いスレッドで順番に依頼していくこともできますが、作業が増えるほど過去の文脈が混ざりやすくなります。
Codexアプリなら、それぞれ別のスレッドとして作っておけます。
OpenAIは、エージェントがプロジェクトごとの個別スレッドで動作することで、作業の文脈を失わずにタスクを切り替えられると説明しています。
実際の使い方としては、プロジェクト = 開発している製品やリポジトリ、スレッド = Codexへ依頼するひとつの仕事くらいに考えると分かりやすいです。
スレッドを細かく分けすぎる必要はありませんが、目的の違う作業を無理にひとつへまとめない方が、あとから作業内容を確認しやすくなります。
Codexアプリの大きな特徴が、複数のエージェントを並行して動かせることです。
これは、ひとつのCodexに作業を順番に頼むのとはかなり違います。
たとえば3つの修正がある場合、1つ目が終わるまで待ってから2つ目を依頼し、さらに3つ目へ進む方法では、Codexが作業している間に人間側が待つ時間が発生します。
アプリでは、それぞれを別のスレッドで開始できます。
すると、エージェントAがUIを修正し、エージェントBがテストを追加し、エージェントCが別の不具合を調査する、といった形で複数の作業を同時に進められます。
OpenAIも現在のCodexを、複数エージェントを並行して動かすことを前提としたワークフローとして案内しています。
この使い方が特に便利なのは、互いに強く依存していない作業が複数あるときです。
たとえば「デザイン修正が終わらないとAPIを修正できない」というように順番が決まっている場合は、無理に同時に走らせる意味はありません。
一方で、「記事ページのUI修正」と「管理画面の検索機能追加」のように別々に進められる仕事なら、並行化の効果が大きくなります。
人間側はCodexが作業している間に別のスレッドを確認し、必要な指示だけ追加していく形になります。
Codexを「質問すると答えてくれるツール」として使うより、複数の作業担当者へ仕事を割り振る感覚に近くなります。
複数エージェントを同じリポジトリで動かすときに重要になるのがworktreeです。
Gitのworktreeは、同じリポジトリを元にしながら、別々の作業ディレクトリを持てる仕組みです。
Codexアプリでは、このworktreeが標準でサポートされています。各エージェントが分離されたコードのコピー上で作業できるため、同じリポジトリに対して複数のエージェントを動かしても、互いの変更がその場で衝突しにくくなります。
たとえば、エージェントAにはヘッダー修正、エージェントBには検索機能追加を同時に頼んだとします。
同じ作業ディレクトリを直接編集させると、片方の変更途中にもう片方がファイルを書き換える可能性があります。
worktreeを使えば、それぞれが独立した作業場所を持つため、まず別々に変更を完成させられます。そのあと変更内容を確認し、必要なものだけ取り込めます。
ここで大事なのは、worktreeを「高速化する機能」と考えないことです。役割は、並行作業を安全に分離することです。
ひとつの小さな修正しかしていないなら、worktreeのありがたみはあまり感じないでしょう。
しかし複数のCodexを同時に走らせるようになると、「別の作業が途中のコードへ影響しない」ということ自体がかなり重要になります。
Gitのworktreeを自分で細かく操作した経験がなくても、Codexアプリ側でサポートされているため、複数エージェントを使うための仕組みとして自然に利用できます。
Codexへ実装を任せても、変更内容を確認せずそのまま採用する必要はありません。
Codexアプリでは、エージェントが行った変更をスレッド内で確認できます。
差分を見て、気になる部分へコメントしたり、そのまま追加修正を依頼したりできます。必要なら変更をエディターで開き、自分で手直しすることもできます。
この流れは、Codexアプリを使ううえでかなり重要です。
Codexへ「この画面を直して」と依頼して、完成したら終わりではありません。
変更されたファイルを見る → 想定していた実装か確認する → 気になる部分だけ再修正させる → 問題なければ採用する、という流れで使えます。
大きな変更ほど、最終結果だけを見るよりdiffを確認した方が安心です。
特に複数のエージェントを並行して動かしている場合は、それぞれがどこを変更したのかを確認してから取り込む方が管理しやすくなります。
つまりCodexアプリは、単にAIへ命令を出す画面ではなく、AIが行った作業を監督する画面でもあります。
CodexにはCLIとIDE拡張もあります。
そのため、すでにターミナルやVS CodeなどからCodexを使っている人なら、「わざわざデスクトップアプリを使う必要があるのか」と感じるかもしれません。
ひとつの作業をCodexと対話しながら進めるだけなら、CLIやIDEの方が速い場面もあります。
ターミナルを開いたまま実装を頼み、その場ですぐ確認するような使い方なら、無理にアプリへ移る必要はありません。
アプリ版の意味が大きくなるのは、同時に複数の仕事を任せ始めたときです。
どのプロジェクトで何を進めているのか、どのエージェントがまだ作業中なのか、どの変更を確認する必要があるのか。
こうした管理が増えると、ターミナルを何枚も開いて追うより、プロジェクトとスレッドでまとめられたアプリの方が見通しがよくなります。
OpenAI自身も、従来のIDEやターミナルは複数のエージェントを大規模に監督するために作られたものではないとして、Codexアプリをそのための新しいインターフェースとして説明しています。
なので、1つの作業を素早く進めるならCLI・IDEでも十分、複数の仕事をCodexへ任せて管理するならアプリ版が使いやすい、という分け方がしやすいです。
どちらか一方だけを選ばなければならないわけでもありません。
CodexアプリはCLIやIDE拡張の履歴・設定を引き継げるため、作業内容によって使い分けられます。
Codexアプリが特に便利なのは、ひとつのプロジェクトで複数の作業を並行して進めている人です。
小さな修正を1件だけ頼むなら、アプリの複数エージェント機能を活かす場面はそれほど多くありません。
しかし、新機能を実装する、不具合を調査する、テストを追加する、ドキュメントを更新する、といった作業が同時に存在するなら、それぞれを別のスレッドへ分けて任せられます。
また、複数のプロジェクトを並行して開発している人にも向いています。
プロジェクトごとに作業を分けられるため、「このスレッドはどのリポジトリの話だったか」を毎回確認する必要が減ります。
反対に、Codexへたまに短い質問をするだけなら、アプリ版の機能をすべて使う必要はありません。
Codexアプリの本領は、AIにコードを書かせること自体よりも、AIへ複数の仕事を任せ、それを人間がまとめて管理することにあります。
OpenAIは現在、Codexを単純なコード生成から、長時間の開発作業や複数エージェントの協調まで扱う方向へ広げています。さらにSkillsやAutomationsなど、チームの作業方法を覚えさせたり、定期的な仕事を任せたりする機能も用意されています。
最初からすべて使う必要はありません。
まずひとつのプロジェクトを登録し、作業ごとにスレッドを分ける。そのうえで並行して進められる仕事が出てきたら、複数エージェントやworktreeを使う。
この順番の方が、Codexアプリが何を便利にしているのか理解しやすいです。
Codexアプリは、Codexをデスクトップから使えるようにしただけのアプリではありません。
プロジェクトごとにスレッドを整理し、複数のエージェントへ別々の仕事を任せ、worktreeで変更を分離しながら並行して進められます。そして完成した変更はdiffを確認し、必要ならその場で追加修正を依頼できます。
ひとつの短い作業だけならCLIやIDEでも十分です。
一方で、Codexへ任せたい仕事が増えてくるほど、どの作業がどこまで進んでいるかを管理すること自体が必要になります。
Codexを「コードを書いてくれるAI」から「複数の仕事を並行して任せる開発エージェント」として使い始めるなら、デスクトップアプリの価値がかなり分かりやすくなります。