Security

2026년 Claude Code 설정은 Agent가 고쳐 쓸까요? SBPL 변조 방지

2026년 Claude Code 설정은 Agent가 고쳐 쓸까요? SBPL 변조 방지

공식 설정 문서는 Claude Code 설정 범위를 managed, user, project, local 네 층으로 나눕니다. 공식 설정 문서에 나온 이 구조가 뜻하는 결론은 분명합니다. Agent가 쓸 수 있는 프로젝트 설정은 우선순위가 높아도 안전 경계가 아닙니다. 개인이 지켜보는 작업이면 denyWrite와 실패 시 중단을 함께 적용하고, 팀 작업이나 무인 실행이면 핵심 정책을 managed settings로 옮겨야 합니다. 그래도 부족한 고위험 작업은 SBPL로 전체 프로세스를 감싸거나 독립 Mac 환경으로 분리해야 합니다.

이 글은 프로젝트 저장소에 .claude/settings.json을 두고 Claude Code가 파일을 자동 편집하는 개발자를 위한 글입니다. 팀 정책이 프로젝트 설정으로 약해지지 않아야 하는 DevSecOps 담당자, 원격 Mac에서 장시간 Agent를 실행하려는 플랫폼 책임자도 대상입니다.

마지막 업데이트는 2026년 9월 15일입니다. 설정 범위와 권한 필드는 공식 권한 문서, 설정 진단 문서, 샌드박스 문서를 기준으로 확인했습니다.

같은 쓰기 경계에 놓인 Agent와 정책 파일

가장 먼저 봐야 할 실패 모델은 파일 삭제가 아닙니다. Agent와 Agent의 권한을 정의하는 파일이 같은 쓰기 가능한 디렉터리에 있다는 점입니다.

프로젝트 폴더에 다음 경로가 있다고 가정합니다.

project/
  .claude/settings.json
  .claude/hooks/
  .claude/skills/
  src/

src만 편집하게 만들었다고 생각해도 실제 쓰기 범위에 project/ 전체가 들어가면 .claude도 같은 경계에 놓입니다. Agent는 내장 Edit와 Write 도구를 사용할 수 있습니다. Bash를 통해 실행되는 자식 프로세스도 별도로 확인해야 합니다.

여기서 중요한 구분이 있습니다.

  • 내장 Edit와 Write는 Claude Code 권한 설정의 영향을 받습니다.
  • 공식 Bash Sandbox는 주로 Bash와 그 자식 프로세스를 제한합니다.
  • Bash Sandbox가 켜져 있어도 Claude Code 본체의 설정 파일 보호를 자동으로 보장하지는 않습니다.
  • Sandbox Runtime, Seatbelt, sandbox-exec, 직접 작성한 SBPL은 서로 같은 층이 아닙니다.

따라서 “Bash가 격리되어 있으니 설정도 안전하다”는 판단은 성립하지 않습니다. 설정 파일의 실제 경로와 각 도구의 적용 범위를 따로 확인해야 합니다.

프로젝트 설정과 보호된 관리 설정

프로젝트 설정은 협업에 편리합니다. 저장소와 함께 배포할 수 있고, 특정 작업에 필요한 권한을 문서화하기 쉽습니다. 실험용 정책을 빠르게 바꾸기에도 좋습니다.

하지만 최종 방어선으로는 약점이 있습니다.

  • Agent가 프로젝트 디렉터리를 쓸 수 있으면 .claude도 함께 수정될 수 있습니다.
  • hooks와 skills는 다음 세션의 동작에 영향을 줄 수 있습니다.
  • 로컬 설정은 개인 환경에 남기 쉽고 팀 전체의 강제 정책이 되기 어렵습니다.
  • 정책 파일과 작업 파일을 같은 복구 단위로 관리하면 변조 원인을 추적하기 어렵습니다.

업무 설정과 보안 설정을 분리해야 합니다. 저장소에 넣어도 되는 것은 허용된 작업 흐름, 프로젝트별 도구 안내, 협업용 규칙입니다. 반대로 샌드박스 우회 금지, 실패 시 중단, 관리 경로 보호처럼 반드시 지켜야 하는 규칙은 Agent가 쓰는 위치에서 꺼내야 합니다.

managed settings는 이 목적에 더 적합합니다. 다만 최고 우선순위라는 표현을 파일 불변성으로 오해하면 안 됩니다. 관리 파일의 운영체제 권한, 배포 위치, 복구 방법까지 함께 설계해야 합니다. 팀 운영자는 ProxyMac 도움말을 참고해 원격 실행 환경의 접근 절차도 별도로 정리하는 편이 좋습니다.

설정 병합과 숨은 권한 확장

