메인 콘텐츠로 건너뛰기
Claude Code는 코드베이스를 이해하고 수정하는 데 도움이 되는 도구 세트에 접근할 수 있습니다. 아래의 도구 이름은 권한 규칙, subagent 도구 목록, 및 hook 매처에서 사용하는 정확한 문자열입니다.
도구설명필요한 권한
Agent작업을 처리하기 위해 자체 context window를 가진 subagent를 생성합니다아니오
AskUserQuestion요구사항을 수집하거나 모호함을 명확히 하기 위해 객관식 질문을 합니다아니오
Bash환경에서 shell 명령을 실행합니다. Bash 도구 동작 참조
CronCreate현재 세션 내에서 반복 또는 일회성 프롬프트를 예약합니다(Claude 종료 시 사라짐). 예약된 작업 참조아니오
CronDeleteID로 예약된 작업을 취소합니다아니오
CronList세션의 모든 예약된 작업을 나열합니다아니오
Edit특정 파일에 대한 대상 편집을 수행합니다
EnterPlanModePlan Mode로 전환하여 코딩 전에 접근 방식을 설계합니다아니오
EnterWorktree격리된 git worktree를 생성하고 전환합니다아니오
ExitPlanMode승인을 위한 계획을 제시하고 Plan Mode를 종료합니다
ExitWorktreeworktree 세션을 종료하고 원래 디렉토리로 돌아갑니다아니오
Glob패턴 매칭을 기반으로 파일을 찾습니다아니오
Grep파일 내용에서 패턴을 검색합니다아니오
ListMcpResourcesTool연결된 MCP servers에서 노출된 리소스를 나열합니다아니오
LSP언어 서버를 통한 코드 인텔리전스입니다. 파일 편집 후 타입 오류 및 경고를 자동으로 보고합니다. 또한 네비게이션 작업을 지원합니다: 정의로 이동, 참조 찾기, 타입 정보 가져오기, 기호 나열, 구현 찾기, 호출 계층 추적. 코드 인텔리전스 플러그인과 해당 언어 서버 바이너리가 필요합니다아니오
NotebookEditJupyter 노트북 셀을 수정합니다
Read파일의 내용을 읽습니다아니오
ReadMcpResourceToolURI로 특정 MCP 리소스를 읽습니다아니오
Skill주 대화 내에서 skill을 실행합니다
TaskCreate작업 목록에 새 작업을 생성합니다아니오
TaskGet특정 작업의 전체 세부 정보를 검색합니다아니오
TaskList현재 상태와 함께 모든 작업을 나열합니다아니오
TaskOutput(더 이상 사용되지 않음) 백그라운드 작업에서 출력을 검색합니다. 작업의 출력 파일 경로에서 Read를 사용하는 것을 권장합니다아니오
TaskStopID로 실행 중인 백그라운드 작업을 종료합니다아니오
TaskUpdate작업 상태, 종속성, 세부 정보를 업데이트하거나 작업을 삭제합니다아니오
TodoWrite세션 작업 체크리스트를 관리합니다. 비대화형 모드 및 Agent SDK에서 사용 가능합니다. 대화형 세션은 대신 TaskCreate, TaskGet, TaskList, TaskUpdate를 사용합니다아니오
ToolSearchtool search가 활성화되었을 때 지연된 도구를 검색하고 로드합니다아니오
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을 shell 스크립트로 설정하거나, SessionStart hook을 사용하여 동적으로 채웁니다.

참고 항목

  • 권한: 권한 시스템, 규칙 구문, 도구별 패턴
  • Subagents: subagent에 대한 도구 접근 구성
  • Hooks: 도구 실행 전후에 사용자 정의 명령 실행