Claude Code, Cursor, Codex에 PDF와 Word 파일 넘기기

2026년 10월 기준으로 Claude Code는 PDF를 직접 읽을 수 있고, Cursor는 채팅에 첨부한 PDF를 읽으며, Codex CLI는 이미지 입력은 문서화하고 있지만 PDF는 그렇지 않습니다. 세 에이전트 모두 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페이지씩 나누어 읽으며, 이렇게 읽으려면 poppler에 포함된 pdftoppm 프로그램이 필요합니다. Windows에서는 poppler 빌드를 직접 설치해 PATH에 추가해야 하며, 그러지 않으면 읽기가 실패합니다. 자세한 내용은 다음 문서에 있습니다: Claude Code 도구 참조.

Cursor는 버전 2.4에서 PDF 읽기를 추가했습니다. 이 버전은 2026년 1월에 출시되었습니다. Cursor의 기본 무시 목록에는 여전히 PDF 파일과 일부 Office 형식이 들어 있습니다. Cursor 도움말에 따르면 무시된 파일은 에이전트에게 차단됩니다. 에이전트가 프로젝트에서 PDF를 찾아 주리라 기대하지 말고 직접 채팅에 PDF를 첨부하세요.

Codex CLI는 이미지를 받을 수 있으며 명령줄로 전달하거나 프롬프트에 붙여 넣으면 됩니다. 이 CLI의 PDF나 Word 입력에 대해서는 문서에 설명이 없습니다.

에이전트는 컴퓨터에 설치된 프로그램을 실행해 문서에서 텍스트를 뽑아내 보려고 할 수도 있습니다. 가끔은 되지만, 어떤 텍스트를 얻었는지 알 수 없고 잘못 읽힌 표가 그대로 답변에 들어갑니다.

Markdown 사본이 더 나은 이유

Markdown은 제목, 목록, 표가 있는 일반 텍스트입니다. 프로젝트 안에서는 PDF나 DOCX 파일에는 없는 네 가지 장점이 있습니다.

에이전트가 검색할 수 있습니다. 텍스트 검색으로 Markdown 파일에서 문구를 찾을 수 있습니다. DOCX 파일은 XML 부분으로 이루어진 ZIP 압축 파일입니다. 그래서 일반 텍스트 검색으로는 그 안에서 아무것도 찾지 못합니다.
에이전트가 정확한 줄을 인용할 수 있고, 인용된 문장을 파일에서 찾아 앞뒤 내용까지 읽어 볼 수 있습니다.
에이전트는 필요한 부분만 읽습니다. 긴 매뉴얼을 검색한 다음, 페이지를 처음부터 훑는 대신 중요한 섹션 하나만 엽니다.
Git이 바뀐 내용을 보여 줍니다. 사양서의 새 판이 오면 diff가 바뀐 줄을 보여 줍니다.

에이전트가 읽는 내용을 정확히 볼 수도 있습니다. 표가 잘못 나왔다면 Markdown 파일에서 한 번만 고치면 이후 모든 세션이 고친 사본을 사용합니다.

텍스트 레이어가 없는 스캔 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에서는 @로 시작하는 경로는 가져오기(import)입니다: Claude Code는 매 세션을 시작할 때 파일 전체를 불러옵니다. 백틱 안의 경로는 단순한 언급으로 남으며, 작업에 필요하면 Claude가 그 파일을 엽니다.

목록은 짧게 유지하세요. Codex는 지침 파일의 합계가 기본 한도인 32 KiB에 이르면 더 읽지 않습니다.

작업 하나에 파일을 쓰려면 프롬프트에서 그 파일을 언급하세요:

Claude Code에서는 @를 입력하고 파일을 선택하세요. Claude Code는 파일 내용을 대화에 추가합니다 읽기 한도(기본 25,000토큰) 안에 들어오는 경우에 한해서입니다. 더 긴 파일은 먼저 Claude에게 검색하라고 요청하세요.
Cursor에서는 @를 입력하고 파일이나 docs 폴더 전체를 선택하세요. 자세한 내용은 다음 문서에 있습니다: Cursor 도움말.
Codex CLI에서는 @를 입력해 파일 경로를 삽입하거나 /mention 명령으로 파일을 첨부하세요. 자세한 내용은 다음 문서에 있습니다: Codex 프롬프트 작성 가이드.

문서를 지정하고 인용을 요청하는 프롬프트는 다음과 같을 수 있습니다:

docs/partner-api-spec.md의 "Authentication"과 "Rate limits" 섹션을 읽고
API 클라이언트가 그 내용을 따르도록 수정하세요.
변경할 때마다 근거로 삼은 사양의 줄을 인용하세요.

답변 확인과 사본 업데이트

답변을 믿기 전에 인용된 구절을 직접 찾아보세요. PowerShell에서는 첫 번째 명령을, 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 무시 파일.
다른 사람이 보낸 문서는 신뢰할 수 없는 입력으로 취급하세요. 에이전트를 조종하려고 쓴 텍스트가 들어 있을 수 있습니다. 에이전트가 제안하는 명령과 수정 사항을 검토하세요.