# 샌드박스로 안전하게 맡기기
id: claude-code-sandbox · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/claude-code-sandbox
기준일: 2026-11-21 (여기서 고친 날)
도구: Claude Code
걸리는 시간: 약 15분
평가 점수: 32/100 (확인 없음 · 검수 대기)

샌드박스를 켜면 Claude Code의 셸 명령이 작업 폴더와 허용한 주소 밖으로 나가지 못해, 승인 창을 줄이고 오래 맡겨도 사고 범위가 좁아집니다.

설명: /sandbox로 샌드박스를 켜고 자동 허용 모드를 고른 뒤, 필요한 쓰기 경로와 네트워크 주소만 설정에 엽니다. 시험 명령으로 막히는지 확인하고, 자동 모드(auto)와 함께 쓸 때의 한계도 알아 둡니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

준비물: Claude Code 설치와 로그인

단계:
1. [명령 실행 · Claude Code] 샌드박스 켜기 — 세션에서 /sandbox를 열어 켭니다. macOS·Linux·WSL2에서 동작하고, Linux와 WSL2는 bubblewrap과 socat이 필요합니다.
   프롬프트:
   > /sandbox
   기대 결과: 켜진 샌드박스
   확인 방법: /sandbox 화면에 켜짐이 보이는지 확인
2. [사람이 · Claude Code] 모드 고르기 — Mode 탭에서 자동 허용을 고르면 샌드박스 안의 셸 명령은 묻지 않고 돕니다. deny 규칙과 git push 같은 ask 규칙은 그대로 묻습니다.
   기대 결과: .claude/settings.local.json에 저장된 모드
   확인 방법: 평범한 셸 명령이 승인 창 없이 도는지 확인
3. [사람이 · Claude Code] 쓰기 경로와 주소 열기 — 기본으로는 작업 폴더와 임시 폴더만 쓸 수 있고, 네트워크는 allowedDomains에 적은 주소만 나갑니다(처음엔 비어 있음). 필요한 것만 엽니다.
   프롬프트:
   > {
   >   "sandbox": {
   >     "enabled": true,
   >     "filesystem": { "allowWrite": ["/tmp/build"] },
   >     "network": { "allowedDomains": ["registry.npmjs.org"] }
   >   }
   > }
   기대 결과: 필요한 것만 연 설정
   확인 방법: npm install이 되는지 확인
4. [AI에게 · Claude Code] 막히는지 시험 — 작업 폴더 밖 쓰기와 허용하지 않은 주소가 막히는지 직접 봅니다.
   프롬프트:
   > touch ~/sandbox-probe 와 curl --noproxy '*' https://example.com 을 실행하고 결과를 알려 줘.
   기대 결과: 두 명령 모두 실패
   확인 방법: 홈 폴더에 sandbox-probe 파일이 없는지 확인
5. [사람이 · Claude Code] 샌드박스 없이는 못 돌게 (선택) — 샌드박스를 쓸 수 없을 때 그냥 돌지 않고 멈추게 하려면 failIfUnavailable을 켭니다. 샌드박스 밖 재시도를 막으려면 allowUnsandboxedCommands를 false로 둡니다.
   프롬프트:
   > "sandbox": { "enabled": true, "failIfUnavailable": true, "allowUnsandboxedCommands": false }
   기대 결과: 엄격 설정
   확인 방법: 샌드박스를 못 쓰는 환경에서 시작이 멈추는지 확인

주의:
- Read·Edit·WebFetch 같은 내장 도구와 훅, 로컬 MCP 서버는 샌드박스 밖에서 돎. 이것들은 권한 규칙으로 막기
- 기본 설정은 ~/.ssh 같은 자격 증명 파일도 읽을 수 있음. sandbox.filesystem.denyRead로 막기
- github.com처럼 넓은 주소를 열면 데이터가 나갈 길이 생김
- 자동 모드(auto)는 분류 모델이 위험한 동작을 걸러 주지만 안전을 보장하지 않음

출처:
- Claude Code 문서: 샌드박스 https://code.claude.com/docs/en/sandboxing
- Claude Code 문서: 권한 모드(자동 모드) https://code.claude.com/docs/en/permission-modes