이 페이지의 목차
확인 2026-10-26근거 자료 2건갱신 2026-10-26언급 6곳
이 페이지의 목차
확인 날짜 안내

이 페이지는 Claude Code 공식 Tools reference(원본 날짜 미상, 서버 Last-Modified 2026-10-26, 수집 2026-10-26) 기준이다. 도구 목록·모델 이름·버전 조건은 자주 바뀌므로 90일이 지나면 다시 확인한다. 낯선 말은 용어 사전에서 찾는다.

도구 이름을 쓰는 곳#

대부분은 Claude가 언제 어떤 도구를 쓸지 정하므로 이름을 부를 일이 없다. 다음 곳은 모두 같은 도구이름(지정자) 규칙 형식을 받는다. Claude Code 도구 레퍼런스

도구 이름을 그대로 쓰는 곳(원본이 지정자 형식을 받는다고 하지 않는 곳): 훅의 matcher(괄호 형식이 아니라 맨 도구 이름), 서브에이전트 정의의 도구 목록(tools·disallowedTools, → 서브에이전트 정의 파일 레퍼런스). Claude Code 도구 레퍼런스

새 도구는 MCP 서버로 더한다. 스킬은 새 도구가 생기는 것이 아니라 기존 Skill 도구로 돈다. Claude Code 도구 레퍼런스

자주 보는 도구 (2026-10-26 기준)#

"확인"은 Manual 모드에서 작업 디렉터리 안 경로를 다룰 때 묻는지다. "아니오"인 Read·Grep·Glob도 작업 디렉터리와 추가 디렉터리 밖 경로는 묻는다. Bash는 "예"지만 내장 읽기 전용 명령 세트는 묻지 않는다. 자동 모드에서는 분류기가 대부분의 확인을 대신 판단한다. Claude Code 도구 레퍼런스 → 권한 모드

도구하는 일확인
Read파일 읽기(이미지·PDF·노트북 포함)아니오
Edit파일의 특정 부분 고치기(정확한 문자열 교체)예
Write파일 만들기·덮어쓰기예
Bash셸 명령 실행예
Glob·Grep이름 패턴으로 파일 찾기, 파일 내용 검색아니오
WebFetchURL 내용 가져오기예
WebSearch웹 검색예
Agent서브에이전트 띄우기아니오
Skill메인 대화에서 스킬 실행예
AskUserQuestion객관식 질문으로 요구사항 확인아니오
EnterPlanMode·ExitPlanModeplan 모드 들어가기, 계획을 승인받고 나가기아니오·예
TaskCreate·TaskGet·TaskList·TaskUpdate할 일 목록 관리(아래 절)아니오
Monitor백그라운드에서 명령을 돌려 출력 줄마다 Claude에게 알림예
Workflow많은 서브에이전트를 조율하는 동적 워크플로 실행예

전체 목록(크론, worktree, LSP, MCP 리소스, 알림, 파일 보내기 등)은 원본 표에 있다. 지금 세션에 실제로 무엇이 로드됐는지는 아래 "확인하는 법". Claude Code 도구 레퍼런스

규칙 형식 (2026-10-26 기준)#

