Skill 도구를 통해 실행됩니다.
자동 모드에서 분류기가 대부분의 권한 프롬프트를 사용자 대신 결정합니다.
권한 필요 열은 작업 디렉토리 내의 경로에 대해 수동 모드에서 도구가 프롬프트하는지 여부를 보여줍니다. Read, Grep 및 Glob을 포함한 파일 액세스 도구는 아니오로 표시되지만 작업 디렉토리 및 추가 디렉토리 외부의 경로에 대해 여전히 프롬프트합니다. Bash는 예로 표시되지만 프롬프트 없이 기본 제공 읽기 전용 명령 세트를 실행합니다.| 도구 | 설명 | 권한 필요 |
|---|---|---|
Agent | 작업을 처리하기 위해 자체 컨텍스트 윈도우가 있는 서브에이전트를 생성합니다. 에이전트 팀이 활성화된 경우, name을 전달하는 호출은 팀원을 시작할 수 있습니다. Agent 도구 동작을 참조하세요 | 아니오 |
Artifact | HTML 또는 Markdown 파일을 아티팩트로 게시합니다. claude.ai의 비공개 대화형 페이지입니다. 공개 링크로 공유하거나 Team 및 Enterprise 플랜에서 조직 내에서 공유할 수 있습니다. 공개 공유는 Owner가 활성화해야 합니다. Pro, Max, Team 또는 Enterprise 플랜이 필요하며 /login 인증이 필요합니다. 가용성을 참조하세요 | 예 |
AskUserQuestion | 요구사항을 수집하거나 모호함을 명확히 하기 위해 객관식 질문을 합니다. 질문은 기본적으로 답변할 때까지 열려 있습니다. AskUserQuestion 도구 동작을 참조하세요 | 아니오 |
Bash | 환경에서 셸 명령을 실행합니다. Bash 도구 동작을 참조하세요 | 예 |
CronCreate | 현재 세션 내에서 반복 또는 일회성 프롬프트를 예약합니다. 작업은 세션 범위이며 만료되지 않은 경우 --resume 또는 --continue에서 복원됩니다. 예약된 작업을 참조하세요 | 아니오 |
CronDelete | ID로 예약된 작업을 취소합니다 | 아니오 |
CronList | 세션의 모든 예약된 작업을 나열합니다 | 아니오 |
Edit | 특정 파일에 대한 대상 편집을 수행합니다. Edit 도구 동작을 참조하세요 | 예 |
EndConversation | 지속적인 학대 입력이 있는 드문 경우 또는 Claude에게 도구를 시연하도록 요청할 때 세션을 종료합니다. Claude Code v2.1.213 이상이 필요합니다. EndConversation 도구 동작을 참조하세요 | 아니오 |
EnterPlanMode | 코딩 전에 접근 방식을 설계하기 위해 계획 모드로 전환합니다 | 아니오 |
EnterWorktree | 격리된 git worktree를 생성하고 이를 전환합니다. 새 worktree를 생성하는 대신 기존 worktree로 전환하려면 path를 전달합니다. 처음 진입할 때 대상은 현재 저장소의 worktree이거나 다중 저장소 작업 공간에서 그 안에 중첩된 저장소의 worktree일 수 있습니다. v2.1.203 이전에는 중첩된 저장소의 worktree가 거부되었습니다. .claude/worktrees/ 외부의 path는 세션의 작업 디렉토리와 쓰기 액세스를 해당 위치로 이동하므로 진입하기 전에 승인을 요청합니다. 새 worktree 생성 및 .claude/worktrees/ 아래의 경로는 프롬프트하지 않습니다. v2.1.206 이전에는 Claude가 .claude/worktrees/ 외부의 경로에 프롬프트 없이 진입했습니다. worktree 세션 내에서 또는 isolation: worktree와 같은 고정된 작업 디렉토리가 있는 서브에이전트에서는 path 형식만 사용 가능하며 대상은 세션의 저장소의 .claude/worktrees/ 아래에 있어야 합니다 | 예 |
ExitPlanMode | 승인을 위한 계획을 제시하고 계획 모드를 종료합니다 | 예 |
ExitWorktree | worktree 세션을 종료하고 원래 디렉토리로 돌아갑니다. isolation: worktree와 같이 자체 작업 디렉토리에서 이미 실행되는 서브에이전트는 사용할 수 없습니다 | 아니오 |
Glob | 패턴 매칭을 기반으로 파일을 찾습니다. macOS, Linux 및 WSL에서 기본적으로 없습니다. Glob 도구 동작을 참조하세요 | 아니오 |
Grep | 파일 내용에서 패턴을 검색합니다. macOS, Linux 및 WSL에서 기본적으로 없습니다. Grep 도구 동작을 참조하세요 | 아니오 |
ListAgents | Claude가 SendMessage로 메시지를 보낼 수 있는 에이전트를 나열합니다. 세션의 서브에이전트, 에이전트 팀 팀원, 다른 로컬 Claude Code 세션, 그리고 이 세션이 Remote Control에 연결되어 있는 동안 웹의 Claude Code 세션 및 다른 머신의 Remote Control 세션입니다. /list-agents 명령을 지원합니다. 크로스 세션 메시징을 참조하세요. Claude Code v2.1.224 이상이 필요하며 크로스 세션 메시징이 활성화된 세션에만 나타납니다. 팀원 행 및 이 세션의 자체 이름을 보여주는 첫 번째 줄은 v2.1.239 이상이 필요합니다 | 아니오 |
ListMcpResourcesTool | 연결된 MCP 서버에서 노출한 리소스를 나열합니다. MCP Apps UI 리소스는 제외합니다. 이는 호스트 애플리케이션이 렌더링할 페이지입니다 | 아니오 |
LSP | 언어 서버를 통한 코드 인텔리전스: 정의로 이동, 참조 찾기, 유형 오류 및 경고 보고. LSP 도구 동작을 참조하세요 | 아니오 |
Monitor | 백그라운드에서 명령을 실행하고 각 출력 줄을 Claude에게 다시 피드하므로 로그 항목, 파일 변경 또는 폴링된 상태에 대화 중에 반응할 수 있습니다. WebSocket을 열고 각 수신 메시지를 이벤트로 처리할 수도 있습니다. Monitor 도구를 참조하세요 | 예 |
NotebookEdit | Jupyter 노트북 셀을 수정합니다. NotebookEdit 도구 동작을 참조하세요 | 예 |
PowerShell | PowerShell 명령을 기본적으로 실행합니다. 가용성은 PowerShell 도구를 참조하세요 | 예 |
PushNotification | 데스크톱 알림을 보내고 Remote Control이 연결되어 있을 때 휴대폰 푸시를 보냅니다. 따라서 장시간 실행되는 작업 또는 예약된 작업이 사용자가 자리를 떠날 때 연락할 수 있습니다. 푸시 배달은 Anthropic 호스팅 인프라를 통해 실행되며, Amazon Bedrock, Claude Platform on AWS, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 액세스할 수 없습니다 | 아니오 |
Read | 파일의 내용을 읽습니다. Read 도구 동작을 참조하세요 | 아니오 |
ReadMcpResourceTool | URI로 특정 MCP 리소스를 읽습니다 | 아니오 |
RemoteTrigger | claude.ai에서 루틴을 생성, 업데이트, 실행 및 나열합니다. /schedule 명령을 지원합니다. RemoteTrigger 입력 참조는 모든 작업 및 도구를 제거하는 조직 정책을 문서화합니다. 루틴은 claude.ai에 있으며 Pro, Max, Team 또는 Enterprise 플랜이 필요하므로 이 도구는 Amazon Bedrock, Claude Platform on AWS, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서 액세스할 수 없습니다 | 아니오 |
ReportFindings | 코드 리뷰 결과를 구조화된 목록으로 보고합니다. 각 결과마다 파일, 요약 및 실패 시나리오가 있으므로 Claude Code가 텍스트로 인쇄하는 대신 렌더링할 수 있습니다. Claude는 활성 코드 리뷰 지침이 이를 수행하도록 지시할 때 호출합니다. 결과는 correctness 또는 test-coverage와 같은 선택적 category 슬러그를 전달할 수도 있으며, 렌더링된 목록의 파일 위치 옆에 표시됩니다 | 아니오 |
ScheduleWakeup | 자체 페이스 /loop의 다음 반복을 다시 예약합니다. Claude는 각 반복이 끝날 때 이를 호출하여 다음 반복이 실행될 시기를 선택합니다. 1분에서 1시간 사이입니다. 직접 호출하지 않습니다. 루프를 대신 종료하려면 Claude는 stop: true로 호출하여 보류 중인 웨이크업을 취소합니다. 보류 중인 웨이크업은 Stop 훅 입력의 session_crons에 나타납니다 | 아니오 |
SendFeedback | Claude Code에 대한 피드백 보고서를 작성합니다. 제품 문제 또는 세션에서 Claude의 자체 동작을 다룹니다. 검토할 수 있도록 머신에서 대기열에 넣습니다. Claude Code는 초안을 보내도록 선택할 때까지 아무것도 보내지 않습니다. SendFeedback 도구 동작을 참조하세요. Claude Code v2.1.238 이상이 필요합니다 | 아니오 |
SendMessage | 다른 에이전트에게 메시지를 보냅니다. 에이전트 팀 팀원, 에이전트 ID 또는 이름으로 재개하는 [서브에이전트], 또는 다른 Claude Code 세션 중 하나입니다. 이 머신 또는 그 이상입니다. 다른 세션으로 메시징하려면 Claude Code v2.1.224 이상이 필요합니다. 크로스 세션 메시징은 Claude가 도달할 수 있는 세션, 메시지가 도착할 때의 모습, 및 다른 세션이 유휴 상태가 될 때 Claude가 공지를 받는 방법을 다룹니다. Claude는 선택적 summary 입력을 포함할 수 있습니다. 일반적으로 5-10단어이며, Claude Code는 한 줄 미리보기로 표시합니다. Claude가 일반 텍스트 메시지에서 생략하면 Claude Code는 메시지의 첫 번째 줄을 요약으로 사용합니다. Claude Code는 200자보다 긴 요약을 줄임표로 자릅니다 | 아니오 |
SendUserFile | 세션의 파일을 선택적 캡션과 함께 사용자에게 보냅니다. 생성된 보고서, 다이어그램, 스크린샷 또는 빌드된 아티팩트가 트랜스크립트에서만 언급되는 대신 장치에 도달합니다. 선택적 display 입력은 프레젠테이션을 제어합니다. render는 파일을 클라이언트에서 인라인으로 열고, attach는 다운로드 카드만 표시하며, 설정되지 않으면 클라이언트가 파일 유형으로 결정합니다. Remote Control 클라이언트가 연결되어 있거나 클라우드 세션에서 사용 가능합니다. 배달은 Anthropic 호스팅 인프라를 통해 실행되므로 도구는 Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서 사용할 수 없습니다 | 아니오 |
ShareOnboardingGuide | ONBOARDING.md를 업로드하고 팀원이 Claude Code에서 열 수 있는 공유 링크를 반환합니다. 가이드가 작성된 후 /team-onboarding에서 호출됩니다. claude.ai 구독자가 Pro, Max, Team 및 Enterprise 플랜에서 사용 가능합니다 | 예 |
Skill | 주 대화 내에서 스킬을 실행합니다 | 예 |
SubagentHandback | 서브에이전트의 최종 보고서를 해당 서브에이전트의 결과를 받는 대화에 전달합니다. 자동 모드에서만 제공되며, Agent 도구가 포크 이외의 로컬에서 실행하는 서브에이전트에만 제공되며, 터미널 CLI, IDE 확장, 클라우드 세션 및 Agent SDK에서 사용 가능합니다. 분류기는 보고서가 전달되기 전에 검토합니다. Claude Code v2.1.271 이상이 필요합니다 | 아니오 |
TaskCreate | 작업 목록에 새 작업을 생성합니다. 작업 도구 가용성 아래에 나열된 모델에서만 기본적으로 제공되며, 다른 모델에서는 옵트인할 때만 제공됩니다 | 아니오 |
TaskGet | 특정 작업의 전체 세부 정보를 검색합니다. 작업 도구 가용성 아래에 나열된 모델에서만 기본적으로 제공되며, 다른 모델에서는 옵트인할 때만 제공됩니다 | 아니오 |
TaskList | 현재 상태와 함께 모든 작업을 나열합니다. 작업 도구 가용성 아래에 나열된 모델에서만 기본적으로 제공되며, 다른 모델에서는 옵트인할 때만 제공됩니다 | 아니오 |
TaskOutput | v2.1.277에서 제거되었습니다. 이전에는 백그라운드 작업에서 출력을 검색했습니다. 이제 Claude는 대신 Read로 백그라운드 작업의 출력 파일을 읽습니다 | 아니오 |
TaskStop | ID로 실행 중인 백그라운드 작업을 중지합니다. 또한 에이전트 팀 팀원 또는 에이전트 ID 또는 이름으로 명명된 백그라운드 에이전트를 허용합니다. ID와 일치하는 작업이 없으면 오류는 다른 에이전트가 생성한 에이전트를 포함하여 실행 중인 백그라운드 에이전트를 ID 및 설명으로 나열합니다 | 아니오 |
TaskUpdate | 작업 상태, 종속성, 세부 정보를 업데이트하거나 작업을 삭제합니다. 작업 도구 가용성 아래에 나열된 모델에서만 기본적으로 제공되며, 다른 모델에서는 옵트인할 때만 제공됩니다 | 아니오 |
TodoWrite | 세션 작업 체크리스트를 관리합니다. TaskCreate, TaskGet, TaskList 및 TaskUpdate를 선호하여 기본적으로 비활성화됩니다. 작업 추적 도구가 있는 세션에서 다시 활성화하려면 CLAUDE_CODE_ENABLE_TASKS=0을 설정합니다 | 아니오 |
ToolSearch | 도구 검색이 활성화되어 있을 때 지연된 도구를 검색하고 로드합니다 | 아니오 |
WaitForMcpServers | 백그라운드에서 여전히 연결 중인 하나 이상의 MCP 서버를 기다립니다. 따라서 요청이 세션을 다시 시작하지 않고도 해당 도구를 사용할 수 있습니다. Claude는 필요한 서버가 아직 연결되지 않았을 때 호출합니다. 도구 검색이 비활성화되어 있을 때만 나타납니다. ToolSearch는 활성화되어 있을 때 대기를 처리합니다 | 아니오 |
WebFetch | 지정된 URL에서 콘텐츠를 가져옵니다. WebFetch 도구 동작을 참조하세요 | 예 |
WebSearch | 웹 검색을 수행합니다. WebSearch 도구 동작을 참조하세요 | 예 |
Workflow | 동적 워크플로우를 실행합니다. 백그라운드에서 많은 서브에이전트를 조율하고 하나의 통합된 결과를 반환하는 스크립트입니다 | 예 |
Write | 파일을 생성하거나 덮어씁니다. Write 도구 동작을 참조하세요 | 예 |
권한 규칙 및 훅으로 도구 구성하기
대부분의 경우 Claude가 이러한 도구를 사용할 시기를 결정하므로 Claude와 상호작용할 때 도구 이름을 직접 지정할 필요가 없습니다. 권한 및 기타 구성을 정의할 때 도구 이름을 직접 참조합니다:- 설정의
permissions.allow및permissions.deny와/permissions인터페이스에서 CLI flags의--allowedTools및--disallowedTools에서- Agent SDK의
allowedTools및disallowedTools옵션에서 - skill의
allowed-toolsfrontmatter에서 - hook의
ifcondition에서
ToolName(specifier)을 허용합니다. specifier는 도구에 따라 다르며, 여러 도구가 형식을 공유합니다: