CI/CD

2026 Claude Code 어떤 작업은 macOS Sandbox만으로 부족한가?

터미널에서 실행한 일반적인 빌드 작업은 안전해 보여도, MCP 서버와 Hooks, 무인 실행까지 같은 경계 안에 있다고 보기는 어렵습니다.

권장안은 분명합니다. 개발자가 계속 검토하고 신뢰할 수 있는 코드만 다룬다면 Claude Code macOS Sandbox를 먼저 사용하고, 확장 프로세스나 무인 실행, 낯선 코드를 다룰 때는 Sandbox Runtime 또는 독립된 가상화 맥 환경으로 올려야 합니다. 손으로 작성한 SBPL은 장기적인 팀 기준이 아니라 실험용 보조 수단으로 보는 편이 안전합니다.

이 글은 주로 다음 독자를 위한 판단 기준입니다.

  • 개인 개발자: 어떤 Claude Code 작업을 주력 맥에서 분리해야 하는지 판단하려는 경우
  • 데브섹옵스 엔지니어: 본체의 Bash 샌드박스가 가리지 못하는 프로세스와 자격 증명 위험을 확인하려는 경우
  • 연구 개발 플랫폼 책임자: 팀별로 본체 실행과 독립 환경의 분류 기준을 만들려는 경우

마지막 업데이트: 2026년 9월 9일. Claude Code의 샌드박스 문서와 Sandbox Runtime 저장소, 애플의 관련 문서 및 sandbox-exec 설명을 기준으로 확인했습니다.

본체 샌드박스에 남겨도 되는 작업

개발자가 실행 중인 명령과 변경 내용을 계속 검토하고, 코드 출처가 신뢰할 만하며, 작업 범위가 현재 작업 폴더 안에 머문다면 내장 macOS Sandbox가 첫 선택입니다. 일반적인 소스 수정, 빌드, 테스트, 임시 파일 생성처럼 작업 폴더 안에서 끝나는 흐름이 여기에 해당합니다.

Claude Code의 Bash 샌드박스는 macOS의 Seatbelt 기능을 이용해 Bash 명령과 그 하위 프로세스의 파일 및 네트워크 접근을 제한합니다. 공식 안내에서도 권한 확인과 샌드박스가 서로 다른 방어 계층으로 설명됩니다. 사용자가 명령을 승인했다는 사실은 운영 체제 경계를 해제했다는 뜻이 아닙니다. 반대로 샌드박스가 켜져 있어도 승인할 명령의 목적과 결과를 검토해야 합니다.

이 구분은 권한 창을 보안 정책 전체로 오해하지 않게 해 줍니다. 권한 창은 특정 행동을 허용할지 묻는 절차이고, 샌드박스는 허용된 프로세스가 어디까지 접근할 수 있는지를 제한하는 환경입니다. 자세한 명령 실행 동작은 Claude Code 공식 명령 문서에서 확인할 수 있습니다.

다만 이 방식은 Claude Code 세션 전체를 하나의 밀폐된 상자에 넣는 기능으로 해석하면 안 됩니다. 내장 기능의 중심은 Bash 명령과 그 하위 프로세스입니다. 확장 기능이 별도의 프로세스로 동작하면 판단 범위가 달라집니다.

MCP와 Hooks의 경계

MCP와 Hooks는 내장 Bash 샌드박스로 모두 제한되는가

그렇다고 단정할 수 없습니다. MCP 서버와 Hooks는 Claude Code가 호출하는 확장 지점이며, 구성에 따라 본체와 별도의 프로세스로 실행될 수 있습니다. 이 프로세스가 호스트의 자격 증명 파일, 네트워크, 외부 서비스 또는 다른 작업 폴더에 접근한다면 Bash의 쓰기 제한만으로는 충분하지 않습니다.

예를 들어 작업 폴더의 파일만 수정하도록 제한해도, MCP 서버가 별도 인증 정보를 읽거나 외부 서비스로 요청을 보낼 수 있다면 노출 범위는 작업 폴더 밖에 있습니다. Hooks도 같은 방식으로 살펴봐야 합니다. 연결된 스크립트가 어떤 사용자 권한으로 실행되는지, 환경 변수를 상속하는지, 네트워크를 사용하는지를 별도로 확인해야 합니다.

