샌드박스(Sandboxing)

좁은 문이 하나 있는 보라색 둥근 울타리 안에서 노는 로봇으로, 명령이 정해진 경계 안에서만 도는 모습입니다.

무엇인가요

샌드박스는 가 실행하는 명령 둘레에 울타리를 치고, 그 울타리를 가 직접 지키게 합니다. 명령이 어느 폴더에 쓸 수 있는지, 어느 에 닿을 수 있는지는 사람이 정합니다. 기본으로는 작업 폴더·임시 폴더·더한 폴더에만 쓸 수 있고, 네트워크는 허용 도메인 목록이 빈 채로 시작하는 의 를 거칩니다. 명령이 이름보다 더 많은 일을 해도 운영체제가 울타리를 지키므로, 는 샌드박스 안의 명령을 하나하나 묻지 않고 실행할 수 있습니다. ··WSL2 에서 되고, 켜기 전에는 꺼져 있습니다.

어떻게 돌아가나요

세션에서 /sandbox 실행
auto-allow 나 일반 고르기
명령이 울타리 안에서 실행
새 도메인은 물을 때 허락

이렇게 씁니다

/sandbox

Mode·Overrides·Config 탭이 있는 샌드박스 창을 엽니다.
~/.claude/settings.json 에 sandbox.enabled 를 true 로

내 모든 프로젝트에서 샌드박스를 켭니다.
sandbox.network.allowedDomains

Bash 명령이 닿아도 되는 도메인입니다. sandbox.filesystem.allowWrite 는 쓸 수 있는 폴더를 더합니다.
"allowUnsandboxedCommands": false

엄격한 샌드박스 모드입니다. 실패한 명령을 샌드박스 밖에서 다시 실행할 수 없게 합니다.

주의할 점

샌드박스는 셸 명령만 감쌉니다. Claude 의 Read·Edit·WebFetch 도구, , 훅은 밖에서 돌고 따로 있는 층인 권한 규칙을 따릅니다. 자동 모드와도 다른 것이고 완전한 벽도 아니어서, github.com 같은 넓은 도메인을 허용하면 자료가 새는 길이 될 수 있습니다. 샌드박스가 시작되지 못하면 sandbox.failIfUnavailable 을 켜지 않은 한 명령이 샌드박스 없이 실행됩니다.

원문과 공식 문서

이 페이지는 용어를 쉬운 말로 풀어 쓴 것입니다. 기준은 원문이니, 다르면 원문을 따르세요.

알림

알림을 켜는 방법

무엇인가요

어떻게 돌아가나요

이렇게 씁니다

주의할 점

원문과 공식 문서

무엇인가요

어떻게 돌아가나요

이렇게 씁니다

주의할 점

함께 보면 좋은 용어

원문과 공식 문서