Claude 보안 설정,
누가 무엇을 통제할까?

Claude Code를 사내 코드나 데이터와 함께 쓸 때, “보안 설정 하나면 끝”이라고 생각하기 쉽습니다. 하지만 파일 접근을 허용할지, 실행 직전에 검증 코드를 돌릴지, 모델에게 어떤 작업 절차를 알려줄지, 외부 통신을 어디로 보낼지는 각각 다른 문제입니다.

오늘은 이 도구들을 권한 정책, 이벤트 실행, 모델 지침, 네트워크 경계로 나눠서 살펴봅니다. 설정 파일은 단순 참고 자료가 아니라 Claude Code가 실제 도구 권한을 판단할 때 읽는 정책 파일이라는 점부터 짚고 갈게요.

settings.json은 Claude가 읽고 “이번엔 허용하자”고 해석하는 안내문이 아닙니다. Claude Code 프로그램이 도구 사용 전에 적용하는 설정입니다. Permission 규칙에서는 대체로 deny가 ask보다 우선하고, ask는 allow보다 우선합니다. 허용 규칙이 있다고 해서 더 제한적인 거부 규칙을 덮어쓰지는 않습니다.

예를 들어 프로젝트의 .claude/settings.json에 허용·질문·거부 규칙을 두면, 팀에서 공유할 수 있습니다. 반면 조직 전체에 강제하려는 정책이라면 개발자가 고칠 수 있는 프로젝트 파일만 믿어서는 부족합니다. 공식 문서에서 Managed Settings는 개인·프로젝트 설정보다 우선하는 관리 계층으로 설명합니다.

Hook은 특정 시점에 연결한 실제 프로그램입니다. 예를 들어 PreToolUse는 도구 실행 전에 조건에 맞는 Hook을 돌릴 수 있고, Hook은 입력을 검사해 진행·승인 요청·차단 결정을 반환할 수 있습니다. 반면 PostToolUse는 작업이 끝난 뒤이므로 이미 일어난 실행을 되돌리는 사전 차단 장치가 아닙니다.

또 하나의 함정은 실패 시 동작입니다. 현재 공식 문서에 따르면 대부분 이벤트에서 Hook이 실행되지 않거나 시간 초과되면 기본적으로 작업이 계속될 수 있습니다. 지원되는 버전에서 command/HTTP Hook에 onFailure: "block"을 명시하면 실패 시 차단하는 설정이 가능합니다. 보안 검사를 “실패하면 통과”로 둘지 “실패하면 중단”으로 둘지 의식적으로 결정해야 합니다.

Skill은 Claude가 특정 일을 더 일관되게 수행하도록 맥락과 절차를 담은 문서입니다. 예를 들어 “민감한 실적 데이터는 가상 데이터로 대체하고, 외부 공유 전에 사용자에게 알린다” 같은 팀 작업 지침을 적을 수 있습니다. Claude는 Skill의 설명을 보고 적절한 것을 찾고, 호출된 Skill의 본문을 컨텍스트에 불러와 작업에 참고합니다.

즉 Skill은 행동을 유도하고, Settings와 Hook 같은 Claude Code 기능은 도구 실행 흐름에 규칙을 적용합니다. 실제 데이터 경계는 여기에 운영체제·샌드박스·네트워크 정책까지 더해져야 합니다.

여기서 Gateway는 Skill이나 Hook처럼 모든 설치에 기본으로 켜져 있는 단일 보안 스위치라는 뜻이 아닙니다. 조직이 프록시나 LLM Gateway를 구성하면 Claude Code의 모델 요청을 정해진 경로로 보내고, 그 인프라에서 인증·라우팅·로깅·정책 검사를 제공할 수 있습니다. 실제로 어떤 내용을 검사·차단할 수 있는지는 Gateway 제품과 연결 방식, TLS 처리, 조직 정책에 달려 있습니다.

이 차이는 중요합니다. 모델에 민감정보가 도달하지 않게 해야 한다면 “파일 읽기 Hook을 만들었다”만으로 충분하지 않습니다. 어떤 입력이 모델 요청에 포함될 수 있는지, Gateway가 실제로 그 요청을 통제하는지, 허용되지 않은 네트워크 경로를 막았는지를 함께 확인해야 합니다.

가령 “사내 생산 실적을 분석해 보고서를 작성해줘”라는 요청을 받았다고 해보겠습니다.

핵심은 ‘Claude에게 잘 부탁하기’와 ‘실행 경계에서 실제로 막기’를 구분하는 것. 지침·권한·검증·네트워크 통제를 겹쳐야 보안 설계가 됩니다.