설정 파일 하나만 열어 보고 실제 정책을 판단하면 안 됩니다. managed, 사용자, 프로젝트, 로컬 범위가 함께 적용되기 때문입니다. 공식 문서는 적용 범위와 우선순위를 설명하지만, 현장에서 필요한 질문은 “최종적으로 어떤 규칙이 살아 있는가”입니다.

특히 allowWrite 같은 배열형 값은 단순한 파일 덮어쓰기로 생각하기 어렵습니다. 범위가 합쳐지거나 다른 설정 출처가 함께 반영될 수 있습니다. 한 파일에서 경로를 지웠다는 사실만으로 최종 쓰기 대상이 줄었다고 단정하면 안 됩니다.

확인은 다음 순서로 진행합니다.

  • /status에서 현재 세션이 참조하는 설정 출처를 확인합니다.
  • /permissions에서 실제 허용 및 거부 규칙을 확인합니다.
  • /doctor에서 설정 충돌이나 해석 오류를 확인합니다.
  • 별도 임시 디렉터리에서 허용 경로와 거부 경로를 각각 시험합니다.
  • 설정을 바꾼 뒤 새 세션에서 같은 검사를 반복합니다.

이 과정은 쓰기 허용 목록을 무작정 줄이는 방법과 다릅니다. 여기서는 “정책 파일을 누가 바꿀 수 있는가”를 확인하는 것이 핵심입니다. 프로젝트 설정이 팀의 관리 규칙보다 약한지, 로컬 설정이 예상하지 못한 권한을 더하는지부터 확인해야 합니다.

샌드박스 실패와 계속 실행되는 경로

샌드박스가 있다는 사실보다 중요한 것은 샌드박스가 실패했을 때 무엇이 일어나는가입니다. 위험한 경우는 다음 세 가지로 나뉩니다.

  • 초기화 실패: Sandbox Runtime 또는 Seatbelt 정책을 준비하지 못한 경우입니다.
  • 일반 권한으로 회귀: 격리된 실행을 시작하지 못했는데 작업 자체는 계속되는 경우입니다.
  • 명시적 비샌드박스 실행: 사용자가 우회 옵션이나 별도 실행 경로를 허용한 경우입니다.

첫 번째와 두 번째를 같은 것으로 보면 안 됩니다. 초기화 실패는 오류일 수 있지만, 일반 권한으로 계속 실행되면 정책 파일 보호라는 가정이 깨집니다. 설정 문서에서 failIfUnavailable의 현재 의미와 기본 동작을 확인하고, 샌드박스를 사용할 수 없을 때 작업을 중단하는 조합을 선택해야 합니다.

allowUnsandboxedCommands도 같은 방식으로 검토해야 합니다. 필요한 명령을 편하게 통과시키는 옵션이 아니라, 격리 바깥으로 나가는 통로가 될 수 있기 때문입니다. 다만 필드의 기본값과 적용 범위는 버전에 따라 달라질 수 있으므로, 실행 시점의 공식 샌드박스 문서를 기준으로 확인해야 합니다.

주의: 정책 파일이 수정되지 않았더라도 실행이 일반 권한으로 바뀌었다면 방어 상태는 동일하지 않습니다. 실패하면 중단되는지, 비샌드박스 경로가 닫혔는지를 별도 시험으로 검증해야 합니다.

명령을 폭넓게 제외해 오류를 없애는 방식도 피해야 합니다. 특정 명령을 계속 예외 처리하면 실패 시 중단 정책이 약해지고, 무엇이 격리 밖에서 실행되는지 추적하기 어려워집니다.

Claude Code 설정 변조 방지와 SBPL

공식 Bash Sandbox와 손으로 작성한 SBPL은 적용 범위가 다릅니다. 전자는 Bash 및 자식 프로세스에 초점을 둡니다. 후자는 프로세스를 시작하는 순간 macOS Seatbelt 정책을 붙여 Claude Code 본체와 자식 프로세스를 함께 제한하는 방식입니다.

macOS에서 sandbox-exec는 아직 호출할 수 있지만, 현재 설명서에는 사용 중단 상태로 표시됩니다. sandbox-exec 설명서와 macOS Sandbox 설명서를 보면 이 도구를 장기적으로 지원되는 기반으로 간주하기 어렵습니다. 현재 검증용 경량 보호층으로 사용할 수 있다는 것과, 미래에도 유지될 것이라는 주장은 구분해야 합니다.

검증은 실제 비밀 키나 운영 저장소에서 하지 않습니다. 임시 경로와 존재하지 않는 시험 파일만 사용합니다.

(version 1)
(deny default)

(allow process*)
(allow sysctl-read)

(allow file-read*
  (subpath "/usr")
  (subpath "/bin")
  (subpath "/System/Library"))

(allow file-write*
  (subpath "/tmp/claude-sbpl-demo"))