이때 판단 기준은 단순합니다.

  • Bash 명령만 제한하면 되는 작업이면 내장 macOS Sandbox를 우선 검토합니다.
  • MCP와 Hooks, 그 하위 프로세스까지 같은 경계에 넣어야 하면 Sandbox Runtime을 평가합니다.
  • 자격 증명과 외부 연결을 함께 분리해야 하면 독립된 개발 환경을 선택합니다.

Sandbox Runtime은 sandbox-exec 명령을 그대로 제품 이름처럼 부르는 방식과 다릅니다. Sandbox Runtime 공식 저장소는 Claude Code 같은 에이전트 실행을 위한 별도 런타임 방향을 설명합니다. 반면 sandbox-exec는 macOS에서 SBPL 정책을 적용하는 실행 도구입니다.

애플의 macOS App Sandbox 설명은 앱 보안 경계를 설명하는 자료이고, 모든 터미널 에이전트의 프로세스 트리를 자동으로 감싸 주는 사용 설명서는 아닙니다. 따라서 세 용어를 같은 계층의 제품으로 취급하면 설계가 어긋납니다.

SBPL과 sandbox-exec의 위치

손으로 작성한 SBPL은 특정 디렉터리의 읽기와 쓰기, 네트워크 접근을 세밀하게 시험할 때 유용할 수 있습니다. 예를 들어 복구 가능한 임시 폴더만 쓰게 하고, 소스 원본과 자격 증명 경로는 읽기조차 막는 실험을 설계할 수 있습니다.

하지만 sandbox-exec에는 중요한 운영상 한계가 있습니다. macOS의 sandbox-exec 설명에는 해당 도구가 더 이상 권장되지 않는 상태로 표시되어 있습니다. 현재 실행되는 환경이 있다는 사실과 애플이 장기적인 제삼자 인터페이스로 보장한다는 사실은 다릅니다. 이후 운영 체제에서 같은 정책 문법과 동작이 유지된다고 약속할 수 없습니다.

또한 SBPL 규칙은 프로세스가 새로 만드는 임시 파일, 도구가 사용하는 소켓, 개발 도구의 예외 동작까지 빠짐없이 검증해야 합니다. 정책 한 줄을 추가하는 과정에서 네트워크 출구나 자격 증명 읽기를 예상보다 넓게 허용할 수도 있습니다. 그러므로 개인 실험이나 짧은 검증에는 쓸 수 있지만, 팀의 장기 기준은 공식적으로 관리되는 런타임이나 재현 가능한 독립 환경으로 두는 편이 낫습니다.

무인 실행과 낯선 저장소

Claude Code를 무인으로 돌릴 때 가상 머신이 필요한가

항상 필요한 것은 아닙니다. 신뢰할 수 있는 저장소에서 제한된 작업을 수행하고, 실패하면 작업 폴더만 폐기할 수 있으며, 외부 연결과 자격 증명이 차단된 경우에는 더 가벼운 격리로 시작할 수 있습니다.

그러나 장시간 백그라운드 실행, 자동 승인, 사람이 즉시 결과를 확인하지 못하는 작업이라면 승인 절차를 마지막 방어선으로 삼아서는 안 됩니다. 이 경우 환경 경계가 주된 방어 수단이 되어야 합니다. 파일 도구, MCP, Hooks, 하위 프로세스가 모두 같은 격리 범위에 포함되는지 먼저 확인해야 합니다.

선택지는 다음처럼 나뉩니다.

  • 내장 macOS Sandbox: 작업 폴더 중심의 Bash 실행에 적합합니다.
  • Sandbox Runtime: 에이전트 실행과 확장 프로세스를 더 넓은 범위에서 분리할 때 평가합니다.
  • 개발 컨테이너: 도구와 파일 시스템을 재현하기 좋지만, 호스트와 연결된 소켓 및 공유 경로를 따로 점검해야 합니다.
  • 가상 머신 또는 독립된 맥: 운영 체제와 자격 증명, 네트워크 정책을 함께 분리하고 필요하면 환경을 폐기할 때 적합합니다.

