●Claude Code●공식 자료●기타
도구 레퍼런스
Claude Code 전체 도구 목록(Bash, Edit, Read 등) 및 권한 요구사항 레퍼런스
도구 레퍼런스
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 훅을 사용하여 동적으로 채우세요.