Codexを使うには｜プロジェクト追加エラーの解決と安全確認

結論：プロジェクト追加の前に作業目的を3段階へ分ける

プロジェクト追加の案内は、Codexそのものが利用できないと決まったことを意味しません。選んだ場所のファイルや文脈が必要な入口で、まだ対象が指定されていない可能性があります。最初に「質問へ答えてほしい」「手元の資料を読んでほしい」「コードを調べて変更してほしい」のどれかを決めましょう。

一般的な設計相談やエラー文の意味を聞くだけなら、まず新しい会話から始められる場合があります。仕様書や画面例を根拠に判断してほしい場合は、必要な資料だけを渡します。実際のコードを調査・変更してほしい場合に、対象を含むフォルダーまたはプロジェクトを選ぶ、という順序なら余計な範囲を渡さずに済みます。

画面名やボタンの位置は、アプリ、エディター、版によって変わることがあります。そのため、検索した文言だけを見て一つの手順に決めつけず、表示された製品名、現在の画面、やりたい作業の三つを確認することが解決の近道です。

Cline Code 0.0.4はフォルダーなしの会話を追加した

2026年7月24日に公開されたCline Codeデスクトップ版0.0.4では、プロジェクトフォルダーを開かずに会話を始められるようになりました。コードを開く前の相談を分ける変更です。

同版には、ファイルのドラッグ＆ドロップ、添付画像の本文内表示、初回案内、長い会話を収める既定の圧縮も追加されています（出典: https://github.com/cline/cline/releases/tag/desktop-v0.0.4 ）。

この変更から読み取れるのは、AIコーディングエージェントとの会話が、必ずしもコード変更から始まるとは限らないということです。要件の整理、エラー文の読み解き、実装方針の比較は、プロジェクト全体を開く前でも進められます。必要になった時点でファイルやフォルダーを渡せば、相談と実作業の境界が明確になります。

ただし、Cline Codeのフォルダーなし会話と、Codexで表示されるプロジェクト追加の案内は、別製品の別機能です。同じ画面や同じ挙動だとは断定できません。

本記事ではCline Codeの更新を「入口を目的別に選ぶ」という時事的な手掛かりとして扱い、Codexの操作はOpenAIの公式説明で確認できる範囲に限定します。確認できない違いは推測で補いません。

Codexで「プロジェクトを追加してください」と出たら確認すること

ChatGPTデスクトップアプリの公式説明では、作業場所を選ぶ段階で「会話を始める」「プロジェクトを作る」「フォルダーを開く」という入口が案内されています。選んだ場所のファイルと文脈を利用できるという説明です（出典: https://learn.chatgpt.com/docs/app ）。

同じ公式ページは、CodexではNew chatから始め、短い質問ならその右側にあるQuick chatを選ぶ手順も案内しています。短い相談の入口として示されています。

したがって、一般的な質問をしたいのにプロジェクト追加で止まった場合は、まず別の会話入口を選べるか確認する価値があります。ただし、現在のすべての環境で同じ表記になるとは限りません。

どの製品・入口・版で表示されたかを確認する

最初に、デスクトップアプリ、VS Codeなどのエディター、端末から使うCodexのどこで案内が出たかを確認します。検索時の前提になる重要な情報なので、必ず控えます。

見た目が似ていても、フォルダーの選び方や新しい会話の作り方は同じとは限りません。アプリ名と版、直前に押した項目、表示された文言を控えると、別の入口の手順を誤って試すことを防げます。

画面のスクリーンショットを共有する場合は、アカウント情報、最近開いたファイル名、組織名などが写っていないか確認してください。検索時はメッセージ全文だけでなく、「Codex デスクトップ」「VS Code」のように利用中の入口を加えると、対象に近い案内を見つけやすくなります。

プロジェクト追加が本当に必要な依頼かを確認する

「このエラー文は何を意味するか」「設計案AとBの違いは何か」のような一般的な質問は、手元のコードを読まなくても答えられます。一方、「このリポジトリでエラーの原因を探して」「この関数を変更して」と依頼するなら、対象コードがある場所をCodexへ示す必要があります。

迷ったときは、まずファイルを扱わない会話として質問し、回答に手元の情報が必要だと分かった段階で資料またはフォルダーを追加します。この順序なら、相談のためだけに大きなリポジトリを開くことを避けられます。

会話・資料確認・コード作業に合う入口を選ぶ

入口は製品名ではなく、Codexに何を根拠として使ってほしいかで選びます。一般知識だけで答えられるなら会話、限定した文書が必要なら資料、複数ファイルの関係を調べて変更するならコードを含むフォルダーが候補です。判断を次の三段階に分けると、必要以上の情報を渡しにくくなります。

会話だけで始める

会話に向くのは、用語の説明、設計方針の比較、エラーメッセージの一般的な意味、調査手順の相談です。手元のコードを根拠にしないため、回答は仮説や一般論になることがあります。その点を理解したうえで、最初の確認事項を洗い出す入口として使うと効果的です。

たとえば、次のように「まだファイルを扱わない」と明示すれば、相談と調査を分けられます。回答の前提が明確になり、情報を追加するタイミングも判断しやすくなります。特に初回の相談で有効です。

まだファイルは読み書きしないでください。
このエラー文の意味と、確認する順番だけを説明してください。

必要な資料だけを読ませる

仕様書、ログ、画面例、設定の説明文など、限られた情報だけで判断できる場合は、その資料だけを渡します。資料名と知りたいことを指定し、ほかの情報を推測で補わないよう依頼すると、回答の根拠を追いやすくなります。画像を渡す場合も、注目してほしい場所を文章で示しましょう。

