codex ファイル参照で詰まる人へ、@指定・AGENTS.md・フォルダ参照のモヤモヤを全部ほどく使い方ガイド

codex ファイル参照で検索している人の多くは、「@でファイルを指定できるらしいけど、どこまで読ませられるのか」「フォルダ全体は参照できるのか」「VS Code拡張とCLIでは何が違うのか」といった疑問を持っているはずです。Codexは便利な一方で、参照範囲・作業ディレクトリ・AGENTS.md・config.toml・権限設定の関係が少しわかりにくく、最初につまずきやすいツールでもあります。

この記事では、2026年5月24日時点で確認できる情報をもとに、Codex CLIとCodex IDE extensionにおけるファイル参照の考え方を整理します。@によるファイル指定、AGENTS.mdによる継続的な指示、VS Codeで開いているファイルの扱い、フォルダ参照の代替策、さらに「codex 入門」「codex のインストール方法は？」「codex スライド作成」といった関連ニーズまで、初めての人にもわかるようにまとめます。

この記事のポイント
✅ codex ファイル参照は、まず@で個別ファイルを明示するのが基本
✅ フォルダ全体を雑に投げるより、対象範囲と目的を絞るほうが安定しやすい
✅ AGENTS.mdは毎回守ってほしい前提、プロンプトは今回だけの作業範囲に使う
✅ CLI・IDE・ChatGPTプロジェクトの違いを理解すると、参照ミスを減らしやすい

今日のセールをまとめてチェック！

本日のセール・タイムセールをまとめてチェックできます。

Amazon

楽天市場

Yahooショッピング

メルカリ

ポチップ

codex ファイル参照の基本と最初につまずきやすいポイント

codex ファイル参照の答えは@で対象ファイルを明示すること
codex 入門では参照範囲を小さくして始めること
codex のインストール方法はnpmか環境に合う導入手順を選ぶこと
AGENTS.mdは毎回読ませたい前提を置く場所であること
VS Code拡張では開いている作業フォルダが参照の起点になること
フォルダ全体を参照したい時は目的別にファイルを絞ること

codex ファイル参照の答えは@で対象ファイルを明示すること

codex ファイル参照で最初に押さえたい結論は、プロンプト内で @path/to/file のように書き、読ませたいファイルを明示するという使い方です。Codex CLIでは、@キーを使ったファイル検索が紹介されており、ワークスペースのルートを基準にファイル名を探して指定できます。

たとえば、@src/components/Header.tsx の表示崩れを直して のように書くと、Codexに「今回このファイルを見てほしい」という意図が伝わりやすくなります。単に「ヘッダーを直して」と頼むより、対象が明確になるため、余計なファイルに触れる可能性も下げやすくなります。

ただし、@指定は「そのファイルだけを必ず触る」という強制ではなく、参照してほしい文脈を明示する手段と考えるほうが自然です。必要に応じてCodexが周辺ファイルを読むことはあります。そのため、変更範囲を絞りたい場合は「指定ファイル以外は編集しない」「関連ファイルは読むだけにする」といった一文も加えるのがおすすめです。

📌 基本の指定例

目的	プロンプト例
1ファイルを読ませる	`@src/utils/date.ts の処理を説明して`
1ファイルだけ直す	`@src/app/page.tsx の文言だけ修正して。挙動は変えないで`
テスト対象を指定する	`@src/utils/date.ts のユニットテストを追加して`
差分確認前提で頼む	`@src/components/Button.tsx を読み、最小変更で修正案を出して`

特に初心者がやりがちなのは、「このプロジェクトをいい感じに直して」と広く依頼してしまうことです。Codexはコード全体を見て判断できる分、良かれと思って周辺の整理まで進める場合があります。これは便利な場面もありますが、慣れていないうちは変更範囲が広がって不安になりやすいです。

そのため、codex ファイル参照の最初の型は、対象ファイル・やってほしいこと・やらないことの3点セットで書くのが実用的です。

🧭 最初に使いやすいプロンプトの型

要素	書く内容
対象	`@ファイルパス`
作業	何を直すか、何を説明するか
制限	指定ファイル以外は編集しない、挙動を変えない等
確認	変更後に実行してほしいテストや確認方法

参考情報では、Codex CLIの機能として「@でファイルをメンションする」使い方が紹介されています。
出典: https://zenn.dev/dely_jp/articles/codex-cli-matome

まとめると、@はCodexにファイルを読ませるための入口です。ただし、ファイル参照だけで作業範囲が完全に固定されるわけではないため、「どこを見て、どこまで触ってよいか」までセットで伝えることが、失敗を減らすコツです。

codex 入門では参照範囲を小さくして始めること