규칙 예적용 도구맞추는 방식
Bash(npm run *)Bash, Monitor명령 패턴
PowerShell(Get-ChildItem *)PowerShell명령 패턴
Read(~/secrets/**)Read, Grep, Glob, LSP경로 패턴
Edit(/src/**)Edit, Write, NotebookEdit경로 패턴
Skill(deploy *)Skill스킬 이름
Agent(Explore)Agent서브에이전트 종류
WebFetch(domain:example.com)WebFetch도메인
WebSearchWebSearch지정자 없음, 도구 전체 허용·거부

여기 없는 도구(ExitPlanMode 등)는 지정자 없는 맨 이름만 받는다. Edit(...) allow 규칙은 같은 경로의 읽기도 허용한다. Read(...) deny 규칙은 같은 경로의 Edit·Write(새 파일 만들기 포함)도 막는다(Write 쪽은 v2.1.228 이상). Claude Code 도구 레퍼런스 이 규칙들이 Bash 명령 중 어디까지 덮고 어디는 못 덮는지는 Claude Code 권한 규칙 문법의 "닿지 않는 곳".

할 일 목록 도구: TodoWrite에서 Task 도구로 (2026-10-26 기준)#

  • 이름 주의: 여기서 말하는 할 일 도구(TaskCreate 등)는 예전 서브에이전트 도구 Task(v2.1.63에서 Agent로 이름이 바뀜)와는 다른 도구다. Claude Code 서브에이전트Claude Code 도구 레퍼런스
  • TodoWrite(세션 체크리스트)는 기본으로 꺼져 있고, TaskCreate·TaskGet·TaskList·TaskUpdate 네 개가 대신한다. 할 일 도구가 있는 세션에서 CLAUDE_CODE_ENABLE_TASKS=0을 주면 네 Task 도구 대신 TodoWrite가 나온다. Claude Code 도구 레퍼런스
  • 할 일 도구는 Opus 4.7, Sonnet 4.6, Haiku 4.5와 그 이전 모델에서만 기본으로 주어진다. 그 밖의 모델과 Claude Code가 모르는 모델 ID(게이트웨이로 쓰는 사용자 지정 모델 이름 등)에서는 켜지 않는 한 빠진다. 원본은 더 새 모델이 적어 둔 체크리스트 없이 여러 단계 일을 추적하고, 도구 정의와 알림이 컨텍스트를 차지하기 때문이라고 설명한다. 도구가 없으면 Claude는 작업 중에 화면의 할 일 목록(task list)에 아무것도 더하지 않는다. v2.1.268 이상의 기본값이다. Claude Code 도구 레퍼런스
  • 기본으로 없는 모델에서 켜는 방법: Claude Code를 시작하기 전에 CLAUDE_CODE_ENABLE_TODO_TOOLS=1을 둔다(예: CLAUDE_CODE_ENABLE_TODO_TOOLS=1 claude, 모든 모델·제공자에 같은 도구), 또는 claude --allowedTools TaskCreate처럼 도구 하나를 --allowedTools에 적는다, 또는 --tools 목록에 넣는다(--tools는 세션의 내장 도구를 그 목록으로 좁히므로 쓰는 다른 도구도 함께 적는다). Claude Code 도구 레퍼런스
  • 백그라운드 세션과 클라우드 세션에서는 모델과 상관없이 같은 도구가 주어진다. 서브에이전트는 세션에 할 일 도구가 있을 때만 갖는다(서브에이전트 모델과 무관). Claude Code 도구 레퍼런스 → 서브에이전트 정의 파일 레퍼런스

macOS·Linux·WSL에서 Glob·Grep이 없는 이유 (2026-10-26 기준)#

  • Windows는 Glob·Grep이 기본 도구 세트에 있다. macOS·Linux·WSL에서는 빠지고, Claude가 Bash로 find·grep을 돌려 검색한다(Claude의 셸에서는 내장된 bfs·ugrep이 돈다). 이 검색은 훅과 권한 규칙에 Bash 호출로 닿는다. Claude Code 도구 레퍼런스
  • 다시 받는 경우: 세션 시작 때 --tools·--allowedTools에 Glob이나 Grep을 적을 때(--allowedTools에 하나만 적어도 둘 다 돌아옴. 설정 파일의 allow 규칙으로는 안 됨), deny 규칙·--disallowedTools·--restricted가 세션에서 Bash를 뺄 때, 서브에이전트가 tools에 Glob·Grep을 적고 Bash를 뺄 때(그 서브에이전트에만. --agent나 agent 설정으로 그 서브에이전트를 메인 세션 에이전트로 돌리면 세션 전체). Claude Code 도구 레퍼런스
  • 편집자 해석: 그래서 Grep·Glob에만 건 훅 matcher는 이 환경의 기본 검색에서는 돌지 않을 수 있다고 볼 수 있다(근거 문장: "the searches reach your hooks and permission rules as Bash calls"). 검색을 감시하는 훅이면 Bash 쪽도 함께 본다. → Claude Code 훅 설정 레시피

알아 두면 좋은 도구별 동작 (2026-10-26 기준)#

  • Edit: 정규식이나 비슷한 문자열 맞추기 없이 정확히 같은 글자를 바꾼다. 공백 하나만 달라도 실패하고, 같은 글자가 여러 번 나오면 더 긴 문맥을 주거나 전부 바꾸기를 쓴다. Claude Opus 4.6·Haiku 4.5와 그 이전 모델은 고치기 전에 반드시 읽어야 한다. 더 새 모델은 그 파일을 읽는 데 권한 확인이 필요 없고 그리고 Read 도구가 있을 때만, 읽지 않은 파일도 고칠 수 있다. Claude Code 도구 레퍼런스
  • Bash: 명령마다 별도 프로세스라 한 명령의 export는 다음 명령에 이어지지 않는다. 가상 환경(virtualenv·conda)은 Claude Code를 시작하기 전에 켠다. 메인 세션의 cd는 프로젝트·추가 디렉터리 안이면 이어진다. Claude Code 도구 레퍼런스
  • Read: 큰 텍스트 파일은 기본으로 한 번에 25,000토큰까지 돌려주고, 256KB 넘는 파일 전체는 나눠 읽는다. .xlsx·.zip 같은 이진 파일은 거부하고 다른 방법(스킬, 스크립트)을 안내한다. 긴 PDF는 pdftoppm(poppler)이 있어야 쪽 범위로 읽는다. Claude Code 도구 레퍼런스
  • WebFetch: 페이지를 Markdown으로 바꾼 뒤 추출 프롬프트를 별도 모델 호출로 돌려 그 결과만 Claude에게 준다. 원본은 이것을 "lossy by design"이라 부르며, "페이지에 그 내용이 없다"는 결과는 프롬프트가 묻지 않았다는 뜻일 수 있으니 더 구체적으로 다시 가져오게 하거나 Bash의 curl을 쓰라고 한다. localhost와 점 없는 호스트 이름은 요청 전에 거부한다. 응답은 기본 15분 캐시한다. Claude Code 도구 레퍼런스
  • WebSearch: 대화형 터미널 세션은 메인 대화와 서브에이전트를 합쳐 200회 한도가 있다. 한도에 닿으면 검색이 아무것도 하지 않은 호출로 보이고, CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION으로 올리거나(끌 수는 없음), 다시 차기를 기다리거나(v2.1.290 이상 시간당 약 100회), /clear로 새 대화를 연다. Amazon Bedrock에서는 서버 측 웹 검색 도구를 쓸 수 없다. Claude Code 도구 레퍼런스
  • AskUserQuestion: 질문은 답할 때까지 열려 있다. askUserQuestionTimeout을 60s·5m·10m으로 두면 오래 답이 없을 때 고른 항목을 내고 Claude가 판단해 진행한다. 이 시간 제한은 객관식 질문에만 적용되고, plan 승인을 포함한 권한 확인 창은 자리를 비워도 저절로 넘어가지 않는다. Claude Code 도구 레퍼런스

확인하는 법#

  • 지금 세션에 어떤 도구가 있는지 Claude에게 직접 묻는다(원문 예: What tools do you have access to?). Claude가 대화체로 요약한다. MCP 도구의 정확한 이름은 /mcp로 본다. Claude Code 도구 레퍼런스
  • 도구 세트는 제공자·플랫폼·설정에 따라 다르다. Claude Code 도구 레퍼런스
  • WebFetch가 세션에 없으면 /status의 Organization policy 줄을 본다. Team·Enterprise 계정은 조직 정책을 불러오기 전까지 WebFetch를 보류할 수 있다. Claude Code 도구 레퍼런스

관련 페이지#

Claude Code(작동 방식의 내장 도구 다섯 범주), Claude Code 권한 규칙 문법, 훅 이벤트 레퍼런스, 서브에이전트 정의 파일 레퍼런스, Claude Code 슬래시 명령.