資料確認の段階では、内容の要約や不足情報の指摘までに留め、コード変更は別の依頼に分けます。資料から実装へ進む前に「どのコードが関係するか」を説明させれば、不要なフォルダーを追加せずに対象を選べます。

docs/setup.mdだけを読み、前提条件を3点にまとめてください。
まだコードは変更しないでください。

コード作業では対象フォルダーを明示する

定義と参照の調査、複数ファイルにまたがる修正、テストによる確認には、対象コードを含むフォルダーが必要です。フォルダーを選んだら、読んでよい範囲、変更の目的、完了条件を最初に伝えます。「全部直して」ではなく、小さな調査から始めるのがポイントです。

最初の依頼では、関連ファイルの候補と理由を報告させ、編集を待たせます。期待した場所を読めていると分かった後に変更へ進めば、別機能や生成物を巻き込む危険を抑えられます。

app/loginだけを調べ、変更候補と影響範囲を説明してください。
確認後に編集へ進みます。

フォルダーを追加する前の安全確認

フォルダーは「Codexに見せたいファイルが入っている最小の場所」から選びます。PC全体、利用者フォルダー、関係のない案件をまとめた上位フォルダーを選ぶ必要はありません。対象が広いほど、検索結果へ無関係なファイルが混ざり、依頼の意図と違う場所を読む可能性が高まります。

追加前には、機密情報、個人情報、認証情報、顧客データ、大きな生成物や依存パッケージが含まれていないか確認します。必要な情報が一部だけなら、共有用の小さな資料へ整理するか、対象を限定できるフォルダーを選びます。組織の規則がある場合は、その規則を優先してください。

次の5項目を順番に確認すると、対象を広げる判断がしやすくなります。一つでも説明できない項目があれば、追加前に対象をもう一段狭めてください。無理に進める必要はありません。

1. 今回の質問にローカルファイルが本当に必要か
2. 必要なファイルがどのフォルダーに入っているか
3. 関係のない案件や機密情報が含まれていないか
4. 最初は読み取りだけで確認できるか
5. 変更する場合の対象と完了条件を一文で説明できるか

追加後は「どのファイルを読んだか」「対象外の場所を見ていないか」を報告させます。期待した範囲と一致しない場合は、そのまま変更を頼まず、プロジェクトまたはフォルダーの選択を見直します。

プロジェクト追加エラーを小さく切り分ける

プロジェクトを選んでも案内が繰り返される場合は、一度に設定を変えず、表示場所、選択内容、再現手順を分けて確認します。問題の起点を特定しやすくするために重要です。

まず新しい会話を作れるか、次に小さな検証用フォルダーを開けるか、最後に目的のフォルダーだけで同じ現象が起きるかを見ます。これでアプリ全体の問題か、特定フォルダーに限る問題かを切り分けられます。

フォルダーの選択画面が開かない、選んだ場所が一覧へ反映されない、会話を送ると案内が出る、という現象は同じではありません。発生した段階を記録し、画面に表示されたエラー文をそのまま控えてください。案内を言い換えて検索すると、別の問題向けの手順へ誘導されることがあります。

小さな検証用フォルダーで入口を確かめる

既存案件を使う前に、機密情報を含まない検証用フォルダーを用意し、短いテキストファイル一つだけで読み取りを試す方法があります。Codexにファイル名と先頭行を答えさせれば、選んだ場所が認識されているかを変更なしで確認できます。成功したら、目的の案件でも同じ入口を使い、まず読み取りだけを依頼します。

検証用フォルダーでも失敗する場合は、現在のアプリ名と版、OS、操作手順、表示文言をそろえて公式案内を確認します。目的の案件だけで失敗する場合は、フォルダーの場所、アクセス範囲、ファイル構成の違いを一つずつ調べます。未確認の設定をまとめて変えないことが重要です。

複数フォルダー・アプリ全体像・画像入力の記事との使い分け

本記事が扱うのは、開始時の案内を見て「会話、資料、コードのどこから始めるか」を決めるところまでです。関連リポジトリを一つのローカルプロジェクトで扱う場合は、Codex複数リポジトリ｜主・副フォルダーの使い分けと設定確認で、主フォルダーと副フォルダーの役割を確認してください。

デスクトップアプリ、エディター、端末から使う方法の全体像を先に知りたい場合は、Codexアプリとはが対象です。どの入口を使っているか自体が分からないときは、全体像を確認してから本記事の判断手順へ戻ると迷いにくくなります。

画像を使った具体的な質問方法は、Codexの画像入力とマルチモーダル機能で扱っています。画像一枚の確認なら資料追加、画面に対応するコードの調査まで必要ならフォルダー追加というように、目的に応じて段階を進めてください。

まとめ：相談から始め、必要な範囲だけ追加する

「Codexを使用するにはプロジェクトを追加してください」と表示されたら、まず利用中の入口を確認し、一般的な会話、資料確認、コード作業のどれをしたいか決めます。相談だけなら新しい会話、限定した根拠が必要なら資料、コードの調査や変更が必要なら対象フォルダーという順序が基本です。

フォルダーは最小限から選び、最初は読み取りだけを依頼します。期待したファイルが見つかり、対象外の場所を見ていないことを確認してから変更へ進みましょう。この順序を守ってください。

画面表記や入口が異なる場合は、推測で操作を広げず、ChatGPTデスクトップアプリの公式説明（https://learn.chatgpt.com/docs/app ）で現在の案内を確認してください。