codex 入門で大事なのは、いきなり大きなリファクタリングや複数ファイル編集を任せないことです。Codexはエージェントとしてファイルを読み、編集し、コマンドを実行できますが、最初から広い範囲を任せると、何が起きたのか追いにくくなります。

最初は、1ファイルの説明、1ファイルの軽微な修正、1つのテスト追加くらいから始めるのが無難です。これは技術的に弱い使い方という意味ではありません。むしろ、Codexがどのようにファイルを読み、どのように修正し、どのタイミングでコマンド実行を提案するのかを理解するための大事なステップです。

🧩 codex 入門でおすすめのタスク

難易度	タスク例	理由
低	`@README.md を要約して`	編集なしで挙動を確認できる
低	`@utils.ts の関数を説明して`	ファイル参照の動きをつかみやすい
中	`@Button.tsx の文言だけ変えて`	小さな編集を試せる
中	`@date.ts のテストを追加して`	テスト実行まで体験できる
高	複数画面の改修	影響範囲が広く、最初は追いにくい

入門段階では、Codexのモードや権限も重要です。調査した情報では、作業ディレクトリ内の読み取り・編集・コマンド実行を許可しつつ、外部アクセスや作業ディレクトリ外の操作は承認を求める進め方が紹介されています。おそらく多くの人にとって、このバランスが最初に扱いやすい設定です。

また、Codexを使う時は「チャット相手」ではなく「作業者」として見ると理解しやすくなります。作業者に依頼するなら、対象ファイル・ゴール・禁止事項を伝えるはずです。Codexにも同じように伝えると、余計なズレが減ります。

📝 入門用プロンプト例

シーン	そのまま使える例
説明してほしい	`@src/utils/date.ts を初心者にもわかるように説明して。編集はしないで`
軽微に直したい	`@src/components/Header.tsx の表示文言だけ変更して。CSSやロジックは触らないで`
テストしたい	`@src/utils/format.ts の正常系と異常系のテスト案を先に列挙して。まだ実装しないで`
レビューしたい	`@src/api/client.ts をレビューして。重大な不具合候補だけ指摘して`

ここで重要なのは、「まだ実装しないで」「まず案だけ出して」も有効な指示だという点です。Codexは作業を進める力が強いため、相談だけしたい時は相談だけと明示したほうが安心です。

Codex入門の記事では、最初はローカル環境で小さなタスクから始め、対象ファイルや触ってよい範囲を明示する考え方が紹介されています。
出典: https://kdl-di.hatenablog.com/entry/2026/01/29/160853

つまり、codex 入門の最短ルートは「すごいことを一気にやらせる」ではありません。小さいファイル参照から始めて、Codexがどう動くかを観察することです。これができると、複数ファイル編集やテスト修正にも自然に広げられます。

codex のインストール方法はnpmか環境に合う導入手順を選ぶこと

codex のインストール方法は、調査した範囲ではnpmによる導入がよく紹介されています。代表的なコマンドは npm install -g @openai/codex です。macOSではHomebrewの例もありますが、Windowsや既存のNode.js環境ではnpmのほうが見かける機会が多いかもしれません。

ただし、インストール手順は環境によって変わる可能性があります。2026年5月24日時点でも、Codex CLIやIDE拡張は更新され続けているため、実際に導入する時は公式情報を確認するのが安全です。ここでは、提供された調査情報に基づき、考え方を整理します。

⚙️ 導入方法の比較

方法	向いている人	備考
npm	Node.js環境がある人	`npm install -g @openai/codex` の形で紹介されている
Homebrew	macOSユーザー	`brew install codex` の例がある
VS Code拡張	エディタ内で使いたい人	マーケットプレイスから導入する流れ
ChatGPT内のCodex	クラウドで任せたい人	ローカルCLIとは利用感が異なる

インストール後は、ChatGPTアカウントでサインインして使う流れが紹介されています。以前はAPIキー前提の印象が強かったようですが、調査情報ではChatGPTプランと紐付けて使う説明が複数見られました。ただし、プランごとの利用条件や制限は変わる可能性があるため、ここは最新の公式画面で確認するのがよいでしょう。

🔐 最初に確認したい設定項目

設定	何を見るか
ログイン状態	ChatGPTアカウントでサインインできているか
作業ディレクトリ	Codexがどのフォルダを見ているか
サンドボックス	編集できる範囲がどこまでか
承認モード	コマンド実行や外部アクセスで確認が出るか
AGENTS.md	共通ルールが読み込まれているか

ファイル参照でつまずく人は、インストールそのものよりも、Codexがどのフォルダを作業ルートとして見ているかで詰まりがちです。@でファイルを探しても出てこない場合、作業ディレクトリが想定と違う可能性があります。

