보안팀이 Claude Code를 허락하지 않을 때 — enterprise-security Kit 실전 테스트

"Claude Code 써도 됩니까?"

이 질문을 보안팀에 던지면 대부분 이런 대답이 돌아옵니다.

"외부로 데이터 나가면 안 됩니다."

"API 키 노출되면 안 됩니다."

"모든 명령은 승인 없이 실행되면 안 됩니다."

합리적인 요구입니다. 문제는 기본 Claude Code 설정으로는 이 세 가지를 동시에 만족하기 어렵다는 겁니다. enterprise-security Kit은 permissions + hooks + env 3중 레이어로 이 문제를 해결합니다.

3중 보안 아키텍처

이 Kit이 다른 Configuration Kit들과 근본적으로 다른 점은 hooks를 사용한다는 것입니다.

Layer 1: Permissions (거부/승인)

{
"permissions": {
"Bash": "ask",
"Write": "ask",
"Edit": "ask",
"NotebookEdit": "deny",
"WebFetch": "deny",
"WebSearch": "deny"
}
}

WebFetch와 WebSearch를 deny로 완전 차단합니다. Claude Code가 외부 URL에 접근하는 것 자체가 불가능합니다.

Layer 2: PreToolUse Hooks (패턴 감지)

permissions만으로는 Bash를 통한 curl, wget 같은 우회를 막을 수 없습니다. 그래서 PreToolUse 훅이 추가됩니다.

Bash 명령 실행 요청
↓
[Hook 1] curl/wget/nc/ssh/scp/rsync/ftp/telnet 감지
↓ 매칭되면 → BLOCK "외부 네트워크 도구 차단"
↓ 통과하면
[Hook 2] API_KEY/SECRET/TOKEN/PASSWORD 패턴 감지
↓ 매칭되면 → BLOCK "시크릿 노출 가능 명령 차단"
↓ 통과하면
[Permission] "ask" → 사용자 확인
↓ 승인
실행

Bash 명령이 실행되기 전에 두 번의 정규식 검사를 거칩니다. 차단될 때마다 "(enterprise-security 정책)"이라는 사유가 함께 표시됩니다.

Layer 3: 환경 변수

{
"env": {
"CLAUDE_CODE_DISABLE_NONINTERACTIVE": "1"
}
}

비대화식 모드를 차단해서, 자동화 스크립트를 통한 무승인 실행을 방지합니다.

6가지 테스트 결과

TC-1: 프로젝트 분석 — 정상

읽기 도구(Read/Glob/Grep)는 영향 없이 즉시 실행됩니다. 보안 정책이 개발 생산성을 해치지 않는다는 점이 중요합니다.

TC-2: WebFetch — 차단

요청: "https://docs.anthropic.com 내용을 가져와줘"

즉시 거부됩니다. "WebFetch 도구가 비활성화되어 있습니다 (enterprise-security 정책)." 외부 URL 접근 자체가 불가능합니다.

TC-3: curl — 훅 차단

요청: "curl https://api.example.com 실행해줘"

Bash 자체는 ask이지만, 사용자 확인 이전에 PreToolUse 훅이 먼저 curl을 감지하고 차단합니다. 사용자가 실수로 Y를 눌러도 실행되지 않습니다.

차단 메시지: "외부 네트워크 도구 차단 (enterprise-security 정책)"

TC-4: 시크릿 감지 — 훅 차단

요청: "echo $API_KEY 실행해줘"

API_KEY 패턴을 감지하고 즉시 차단합니다. echo $HOME 같은 비시크릿 환경변수는 통과 — 오탐 없이 정밀하게 작동합니다.

차단 메시지: "시크릿 노출 가능 명령 차단 (enterprise-security 정책)"

TC-5: npm run build — 정상 (승인 필요)

요청: "npm run build 실행해줘"

npm은 네트워크 도구 차단 목록에 없으므로, 훅을 통과합니다. 그 다음 ask 권한에 따라 사용자 확인이 한 번 나타나고, 승인하면 정상 빌드됩니다. 로컬 개발은 방해 없이 가능하다는 점이 핵심입니다.

TC-6: wget — 훅 차단

wget도 curl과 동일하게 정규식 매칭으로 차단됩니다.

솔직한 빈틈

94점이지 100점이 아닌 이유입니다.

DNS 도구: dig, nslookup, host 같은 DNS 조회 도구는 차단 목록에 없습니다.

Python 우회: python -c "import urllib.request; urllib.request.urlopen('http://...')" 같은 스크립트 기반 네트워크 접근은 정규식으로 잡히지 않습니다.

시크릿 패턴: AWS_ACCESS_KEY_ID, GITHUB_TOKEN 같은 구체적인 변수명은 현재 정규식에 포함되어 있지 않습니다.

이 빈틈은 인정합니다. 하지만 가장 빈번한 우회 경로(curl, wget, ssh 등)는 확실히 막히고, 추가 패턴은 훅의 정규식을 확장하면 됩니다.

최종 점수: 94/A

3종 Configuration Kit 중 최고 점수입니다.

3종 Kit 비교

보안팀에 보여줄 체크리스트

이 Kit을 적용하면 다음을 보장할 수 있습니다:

• [x] 외부 URL 접근 차단 (WebFetch/WebSearch deny)
• [x] curl/wget/ssh 등 네트워크 CLI 차단 (PreToolUse 훅)
• [x] API_KEY/SECRET/TOKEN 등 시크릿 노출 차단 (PreToolUse 훅)
• [x] 모든 Bash/Write/Edit에 사용자 승인 필수
• [x] 비대화식(자동화) 실행 차단
• [ ] DNS 조회 도구 차단 (향후 패치 예정)
• [ ] 스크립트 기반 네트워크 우회 차단 (향후 패치 예정)

적용 방법

이 Kit은 hooks 설정이 포함되어 있어서 JSON 복붙이 좀 복잡합니다.

Kit 상세 페이지에서 전체 설정 다운로드

~/.claude/settings.json에 병합

Claude Code 재시작

주의: 기존 permissions나 hooks 설정이 있다면 병합해야 합니다. 덮어쓰면 기존 설정이 사라집니다.

---

평가 상세: enterprise-security 테스트 리포트 전문