breakerbox 는 클로드 코드의 PreToolUse 훅으로 붙어, 에이전트가 셸 명령을 실행하기 직전에 그 명령이 부를 클라우드 요금을 어림잡고 건당 20달러·세션 50달러·하루 200달러 같은 상한을 넘으면 막거나 물어봐요. 판단 근거는 실제 요금 조회가 아니라 저장소에 박아 둔 시간당 단가표(2026-08 기준 어림값)와 명령줄 문자열 대조라서, 만든 사람도 '보안 격리 장치가 아니다'라며 스크립트 안에 숨은 명령·SDK 호출·설정에 등록 안 된 도구 호출은 못 본다고 README 에 적어 뒀어요. 검사 대상 기본값은 셸 명령 하나뿐이라 MCP 도구 호출은 그냥 지나가고, 훅이 오류를 내면 막지 않고 통과시키는 게 기본값이에요.
용어 풀이
- PreToolUse
- 클로드 코드가 도구를 실행하기 직전에 끼어드는 훅 지점. 여기서 막으면 명령이 아예 실행되지 않음
- SDK
- 프로그램 코드 안에서 클라우드를 직접 부르는 개발 도구 모음. 터미널 명령이 아니라 코드라 명령줄만 보는 검사에는 안 걸림
- MCP
- AI 에이전트가 외부 도구·서비스에 붙도록 정한 공용 규격. 여기서는 셸을 거치지 않는 도구 호출 경로를 뜻함
- 게이트웨이
- 여러 AI 모델 호출을 한곳으로 모아 토큰 사용량과 비용을 재고 통제하는 중계 서버
운영자 인사이트
토큰 계량기는 게이트웨이가 봐 주지만 에이전트가 부른 aws ec2 run-instances 는 아무도 안 세는 빈틈은 실제로 있어요. 다만 명령줄 문자열만 보는 훅은 셸 변수·스크립트·SDK 로 비켜 가고, 8월 15일에 처음 올라온 0.1.1 이라 별·이슈도 아직 0이에요 — 실제 방어선은 에이전트에게 주는 자격증명 권한과 클라우드 쪽 예산 경보에 두고 이런 훅은 실수 한 번을 줄이는 보조로 보는 게 맞아요.
여러 관점으로 보기
- 만든 쪽 설명 셸 명령을 실행 전에 가로채 클라우드 요금을 어림잡고 상한을 넘으면 막아요. AWS·GCP·Azure 와 테라폼 같은 인프라를 코드로 만드는 도구까지 짚어봐요. GitHub
- 스스로 밝힌 한계 프로젝트 문서가 '보안 격리 장치가 아니다', '지금은 셸 명령만 본다', '단가는 2026-08 기준 어림값이라 지역·약정·스팟 할인을 무시한다'고 못 박아 뒀어요. GitHub Pages