Codex CLIでは、--cd や -C のように作業ディレクトリを指定する考え方も紹介されています。つまり、Codexを起動する場所を間違えると、参照したいファイルが候補に出ないことがあります。

Codex CLIのクイックスタートでは、codex、codex "..."、codex exec "..." といった使い方や、--cd オプションに触れられています。
出典: https://note.com/npaka/n/n7b6448020250

導入直後にやるべきことは、難しい設定を全部理解することではありません。まずは小さなリポジトリやテスト用フォルダでCodexを起動し、@で目的のファイルが見えるかを確認することです。これだけでも、ファイル参照まわりの混乱はかなり減らせます。

AGENTS.mdは毎回読ませたい前提を置く場所であること

AGENTS.mdは、Codexに毎回守ってほしい前提や作業ルールを書いておくファイルです。調査情報では、グローバル、リポジトリルート、作業ディレクトリなど、複数階層のAGENTS.mdを上からマージして使う考え方が紹介されています。

ファイル参照とAGENTS.mdは役割が違います。@は「今回このファイルを見て」と伝えるものです。一方、AGENTS.mdは「このプロジェクトでは常にこう動いて」と伝えるものです。毎回プロンプトに書くと長くなるルールは、AGENTS.mdに置くと扱いやすくなります。

📁 @指定とAGENTS.mdの違い

仕組み	役割	例
@ファイル参照	今回読ませたいファイルを指定	`@src/app/page.tsx を修正して`
AGENTS.md	常に守る前提やルールを書く	テストコマンド、編集方針、禁止事項
config.toml	Codex自体の設定を書く	モデル、推論、MCP、検索など
プロンプト	今回だけの作業範囲を書く	「文言だけ変更」「削除禁止」など

AGENTS.mdに書く内容は、長ければよいわけではありません。むしろ、Codexが毎回読む前提なので、短く・具体的に・迷わない書き方が向いています。たとえば「勝手に大幅リファクタしない」「テストはこのコマンドで実行する」「外部API送信は確認する」などです。

🧾 AGENTS.mdに書きやすい内容

カテゴリ	書く例
プロジェクト前提	このアプリの目的、主要ディレクトリ
実装方針	既存パターンに合わせる、YAGNIを守る
テスト方法	`npm test`、`pytest` など
禁止事項	無関係なリファクタ禁止、削除禁止
報告形式	変更点、確認結果、残課題を短く報告

AGENTS.mdは、Codexだけでなく複数のAIツールが参照する共通指示として扱われることもあります。そのため、チームや複数エージェントで作業する場合にも便利です。おそらく今後は、READMEと同じくらい「AIに作業してもらうための説明書」として重要になる場面が増えるかもしれません。

注意点として、AGENTS.mdに何でも詰め込みすぎると、今回の作業に関係ない制約まで影響する可能性があります。常に守るルールはAGENTS.md、今回だけのルールはプロンプト、と分けるのが実務的です。

OpenAIのCodex紹介記事では、リポジトリ内のAGENTS.mdによって、コードベースの進み方やテストコマンド、プロジェクト慣習を伝えられると説明されています。
出典: https://openai.com/index/introducing-codex/

codex ファイル参照で安定した結果を得たいなら、@指定だけに頼らず、AGENTS.mdで土台を作るのが近道です。@は今回の地図、AGENTS.mdは常設のルールブックと考えるとわかりやすいでしょう。

VS Code拡張では開いている作業フォルダが参照の起点になること

Codex IDE extensionを使う場合、CLIとは少し感覚が変わります。VS Code拡張では、エディタ内で開いているファイルやワークスペースを前提に作業できます。そのため、CLIで毎回@指定するよりも、自然に文脈を渡しやすい場面があります。

ただし、VS Codeでワークスペースフォルダを開いていない場合、Codexがどのフォルダを対象にすればよいかわからず、実行できないことがあります。調査情報でも、ワークスペースにフォルダを登録してから実行できるようになった例が紹介されています。

🖥️ CLIとVS Code拡張の違い

項目	Codex CLI	Codex IDE extension
起点	ターミナルの作業ディレクトリ	VS Codeのワークスペース
ファイル指定	@で明示しやすい	開いているファイル文脈を使いやすい
差分確認	CLI上で確認	エディタ上で確認しやすい
初心者向き	慣れると強い	視覚的にわかりやすい
注意点	起動場所を間違えやすい	フォルダ未指定だと動きにくい

VS Code拡張のメリットは、ファイルを見ながら依頼できることです。たとえば、今開いているコンポーネントに対して「このボタンの見た目だけ整えて」と依頼し、差分をその場で確認できます。コマンドラインに慣れていない人には、こちらのほうが心理的なハードルが低いかもしれません。

