Claude Code 도구 레퍼런스

한 줄 요약: Claude Code 공식 문서 "Tools reference". Claude Code가 쓰는 내장 도구 전체 표(이름, 하는 일, Manual 모드에서 확인을 묻는지)와 도구 이름을 쓰는 곳(권한 규칙, --allowedTools, 스킬 allowed-tools, 훅), 도구별 동작(Agent, Bash, Edit, Glob·Grep, Read, WebFetch, WebSearch 등)을 다룬다. 할 일 목록 도구는 TodoWrite가 기본으로 꺼지고 TaskCreate·TaskGet·TaskList·TaskUpdate가 대신하며, 이 도구들은 Opus 4.7·Sonnet 4.6·Haiku 4.5와 그 이전 모델에서만 기본으로 주어진다(v2.1.268 이상). 더 새 모델은 적어 둔 체크리스트 없이 여러 단계 일을 추적한다.

원본 정보#

제목: Tools reference
발행처: Claude Code 공식 문서(code.claude.com)
원본 날짜: 문서에 표기 없음. 서버 Last-Modified 2026-10-26, 수집 2026-10-26. 도구·버전·모델 사실은 2026-10-26 기준이다.
URL: https://code.claude.com/docs/en/tools-reference (새 창)

핵심 주장#

도구 이름은 설정에 그대로 쓰는 문자열이다. 권한 규칙, 서브에이전트 도구 목록, 훅 matcher에 쓰는 정확한 이름이다. 새 도구는 MCP 서버로 더하고, 스킬은 새 도구가 아니라 기존 Skill 도구로 돈다. → Claude Code 내장 도구
"Permission required" 열은 Manual 모드, 작업 디렉터리 안 경로 기준이다. Read·Grep·Glob처럼 No로 표시된 파일 도구도 작업 디렉터리·추가 디렉터리 밖 경로는 묻는다. Bash는 Yes지만 내장 읽기 전용 명령 세트는 묻지 않고 돌린다. 자동 모드에서는 분류기가 대부분의 확인을 대신 판단한다. → Claude Code 내장 도구, 권한 모드
할 일 목록 도구가 바뀌었다. TodoWrite는 "Disabled by default in favor of TaskCreate, TaskGet, TaskList, and TaskUpdate"이고, 할 일 도구가 있는 세션에서 CLAUDE_CODE_ENABLE_TASKS=0이면 다시 켜진다. 할 일 도구 다섯 개는 Opus 4.7·Sonnet 4.6·Haiku 4.5와 그 이전 모델에서만 기본 제공되고, 그 밖의 모델(인식하지 못하는 모델 ID 포함)에서는 켜지 않는 한 빠진다. 원본 이유: "On newer models, Claude keeps track of multi-step work without a written checklist, and the tools' definitions and reminders take up context." 켜는 방법은 CLAUDE_CODE_ENABLE_TODO_TOOLS=1, --allowedTools TaskCreate, --tools 목록. 백그라운드·클라우드 세션은 모든 모델에서 제공. v2.1.268 이상의 기본값이다. → Claude Code, Claude Code 내장 도구
macOS·Linux·WSL에서는 Glob·Grep이 기본으로 빠진다. Claude는 Bash로 find·grep(내장 bfs·ugrep)을 돌려 검색하고, 그 검색은 훅과 권한 규칙에 Bash 호출로 닿는다. Windows는 기본 포함. --tools·--allowedTools에 이름을 넣거나, deny 규칙·--disallowedTools·--restricted로 Bash를 빼거나, 서브에이전트가 Bash 없이 Glob·Grep을 나열하면 돌아온다. → Claude Code 내장 도구
도구별 동작에 실무 조건이 많다. Edit은 정확한 문자열 교체다. Claude Opus 4.6·Haiku 4.5와 그 이전 모델은 먼저 읽어야 하고, 더 새 모델은 그 파일을 읽는 데 권한 확인이 필요 없고 Read 도구가 있을 때만 읽지 않은 파일을 고칠 수 있다. Bash는 명령마다 별도 프로세스라 환경 변수가 이어지지 않는다. WebFetch는 추출 프롬프트를 거친 결과만 Claude에게 가는 "lossy by design"이고 localhost를 거부한다. 대화형 세션의 WebSearch는 200회 한도가 있다. → Claude Code 내장 도구

이전 원본과 달라진 점 (시간에 따른 변화)#

효과적인 컨텍스트 엔지니어링(2025-09-29)은 Claude Code가 할 일 목록(to-do list)을 만드는 것을 구조화된 노트의 예로 들었다. 이 원본(2026-10-26 기준)은 할 일 도구가 Opus 4.7·Sonnet 4.6·Haiku 4.5 이하 모델에서만 기본 제공되고, TodoWrite 대신 Task 도구 네 개가 기본이라고 적는다. 2025년 글 시점의 동작이 지금 모든 모델에 해당하지 않는 시간에 따른 변화로 보고, Claude Code와 장기 작업 컨텍스트 관리에 새 사실을 앞세웠다.
Claude Code 서브에이전트(수집 2026-10-18)는 백그라운드 서브에이전트의 내장 도구 목록에 TodoWrite를 든다. 이 원본은 서브에이전트가 할 일 도구를 갖는 것은 세션이 가질 때뿐이라고 더한다.

원본에 없는 것#

head·tail로 큰 데이터를 다뤄 전체를 컨텍스트에 싣지 않는다는 권고. 이 원본은 head·tail을 Read 없이 편집할 수 있게 해 주는 파일 보기 명령 목록으로만 든다. 2025년 글의 그 권고는 이 원본으로 확인되지 않는다.

원본이 링크만 한 것#

Agent teams, Cross-session messaging, Scheduled tasks·Routines, Worktrees, Interactive mode(task list, 백그라운드), Env vars, Errors, Artifacts, Agent SDK todo tracking, Advisor tool.