클로드 코드 권한 감사: 도구 접근 범위 지정 실무 가이드

최근 r/ClaudeAI의 한 개발자가 자신의 Claude Code 권한을 감사하다가 AI에게 범위를 고려하지 않고 막연한 도구 접근 권한을 부여했다는 사실을 발견했습니다. 그 결과, Claude는 이론적으로 .env 파일을 수정하고, 프로덕션 설정을 변경하며, 다른 프로젝트에 사용되는 디렉토리에 쓸 수 있었습니다. 실제 사고는 발생하지 않았지만, 저자는 "아직 아무 잘못도 일어나지 않았다"는 이유로 이런 설정을 유지하는 것은 타당하지 않다고 주장합니다.

주요 발견 사항

• 전역 대 프로젝트별 도구 접근: 많은 설정이 도구를 전역적으로 허용하지만, 특정 프로젝트나 디렉토리로 제한해야 합니다.
• CLAUDE.md 비밀 정보: 시스템의 CLAUDE.md 파일에 Claude가 읽거나 쓸 수 있는 비밀 정보나 민감한 경로가 있는지 확인하세요.
• 모호한 지시: 실제 위험은 악의적인 AI 행동보다는 광범위한 해석에 더 가깝습니다. 예를 들어, "이 모듈을 리팩터링하라"는 지시가 권한이 범위 내에 있지 않으면 인접 모듈까지 실수로 건드릴 수 있습니다.

감사 프로세스

1. Claude Code 구성에서 전역적으로 허용된 도구와 프로젝트별로 허용된 도구를 모두 나열하세요.
2. 시스템 전체의 CLAUDE.md 파일에서 하드코딩된 비밀 정보, API 키, 또는 민감한 디렉토리 경로를 검토하세요.
3. 어떤 파일과 디렉토리를 제한해야 할지 정의하세요(예: .env, 프로덕션 설정, 다른 프로젝트 디렉토리).
4. 모델이 올바르게 추측하도록 두지 말고 이러한 경계를 명시적으로 만들기 위해 권한을 업데이트하세요.

권한 범위를 지정하면 암묵적 신뢰가 명시적 경계로 바뀝니다. 이는 프로덕션 환경과 개발 환경이 혼합된 프로젝트에서 특히 중요합니다. 전체 Reddit 스레드에는 특정 권한 모델 및 도구 구성에 대한 커뮤니티 토론이 포함되어 있습니다.