一方で、VS Code拡張でも参照範囲の指定は大切です。「この画面を改善して」だけでは、どのファイルに手を入れるかが広がる可能性があります。開いているファイルがあるとしても、「このファイル中心」「関連CSSは必要なら読むだけ」などの制約を添えると、作業が安定しやすくなります。

🧠 VS Code拡張での頼み方例

状況	依頼例
開いているファイルを直す	`今開いているファイルの表示文言だけ修正して`
複数ファイルを見てほしい	`このコンポーネントと関連CSSを確認し、最小変更で直して`
画像から作りたい	`添付画像に近いHTML/CSSを作って。既存ファイルは触らないで`
テストも見たい	`変更後に関連テストを実行し、失敗したら原因を説明して`

調査情報では、Codex IDE extensionを使い、画像を元にHTML/CSSを作らせる試行も紹介されていました。つまり、単なるファイル参照だけでなく、画像や開いているファイルの文脈を使った作業も視野に入ります。ただし、生成結果の精度はタスクや素材によるため、確認と修正は必要です。

Codex IDE extensionの試用記事では、VS Codeでワークスペースフォルダを登録した後に処理を実行できるようになった流れが紹介されています。
出典: https://qiita.com/youtoy/items/e5c8732340a483633257

結論として、VS Code拡張は「見ながら頼む」用途に向いています。CLIは「作業ディレクトリを決めて、エージェントとして任せる」用途に向いています。どちらでも、ファイル参照の基本は対象・目的・制限を言葉にすることです。

フォルダ全体を参照したい時は目的別にファイルを絞ること

codex ファイル参照でよくある疑問が、「ファイルではなくフォルダ全体を参照できるのか」です。提供された調査結果にはRedditのURLも含まれていますが、本文は確認待ちページの情報しかありません。そのため、ここでは断定を避けます。少なくとも調査本文から明確に言えるのは、@によるファイル参照は紹介されている一方で、フォルダ全体参照の詳細は十分に確認できないという点です。

実務的には、フォルダ全体を丸ごと読ませるよりも、目的に合わせて代表ファイルを指定するほうが安定しやすいです。たとえば「認証まわりを理解して」なら、authフォルダ全体ではなく、入口ファイル・設定ファイル・主要なサービスファイルを指定します。

📦 フォルダ全体を読みたい時の代替策

やりたいこと	おすすめの指定
構造を知りたい	`このフォルダ構成を調べて概要を出して`
主要処理を知りたい	エントリーポイントやREADMEを@指定
バグを直したい	エラーが出ているファイルとログを指定
リファクタしたい	まず対象ファイル一覧を出させる
テスト追加したい	実装ファイルと既存テストを指定

フォルダ全体を指定したい気持ちは自然です。人間から見ると「この機能一式を見て」と言いたくなります。ただ、AIにとっては、情報量が増えすぎると焦点がぼやけることがあります。結果として、今回必要ないファイルまで読んだり、余計な変更を提案したりする可能性があります。

そこでおすすめなのが、2段階に分ける方法です。最初に「この機能に関係するファイルを調べ、編集候補を一覧化して。まだ編集しないで」と依頼します。その後、候補を見てから「この3ファイルだけ修正して」と進めると、参照範囲をコントロールしやすくなります。

🪜 2段階プロンプトの例

段階	プロンプト
調査	`認証機能に関係するファイルを調べて、編集候補を一覧にして。まだ編集しないで`
絞り込み	`候補のうち @src/auth/login.ts と @src/auth/session.ts だけを対象にして`
実装	`挙動を変えずにエラーハンドリングだけ改善して`
確認	`関連テストを実行し、結果を短く報告して`

このやり方は、Codexに限らずAIエージェント全般で使いやすい進め方です。いきなり全体を編集させるのではなく、まず調査、次に対象決定、最後に編集という流れにすると、ユーザー側も判断しやすくなります。

また、AGENTS.mdに「大きな変更は先に計画を出す」「5ファイル以上変更する場合は事前に確認する」と書いておくのも有効です。フォルダ参照の代替として、作業プロセスを制御するイメージです。

つまり、フォルダ全体を参照したい時の正解は、単にフォルダを投げることではありません。まず全体像を調べさせ、次に編集対象を絞ることです。このほうが、結果的に早く、怖さも少なくなります。

忘れる前に！【ふるさと納税】今年もお得に！

ふるさと納税のポイント付与は2025年10月に廃止になりました。

Amazon

楽天市場

Yahooショッピング

メルカリ

ポチップ

codex ファイル参照を実務で安定させる設定と応用

config.tomlでは検索・MCP・推論などの土台を整えること
サンドボックスと承認設定で触れる範囲を決めること
ChatGPTプロジェクトは長期文脈の整理に向いていること
codex スライド作成は資料ソースを明示して進めること
テストやレビューでは成功条件を先に言語化すること
WordPressや外部ファイルを扱う時は公式情報とバックアップを優先すること
総括：codex ファイル参照のまとめ

