CLI 입력창에서 Claude 코드 파일 첨부하는 방법

CLI 입력창에서 Claude 코드 파일 첨부하는 방법 초보도 한 번에 이해하는 실전 가이드

터미널(CLI)에서 Claude Code에게 파일을 첨부하는 방법을 완전 초보 기준으로 설명합니다. txt, md, 코드 파일까지 실제 입력 예제와 함께 쉽게 정리했습니다.

---

📌 목차 (클릭하면 이동)

• 1. CLI에서 파일 첨부가 왜 헷갈릴까
• 2. Claude Code가 파일을 읽는 원리
• 3. 가장 기본적인 파일 첨부 방법
• 4. 여러 파일을 한 번에 첨부하는 법
• 5. 파일 첨부가 안 될 때 해결법

---

1. CLI에서 파일 첨부가 왜 헷갈릴까

처음 Claude Code를 CLI에서 쓰면 거의 대부분 여기서 멈춥니다.

“채팅창에서는 파일 올렸는데 터미널에서는 대체 어떻게 넘기지?”

이 혼란은 아주 정상입니다.

CLI는 마우스로 끌어다 놓는 공간이 아니라 파일 경로를 말로 설명하는 세계이기 때문입니다.

그래서 파일 첨부의 핵심은 파일 그 자체가 아니라 ‘경로’입니다.

---

2. Claude Code가 파일을 읽는 원리

Claude Code는 현재 터미널 위치를 기준으로 파일을 찾습니다.

즉, Claude에게 이렇게 말하는 겁니다.

“지금 이 폴더 안에 있는 이 파일 좀 같이 보자.”

그래서 가장 중요한 전제는 하나입니다.

파일이 실제로 존재하는 위치에서 실행해야 한다

이걸 놓치면 아무리 명령어를 잘 쳐도 파일을 못 찾습니다.

---

3. 가장 기본적인 파일 첨부 방법

예를 들어, 현재 폴더에 example.txt 파일이 있다고 가정해 보겠습니다.

CLI에서 이렇게 입력합니다.

claude example.txt

이 한 줄로 Claude는 해당 파일 내용을 읽고 바로 분석을 시작합니다.

코드 파일도 동일합니다.

claude app.js
claude main.py

이 순간부터 Claude는 “이 파일을 기준으로 이야기하자” 라는 전제를 공유하게 됩니다.

---

4. 여러 파일을 한 번에 첨부하는 법

실전에서는 파일 하나만 쓰는 경우가 드뭅니다.

그래서 여러 파일을 동시에 넘길 수도 있습니다.

claude index.html style.css script.js

이렇게 하면 Claude는 세 파일을 모두 읽은 상태로 대답을 시작합니다.

특히 프로젝트 구조 설명할 때 이 방법이 엄청나게 편합니다.

“이 세 파일 기준으로 문제점 찾아줘” 이게 말 한 줄로 끝납니다.

---

5. 파일 첨부가 안 될 때 해결법

파일 첨부가 안 될 때 대부분 이유는 비슷합니다.

아래만 체크해도 90%는 바로 해결됩니다.

① 파일명이 정확한지 (대소문자 포함)
② 현재 터미널 위치가 파일 있는 폴더인지
③ 확장자를 빼먹지 않았는지

특히 윈도우 사용자분들은 확장자 숨김 설정 때문에 자주 헷갈립니다.

보이는 이름과 실제 이름이 다를 수 있다는 점, 꼭 기억해 두시면 좋습니다.

---

📎 꼭 필요한 공식 자료

아래 공식 문서는 CLI 사용 시 가장 정확한 기준이 됩니다.

Claude 공식 문서 바로가기

---

정리해 보면,

CLI에서의 파일 첨부는 업로드가 아니라 경로 공유입니다.

이 개념만 잡히면 Claude Code 활용 속도는 체감상 두 배 이상 빨라집니다.

이제 터미널에서 파일 하나 골라 직접 넘겨보세요. Claude가 훨씬 똑똑해진 느낌을 받을 겁니다.