MENU

Codexに既存プロジェクトを読み込ませるには?VS Codeで参照範囲を確認する

既存プロジェクトをCodexに見てもらう場合は、VS Codeで対象フォルダを開き、説明してほしいファイルや処理を指定するところから始めます。最初からプロジェクト全体の改修を頼む必要はありません。

ここでいう「読み込ませる」は、モデルを追加学習させることではなく、その作業に必要なコードを参照させることです。開いているファイルの文脈を使えるIDE拡張でも、全ファイルの内容を常に把握していると考えない方が、依頼を組み立てやすくなります。公式資料も、関連ファイルを開き、必要なコードを選んで説明を依頼する流れを紹介しています。S1S2

この記事は、Codex拡張の導入とログインが済んだVS Codeを対象にしています。入口の設定はCodexの導入・設定記事を参照してください。

目次

まず、作業するプロジェクトの根元を開く

PHPやLaravelなら、composer.json、アプリケーションのコード、テストなどが一緒に見えるフォルダを確認します。WordPressなら、調べたい対象がテーマなのか、独自プラグインなのか、サイト全体なのかを先に決めます。

たとえば自作のLaravelアプリを調べたいときに、作業場所が app/ の中だけだと、依存関係やテストの位置を捉えにくくなります。反対に、複数顧客のコードが置かれた親フォルダ全体を開くと、今回扱う範囲が曖昧になります。

調べたいこと 最初に用意する範囲 追加で参照するもの
Laravelの入力処理 対象ルート、Controller、Request 呼び出すService、関連テスト
WordPressの独自機能 対象プラグインや子テーマ 登録するフック、呼び出し元
PHPの小さな関数 対象関数と呼び出し例 入力条件、期待する出力

WordPress全体を対象にするときも、コア、親テーマ、独自コードを分けて扱います。変更したい機能の場所が分からない段階では、編集を頼むより、関係しそうなファイルと呼び出し経路の調査を依頼します。

既存コードを渡してよいか、開く前に確認する

顧客コードや勤務先のリポジトリは、アクセス権があることと、AIサービスで扱う許可があることを分けて考えます。契約、社内方針、利用するサービスのデータ管理条件を確認してください。許可が不明なら、そのまま参照させないことが先です。

特に、.env、認証用ファイル、データベースの書き出し、ログ、アップロード画像には、コードとは別の情報が混ざる場合があります。必要なファイルを選ぶ前に、これらを分離します。環境設定の説明が必要なら、実値を含まない自作の例に置き換えます。

.gitignore に書いたことだけを、AIからの読み取り防止策にはしません。これはGitの未追跡ファイルを無視するための指定で、S5Codexのアクセス権限そのものではありません。参照させない情報は作業用コピーに含めない、権限でアクセスを制限するなど、実際の境界を用意します。S3

作業コピーを使う場合も、Gitの履歴や添付資料に機密が残っていないか確認します。顧客名を伏せるだけで安全と判断せず、渡す内容そのものを減らしてください。

最初は「参照したファイルが分かる説明」を頼む

対象ファイルをVS Codeで開き、必要なら処理の一部を選択します。そのうえで、変更なしの説明を依頼します。IDE拡張は開いているファイルや選択したコードを文脈に使えますが、何を根拠に説明したかを返してもらうと、認識のずれを見つけやすくなります。S1S2

次は、架空のLaravelアプリを調べる依頼例です。

この作業は説明だけにしてください。ファイルの変更とコマンド実行は不要です。

対象は routes/web.php と app/Http/Controllers/OrderController.php です。
注文一覧が表示されるまでの呼び出し順を説明してください。
必要なら、呼び出し先のServiceと関連テストを読んでください。
.env、顧客データ、ログは参照しないでください。

回答には、実際に参照したファイル名と、未確認で判断できない点を含めてください。

この例のパスは説明用です。自分のプロジェクトに存在するファイルへ置き換えます。コードの名前から推測した説明と、実際に読んだ実装の説明を区別してもらうのが目的です。