config.tomlでは検索・MCP・推論などの土台を整えること

Codex CLIを継続的に使うなら、~/.codex/config.toml の理解も避けて通れません。config.tomlは、モデル、推論の強さ、通知、MCP、Web検索など、Codexの基本設定を置くファイルとして紹介されています。

ファイル参照だけなら@指定で始められますが、調査や外部情報が必要な作業では設定が関係してきます。たとえばWeb検索機能は、設定で有効化する例が紹介されています。ただし、設定キーの形式は記事によって表記が異なる部分もあり、バージョン差がある可能性があります。実際に使う時は、現在のCodex CLIの公式ドキュメントや手元のヘルプを確認するのが無難です。

🛠️ config.tomlで扱われる主な項目

項目	役割
model	使用するモデルを指定
model_reasoning_effort	推論の強さを指定
hide_agent_reasoning	reasoning表示を抑える設定例
notify	タスク完了通知
mcp_servers	MCPサーバー設定
web_search	Web検索系の設定

MCPは、外部ツールや情報源をCodexから使うための仕組みとして紹介されています。CodexではJSONではなくTOML形式で設定する点が特徴です。たとえばContext7やFigmaのようなMCPを接続する例が紹介されていますが、stdio通信やラッパーの話も出てくるため、初心者はまず必須設定ではなく「必要になったら触る領域」と考えてよいでしょう。

🔌 MCP設定の考え方

利用目的	MCPが役立つ可能性
ライブラリ情報を引きたい	ドキュメント参照MCP
デザインを参照したい	Figma系MCP
社内ツールとつなぎたい	専用MCP
まずファイルを直したい	MCPなしでも始められる

config.tomlで気をつけたいのは、設定を増やしすぎることです。最初から通知、検索、MCP、推論、プロファイルを全部整えようとすると、Codex本体より設定で疲れます。まずはログイン、作業ディレクトリ、ファイル参照、承認モードの確認からで十分です。

一方で、調査を含む作業が多い人はWeb検索設定が重要になります。Codexが外部情報を参照できない状態だと、ローカルファイルと与えられた文脈だけで判断するため、最新情報が必要なタスクではズレが出るかもしれません。

Codex CLIの設定例では、config.toml にモデル、推論、Web検索、MCPサーバーなどを記述する例が紹介されています。
出典: https://zenn.dev/dely_jp/articles/codex-cli-matome

結論として、config.tomlはCodexの「作業環境設定」です。@によるファイル参照が現場の指示だとすれば、config.tomlは作業者に渡す道具箱です。最初は最小限で始め、必要に応じて検索やMCPを足すのが扱いやすいでしょう。

サンドボックスと承認設定で触れる範囲を決めること

Codexを使う時に怖さを感じる原因の多くは、「どこまで勝手に触るのかわからない」ことです。そこで重要になるのが、サンドボックスと承認設定です。サンドボックスは、Codexが読み書きできる範囲を制限する仕組みと考えるとわかりやすいです。

調査情報では、読み取り専用、ワークスペース書き込み、フルアクセスに近い設定など、複数の組み合わせが紹介されています。一般的には、最初からフルアクセスにするより、作業ディレクトリ内は許可し、外部アクセスやネットワークは確認する形が扱いやすいです。

🔒 サンドボックス設定の考え方

モードの考え方	できること	向いている場面
読み取り中心	ファイルを読む、説明する	初回調査、レビュー
ワークスペース書き込み	作業フォルダ内を編集	通常の実装作業
承認つき実行	必要時に確認して進める	安全に進めたい作業
フルアクセス系	広範囲に操作	慣れてから慎重に検討

ファイル参照とサンドボックスは別物ですが、実務では強く関係します。@で指定したファイルがワークスペース外にある場合、読めない・編集できない可能性があります。また、ネットワークアクセスが無効なら、外部ドキュメントを見に行く作業はできない場合があります。

🧯 怖さを減らすプロンプト例

不安	追加するとよい一文
勝手に編集されそう	`まず調査だけ。編集はしないで`
変更範囲が広がりそう	`指定ファイル以外は編集しないで`
ファイル削除が怖い	`ファイル削除は禁止`
コマンド実行が不安	`実行前にコマンドと目的を説明して`
外部通信が不安	`外部API送信やデプロイは行わないで`

特に、外部API送信、デプロイ、DBマイグレーションのような操作は、事前確認を入れる運用が安心です。Codexは便利ですが、実行力のあるツールなので、作業の境界線を決めておくほど使いやすくなります。