애플의 Virtualization 프레임워크 문서는 macOS에서 가상화 환경을 구성하는 공식 기반을 설명합니다. 하드웨어 가속과 저수준 실행을 다루는 Hypervisor 문서도 함께 참고할 수 있습니다. 다만 가상 머신을 선택했다고 자동으로 안전해지는 것은 아닙니다. 공유 폴더, 클립보드, 포트 전달, 호스트 자격 증명 연결을 끄는 운영 정책이 필요합니다.

낯선 저장소를 바로 수정해도 되는가

주력 맥에서 바로 수정하는 선택은 피하는 편이 좋습니다. 낯선 저장소는 설치 스크립트, 빌드 훅, 패키지 관리자 설정, 생성 코드처럼 에이전트가 직접 편집하지 않은 실행 경로를 포함할 수 있습니다. 프롬프트 안에 작업 범위를 바꾸도록 유도하는 내용이 들어갈 가능성도 별도로 고려해야 합니다.

이때 핵심은 저장소가 악성이라고 단정하는 것이 아닙니다. 신뢰도를 확인하지 못한 코드와 의존성을 주력 맥의 쓰기 가능한 영역 및 개인 자격 증명과 함께 실행할 이유가 적다는 뜻입니다. 일회성 가상 머신, 초기화할 수 있는 독립 맥, 또는 완전히 분리된 운영 체제 환경에서 먼저 분석하고 필요한 결과만 검토된 저장소로 옮기는 흐름이 적절합니다.

작업 분류와 적용 순서

실제 운영에서는 다음 조건 분기를 사용하면 됩니다.

  • 코드가 신뢰할 수 있고 개발자가 계속 검토하며 변경 범위가 작업 폴더에 머물면 Claude Code macOS Sandbox를 선택합니다.
  • MCP나 Hooks가 자격 증명, 네트워크 또는 외부 서비스를 사용하면 전체 프로세스 격리를 우선 평가합니다.
  • 사람이 결과를 계속 확인하지 못하거나 자동 승인이 들어가면 Sandbox Runtime 또는 독립 환경으로 이동합니다.
  • 저장소 출처와 설치 스크립트를 확인할 수 없으면 주력 맥을 사용하지 않고 초기화 가능한 환경으로 되돌립니다.
  • 실패 후 환경을 빠르게 폐기할 수 없고 팀 정책을 강제해야 하면 표준화된 독립 맥 환경을 선택합니다.
  • 물리 장치나 주력 맥의 특정 개발 도구가 꼭 필요하면 호환성을 먼저 시험한 뒤, 허용 범위를 좁힌 본체 샌드박스로 되돌립니다.

적용 순서는 다음과 같이 구성할 수 있습니다.

  • 작업을 신뢰된 코드, 확장 기능 사용 작업, 무인 작업, 낯선 코드로 나눕니다.
  • 각 작업에서 읽고 쓰는 디렉터리와 네트워크 출구를 기록합니다.
  • MCP와 Hooks가 별도 프로세스로 실행되는지 확인합니다.
  • 개발자 승인에 의존하는 부분과 운영 체제 경계가 담당하는 부분을 분리합니다.
  • 가장 위험한 작업 하나를 격리 환경으로 옮기고, 실패 시 폐기와 재생성을 시험합니다.
  • 팀에서는 설정 파일의 출처, 변경 권한, 자격 증명 전달 방식, 실패 시 차단 동작을 문서화합니다.

팀 규모에 따라 출발점도 달라집니다. 소규모 팀은 신뢰된 저장소의 본체 샌드박스와 위험 작업용 독립 환경을 병행하는 방식이 현실적입니다. 규제를 받는 팀은 개인별 예외보다 승인된 이미지와 네트워크 출구, 자격 증명 전달 정책을 먼저 고정해야 합니다. 중앙 집중형 AI 에이전트 플랫폼은 각 실행을 초기화 가능한 환경에서 시작하고, 결과물만 검토 후 반출하는 구조가 더 적합합니다.

위험도별 선택표

