[Claude Code] Tool 정리 - 01

1. Tool이란?

Tool 개념

Claude Code가 코드베이스를 이해하고, 파일 수정, 명령어 실행, 개발 도구 통합 등 AI가 외부 세계와 상호작용하여 직접 작업을 수행할 수 있도록 확장해 주는 기능

'외부 세계와 상호작용하는 함수' 형태로 생각하면 된다.

이는 외부 MCP(Pencil.dev)를 tool로써 추가하는 사진인데, 이렇게 설정하면 Claude가 Pencil에 접근이 가능해진다.

Tool을 알아야 하는 이유

• 기능 확장

기본 Claude는 'text 생성'이 다이므로, 이 text에 tool+action을 통해 'file-system 접근/조작', 'bash 명령어 실행', '외부 API 연동' 등이 가능해진다.

• 권한 및 보안 통제

각 Tool이 동작하는 동작과 권한을 설정(Allow / Deny)하여 안전하게 사용할 수 있다.

• 세밀한 Workflow 설정

서브 에이전트(Sub-agent)나 훅(Hook) 등에서 어떤 Tool을 허용하고 제한할지 결정함으로써 작업 효율과 정확도를 높일 수 있다.

사용자 정의 Tool

• MCP (Model Context Protocol)

외부 서버나 커스텀 서비스를 연결하여 Claude가 기본 제공하지 않는 나만의 기능(Tool)을 확장할 수 있다.

• Skill

반복되는 워크플로우를 프롬프트 형태로 작성하여 확장하는 방식이며, 실행될 때 Claude 내부의 Skill이라는 전용 Tool을 사용한다.

2. Tool 종류

1) Agent

별도의 context window에서 sub-agent를 생성

sub-agent는 자신의 task 처리 후 결과를 '단일 text'만 부모 Conversation에 반환 => 부모는 이 Reply만 봄!

sub-agent의 tool은 tools(Allow), disallowedTools(deny) 필드에서 관리할 수 있으며, 기본적으로 부모 tool + MCP를 상속받는다.
(우선순위: disallowedTools > tool)

이 떄, 아래 tool은 sub-agent에서 사용할 수 없다.

• AskUserQuestion
• EnterPlanMode
• ExitPlanMode (sub-agent의 permissionMode가 plan인 경우 제외)
• ScheduleWakeup
• WaitForMcpServers

sub-agent는 기본적으로 background에서 실행되며, 메인 세션에서 결과가 필요한 경우 foreground에서 실행시킨다. (Ctrl+B: back으로 sub-agent 이동)

background에서 실행 중인 sub-agent의 도구 호출을 위해 Esc를 누르면 해당 agent 자체가 죽는 것이 아닌, 그 도구 호출만 거부하고 다른 작업을 실행한다.

2) Artifact

HTML 또는 Markdown 파일을 artifact로 게시한다.

이는 Claude의 '비공개 대화형 페이지'로써, 사용자가 공유를 하면 다른 사람들도 해당 링크를 통해 들어가 내용을 확인할 수 있다.

개인적으로 나는 아래 방법으로 사용하고 있다.

• 디자인 하기 전 디자인 후보를 artifact로 보고 확정 짓기
• 빠르게 보고서 작성
• 세션 내 기록을 효과적으로 확인할 때

artifact의 지속 시간은 '설정 > 데이터 및 개인정보 보호 제어'에서 관리할 수 있다.

또한 artifact 그리는 것을 Claude에게 요청할 때 /artifact-design 스킬이 발동된다.

3) AskUserQuestion

요구사항을 수집하거나 모호함을 명확히 하기 위해 사용자에게 질문을 해주는 Tool이다.

이는 사용자가 답변할 때까지 열려있으며, default에는 timeout 없이 계속 떠있다.

만약 떠있는 시간을 제한하고 싶으면(일정 시간 지나면 대화창 닫히고 진행), askUserQuestionTimeout을 설정할 수 있다. (ex. 60s, 10m )

만약 제한시간을 설정하면 해당 대화창에서 20초부터 카운트다운이 표시된다.

질문 형태는 기본적으로 객관식이며, 그 안에서 '주관식'으로 답변도 가능하다.