Claude Code skills 권한: allowed tools와 visibility를 안전하게 운영하는 법 | DAKER 커뮤니티
Claude Code skills 권한 운영의 핵심은 사전 승인과 실제 제한을 분리해서 설계하는 것입니다. Skill이란 반복 절차와 지침을 하나의 Claude Code 실행 단위로 포장한 파일 기반 능력입니다. 오늘은 2026년 7월 13일 KST 기준 공식 문서에서 확인한 allowed tools, disallowed tools, visibility, subagent preload 흐름을 팀 운영 기준으로 정리합니다.
문제 상황: skill을 만들었는데 권한 경계가 흐려지는 이유는?
반복 업무를 skill로 묶으면 팀원은 같은 절차를 빠르게 실행할 수 있습니다. 하지만 사전 승인 필드를 “이 skill은 이 도구만 쓴다”는 뜻으로 이해하면 위험합니다. 공식 문서 기준으로 allowed tools는 skill 활성 중 지정 도구를 승인하는 편의 장치이고, 도구 풀 자체를 좁히는 제한 장치가 아닙니다.
핵심 개념: 사전 승인과 실제 제한은 어떻게 다를까?
한 줄 요약: allowed tools는 승인 피로를 줄이고, disallowed tools와 permission 정책은 실행 경계를 좁힙니다. 팀 skill은 이름과 설명보다 권한 의도가 더 중요합니다. 실행 중 파일 수정, 셸 명령, 외부 도구 접근이 필요한지 먼저 나누어야 합니다.
단계별 사용법: 안전한 팀 skill은 어떻게 배포할까?
- 반복 절차인지, 단순 지식인지 먼저 구분합니다.
- 자동 승인할 도구와 절대 쓰면 안 되는 도구를 따로 적습니다.
- 프로젝트에 넣는 skill은 저장소 trust 전에 리뷰해야 한다고 안내합니다.
- 하위 에이전트에 지식만 주입할 때는 skills preload를 쓰고, 실행을 분리할 때는 fork 실행을 검토합니다.
- 너무 자주 발동하거나 안 발동하는 skill은 description을 조정하고, 강제 차단은 hooks로 분리합니다.
짧은 예시: 배포 전 점검 skill을 만들 때
배포 전 점검 skill이 git 상태 확인과 테스트 실행만 필요하다면 그 도구만 사전 승인합니다. 파일 삭제나 배포 명령은 skill이 직접 수행하지 않도록 분리합니다. 답변 형식까지 통일하려면 output styles 글을 함께 참고하고, 반복 절차 설계는 Claude Code Skills 팀 명령어 글과 연결하면 좋습니다.
팀 적용 체크리스트: 게시 전 무엇을 확인할까?
- skill 설명이 언제 실행해야 하는지 명확하게 말하는지 확인합니다.
- allowed tools를 편의 승인으로, disallowed tools를 제한으로 분리해 적습니다.
- 저장소에 들어간 skill은 코드 리뷰 대상에 포함합니다.
- 하위 에이전트에 preload할 skill은 지식 전달용인지 실행용인지 구분합니다.
- 보안 경계는 skill 설명보다 hooks 차단 정책으로 고정합니다.
공식 출처 기준으로 무엇을 조심해야 할까?
작성 기준일은 2026년 7월 13일 KST입니다. 공식 문서는 bundled skills, 프로젝트 skill, 하위 에이전트 preload, fork 실행을 서로 다른 사용 패턴으로 설명합니다. 공개 본문에는 외부 공식 링크를 넣지 않았고, 기능 사실은 private verification에서만 확인했습니다.
자주 묻는 질문
allowed tools를 쓰면 다른 도구는 자동으로 막히나요?
아닙니다. 공식 문서 기준으로 allowed tools는 사전 승인에 가깝습니다. 실제 제한은 disallowed tools나 permission 정책을 함께 써야 합니다.
프로젝트 skill은 바로 신뢰해도 되나요?
아닙니다. 저장소에 포함된 skill도 실행 권한을 넓힐 수 있으므로 trust 전에 내용을 읽어야 합니다.
skill을 하위 에이전트에 넣으면 무엇이 달라지나요?
skills preload는 하위 에이전트 시작 시 관련 지식을 넣어 줍니다. 실행 격리가 목적이면 fork 흐름을 따로 검토해야 합니다.
오늘 바로 점검할 항목은 무엇인가요?
팀 skill 한 개를 골라 자동 승인 도구, 금지 도구, 리뷰 담당자를 세 줄로 적어 보세요.
오늘은 자주 쓰는 skill 하나를 고르고, 편의 승인과 실제 제한을 분리해 다시 점검해 보세요.