返ってきた内容は、入口のルート、呼び出しているメソッド、データの取り方、画面へ渡す値をコードと照合します。説明が違っていたら、すぐに修正案を採用せず、どのファイルを見てそう判断したかを確認してください。

AGENTS.mdには、長く使う作業ルールを書く

毎回伝える規則は、プロジェクトの AGENTS.md に短くまとめられます。公式資料では、Codexのホームにある共通指示と、プロジェクトルートから作業ディレクトリまでの指示を組み合わせる仕組みが説明されています。同じ場所に AGENTS.override.md があれば、その階層ではそちらが優先されます。S4

自分のリポジトリに置く内容の例です。これはCodexへ渡す指示ファイルのサンプルで、既存のチームルールを置き換えるものではありません。

# このプロジェクトでの作業

- 最初の依頼では、対象ファイルを読んで影響範囲を説明する。
- public/ 以下の生成済みファイルは直接編集しない。
- 依存パッケージの追加やDB構造の変更は、理由を説明して相談する。
- テストは専用DBを使い、メール送信はテスト用の設定にする。
- コマンドの実行結果と、実行できなかった確認を分けて報告する。

このファイルは実行権限を制限する仕組みではありません。「触らない」と書くことに加え、サービス側の権限設定や作業用環境も必要です。指示を変えた場合は新しいセッションで開始し、読み込んだ指示の場所と内容を説明させると確認しやすくなります。S3S4

サブフォルダごとのルールを使う場合は、どのディレクトリを起点に作業しているかを意識します。全階層の指示が無条件でまとめて入るとは限りません。適用させたいファイルが読まれたかを確認してください。

説明の後に、変更してよい範囲を決める

最初の説明で構造が分かったら、修正対象、変えない動作、確認方法を伝えます。「このプロジェクトを良くして」と広く頼むより、一つの入口と一つの期待結果を示す方が、差分を確認しやすくなります。

たとえば、一覧画面の入力検証を直したいのに、認証、DB、画面構成まで同時に変える必要があるかは別の判断です。提案されたファイル数が増えた場合は、それぞれが必要な理由を確かめます。

コードの検証まで進める場合は、PHP・WordPressの既存コードをAIで改修する手順で、変更範囲と確認方法を整理できます。参照できたことを、そのまま安全に改修できる証拠にはしないようにします。

ファイルを認識しないときに確認する順序

  1. VS Codeで開いているフォルダと、対象ファイルの相対パスを照合する。
  2. Codexに作業場所と参照できたファイルを説明してもらう。
  3. 説明に必要なファイルを開き、必要な箇所を指定する。
  4. 権限で読めないのか、パスが違うのか、まだ参照していないのかを分ける。
  5. 直前の思い込みが残るなら、対象を絞った新しいチャットで確認する。

MacとWindowsで説明用の相対パスの考え方は共通です。WSLやリモート接続では、ローカルに同名のフォルダがあっても別の環境なので、接続先と作業場所を一緒に確認してください。

確認日:2026年11月17日。公式IDE拡張の文脈参照と指示ファイルの仕様を確認しています。本文のアプリ構成・依頼文は架空例です。顧客プロジェクトや各OSの画面で、この手順を実証したものではありません。

出典

  1. https://learn.chatgpt.com/docs/codex/ide OpenAI「Codex IDE extension」(確認日: 2026-11-17) ↩1 ↩2
  2. https://learn.chatgpt.com/docs/prompting OpenAI「Prompting Codex」(確認日: 2026-11-17) ↩1 ↩2
  3. https://learn.chatgpt.com/docs/permissions OpenAI「Permissions」(確認日: 2026-11-17) ↩1 ↩2
  4. https://learn.chatgpt.com/docs/agent-configuration/agents-md OpenAI「Custom instructions with AGENTS.md」(確認日: 2026-11-17) ↩1 ↩2
  5. https://git-scm.com/docs/gitignore Git「gitignore」(確認日: 2026-11-17) ↩1
よかったらシェアしてね!
  • URLをコピーしました!
目次