위 예시는 /tmp/claude-sbpl-demo만 쓰기 대상으로 둔 최소 시험용 형태입니다. 실제 시스템 경로, 비밀 키, 운영 저장소를 보호 대상으로 넣어 검증하지 않습니다. 실행에 필요한 읽기 경로가 환경마다 다를 수 있으므로, 실패한 규칙을 무조건 넓히지 말고 어떤 접근이 필요한지 기록해야 합니다.

실행 방식은 프로필을 별도 파일로 저장한 뒤 되돌릴 수 있는 함수로 감싸는 편이 안전합니다.

claude_sbpl_demo() {
  sandbox-exec \
    -f "$HOME/.config/claude/demo.sb" \
    claude
}

이 방식의 장점은 실행 경계를 눈에 보이게 만드는 것입니다. 단점도 분명합니다.

  • 장점: Claude Code 본체와 자식 프로세스의 쓰기 범위를 함께 제한할 수 있습니다.
  • 장점: 프로젝트 밖의 정책 파일과 설정 경로를 허용 목록에서 제외하기 쉽습니다.
  • 단점: sandbox-exec는 사용 중단 상태입니다.
  • 단점: 프로필 문법 오류나 누락된 읽기 권한으로 실행이 실패할 수 있습니다.
  • 단점: Agent가 프로필 파일이나 실행 함수를 바꿀 수 있으면 보호가 약해집니다.

따라서 SBPL 파일도 프로젝트의 쓰기 가능 경로에 두면 안 됩니다. 더구나 Agent가 새 프로세스를 샌드박스 밖에서 시작할 수 있는 경로가 남아 있는지 확인해야 합니다. Anthropic의 Sandbox Runtime 공개 저장소는 macOS에서 sandbox-exec와 사용자 정책을 사용하는 구현 사례를 보여 주지만, 이 사실이 모든 Claude Code 실행을 자동으로 보호한다는 뜻은 아닙니다.

위험도별 실행 환경 분기

최종 선택은 도구 이름보다 작업 방식으로 결정해야 합니다. 아래 기준에서 하나라도 더 높은 위험에 해당하면 정책 파일을 프로젝트 밖으로 이동해야 합니다.

실행 조건 권장 경계 핵심 이유 피해야 할 선택
개발자가 계속 지켜보는 개인 작업 프로젝트 설정과 denyWrite, 실패 시 중단 즉시 승인하고 세션을 종료할 수 있음 프로젝트 전체 쓰기 허용
팀이 공유하는 작업 managed settings와 별도 배포 경로 프로젝트 변경으로 팀 규칙이 약해지는 것을 방지 보안 규칙을 .claude에만 저장
무인 실행 또는 장시간 작업 관리 정책과 전체 프로세스 격리 실패와 우회 경로를 자동으로 차단 샌드박스 실패 뒤 일반 실행
운영 데이터에 접근하는 고위험 작업 독립 Mac 환경과 외부 정책 저장소 복구와 환경 독점성을 확보 개발 저장소와 같은 실행 환경

독립 Mac으로 옮길 때는 성능이나 가격보다 정책 파일의 위치, 전달 방식, 복구 가능성, 환경 독점성을 먼저 봐야 합니다. 실행 환경을 따로 두면 프로젝트 설정이 바뀌어도 관리 정책과 복구 지점이 함께 오염될 가능성을 줄일 수 있습니다. 반대로 물리 인터페이스가 필요하거나 장기간 안정적인 고부하 작업이 중심이면 임시 대여 환경이 최선이 아닐 수 있습니다.

장기 실행을 검토하는 팀은 먼저 정책 파일 위치, 무인 실행 여부, 허용 쓰기 경로를 문서화해야 합니다. 그다음 ProxyMac 콘솔에서 독립된 원격 Mac 환경으로 격리 검증을 진행하는 방식이 현실적입니다. 실행 기간이 짧은 검증이라면 ProxyMac 요금 안내에서 대여 조건을 확인한 뒤, 장기 구매와 비교하는 편이 낫습니다.

자주 확인하는 설정 경계

Agent가 자신의 설정 파일을 바꿀 수 있는 조건

가능합니다. 단, 반드시 현재 세션의 도구와 파일 권한을 함께 봐야 합니다. .claude/settings.json이 작업 범위 안에 있고 쓰기 권한이 허용되어 있다면 내장 도구 또는 Bash 자식 프로세스를 통해 변경될 여지가 있습니다. 반대로 managed 정책과 파일 시스템 경계가 분리되어 있으면 프로젝트 설정을 바꿔도 핵심 규칙이 따라 바뀌지는 않습니다.

.claude 쓰기 차단의 실제 기준

쓰기 차단은 파일 이름이 아니라 경로 범위로 판단해야 합니다. project/ 전체를 허용하면서 .claude/settings.json만 금지하는 방식은 우회 경로를 남길 수 있습니다. .claude, hooks, skills, 실행 스크립트, 정책 파일이 실제로 어느 상위 디렉터리에 있는지 먼저 확인해야 합니다.

