Berikan PDF dan file Word Anda kepada Claude Code, Cursor, dan Codex

Per Oktober 2026, Claude Code dapat membaca PDF sendiri, Cursor membaca PDF yang Anda lampirkan ke obrolan, dan Codex CLI mendokumentasikan input gambar tetapi bukan PDF. Ketiganya tidak mencantumkan file Word (DOCX) di antara format yang dibaca langsung. Untuk spesifikasi, manual, makalah, dan kontrak yang akan dipakai agen lebih dari sekali, ubah menjadi Markdown, simpan salinannya di proyek, dan beri tahu agen di mana letaknya.

Panduan ini untuk agen pemrograman yang bekerja di folder proyek. Jika Anda membuat folder dokumen referensi tersendiri dan bukan proyek kode, mulailah dengan menyiapkan dokumen untuk agen AI.

Yang dibaca langsung oleh setiap agen

Berikut yang dinyatakan dokumentasi masing-masing vendor per Oktober 2026.

Claude Code membaca PDF pendek secara utuh. PDF lebih dari 10 halaman dibaca per rentang hingga 20 halaman sekaligus, dan pembacaan itu memerlukan pdftoppm program dari poppler. Di Windows Anda memasang build poppler sendiri dan menambahkannya ke PATH; tanpa itu, pembacaan gagal. Rinciannya ada di referensi alat Claude Code.

Cursor menambahkan pembacaan PDF pada versi 2.4, yang dirilis pada Januari 2026. Daftar abaikan bawaan Cursor masih mencakup file PDF dan beberapa format Office, dan bantuan Cursor menyatakan bahwa file yang diabaikan diblokir dari agen. Lampirkan PDF ke obrolan sendiri alih-alih mengharapkan agen menemukannya di proyek.

Codex CLI menerima gambar yang diteruskan lewat baris perintah atau ditempel ke prompt. Dokumentasinya tidak menjelaskan input PDF atau Word untuk CLI.

Agen tetap bisa mencoba mengambil teks dari dokumen dengan menjalankan program yang terpasang di komputer Anda. Terkadang berhasil, tetapi Anda tidak melihat teks mana yang didapat, dan tabel yang salah terbaca langsung masuk ke jawabannya.

Mengapa salinan Markdown bekerja lebih baik

Markdown adalah teks biasa dengan judul, daftar, dan tabel. Di dalam proyek, ini memberi Anda empat hal yang tidak dimiliki file PDF atau DOCX.

• Agen bisa mencarinya. Pencarian teks menemukan frasa di file Markdown. File DOCX adalah arsip ZIP berisi bagian-bagian XML, jadi pencarian teks biasa tidak menemukan apa pun di dalamnya.
• Agen bisa mengutip baris yang persis, dan Anda bisa menemukan setiap kalimat kutipan di file serta membaca apa yang melingkupinya.
• Agen hanya membaca yang dibutuhkan: ia mencari di manual yang panjang, lalu membuka satu bagian yang penting alih-alih membaca halaman demi halaman.
• Git menunjukkan apa yang berubah. Saat edisi baru sebuah spesifikasi tiba, diff mencantumkan baris yang berubah.

Anda juga melihat persis apa yang dibaca agen. Jika sebuah tabel salah, Anda memperbaikinya sekali di file Markdown, dan setiap sesi berikutnya memakai salinan yang sudah benar.

PDF hasil pindai tanpa lapisan teks hanyalah gambar halaman. PDF itu memerlukan OCR (pengenalan teks) sebelum agen bisa mencarinya. MD Factory mengenali teks di PDF hasil pindai di PC Anda. Untuk memeriksa hasilnya, lihat panduan mengonversi PDF hasil pindai.

Taruh dokumen di folder docs

Simpan file asli dan salinan Markdown-nya di dalam proyek, di samping kode yang bergantung padanya:

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

1. Salin file PDF dan Word ke folder docs. MD Factory menyimpan setiap file Markdown di samping aslinya, jadi di sinilah salinannya akan muncul.
2. Di MD Factory, klik Tambahkan folder dan pilih folder docs, atau letakkan folder ke jendela aplikasi. Konversi langsung dimulai.
3. Tunggu sampai setiap file menampilkan status: Selesai, Perlu diperiksa, atau Gagal.
4. Klik Perlu diperiksa di samping file untuk melihat apa yang perlu diperiksa, lalu bandingkan bagian itu dengan aslinya.

Gambar dari dokumen disimpan di folder yang dinamai sesuai dokumen itu, seperti partner-api-spec_images. File PDF dan Word-nya sendiri tidak diubah.

Simpan file asli di proyek. Nomor halaman, gambar, dan kata-kata persis yang ditandatangani ada di sana, dan Anda akan membutuhkannya setiap kali salinan dan jawaban agen berbeda.

Arahkan agen ke file-filenya

Berikan agen daftar singkat dokumen di file instruksinya. Claude Code membaca CLAUDE.md, atau AGENTS.md jika proyek tidak memiliki CLAUDE.md. Codex dan Cursor membaca AGENTS.md. Contohnya:

## Dokumen referensi

