Codexの /mention でREADMEを指定する — 読ませたい1ファイルを10分で添付

Codex CLIを使い始めたばかりで、「このREADMEだけを読んでほしい」と確実に伝えたい方向けです。
この記事では、練習用のREADME.mdを作り、/mentionからファイル候補を開いて、Codexのチャット入力欄へ追加された状態までを10分のゴールにします。
前提は、Codex CLIを利用できる環境とサインイン手段があることです。まだ導入していない場合も、インストールから順に進められます。

この記事でやること

やることは1つだけです。

Codex CLIの入力欄で/mentionを選び、続けてREADME.mdを検索します。読み取ってほしいファイルを候補から明示する操作です。

ここでいうCLIは、ターミナルへ文字を入力してツールを操作する方式のことです。ターミナルは、macOSの「ターミナル」やWindowsの「PowerShell」のようなアプリを指します。

また、AIエージェントは、質問へ答えるだけでなく、許可された範囲でファイルを読んだり、編集したり、コマンドを実行したりできるAIです。Codex CLIは、そのCodexをターミナルから使うためのツールです。

`/mention`とは何か

/mentionは、Codex CLIの対話画面で、ファイル候補を開くスラッシュコマンドです。現在の公式GitHubソースでは「mention a file」と説明され、実行すると入力欄へ@を挿入する実装になっています。

スラッシュコマンドとは、Codexの入力欄で/から始めて呼び出す操作です。通常のターミナルコマンドとは入力する場所が違います。ここは最初に混ざりやすいので、次の2つを分けて考えると進めやすいです。

mkdirやcd、codexは、普段のターミナルへ入力する
/mentionは、Codexを起動した後の入力欄で選ぶ
挿入された@の後へREADME.mdと入力し、候補から対象を選ぶ

現在の公式GitHubソースでは、/mentionを実行すると入力欄へ@が挿入されます。続けてファイル名やパスを入力し、表示された候補から一致するファイルを選びます。

この記事では機能を広げず、README.mdを1枚添付するところだけに絞ります。

なぜファイルを明示するのか

たとえば、作業フォルダに次のファイルがあるとします。

project/
├── README.md
├── docs/
│   └── README.md
└── src/
    └── app.js

ここで「READMEを読んで」とだけ頼むと、どちらのREADMEを指しているのかが曖昧です。人間同士でも、同じ名前の書類が2枚あれば確認が必要になりますよね。

/mentionからREADME.mdを選べば、少なくともどのファイルを会話へ追加したかを入力欄で確認できます。便利なのは、賢い回答を保証するからではありません。対象の取り違えを減らし、依頼の前提を目で確認しやすくなるからです。

情報をたくさん渡すことと、必要な情報を正しく指すことは別物。最初の練習では、1ファイルだけを明示するくらいがちょうどいいと思います。

準備1: Codex CLIをインストールする

すでにcodexを起動できる方は、この章を読み飛ばして大丈夫です。

2026年9月16日に確認した公式ドキュメントでは、macOS/Linux向けのスタンドアロンインストーラーは次のとおりです。

curl -fsSL https://chatgpt.com/codex/install.sh | sh

npmを使う場合は、次の方法も公式に案内されています。npmは、Node.js向けのパッケージ管理ツールです。

npm install -g @openai/codex

WindowsのPowerShellでは、公式ページに次のコマンドが掲載されています。

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

インストール後、バージョンが表示されるか確認します。

codex --version

バージョン文字列が表示されれば、コマンドを呼び出せています。筆者の検証環境ではcodex-cli 0.153.4と表示されました。ただし、これは記事内の必須バージョンを意味しません。バージョン番号は更新されるため、ご自身の画面に別の番号が出ても、それだけで失敗ではありません。

初回起動時は、画面の案内に従ってサインインします。公式ドキュメントでは、ChatGPTでのサインインなど、利用可能な方法から選ぶ流れが案内されています。利用できる機能や上限は、契約や管理者設定によって異なる場合があります。

準備2: 安全な練習用READMEを作る

いきなり仕事のリポジトリを使わず、内容がわかっている練習ファイルで試します。

リポジトリは、コードや設定ファイルなどをまとめて管理する作業場所です。今回はGitの操作をしないので、単なる練習フォルダとして考えて問題ありません。

macOS/Linuxのターミナルで、次を上から順に実行します。

mkdir codex-mention-practice
cd codex-mention-practice
printf '# Sample Project\n\nStatus: ready\n' > README.md
cat README.md

最後に、次のような内容が表示されます。

# Sample Project

Status: ready

この作成手順は、隔離した一時ディレクトリで実行し、Status: readyが表示されることを確認しました。

Windows PowerShellで同じ練習ファイルを作る場合は、次のようにできます。

New-Item -ItemType Directory codex-mention-practice
Set-Location codex-mention-practice
@"
# Sample Project

Status: ready
"@ | Set-Content README.md
Get-Content README.md

PowerShellの例はこの記事の検証環境がmacOSのため、Windows上では筆者未実行です。実行前に作成先フォルダ名と現在地を確認してください。

`/mention`でREADMEを添付する

いよいよ本題です。README.mdがあるフォルダにいる状態で、Codexを起動します。

codex

起動後は、普段のシェルではなくCodexの対話画面になります。シェルは、ターミナルへ入力したコマンドを解釈して実行する仕組みです。

Codexの入力欄で/mentionを選びます。

/mention

入力欄へ@が挿入されたら、その後へREADME.mdと入力します。

@README.md

候補のポップアップが開いたら、今回作ったREADME.mdを選びます。期待結果は、選んだファイルがチャットへ追加されることです。

ここでは、まだ長い依頼を書かなくて大丈夫です。

入力欄にREADME.mdが添付されたとわかる表示が出た。

