Cmd. /approved-tools
레거시 권한 관리 명령 /approved-tools의 역사적 문맥을 설명하고, 현재 표준인 /permissions(별칭 /allowed-tools)로 마이그레이션하는 안내
핵심 요약
- 이전 권한 명령의 현재 대체 경로인 /permissions 안내
- 현재 공식 명령 표에는 없습니다. 아래 예시는 현재 대체 경로이며 이전 이름의 실행을 권장하지 않습니다.
역할
이전 권한 명령의 현재 대체 경로인 /permissions 안내
/approved-tools사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 이전 명령 |
| 상태 | 현재 표에 없음 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
현재 공식 명령 표에는 없습니다. 아래 예시는 현재 대체 경로이며 이전 이름의 실행을 권장하지 않습니다.
사용 예
/permissions/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에서 수행합니다. 이 페이지의 이전 이름은 마이그레이션 참고용입니다.
/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는 신규 운영에서 쓰지 말고, 레거시 문서를 해석하거나 마이그레이션할 때의 역사적 맥락으로만 다루는 편이 안전합니다.
주의사항
/approved-tools는 현재 공식 명령 표에 존재하지 않습니다. 신규 운영에서는 사용하지 마세요.- 공식 표준 대체 명령은
/permissions이며, 별칭은/allowed-tools입니다. 두 표기는 동일하게 동작합니다. - 레거시 문서와 신규 문서를 혼합해 사용하면 팀 내 용어가 불일치할 수 있으니, 권한 관련 표기를
/permissions로 통일하는 것을 권장합니다. - 권한 프롬프트가 잦다면
/permissions로 규칙을 조정하거나/fewer-permission-prompts스킬을 함께 활용하세요.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록