Salinan Markdown dari file PDF dan Word ada di docs/.
File asli setiap salinan ada di sampingnya.

- `docs/partner-api-spec.md`: spesifikasi API mitra, versi 3.2
- `docs/supplier-contract.md`: kontrak pemasok, edisi 2026

Cari di docs/ sebelum menjawab pertanyaan tentang API mitra atau kontrak.
Kutip judul bagian yang Anda andalkan.
Jangan edit file di docs/.

Tulis jalurnya dalam backtick, seperti di atas, bukan sebagai @docs/partner-api-spec.md. Di CLAUDE.md, jalur dengan @ adalah impor: Claude Code memuat seluruh file di awal setiap sesi. Jalur dalam backtick tetap hanya sebuah sebutan biasa, dan Claude membuka file itu saat tugas memerlukannya.

Buat daftarnya singkat. Codex berhenti membaca file instruksi begitu totalnya mencapai 32 KiB, batas bawaannya.

Untuk satu tugas, sebut file itu di prompt Anda:

• Di Claude Code, ketik @ dan pilih file. Claude Code menambahkan isinya ke percakapan jika muat dalam batas baca, 25.000 token secara bawaan. Untuk file yang lebih panjang, minta Claude mencarinya terlebih dahulu.
• Di Cursor, ketik @ dan pilih file atau seluruh folder docs, seperti dijelaskan di bantuan Cursor.
• Di Codex CLI, ketik @ untuk menyisipkan jalur file, atau gunakan perintah /mention untuk melampirkan file, seperti dijelaskan di panduan prompt Codex.

Prompt yang menyebut dokumen dan meminta kutipan bisa seperti ini:

Baca bagian “Authentication” dan “Rate limits” dari
docs/partner-api-spec.md. Perbarui klien API agar mengikutinya.
Untuk setiap perubahan, kutip baris spesifikasi yang menjadi dasarnya.

Periksa jawaban dan perbarui salinan

Sebelum mengandalkan sebuah jawaban, temukan sendiri bagian yang dikutip. Gunakan perintah pertama di PowerShell dan yang kedua di Git Bash:

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

Jika kutipan tidak ada di file Markdown, cari di file asli. Jika di sana juga tidak ada, agen tidak mengambilnya dari dokumen. Untuk nomor halaman dan angka, selalu buka file aslinya.

Perhatikan file .gitignore Anda. Pencarian Claude Code melewati file yang di-gitignore, meskipun Claude masih bisa mencari atau membaca file yang Anda sebut lewat jalurnya. Cursor menjauhkan file yang di-gitignore dari agen kecuali sebuah baris yang diawali ! di .cursorignore mengizinkannya kembali. Jika dokumen harus tetap di luar Git, cantumkan setiap jalur file di file instruksi untuk Claude Code, dan tambahkan baris ini ke .cursorignore untuk Cursor: !docs/

File referensi hanya boleh berubah saat Anda memutuskannya. Lihat diff setelah setiap tugas. Jika Anda ingin Claude Code tidak menyentuh folder docs, tambahkan aturan tolak Edit untuknya.

Saat edisi baru tiba, ganti file asli di folder docs dengan nama file yang sama, lalu tambahkan lagi ke MD Factory. Jika Anda belum mengedit salinan Markdown lama, MD Factory menggantinya. Jika sudah, salinan baru mendapat nama bernomor, seperti partner-api-spec (2).md, dan suntingan Anda tetap di file lama. Diff file Markdown kemudian menunjukkan bagian mana yang berubah dan kode mana yang mungkin perlu mengikutinya.

Dokumen rahasia: apa yang dikirim agen

MD Factory mengonversi dokumen di PC Anda dan tidak mengunggahnya, tetapi itu hanya mencakup proses konversi. Saat agen membaca salinan Markdown, teksnya dikirim ke penyedia model seperti bagian prompt Anda yang lain.

• Claude Code berjalan di komputer Anda tetapi mengirim prompt dan keluaran model lewat jaringan. Berapa lama Anthropic menyimpan data itu bergantung pada jenis akun dan pengaturan privasi Anda: lihat retensi data di Claude Code.
• Cursor menyatakan bahwa saat agen membuka file, isinya dapat disertakan dalam permintaan ke model.
• Codex memakai OpenAI sebagai penyedia model bawaannya.

Sebelum agen membaca dokumen rahasia:

• Konversi dan tambahkan hanya dokumen yang dibutuhkan tugas.
• Jika sebuah dokumen dicakup perjanjian kerahasiaan atau kontrak klien, periksa apakah perjanjian atau kontrak itu mengizinkan pengiriman teksnya ke layanan AI eksternal.
• Simpan dokumen yang tidak boleh dibaca agen di luar folder proyek. Aturan tolak Claude Code dan file abaikan Cursor memblokir alat file bawaan. Kedua vendor mencatat bahwa beberapa perintah terminal masih bisa membaca file seperti itu: lihat izin Claude Code dan file abaikan Cursor.
• Perlakukan dokumen dari orang lain sebagai input yang tidak tepercaya: dokumen itu bisa berisi teks yang ditulis untuk mengarahkan agen. Tinjau perintah dan suntingan yang diusulkan agen.