Claude Code、Cursor、CodexにPDFとWordのファイルを渡す

2026年10月時点で、Claude CodeはPDFを単独で読め、CursorはチャットにPDFを添付すれば読め、Codex CLIは画像入力は記載しているもののPDFには触れていません。3つとも、Word（DOCX）ファイルを直接読める形式としては挙げていません。エージェントが繰り返し使う仕様書、マニュアル、論文、契約書は、Markdownに変換し、そのコピーをプロジェクトに置いて、場所をエージェントに伝えましょう。

このガイドは、プロジェクトフォルダーで作業するコーディングエージェント向けです。コードプロジェクトではなく、参考資料を集めた別のフォルダーを作る場合は、まず次のガイドをご覧ください： AIエージェント向けに文書を準備する.

ぼやけた画面のノートパソコンが開かれていて、その隣に、淡い紫のバインダークリップで留められた印刷書類の束がある。 — エージェントが読むコピーの隣に、元のファイルを置いておきます。

各エージェントが直接読めるもの

以下は、2026年10月時点での各ベンダーのドキュメントの記載です。

エージェント	PDF	Word（DOCX）	画像
Claude Code	ファイルツールでPDFファイルを読み込む	対応するファイル形式の一覧にない	PNG、JPG、その他の形式
Cursor	チャットに添付したPDFを読み込む	記載なし	PNG、JPG、GIF、WebP、SVG
Codex CLI	CLIについては記載なし	記載なし	PNGやJPEGなどの一般的な形式

Claude Codeは、短いPDFなら全体を読み込みます。10ページを超えるPDFは、一度に最大20ページずつの範囲で読み込まれ、その読み込みには pdftoppm プログラムが必要です。これはpopplerに含まれています。Windowsでは、popplerのビルドを自分でインストールしてPATHに追加する必要があり、ないと読み込みは失敗します。詳しくは次に記載されています： Claude Codeツールリファレンス.

CursorがPDFの読み込みに対応したのはバージョン2.4からで、2026年1月にリリースされました。 Cursorの既定の無視リストには、今もPDFファイルとOffice形式のいくつかが含まれています。Cursorのヘルプには、無視されたファイルはエージェントから遮断されると書かれています。エージェントがプロジェクト内でPDFを見つけてくれると期待せず、PDFは自分でチャットに添付してください。

Codex CLIが受け付ける画像は、コマンドラインで渡すか、プロンプトに貼り付けます。ドキュメントには、CLIでのPDFやWordの入力についての説明はありません。

エージェントは、コンピューターにインストールされたプログラムを実行して、文書からテキストを取り出そうとすることもできます。うまくいく場合もありますが、どのテキストが取得されたかは見えず、読み取りを誤った表がそのまま回答に入り込みます。

Markdownコピーのほうがうまくいく理由

Markdownは、見出し、リスト、表を備えたプレーンテキストです。プロジェクトの中では、PDFやDOCXファイルにはない4つの利点があります。

エージェントがそれを検索できます。テキスト検索で、Markdownファイルの中からフレーズが見つかります。 DOCXファイルはXMLパーツのZIPアーカイブなので、単純なテキスト検索ではその中身は何も見つかりません。
エージェントは正確な行を引用でき、引用された文をファイルの中で見つけて、前後を読むことができます。
エージェントは必要な部分だけを読みます。長いマニュアルを検索し、ページを順に読み進めるのではなく、重要な1つのセクションだけを開きます。
Gitで変更点がわかります。仕様の新しい版が届いたとき、diffに変更された行が一覧表示されます。

エージェントが何を読んでいるかも、正確にわかります。表が正しく出力されなかった場合も、Markdownファイルで1回修正すれば、以降のセッションはすべて修正済みのコピーを使います。

テキストレイヤーのないスキャンしたPDFは、ページの画像にすぎません。エージェントが検索できるようにするには、まずOCR（文字認識）が必要です。MD Factoryは、スキャンしたPDFの文字をPC上で認識します。結果の確認方法は、当サイトのスキャンしたPDFの変換ガイド.

文書をdocsフォルダーに入れる

元のファイルとそのMarkdownコピーは、それらに依存するコードの隣、プロジェクトの中に置きます。

payments-service/
  AGENTS.md
  docs/
    partner-api-spec.pdf
    partner-api-spec.md
    partner-api-spec_images/
    supplier-contract.docx
    supplier-contract.md
  src/

PDFとWordのファイルをdocsフォルダーにコピーします。MD Factoryは各Markdownファイルを元のファイルの隣に保存するので、コピーはここに作成されます。
MD Factoryで、フォルダーを追加をクリックしてdocsフォルダーを選ぶか、フォルダーをウィンドウにドロップします。変換はすぐに始まります。
すべてのファイルにステータス（完了、要確認、失敗）が表示されるまで待ちます。
ファイルの隣の要確認をクリックすると、確認すべき点がわかります。その部分を元のファイルと見比べます。

文書内の画像は、その文書にちなんだ名前のフォルダー（例： partner-api-spec_images）に入ります。PDFとWordのファイル自体は変更されません。

元のファイルはプロジェクトに残しておきます。ページ番号、図、署名された文言そのものは元のファイルにあり、コピーとエージェントの回答が食い違ったときに必要になります。

エージェントにファイルの場所を伝える

