topic★★★★★난이도 · 약 15분

도구 시스템 — 파일 읽기·쓰기·검색·실행

Read, Write, Edit, Bash, Glob, Grep — AI가 코드베이스를 직접 조작하는 6가지 도구.

#도구#Read#Write#Edit#Bash#Grep

왜 배우는가

Claude Code는 채팅만 하는 게 아니라 파일을 읽고, 수정하고, 터미널 명령을 실행한다. 어떤 도구가 있는지 알면 AI에게 더 정확한 지시를 내릴 수 있다.

Claude Code는 6가지 핵심 도구를 사용하여 코드베이스와 상호작용한다. AI가 사용자의 지시를 받으면 적합한 도구를 스스로 선택하여 실행한다.

도구 사용 — AI가 사용자 지시에 맞는 도구(Read/Edit/Bash…)를 스스로 호출한다

도구	용도	예시
Read	파일 내용 읽기	특정 파일의 코드 확인
Write	새 파일 생성 / 전체 덮어쓰기	새 컴포넌트 파일 생성
Edit	기존 파일의 일부만 수정	함수 하나만 변경 (diff 방식)
Bash	터미널 명령 실행	`npm install`, `git status`, `npx tsc`
Glob	파일명 패턴 검색	`*/.tsx` — 모든 TSX 파일 찾기
Grep	파일 내용 검색 (정규식)	`useState` 가 사용된 파일 찾기

AI가 도구를 선택하는 원리 — 사용자가 "이 파일 수정해줘"라고 하면 AI는 먼저 Read로 파일을 읽고, 변경할 부분을 파악한 뒤, Edit으로 해당 부분만 교체한다. 전체를 새로 쓸 필요가 있으면 Write를 쓴다. 이 판단을 AI가 자동으로 한다.

bash

# 사용자: "프로젝트에서 useState 쓰는 파일 찾아줘"
# → AI는 내부적으로 Grep 도구를 호출:
#   pattern: "useState"
#   glob: "**/*.tsx"

# 사용자: "Header.tsx에서 로고 텍스트를 JIT로 바꿔줘"
# → AI는 내부적으로:
#   1. Read("src/components/Header.tsx")  — 파일 읽기
#   2. Edit(old_string="이전 로고", new_string="JIT") — 수정

사용자는 자연어로 지시하면 되고, AI가 어떤 도구를 어떤 순서로 쓸지 자동으로 결정한다.

팁: Edit 도구는 정확히 일치하는 문자열을 교체하는 방식이다. 따라서 AI가 파일을 먼저 Read하지 않으면 Edit이 실패할 수 있다. AI는 이 규칙을 알고 있으므로 항상 읽기 → 수정 순서를 지킨다.