Codex CLIのクイックスタートでは、--sandbox workspace-write や --ask-for-approval など、サンドボックスと承認に関する考え方が紹介されています。
出典: https://note.com/npaka/n/n7b6448020250

また、作業途中のコードを消そうとする問題にも注意が必要です。Codexは完成形に近づけようとして、不要に見えるコメントやTODOを消す場合があります。途中段階のコードを残したい時は、「コメントアウトやTODOは残す」「削除ではなく提案に留める」と指示するとよいでしょう。

サンドボックスは、Codexを縛るためだけの仕組みではありません。むしろ、安心して任せるための境界線です。参照するファイル、編集してよい範囲、実行してよいコマンドを分けて考えると、Codexの扱いはかなり楽になります。

ChatGPTプロジェクトは長期文脈の整理に向いていること

codex ファイル参照を調べている人の中には、ChatGPTのプロジェクト機能と混同している人もいるかもしれません。ChatGPTプロジェクトは、チャット、ファイル、指示を1か所にまとめるためのワークスペースです。Codex CLIの@参照とは別の仕組みですが、長期的な作業文脈を整理する用途では関係があります。

ChatGPTプロジェクトでは、ファイルを追加したり、プロジェクト指示を設定したりできます。調査情報では、プロジェクト内のチャットやファイルを文脈として使えること、プロジェクト専用メモリの考え方、共有プロジェクトの扱いなどが説明されています。

🗂️ Codex CLIとChatGPTプロジェクトの違い

項目	Codex CLI	ChatGPTプロジェクト
主な用途	ローカルコードの読解・編集・実行	長期作業の文脈整理
ファイル参照	@でローカルファイルを指定	プロジェクトにファイルを追加
編集	ローカルファイルを変更できる	基本はチャット上の作業
指示	AGENTS.mdやプロンプト	プロジェクト指示
向いている場面	実装、テスト、修正	調査、企画、資料整理

たとえば、開発方針や仕様メモをChatGPTプロジェクトにまとめ、実装作業はCodex CLIで行う、という使い分けが考えられます。プロジェクト機能は「長く続く文脈」を保つ場所、Codex CLIは「実際にコードを触る場所」と見ると理解しやすいです。

📚 使い分けの例

やりたいこと	向いている場所
仕様書を整理する	ChatGPTプロジェクト
ローカルコードを修正する	Codex CLI
画像や資料をもとに案を出す	ChatGPTプロジェクトまたはIDE
テストを実行して直す	Codex CLI
チームで文脈を共有する	共有プロジェクト

ただし、プロジェクトに追加したファイルと、ローカルリポジトリ内のファイルは同じものではありません。ChatGPTプロジェクトに資料を置いたからといって、Codex CLIが自動的にローカルファイルとして参照できるとは限りません。ここを混同すると、「読ませたはずなのに伝わっていない」というズレが起きます。

OpenAI Help Centerでは、ChatGPTのプロジェクトを、チャット・参照ファイル・カスタム指示をまとめるワークスペースとして説明しています。
出典: https://help.openai.com/ja-jp/articles/10169521-projects-in-chatgpt

ファイル参照の観点では、短期作業は@、継続ルールはAGENTS.md、長期文脈はChatGPTプロジェクト、という分け方がわかりやすいです。どれも「AIに文脈を渡す」仕組みですが、目的が違います。

つまり、Codexのファイル参照だけで全てを解決しようとしなくてもよいということです。資料、仕様、コード、実行環境を分けて管理すると、Codexへの依頼も自然に整理されます。

codex スライド作成は資料ソースを明示して進めること

関連検索ワードに「codex スライド作成」があります。Codexは主にコーディングエージェントとして紹介されていますが、HTML/CSSでスライド風ページを作る、Markdown資料を整える、プレゼン用の構成案を作る、といった用途に使われる可能性はあります。ただし、専用のスライド作成ツールではないため、期待値の置き方が大切です。

codex スライド作成で重要なのも、やはりファイル参照です。既存の資料、README、調査メモ、画像、デザイン参考などを明示しないと、Codexは一般的な構成で作るしかありません。資料の正確性が必要な場合は、元ファイルを指定して「この内容だけを使って」と伝えるのが安全です。

🎞️ Codexでスライド作成を頼む時の材料

材料	参照方法の例
既存メモ	`@docs/research.md を元に`
README	`@README.md の内容を初心者向けに`
画像	IDEや画像入力が使える環境で添付
デザインCSS	`@styles/theme.css に合わせて`
発表時間	`5分発表用に10枚以内`

たとえば、Markdownからスライド原稿を作るなら、@docs/research.md をもとに、10枚構成のスライド見出しと本文を作って。事実はこのファイルの範囲に限定して と頼むと、話が広がりすぎにくくなります。

🧭 スライド作成プロンプト例