エージェントの指示ファイルに、ドキュメントの短い一覧を書いておきます。 Claude Code はCLAUDE.mdを読み込み、プロジェクトにCLAUDE.mdがなければAGENTS.mdを読み込みます。 Codex と Cursor はAGENTS.mdを読み込みます。例：

## 参考ドキュメント

PDFとWordファイルのMarkdownコピーはdocs/にあります。
各コピーの元のファイルは、その隣にあります。

- `docs/partner-api-spec.md`：パートナーAPI仕様、バージョン3.2
- `docs/supplier-contract.md`：サプライヤー契約、2026年版

パートナーAPIや契約に関する質問に答える前に、docs/を検索してください。
根拠にしたセクションの見出しを引用してください。
docs/内のファイルは編集しないでください。

パスは、上の例のようにバッククォートで囲んで書き、 @docs/partner-api-spec.mdのようには書かないでください。CLAUDE.mdでは、 @で始まるパスはインポートとして扱われます。Claude Codeはそのファイル全体を、セッションを開始するたびに読み込みます。バッククォートで囲んだパスは単なる言及のままで、Claudeは作業に必要になったときにそのファイルを開きます。

一覧は短くしてください。Codexは、指示ファイルの合計が既定の上限である32 KiBに達すると、それ以上読み込みません。

1つのタスクだけなら、プロンプトの中でファイルを指定します。

Claude Codeでは、@を入力してファイルを選びます。 Claude Codeはその内容を会話に追加します。ただし、既定の25,000トークンという読み込み上限に収まる場合に限ります。もっと長いファイルは、先にClaudeに検索させてください。
Cursorでは、@を入力してファイルまたはdocsフォルダー全体を選びます。手順は次に記載されています： Cursorのヘルプ.
Codex CLIでは、@を入力してファイルパスを挿入するか、/mentionコマンドでファイルを添付します。手順は次に記載されています： Codexプロンプトガイド.

文書を指定して引用を求めるプロンプトは、次のようになります。

docs/partner-api-spec.mdの「Authentication」と「Rate limits」のセクションを読んでください。
APIクライアントを、それに従うように更新してください。
変更ごとに、根拠にした仕様の行を引用してください。

回答を確認し、コピーを更新する

回答を信頼する前に、引用された箇所を自分で探してください。1つ目のコマンドはPowerShellで、2つ目はGit Bashで使います。

Select-String -Path docs\*.md -Pattern "rate limit"
grep -n -i "rate limit" docs/*.md

引用がMarkdownファイルにない場合は、元のファイルを探してください。そこにもなければ、エージェントはその文書から取ったのではありません。ページ番号や数値は、必ず元のファイルを開いて確認してください。

.gitignoreファイルに注意してください。 Claude Codeの検索はgitignoreされたファイルをスキップします。ただし、パスを指定したファイルなら、Claudeは検索も読み込みもできます。 Cursorはgitignoreされたファイルをエージェントから遠ざけます。ただし、.cursorignoreに!で始まる行を書けば、それらをまた使えるようにできます。ドキュメントをGitに入れない場合は、Claude Code用に、指示ファイルにすべてのファイルパスを書き、Cursor用に、.cursorignoreに次の行を追加してください： !docs/

参照ファイルは、自分で決めたときだけ変わるようにします。各タスクのあとにdiffを確認してください。Claude Codeにdocsフォルダーに触れさせたくない場合は、 Editの拒否ルールを追加します.

新しい版が届いたら、docsフォルダーの元のファイルを、同じファイル名のまま置き換え、MD Factoryにもう一度追加します。古いMarkdownコピーを編集していなければ、MD Factoryがそれを置き換えます。編集している場合は、新しいコピーに番号付きの名前（例： partner-api-spec (2).md）が付き、編集した内容は古いファイルに残ります。そのMarkdownファイルをdiffで見れば、どのセクションが変わったか、どのコードを合わせて直す必要があるかがわかります。

機密文書：エージェントが送信するもの

MD Factoryは文書をPC上で変換し、アップロードしませんが、それは変換に限った話です。エージェントがMarkdownコピーを読むと、そのテキストはプロンプトのほかの部分と同じようにモデルプロバイダーに送られます。

Claude Codeは自分のコンピューター上で動作しますが、プロンプトとモデルの出力をネットワーク経由で送信します。Anthropicがそのデータを保持する期間は、アカウントの種類とプライバシー設定によって異なります。詳しくは次をご覧ください： Claude Codeのデータ保持.
Cursorによると、エージェントがファイルを開くと、その内容がモデルへのリクエストに含まれることがあります.
Codexは、既定のモデルプロバイダーとしてOpenAIを使います.

エージェントが機密文書を読む前に、次の点を確認してください。

タスクに必要な文書だけを変換して追加します。
文書が秘密保持契約や顧客との契約の対象になっている場合は、そのテキストを外部のAIサービスに送ってよいか確認してください。
エージェントに読ませたくない文書は、プロジェクトフォルダーの外に置きます。Claude Codeの拒否ルールとCursorの無視ファイルは、組み込みのファイルツールを遮断します。どちらのベンダーも、一部のターミナルコマンドではそれらのファイルを読めてしまうと注記しています。詳しくは次をご覧ください： Claude Codeの権限と Cursorの無視ファイル.
他人から受け取った文書は、信頼できない入力として扱ってください。エージェントを誘導するために書かれたテキストが含まれている可能性があります。エージェントが提案するコマンドや編集は、必ず確認してください。