# Read

로컬 파일시스템에서 단일 파일의 내용을 로드합니다. 일반 텍스트, 소스 코드, 이미지, PDF, Jupyter 노트북을 지원하며, `cat -n` 스타일의 1 기반 줄 번호로 결과를 반환합니다.

## 사용 시점

- 편집 또는 분석 전에 알려진 경로의 소스 파일 읽기
- 구성 파일, 잠금 파일, 로그, 또는 생성된 아티팩트 검사
- 사용자가 대화에 붙여 넣은 스크린샷 또는 다이어그램 보기
- 긴 PDF 매뉴얼에서 특정 페이지 범위 추출
- 코드 셀, 마크다운, 셀 출력을 함께 검토하기 위해 `.ipynb` 노트북 열기

## 매개변수

- `file_path` (string, 필수): 대상 파일의 절대 경로. 상대 경로는 거부됩니다.
- `offset` (integer, 선택): 읽기를 시작할 1 기반 줄 번호. `limit`와 함께 사용하면 큰 파일에 유용합니다.
- `limit` (integer, 선택): `offset`에서 시작하여 반환할 최대 줄 수. 생략 시 기본값은 파일 맨 위에서 2000줄입니다.
- `pages` (string, 선택): PDF 파일의 페이지 범위, 예를 들어 `"1-5"`, `"3"`, 또는 `"10-20"`. 10페이지를 초과하는 PDF에 필요합니다. 요청당 최대 20페이지입니다.

## 예시

### 예시 1: 전체 작은 파일 읽기
`file_path`만 `/Users/me/project/src/index.ts`로 설정하여 `Read`를 호출합니다. 줄 번호와 함께 최대 2000줄이 반환되며, 이는 일반적으로 편집 컨텍스트에 충분합니다.

### 예시 2: 긴 로그 페이지 넘기기
컨텍스트 토큰을 낭비하지 않고 좁은 창을 검색하려면 수천 줄의 로그 파일에서 `offset: 5001`과 `limit: 500`을 사용합니다.

### 예시 3: 특정 PDF 페이지 추출
`/tmp/spec.pdf`의 120페이지 PDF의 경우, 필요한 챕터만 가져오려면 `pages: "8-15"`를 설정합니다. 큰 PDF에서 `pages`를 생략하면 오류가 발생합니다.

### 예시 4: 이미지 보기
PNG나 JPG 스크린샷의 절대 경로를 전달합니다. 이미지가 시각적으로 렌더링되어 Claude Code가 직접 추론할 수 있습니다.

## 참고사항

- 항상 절대 경로를 선호하십시오. 사용자가 제공하면 그대로 신뢰하십시오.
- 2000자보다 긴 줄은 잘립니다. 매우 넓은 데이터의 경우 반환된 내용이 잘릴 수 있다고 처리하십시오.
- 여러 독립 파일을 읽고 있나요? 병렬로 실행되도록 같은 응답에서 여러 `Read` 호출을 실행하십시오.
- `Read`는 디렉토리를 나열할 수 없습니다. 대신 `Bash` `ls` 호출이나 `Glob` 도구를 사용하십시오.
- 존재하지만 비어 있는 파일을 읽으면 파일 바이트 대신 시스템 알림이 반환되므로 해당 신호를 명시적으로 처리하십시오.
- 현재 세션에서 같은 파일에 `Edit`를 사용하려면 성공적인 `Read`가 필요합니다.