managed settings와 프로젝트 설정의 역할 차이

프로젝트 설정은 업무 협업에 적합합니다. managed settings는 팀이 강제해야 하는 보안 기준에 적합합니다. 다만 managed settings도 실행 환경에서 읽히는 파일이므로 운영체제 수준의 접근 제한과 백업이 필요합니다. 가장 강한 형태는 관리 정책을 Agent가 쓰지 못하는 위치에 두고, 실패 시 실행을 멈추며, 고위험 작업에서는 독립 환경을 사용하는 것입니다.

SBPL의 적용 범위

SBPL은 Claude Code 전체 프로세스를 시작 단계에서 제한할 수 있습니다. 공식 Bash Sandbox보다 넓은 범위를 다룰 수 있다는 점이 장점입니다. 그러나 sandbox-exec는 사용 중단 상태이므로 장기 운영의 유일한 방어선으로 두면 안 됩니다. 현재는 임시 검증과 경량 격리에 사용하고, 지속 운영에는 현대적인 가상화 또는 독립 Mac 환경을 함께 검토해야 합니다.

현재 개발 환경만으로 운영하면 프로젝트 설정, Agent 프로세스, 복구 지점이 한곳에 모입니다. 이 구조는 정책 파일이 바뀌었을 때 원인을 추적하기 어렵고, 샌드박스 초기화 실패 뒤 일반 권한으로 이어질 위험도 남깁니다. 특히 무인 실행에서는 사람이 즉시 승인하거나 중단할 수 없습니다. 이런 조건이라면 ProxyMac의 독립 Mac 대여 환경에서 정책 파일을 외부에 두고 격리 검증을 수행하는 편이 더 나은 선택입니다. 핵심은 단순히 Mac을 빌리는 것이 아니라, Agent가 바꿀 수 있는 파일과 팀이 지켜야 하는 정책을 서로 다른 실행 경계에 배치하는 것입니다.

FAQ

Claude Code가 자신의 settings.json을 직접 바꿀 수 있나요?+
가능성은 설정 파일이 있는 경로에 쓰기 권한이 열려 있는지에 달려 있습니다. 프로젝트 폴더와 그 안의 .claude 디렉터리가 쓰기 대상이면 Agent의 Edit, Write 또는 Bash 자식 프로세스가 파일을 바꿀 수 있습니다. 설정 우선순위가 높아도 파일 자체가 읽기 전용으로 보호되는 것은 아니므로, 핵심 정책은 Agent가 쓰지 못하는 managed settings나 외부 실행 환경에 둬야 합니다.
Claude Code가 .claude 디렉터리에 쓰지 못하게 하려면 어떻게 하나요?+
공식 권한 설정에서 쓰기 거부 규칙을 적용하고, 실제 작업 경로에 .claude가 포함되는지 확인해야 합니다. 실패 시 일반 권한으로 계속 실행되는 경로도 함께 닫아야 합니다. 더 강한 보호가 필요하면 Claude Code 전체를 SBPL 프로필로 시작해 .claude 경로를 허용 목록에서 제외합니다. 적용 뒤에는 /status, /permissions, /doctor로 실제 출처를 다시 확인합니다.
managed settings와 프로젝트 설정 중 어느 쪽이 더 안전한가요?+
팀 전체의 강제 규칙에는 managed settings가 더 적합합니다. 공식 설정 우선순위에서 가장 높은 위치에 있고 프로젝트 저장소와 분리해 배포할 수 있기 때문입니다. 다만 우선순위가 높다는 사실만으로 파일 변조가 막히지는 않습니다. Agent가 관리 파일이 있는 경로에 접근할 수 있다면 파일 시스템 보호와 실행 환경 분리가 함께 필요합니다.
SBPL로 Claude Code 전체 프로세스의 쓰기 권한을 제한할 수 있나요?+
가능합니다. macOS의 sandbox-exec로 Claude Code 프로세스를 시작하면 해당 프로세스와 자식 프로세스에 별도의 SBPL 규칙을 적용할 수 있습니다. 따라서 Bash만 다루는 공식 Bash Sandbox보다 넓은 범위를 통제할 수 있습니다. 다만 sandbox-exec는 사용 중단 상태로 표시되어 장기 기반으로 의존하면 안 됩니다. 고위험 업무는 독립 Mac이나 현대적인 가상화 방식으로 이전하는 편이 안전합니다.

에이전트 설정 변경을 독립된 맥 환경에서 안전하게 검증해 보세요

ProxyMac은 에이전트의 권한과 설정을 실제 작업 환경과 분리해 점검할 수 있는 원격 맥 환경을 제공합니다.
프로젝트 설정과 샌드박스 정책을 적용한 뒤 예상하지 못한 변경이 발생하는지 안전하게 확인할 수 있습니다.