도구 레퍼런스

Claude Code가 사용할 수 있는 도구의 전체 레퍼런스로, 권한 요구사항을 포함합니다.

Claude Code는 코드베이스를 이해하고 수정하는 데 도움이 되는 도구 세트에 접근할 수 있습니다. 아래의 도구 이름은 권한 규칙, 서브에이전트 도구 목록, 훅 매처에서 사용하는 정확한 문자열입니다.

도구	설명	권한 필요 여부
Agent	별도의 컨텍스트 윈도우를 가진 서브에이전트를 생성하여 작업을 처리합니다	아니오
AskUserQuestion	요구사항을 수집하거나 모호한 점을 명확히 하기 위해 객관식 질문을 합니다	아니오
Bash	사용자 환경에서 셸 명령을 실행합니다. Bash 도구 동작을 참고하세요	예
CronCreate	현재 세션 내에서 반복 또는 일회성 프롬프트를 예약합니다 (Claude 종료 시 사라짐). 예약 작업 참고	아니오
CronDelete	ID로 예약된 작업을 취소합니다	아니오
CronList	세션의 모든 예약 작업을 나열합니다	아니오
Edit	특정 파일에 대해 타겟 편집을 수행합니다	예
EnterPlanMode	코딩 전에 접근 방식을 설계하기 위해 계획 모드로 전환합니다	아니오
EnterWorktree	격리된 git worktree를 생성하고 해당 디렉토리로 전환합니다	아니오
ExitPlanMode	승인을 위해 계획을 제시하고 계획 모드를 종료합니다	예
ExitWorktree	worktree 세션을 종료하고 원래 디렉토리로 돌아갑니다	아니오
Glob	패턴 매칭을 기반으로 파일을 찾습니다	아니오
Grep	파일 내용에서 패턴을 검색합니다	아니오
ListMcpResourcesTool	연결된 MCP 서버가 노출하는 리소스를 나열합니다	아니오
LSP	언어 서버를 통한 코드 인텔리전스를 제공합니다. 파일 편집 후 타입 오류와 경고를 자동으로 보고합니다. 정의로 이동, 참조 찾기, 타입 정보 조회, 심볼 나열, 구현 찾기, 호출 계층 추적 등의 탐색 기능도 지원합니다. 코드 인텔리전스 플러그인과 해당 언어 서버 바이너리가 필요합니다	아니오
NotebookEdit	Jupyter 노트북 셀을 수정합니다	예
Read	파일의 내용을 읽습니다	아니오
ReadMcpResourceTool	URI로 특정 MCP 리소스를 읽습니다	아니오
Skill	메인 대화 내에서 스킬을 실행합니다	예
TaskCreate	작업 목록에 새 작업을 생성합니다	아니오
TaskGet	특정 작업의 전체 세부사항을 조회합니다	아니오
TaskList	현재 상태와 함께 모든 작업을 나열합니다	아니오
TaskOutput	백그라운드 작업의 출력을 조회합니다	아니오
TaskStop	ID로 실행 중인 백그라운드 작업을 종료합니다	아니오
TaskUpdate	작업 상태, 의존성, 세부사항을 업데이트하거나 작업을 삭제합니다	아니오
TodoWrite	세션 작업 체크리스트를 관리합니다. 비대화형 모드와 Agent SDK에서 사용 가능하며, 대화형 세션에서는 TaskCreate, TaskGet, TaskList, TaskUpdate를 대신 사용합니다	아니오
ToolSearch	도구 검색이 활성화된 경우 지연 로드된 도구를 검색하고 로드합니다	아니오
WebFetch	지정된 URL에서 콘텐츠를 가져옵니다	예
WebSearch	웹 검색을 수행합니다	예
Write	파일을 생성하거나 덮어씁니다	예

권한 규칙은 /permissions를 사용하거나 권한 설정에서 구성할 수 있습니다. 도구별 권한 규칙도 참고하세요.

Bash 도구 동작

Bash 도구는 각 명령을 별도의 프로세스에서 실행하며, 다음과 같은 지속성 동작을 따릅니다:

• 작업 디렉토리는 명령 간에 유지됩니다. CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1을 설정하면 각 명령 후 프로젝트 디렉토리로 초기화됩니다.
• 환경 변수는 유지되지 않습니다. 한 명령에서의 export는 다음 명령에서 사용할 수 없습니다.

Claude Code를 실행하기 전에 virtualenv 또는 conda 환경을 활성화하세요. Bash 명령 간에 환경 변수를 유지하려면 Claude Code를 실행하기 전에 CLAUDE_ENV_FILE을 셸 스크립트로 설정하거나, SessionStart 훅을 사용하여 동적으로 채우세요.

참고 자료

• 권한: 권한 시스템, 규칙 구문, 도구별 패턴
• 서브에이전트: 서브에이전트의 도구 접근 구성
• 훅: 도구 실행 전후에 사용자 정의 명령 실행