まずは、これを10分の成功にします。理解した気がする、ではなく、画面上で対象ファイルを選べた状態です。

添付後に最初の質問を1つ送る

次の軌道へ進む1アクションとして、添付したREADMEの1行だけを質問します。

添付したREADME.mdのStatusの値だけ答えてください。

先ほど作ったファイルなら、期待する回答は次です。

ready

この質問を短くしているのには理由があります。最初から「プロジェクト全体を分析して改善案を出して」と頼むと、/mentionで正しいファイルを渡せたのか、AIの分析が妥当なのかを一度に判断することになります。

今回は確認対象をStatusの1語だけにしています。元ファイルと回答を見比べれば、結果を自分で判定できます。

なお、筆者環境ではCodex CLI 0.153.4のインストールと、練習ファイルの生成までは確認しました。一方、検証時点の環境はサインインしていなかったため、/mention選択後の画面表示とモデル回答は筆者未検証です。/mentionがファイル候補を開き、入力欄へ@を挿入する点は、2026年9月16日に公式GitHubソースで再確認しました。

成功確認は3段階に分ける

一連の操作は、次の3段階で確認できます。

ファイル確認: cat README.mdでStatus: readyが見える
添付確認: Codexの入力欄でREADME.mdを選んだ表示が見える
回答確認: Codexの回答がreadyで、元ファイルと一致する

1と2ができれば、/mentionという今回の機能は試せています。3は、その添付を使ってAIへ質問する次の一歩です。

この分け方は小さいですが、失敗した場所を見つけやすくしてくれます。ファイルが存在しないのか、添付候補が出ないのか、回答が一致しないのか。全部を「Codexが動かない」にまとめないことが、つまずきを短くするコツです。

つまずきポイント

1. `/mention`を通常のターミナルで実行してしまう

/mentionは、Codexを起動した後の入力欄で使います。

先に通常のターミナルで次を実行します。

codex

Codexの対話画面が開いてから/mentionを選び、挿入された@の後へREADME.mdと入力します。

@README.md

入力場所を2段階に分けるだけで切り分けやすくなります。

2. 候補に`README.md`が出ない

まず、Codexをどのフォルダから起動したか確認します。Codexを起動する前のターミナルで、次を実行します。

pwd
ls

pwdは現在いるフォルダ、lsはその場所のファイル一覧を表示します。lsの結果にREADME.mdがなければ、練習フォルダへ移動します。

cd codex-mention-practice
ls
codex

その後、もう一度/mentionを選び、挿入された@の後へREADME.mdと入力します。

3. 同じ名前のREADMEが複数ある

候補の表示を見て、パスまで確認します。ルート直下ではなくdocsフォルダのREADMEを選びたいなら、次のように相対パスを長めに入力します。

@docs/README.md

相対パスは、今いる作業フォルダを基準にしたファイルの住所です。同名ファイルがあるほど、ファイル名だけでなく住所まで指定する意味が大きくなります。

4. ファイルを選んだが、質問を送っていない

/mentionは対象を添付する操作です。添付しただけでは、何をしてほしいかまでは決まりません。

ファイルを選んだ後に、短い依頼を1つ追加します。

Statusの値だけ答えてください。

「対象」と「依頼」を分けると、プロンプトも読み返しやすくなります。

5. サインイン画面が出て先へ進めない

初回起動では、先に認証が必要です。画面に表示された利用可能な方法からサインインしてください。会社や学校の管理環境では、管理者ポリシーによって選べる方法や機能が異なる場合があります。

認証できない状態で何度も操作を繰り返すより、まずサインイン状態を解決してから同じ練習フォルダで再開する方が安全です。

6. 添付できたのに回答が元ファイルと違う

/mentionはファイルを会話へ添付する機能で、回答の正しさを保証する機能ではありません。

今回なら、次で元の値を確認します。

grep '^Status:' README.md

重要な判断に使うときは、AIの回答だけで完了にせず、元ファイルやテスト結果と照合します。

7. 機密ファイルまで添付しそうで不安

候補を選ぶ前にパスを読みます。認証情報、秘密鍵、環境変数ファイルなど、依頼に不要なファイルは添付しません。練習では内容が公開されても困らないダミーファイルを使うのが安心です。

`/mention`の限界と、使わなくてよい条件

/mentionでファイルを添付しても、回答の正確性、安全性、完全性が保証されるわけではありません。添付後も、重要な内容は元ファイル、差分、テストなどで確認する必要があります。

また、いつでも/mentionが必要なわけではありません。

作業フォルダにREADME.mdが1枚しかなく、対象が誰の目にも明らかな小さな練習では、普通に「README.mdを読んで」と書くだけで十分な場合があります。毎回操作を増やせばよい、という話ではないんです。

見分け方はシンプルです。

同名ファイルがある
読ませる範囲を1つに限定したい
送信前に対象ファイルを目で確認したい

このどれかに当てはまるなら、/mentionを使う意味があります。逆に、対象が明白で確認コストも小さいなら、通常のパス記述で十分です。

まとめ

Codex CLIの/mentionは、読ませたいファイルをチャット入力欄へ追加するための機能です。

今回の最短手順は、次の3つでした。

練習用README.mdを作る
そのフォルダでcodexを起動する
Codexの入力欄で/mentionを選び、@README.mdの候補から対象を選ぶ

まずは、入力欄にREADME.mdが添付された表示までで大丈夫です。その後にStatusの値だけを質問し、元ファイルと照合すれば、AIエージェントへ「対象を渡す→依頼する→自分で確かめる」という小さな一周を体験できます。

生成AI活用エンジニア&3児のパパ。AI×開発の実践知を毎日発信しています。次の小さな実践もXで受け取る

参考リンク

確認日: 2026-09-16