目的	プロンプト例
構成案	`@docs/research.md をもとに、10枚のスライド構成案を作って`
原稿化	`各スライドに見出し1つ、本文3行以内でまとめて`
HTML化	`@slides.md をもとに、1枚ずつ表示するHTML/CSSを作って`
デザイン調整	`@styles/theme.css の色に合わせてスライドCSSを整えて`

注意したいのは、Codexに「いい感じのスライドを作って」と頼むだけでは、内容の根拠が弱くなる可能性があることです。体裁は整っても、情報の出どころが曖昧だと、実務資料としては使いづらくなります。

また、スライド生成には画像やデザインの扱いも関係します。Codex IDE extensionでは画像をもとにHTML/CSSを作る試行が紹介されていますが、完全再現を期待するより、初稿を作って修正していく使い方が現実的です。

Codex IDE extensionの試用記事では、画像を元にHTML/CSSを作成する依頼の流れが紹介されています。
出典: https://qiita.com/youtoy/items/e5c8732340a483633257

codex スライド作成で成功させるコツは、資料ソースを明示し、出力形式を決め、1回で完成を狙いすぎないことです。ファイル参照を使って根拠を固定し、構成、本文、デザインを段階的に進めると、実用的な資料に近づきます。

テストやレビューでは成功条件を先に言語化すること

Codexにテスト作成やコードレビューを頼む時も、ファイル参照は重要です。ただし、単に対象ファイルを指定するだけでは足りないことがあります。なぜなら、Codexが「現在の実装が通るテスト」を優先して書く可能性があるからです。

テストで大事なのは、実装に合わせることではなく、守りたい仕様を確認することです。そのため、先に「正常系」「異常系」「境界値」「失敗時の挙動」を列挙させると、テストの抜け漏れを減らしやすくなります。

🧪 テスト依頼の進め方

ステップ	依頼内容
1	対象ファイルを@で指定
2	守りたい仕様を説明
3	先にテスト観点を列挙させる
4	合意した観点でテストを書かせる
5	テスト実行結果を確認する

たとえば、@src/utils/password.ts のテストを書いて だけだと、実装に沿ったテストになりやすいかもしれません。より良い依頼は、@src/utils/password.ts について、セキュリティ要件ではなく一般的な入力検証として、空文字・短すぎる文字列・英大文字を含むケースを先にテスト観点として列挙して。まだ実装しないで のような形です。

🔍 レビュー依頼の観点

観点	指示例
不具合	`重大な不具合候補を優先して指摘して`
セキュリティ	`一般的な入力検証の漏れを確認して`
影響範囲	`変更が他ファイルに波及する箇所を挙げて`
テスト不足	`追加すべきテスト観点を列挙して`
可読性	`挙動を変えない範囲の改善だけ提案して`

レビューでは、Codexに「全部見て」と言うより、優先順位を伝えるほうが実用的です。重大な不具合を見たいのか、命名を整えたいのか、テスト不足を探したいのかで、読むべきポイントは変わります。

Codex入門の記事では、テストが「成功するテスト」寄りになる落とし穴と、検証したい観点を先に明示する対処が紹介されています。
出典: https://kdl-di.hatenablog.com/entry/2026/01/29/160853

また、Codexの公式紹介でも、テストやリンター、型チェックを実行できることが説明されています。つまり、ファイルを読むだけでなく、実行結果まで確認して修正する流れがCodexの強みです。

ただし、テスト実行には環境が必要です。依存関係が不足していたり、ネットワーク制限があったりすると失敗する場合があります。その時は、Codexに「失敗原因を環境・依存関係・実装の3つに分けて説明して」と頼むと、原因を整理しやすくなります。

WordPressや外部ファイルを扱う時は公式情報とバックアップを優先すること

今回の調査情報には、WordPressの wp-config.php に関する公式ドキュメントも含まれていました。codex ファイル参照というテーマから少し離れて見えるかもしれませんが、実務では「Codexに設定ファイルを読ませて修正したい」という場面がよくあります。WordPressのような本番サイトに関係するファイルでは、特に慎重さが必要です。

wp-config.php は、WordPressの基本設定やデータベース接続情報を含む重要ファイルとして説明されています。つまり、Codexに参照させること自体はできても、内容には機密情報が含まれる可能性があります。外部に貼り付けたり、不要に共有したりしない配慮が必要です。

⚠️ 重要ファイルを扱う時の注意

ファイル例	注意点
`.env`	APIキーやパスワードが入ることがある
`wp-config.php`	DB接続情報が入ることがある
`config.toml`	ツール設定やMCP情報が入ることがある
認証関連ファイル	セキュリティ影響がある
デプロイスクリプト	本番反映につながる可能性がある

