Cmd. /approved-tools (renamed)
레거시 권한 관리 명령 /approved-tools의 역사적 문맥을 설명하고, 현재 표준인 /permissions(별칭 /allowed-tools)로 마이그레이션하는 안내
핵심 요약
/approved-tools는 현재 공식 명령 표에 더 이상 존재하지 않으며, 도구 권한 관리는/permissions로 통합·승계되었습니다.- 현재 표준은
/permissions이고 별칭은/allowed-tools로, 두 표기는 동일하게 동작합니다. /permissions는 allow/ask/deny 규칙을 범위별로 보고·추가·삭제하고, 작업 디렉터리 관리와 최근 auto 모드 거부 검토를 제공합니다.- 레거시 문서에서
/approved-tools표기를 만나면/permissions로 매핑하고, 권한 프롬프트가 잦으면/fewer-permission-prompts스킬을 함께 씁니다.
명령어 원본 선언
/approved-tools공식 설명 요약
/approved-tools는 현재 공식 Claude Code 명령어 목록에 더 이상 존재하지 않습니다.
공식 문서(/commands)의 빌트인 명령 표 어디에도 /approved-tools 항목이 없고, 도구 권한 관리 기능은 /permissions 명령이 통합·승계했습니다.
현재 표준 명령인 /permissions의 공식 설명은 다음과 같습니다.
Manage allow, ask, and deny rules for tool permissions. Opens an interactive dialog where you can view rules by scope, add or remove rules, manage working directories, and review recent auto mode denials. Alias:
/allowed-tools
/permissions는 도구 권한의 allow / ask / deny 규칙을 관리하고, 범위(scope)별로 규칙을 확인·추가·삭제하며, 작업 디렉터리를 관리하고, 최근 auto 모드 거부 내역을 검토하는 인터랙티브 대화창을 엽니다. 별칭(alias)은 /allowed-tools 입니다.
그러니 /approved-tools는 신규 운영에서 쓰지 말고, 레거시 문서를 해석하거나 마이그레이션할 때의 역사적 맥락으로만 다루는 편이 안전합니다.
최소 지원 버전
- 공식 문서는
/permissions(별칭/allowed-tools)에 대해 별도의 최소 지원 버전을 명시하지 않습니다. /approved-tools는 현재 공식 명령 표에 등재되어 있지 않으므로, 특정 버전부터 동작한다고 단정할 수 없습니다. 레거시 문서에 등장하는 표기로만 취급하세요.
사용법
/approved-tools는 더 이상 권장되지 않습니다. 권한 관리는 다음 명령으로 수행합니다.
# 현재 표준
/permissions
# 동일하게 동작하는 별칭
/allowed-tools위 명령을 실행하면 인터랙티브 대화창이 열리며, 범위별 규칙 보기, allow/ask/deny 규칙 추가·삭제, 작업 디렉터리 관리, 최근 auto 모드 거부 내역 검토를 할 수 있습니다.
좋은 사용 예
- 구버전 문서·플레이북에서
/approved-tools표기를 발견하면/permissions(또는/allowed-tools)로 매핑하여 갱신 - 팀 권한 정책 문서를 리팩터링하면서 명령 용어를
/permissions기준으로 통일 /permissions로 allow/ask/deny 규칙을 범위별로 점검하고 작업 디렉터리 설정을 정리
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/approved-tools | 레거시 권한 명령, 현재 공식 목록에 없음 | 구버전 문서 해석·마이그레이션 목적 |
/permissions | 현재 권한 관리 표준 (allow/ask/deny 규칙 관리) | 실제 운영 설정 목적 |
/allowed-tools | /permissions의 공식 별칭, 동일 동작 | /permissions와 동일 |
/fewer-permission-prompts | 번들 스킬, 자주 쓰는 읽기 전용 호출 허용목록 생성 | 권한 프롬프트를 줄이고 싶을 때 |
/add-dir <path> | 현재 세션의 파일 접근 작업 디렉터리 추가 | 추가 디렉터리 접근이 필요할 때 |
활용 사례
- 레거시 플레이북에서 권한 관련 용어를
/permissions기준으로 정리 - 권한 정책 운영 문서를 단일 표준 명령으로 통일
- 신규 멤버 온보딩 시 "권한은
/permissions(별칭/allowed-tools)로 관리한다"는 기준 전달
주의사항
/approved-tools는 현재 공식 명령 표에 존재하지 않습니다. 신규 운영에서는 사용하지 마세요.- 공식 표준 대체 명령은
/permissions이며, 별칭은/allowed-tools입니다. 두 표기는 동일하게 동작합니다. - 레거시 문서와 신규 문서를 혼합해 사용하면 팀 내 용어가 불일치할 수 있으니, 권한 관련 표기를
/permissions로 통일하는 것을 권장합니다. - 권한 프롬프트가 잦다면
/permissions로 규칙을 조정하거나/fewer-permission-prompts스킬을 함께 활용하세요.
출처
- 공식 명령어 레퍼런스: https://code.claude.com/docs/en/commands