プロジェクトを使うと、関連するチャットを整理し、ChatGPT に必要なコンテキストを提供できます。ChatGPT デスクトップアプリのプロジェクト画面には、ChatGPT プロジェクトと、コンピューター上のフォルダーに接続するローカルプロジェクトが表示されます。
プロジェクトを使う場合と使わない場合
継続的な作業、複数の成果物を作る作業、同じファイルやソースを繰り返し使う作業には、プロジェクトを作成します。単独で完結し、プロジェクトで共有するコンテキストが不要な作業は、プロジェクトを使わずにチャットを始めます。
プロジェクトを使うと、関連するチャット、ファイル、指示、ソースをまとめて管理できます。Chat で始めたチャットも、ChatGPT Work で始めたチャットも、同じプロジェクトに含めることができます。
プロジェクトを使う場合と使わない場合
継続的な作業、複数の成果物を作る作業、同じファイルやソースを繰り返し使う作業には、プロジェクトを作成します。単独で完結し、プロジェクトで共有するコンテキストが不要な作業は、プロジェクトを使わずにチャットを始めます。
各プロジェクトのチャットセクションには、そのプロジェクトのチャットが一覧表示されます。ソースセクションには、アップロードしたファイルや接続先から取得するコンテキストがまとまっています。プロジェクトの指示は、その中のすべてのチャットに適用されます。ChatGPT プロジェクトからコンピューター上のフォルダーに直接アクセスすることはできないため、ChatGPT に使ってほしいソースをアップロードするか、接続してください。
どちらのモードでも、プロジェクトから新しいチャットを始めると、共有ファイルと指示を利用できます。後で再開するには、チャットからそのチャットを開きます。
Codex CLI では、起動したディレクトリがそのチャットのプロジェクトになります。Codex に作業させたいディレクトリで codex を実行するか、--cd <directory>（-C）でディレクトリを明示的に指定します。CLI では ChatGPT のプロジェクト画面は利用できません。
IDE 拡張機能では、IDE で開いているフォルダーまたはワークスペースがローカルプロジェクトになります。マルチルートワークスペースでは、チャットに使うワークスペースルートを選択します。拡張機能では、Web 版やデスクトップアプリの ChatGPT プロジェクト画面は利用できません。
プロジェクト内での作業
プロジェクト画面では、ChatGPT プロジェクトとローカルプロジェクトをまとめて管理できます。ChatGPT プロジェクトでは、関連するチャット間でプロジェクトのファイルやコンテキストを共有できます。ローカルプロジェクトでは、ソースファイルをまとめたフォルダーやコードベースなど、コンピューター上の 1 つ以上のフォルダーにチャットからアクセスできます。
目的ごとにチャットを分けると、それぞれのやり取りと結果を追いやすくなり、関連する作業はプロジェクトにまとめておけます。
プロジェクト内での作業
ChatGPT プロジェクト内の各チャットでは、アップロードしたファイル、プロジェクトの指示、接続済みのソースを共有できます。ちょっとしたやり取りには Chat を、規模の大きな成果物の作成には ChatGPT Work を使います。どちらもプロジェクトのチャットセクションに表示されます。目的ごとにチャットを分けると、それぞれのやり取りと結果を追いやすくなり、共通のコンテキストはプロジェクトに保持されます。
プロジェクトディレクトリでの作業
チャットで参照したいファイルがあるディレクトリから Codex を起動します。目的ごとに /new で新しいチャットを始めます。保存済みのチャットを再開するには、Codex の起動中に /resume を使うか、codex resume を実行します。
チャットには会話履歴と作業ディレクトリの記録が残ります。Codex がファイルを読み取るのは現在の作業ツリーからです。今後のチャットでも使うプロジェクトの指針は、AGENTS.md またはリポジトリにコミットしたドキュメントに記載します。
ワークスペースでの作業
チャットで参照したいファイルがあるフォルダーまたはワークスペースを開きます。目的ごとに新しいチャットを始め、再開するときは最近のチャットから選択します。同じプロジェクト内のチャットでは同じファイルを扱えますが、会話履歴はチャットごとに保持されます。
現在の選択範囲と開いているファイルが、そのターンのコンテキストになります。今後のチャットでも使うプロジェクトの指針は、AGENTS.md またはリポジトリにコミットしたドキュメントに記載します。
プロジェクトとチャットの整理
進行中の作業を見つけやすくし、完了した作業を片付けるには、次の操作を使います。
- プロジェクトをピン留めすると、サイドバーの上部に表示されます。プロジェクト画面からもピン留めできます。
- チャットをピン留めすると、プロジェクトに新しいチャットが増えても、よく使うチャットを見つけやすくなります。
- チャットの名前を変更し、「第 3 四半期のリリース概要」や「購入手続きのアクセシビリティレビュー」など、成果がわかる短いタイトルを付けます。
- プロジェクトを検索するには、プロジェクト画面を使います。過去のチャットのタイトルを思い出せなくても、フレーズやブランチ名を覚えていれば、サイドバーのチャットを検索から探せます。チャット検索には既定のショートカットはありませんが、設定 > キーボードショートカットで割り当てられます。
- 作業が完了したら、チャットをアーカイブします。プロジェクトのメニューからチャットをアーカイブを選択すると、そのプロジェクトのチャットをまとめてアーカイブできます。
ピン留めによってコンテキストが追加されたり、ChatGPT がアクセスできる範囲が変わったりすることはありません。変わるのは、サイドバーでのプロジェクトやチャットの表示位置だけです。
アーカイブしたチャットは、設定 > アーカイブ済みのチャットから復元できます。
プロジェクトとチャットの整理
進行中の作業を見つけやすくし、完了した作業を片付けるには、次の操作を使います。
- プロジェクトをピン留めすると、サイドバーの上部に表示されます。プロジェクト画面からもピン留めできます。
- チャットをピン留めすると、プロジェクトに新しいチャットが増えても、よく使うチャットを見つけやすくなります。
- チャットの名前を変更し、「第 3 四半期のリリース概要」や「購入手続きのアクセシビリティレビュー」など、成果がわかる短いタイトルを付けます。
- プロジェクトを検索するには、プロジェクト画面を使います。過去のチャットのタイトルを思い出せなくても、フレーズやブランチ名を覚えていれば、Cmd/Ctrl+K で検索できます。
- 作業が完了したら、チャットをアーカイブします。
ピン留めによってコンテキストが追加されたり、ChatGPT がアクセスできる範囲が変わったりすることはありません。変わるのは、サイドバーでのプロジェクトやチャットの表示位置だけです。
アーカイブしたチャットは、設定 > データコントロール > アーカイブ済みのチャットから復元できます。
ローカルプロジェクトでのフォルダーとコードベースの利用
別のデバイスで Work を続けるときに承認済みのプロジェクトフォルダーを使うには、ワークスペースでローカルコンピューターへのアクセスが有効になってから、新しいクラウドタスクを開始します。そのフォルダーがあるコンピューターはオンラインのまま、接続を維持してください。
会話の同期とプロジェクトファイルへのアクセスは別々に扱われます。
- 会話を同期しても、ローカルフォルダー全体がアップロードされたり、別のコンピューターから利用できるようになったりすることはありません。
- タスクを再開するときは、そのタスクからアクセスできるソースとツールを確認してください。
- Work の会話履歴と Codex の履歴は引き続き別々に管理されます。
ChatGPT がコンピューター上のファイルを読み取ったり変更したりする必要がある場合は、ローカルプロジェクトを追加します。プロジェクトにフォルダーは必須ではありませんが、必要に応じて追加できます。
フォルダーを追加または変更するには、プロジェクトのメニューを開き、プロジェクトを編集を選択します。フォルダーを追加を選ぶと、複数のフォルダーを追加できます。ChatGPT は、追加したすべてのフォルダー内のファイルを読み取り、変更できます。既定の作業ディレクトリを変更するには、フォルダーにポインターを合わせ、プライマリに設定を選択します。
新しいチャットはプライマリフォルダーから始まります。Codex は、このフォルダーを Git 操作の既定のディレクトリとして使い、AGENTS.md、スキル、config.toml を自動検出します。ほかのフォルダーでもファイルの検索、読み取り、編集はできますが、Codex はそこにあるこれらのプロジェクトファイルを自動検出しません。
アプリとそのドキュメント、ウェブサイトとそのバックエンドなど、関連する作業の対象が異なる場所にある場合は、複数のフォルダーを使います。互いに関連のない作業や、各チャットのアクセス範囲をリポジトリの一部に限定したい場合は、プロジェクトを分けます。こうすると、作業に必要なコンテキストに絞れます。現在、リモートプロジェクトで使えるフォルダーは 1 つです。
ローカル環境では、プロジェクトのセットアップ手順やよく使うコマンドを定義できます。レビューペインには、同じプロジェクトに追加した複数のリポジトリの変更を表示できます。Pull request と Worktree の操作は、プライマリリポジトリが対象です。Worktree でチャットを始めても、ほかのフォルダーは引き続きプロジェクトに関連付けられています。
プロジェクトと Worktree は作業の整理に使います。ローカルコマンドが読み取りや変更を行える範囲や、ネットワーク経由でアクセスできる範囲を制限するのはサンドボックスです。
プロジェクトを使わないチャットの開始
Codex で新しいチャットを選択すると、プロジェクトを使わずにチャットを始められます。この項目は最近の項目の横にあります。プロジェクトの共有ファイルや指示、フォルダーへのアクセスが不要で、単独で完結する作業に適しています。複数のチャットで同じコンテキストを使う場合は、先にプロジェクトを作成します。
プロジェクトを使わないチャットの開始
プロジェクトの共有ファイル、指示、ソースが不要な場合は、ChatGPT のホームからチャットを始めます。Web 版では、Chat と ChatGPT Work のどちらを使ってもチャットが作成されます。
作業の規模が大きくなったら、チャットをプロジェクトに移し、目的がわかる名前をそれぞれに付けます。調査、草案作成、レビュー、フォローアップのチャットを同じプロジェクト内で並行して進めれば、すべてのメッセージが 1 つのコンテキストに混在することはありません。
クイックチャットでの簡単な質問
クイックチャットを使うと、通常の ChatGPT チャットが開きます。Codex のサイドバーには Codex のチャットとプロジェクトが表示されます。ChatGPT のチャットはここには表示されません。
新しいチャットにポインターを合わせ、右側にあるクイックチャットアイコンを選択します。キーボードからも開けます。
macOS では Cmd+Option+N を、Windows と Linux では Ctrl+Alt+N を押します。新しいチャットから既存の ChatGPT チャットを開き、Codex のチャットに追加することもできます。