Codexに重要ファイルを見せる場合は、まず「編集しないで、問題点だけ指摘して」と依頼するのが安全です。設定変更が必要な場合も、いきなり書き換えさせるのではなく、変更案を出してもらい、公式情報と照合してから反映する流れがよいでしょう。

🛡️ 安全な依頼例

目的	プロンプト例
読み取りのみ	`@wp-config.php を読んで、設定項目の意味を説明して。編集しないで`
変更案	`公式情報に照らして変更候補だけ挙げて。まだ修正しないで`
機密配慮	`秘密情報の値は出力せず、項目名だけで説明して`
バックアップ前提	`変更が必要な場合は、先にバックアップ手順を提案して`

WordPress公式ドキュメントでは、wp-config.php の変更前にバックアップや復元方法を意識するような注意が示されています。これはCodex利用でも同じです。AIが編集できるからといって、本番設定を気軽に変えるのは避けたほうがよいです。

WordPress公式ドキュメントでは、wp-config.php がサイトの基本設定を含む重要ファイルであること、変更時には注意が必要であることが説明されています。
出典: https://developer.wordpress.org/advanced-administration/wordpress/wp-config/

特に外部API送信、デプロイ、DB変更を伴う場合は、ファイル参照の問題ではなく運用リスクの問題になります。Codexには「変更案だけ」「差分だけ」「実行しない」と明示し、人間が確認してから進めるのが現実的です。

つまり、重要ファイルを扱う時の合言葉は、参照は慎重に、編集は段階的に、実行は確認後にです。Codexは強力ですが、本番に近いファイルほど、公式情報とバックアップを優先したほうが安心です。

総括：codex ファイル参照のまとめ

最後に記事のポイントをまとめます。

codex ファイル参照の基本は、@path/to/file で対象ファイルを明示することである。
@指定だけで変更範囲が完全固定されるわけではないため、禁止事項も一緒に書くべきである。
codex 入門では、1ファイルの説明や軽微な修正から始めるのが扱いやすい。
codex のインストール方法はnpmやHomebrew、VS Code拡張など環境に合わせて選ぶ形である。
ファイルが見つからない時は、Codexの作業ディレクトリやVS Codeのワークスペースを確認するべきである。
AGENTS.mdは毎回守ってほしい前提、@指定は今回読ませたいファイル、プロンプトは今回だけの作業範囲である。
フォルダ全体を参照したい場合は、まず関係ファイルの調査を依頼し、その後に編集対象を絞るのが実務的である。
config.tomlはモデル、推論、Web検索、MCPなどの土台を整える設定ファイルである。
サンドボックスと承認設定は、Codexにどこまで触らせるかを決める安全装置である。
VS Code拡張は、開いているファイルやワークスペースの文脈を使いやすい点が強みである。
ChatGPTプロジェクトは長期文脈の整理に向き、Codex CLIのローカルファイル参照とは役割が異なる。
codex スライド作成では、元資料や参照ファイルを明示し、構成、本文、デザインを段階的に作るべきである。
テスト作成では、実装に合わせたテストだけにならないよう、検証観点を先に言語化するべきである。
WordPressの wp-config.php や .env など重要ファイルは、参照前に機密情報とバックアップを意識するべきである。
codex ファイル参照で失敗を減らす要点は、対象・目的・制限・確認方法をセットで伝えることである。

記事作成にあたり参考にさせて頂いたサイト

各サイト運営者様へ
有益な情報をご公開いただき、誠にありがとうございます。
感謝の意を込め、このリンクはSEO効果がある形で設置させていただいております。
※リンクには nofollow 属性を付与しておりませんので、一定のSEO効果が見込まれるなど、サイト運営者様にとってもメリットとなれば幸いです。
当サイトは、インターネット上に散在する有益な情報を収集し、要約・編集してわかりやすくお届けすることを目的としたメディアです。
引用や参照の方法に不備、あるいはご不快に感じられる点がございましたら、お問い合わせフォームよりご連絡ください。
今後とも、どうぞよろしくお願いいたします。

AI 業務効率化職場

当サイトについて

当サイトでは、インターネット上に散らばるさまざまな情報を収集し、AIを活用しながら要約・編集を行い、独自の切り口で見解を交えながらわかりやすい形でお届けしています。情報の整理・編集にあたっては、読者やオリジナル記事の筆者へご迷惑をおかけしないよう、細心の注意を払って運営しておりますが、万が一、掲載内容に問題がある場合や修正・削除のご要望がございましたら、どうぞお気軽にお問い合わせください。迅速に対応をさせていただきます。その際には、該当記事の URLやタイトルをあわせてお知らせいただけますと、より速やかに対応することができますのでそちらもご協力いただけますと大変幸いでございます。今後とも当サイトをよろしくお願いいたします。