작업 상황 우선 환경 본체 실행을 허용할 조건 상위 격리가 필요한 신호
신뢰된 저장소의 빌드와 테스트 내장 macOS Sandbox 개발자가 계속 검토하고 작업 폴더 안에서 끝남 호스트 설정이나 개인 파일에 접근
MCP 또는 Hooks 사용 Sandbox Runtime 검토 확장 프로세스의 권한과 연결 범위가 확인됨 자격 증명, 외부 서비스, 넓은 네트워크 사용
장시간 무인 실행 Sandbox Runtime 또는 독립 환경 폐기 가능한 작업 공간과 제한된 출구가 있음 자동 승인, 백그라운드 실행, 즉시 검토 불가
낯선 저장소와 설치 스크립트 초기화 가능한 가상화 맥 별도 환경에서 먼저 검증 완료 출처 불명 의존성, 실행 훅, 복구 불가 변경
팀의 공통 실행 기준 표준화된 독립 환경 설정과 예외가 중앙에서 관리됨 개인별 SBPL과 임의의 자격 증명 공유

현재 주력 맥에서 MCP, Hooks, 무인 실행, 낯선 저장소를 모두 처리하고 있다면 전체 흐름을 한 번에 바꿀 필요는 없습니다. 먼저 가장 높은 위험 작업 하나를 분리하고, 초기화와 결과 반출이 실제로 가능한지 확인한 뒤 범위를 넓히는 방식이 운영 중단을 줄입니다.

독립된 맥 환경으로 옮기는 기준

본체 샌드박스는 빠르게 시작할 수 있고 기존 도구와의 호환성도 확인하기 쉽습니다. 반면 확장 프로세스와 네트워크, 자격 증명, 작업 폴더가 얽히면 정책 검토가 복잡해집니다. 손으로 작성한 SBPL은 이 복잡성을 줄이기보다 팀별 예외를 늘릴 수 있습니다.

독립된 맥 환경은 초기 설정과 이미지 관리가 필요하지만, 낯선 저장소와 무인 작업을 주력 맥에서 분리하고 문제가 생긴 환경을 폐기하기 쉽습니다. 특히 실제 맥 도구 체인과 호환성을 유지해야 하는 작업이라면 가상화 맥을 별도 개발 환경으로 운영하는 선택을 검토할 수 있습니다. 환경을 준비해야 하는 경우에는 KuzCloud의 맥 개발 환경 관리 화면과 지원 안내를 함께 확인하면 됩니다.

확인 항목 본체 macOS Sandbox 독립된 가상화 맥
신뢰된 일상 개발 적합 필요 이상일 수 있음
MCP와 Hooks의 전체 격리 별도 검증 필요 환경 설계에 포함 가능
무인 실행 조건부 기본 선택으로 검토
낯선 저장소 권장하지 않음 초기화 가능한 환경에 적합
정책 강제와 팀 재현성 개인 설정 의존 가능 이미지와 운영 절차로 표준화 가능
실패 후 복구 작업 폴더 정리 필요 환경 폐기와 재생성 방식 검토

현재 방식이 본체 맥 한 대에 의존한다면, 개인별 SBPL을 계속 추가하는 것보다 위험 작업을 별도의 맥 환경으로 옮기는 편이 관리하기 쉽습니다. 다만 장시간 같은 환경에서 안정적으로 무거운 작업을 계속 수행하거나 특정 물리 장치가 반드시 필요한 경우에는 독립 환경이 항상 최선은 아니므로, 호환성과 운영 비용을 먼저 확인해야 합니다.

KuzCloud의 맥 환경은 임시 개발 공간, 확장 기능 검증, 무인 실행 전 사전 시험처럼 주력 맥과 분리해야 하는 작업을 검토할 때 선택지로 볼 수 있습니다. 맥 환경 선택 정보를 확인한 뒤, 낯선 저장소와 MCP 작업부터 순차적으로 옮기는 방식이 안전합니다.

민감한 작업은 독립된 맥 환경에서 안전하게 실행하세요

KuzCloud의 원격 맥 환경으로 낯선 저장소와 자동화 작업을 본체와 분리해 실행할 수 있습니다.

개발과 테스트에 필요한 맥 자원을 필요할 때 원격으로 이용하고 개인 장비의 부담을 줄일 수 있습니다.