개발도구보안AIClaude Code

Boxdawn guard

v0.4.11 · 어제 업데이트·업데이트 1건

Claude Code·GitHub Copilot CLI가 셸 명령을 실행하기 전에 확인하는 무료 도구. 거절하거나, 이유를 붙여 묻거나, 판정하지 않습니다.

Boxdawn guard v0.4.11 스크린샷
Boxdawn guard 스크린샷 2Boxdawn guard 스크린샷 3

소개

AI 코딩 에이전트가 셸 명령을 실행하기 직전에 그 명령을 읽고 판정하는 도구입니다. guard의 답은 세 가지입니다. · 거절: 예를 들어 rm -rf ~ 는 프로젝트 밖까지 닿는 명령이라 실행되지 않습니다. · 묻기: 예를 들어 git reset --hard 는 커밋하지 않은 변경이 사라진다는 이유를 붙여 사람에게 먼저 묻습니다. .env 같은 비밀 파일을 셸 명령으로 읽을 때도 묻습니다(Claude Code에서는 파일 읽기 도구도). · 판정 없음: npm test 같은 평범한 명령에는 아무 말도 하지 않습니다. 그다음은 Claude Code·Copilot CLI 자체의 권한 설정이 정합니다. "실행해도 된다"는 답은 주지 않습니다. 그래서 guard를 깔아도 권한 설정은 그대로 중요합니다. 만든 이유 Claude Code 공개 이슈에는 에이전트가 파일·DB·도커 데이터를 지운 사고 보고가 꾸준히 올라옵니다. 그 보고에 적힌 명령 107개를 guard 0.4.11에 넣어 보면 24개는 거절, 52개는 묻기, 31개는 판정 없음입니다. 이 107개는 규칙을 고칠 때 쓴 목록이라 처음 보는 명령에서의 적중률은 아닙니다. 판정 없음으로 남은 31개를 묶음별로 개발 일지에 적고 있습니다. 지원 환경 · Claude Code: Windows, macOS(Apple 실리콘·Intel), Linux(x64·ARM64). Bash와 PowerShell 명령을 봅니다. · GitHub Copilot CLI: Windows에서 실행을 확인했습니다. macOS·Linux는 아직 Copilot에서 돌려 보지 않았습니다. 무료이고 소스를 공개합니다(FSL-1.1-ALv2). 혼자 만들고 있어서 써 보신 분의 이야기가 가장 큰 도움이 됩니다. 묻기로 바꿨으면 하는 명령이 있으면 알려 주세요.

업데이트 기록

v0.1에서 v0.4.11까지 · 1건. 카드를 누르면 펼쳐져요

프로젝트 폴더 밖 파일에 덧붙여 쓰는 명령과 curl … | env bash 같은 파이프를 묻도록 바꾼 판
v0.4.11
v0.4.11NOW
어제
프로젝트 폴더 밖 파일에 덧붙여 쓰는 명령과 curl … | env bash 같은 파이프를 묻도록 바꾼 판
0▼
자세한 노트

지금 공개된 판입니다. 프로젝트 폴더 밖 파일에 덧붙여 쓰는 명령(예: echo hi >> ~/notes.txt)과 curl … | env bash처럼 감싼 인터프리터 파이프를 묻도록 바꿨습니다. 공개 사고 보고에 적힌 명령 107개 기준 거절 24 · 묻기 52 · 판정 없음 31.

이 버전 댓글
이 버전에 첫 댓글을 남겨보세요.
그때의 스크린샷

댓글

VibeNow@vibenow_official어제
소개와 v0.4.11 노트까지 읽었습니다. '실행해도 된다'고 답하지 않는 설계와, 판정 없음 31개를 묶음별로 공개하신 방식이 좋습니다. 세 가지 덧붙입니다. 1) 107개는 규칙을 고친 목록이라 적중률이 아닌 건 직접 밝히셨으니, 공개 뒤에 새로 올라온 사고 보고로 홀드아웃 셋을 따로 만들어 릴리스마다 같은 셋으로 24·52·31 같은 표를 다시 재면 회귀가 바로 보입니다. 2) 경로 판정은 명령 문자열이 아니라 최종 해석된 실제 경로로 하셔야 합니다. cd로 옮긴 뒤의 상대 경로, 심볼릭 링크, ~ 확장, Windows의 8.3 짧은 이름과 UNC 경로가 같은 파일을 가리키는데 문자열만 보면 통과합니다. 검사와 실행 사이에 링크가 바뀌는 경우도 있어, 쓰기 대상은 실행 직전에 한 번 더 확인하거나 가능하면 파일 디스크립터 기준으로 다루는 편이 안전합니다. 3) python -c, node -e, eval, xargs, find -exec, base64 디코드 파이프처럼 인터프리터에 문자열로 넘기는 형태는 정적으로 판정하기 어렵습니다. 이런 형태는 '판정 없음'이 아니라 기본을 '묻기'로 두는 쪽이 사고를 줄일 것 같습니다. 마지막으로 훅 자체의 신뢰 경계를 문서에 못 박아 주세요. guard가 꺼졌을 때와 훅이 실패했을 때 통과시키는지(fail-open) 막는지(fail-closed)가 실제 안전을 결정합니다. v0.4.11 판정표를 릴리스마다 같은 기준으로 이어서 보여 주시면 좋겠습니다.
박스던@boxdawn오늘
꼼꼼히 읽어 주셔서 고맙습니다. 항목별로 지금 상태를 알려드리겠습니다. 아래는 guard 0.4.14를 Windows에서 판정 함수로 돌려 본 결과입니다. 1) 맞습니다. 107개는 규칙을 고치면서 본 목록이라 held-out이 아닙니다. 사고 원문에서 명령만 떼어 빈 폴더에서 판정한 값이라 실제 세션과도 같지 않습니다. 같은 107개(사고 83건)는 릴리스마다 다시 돌리고 있습니다. 0.4.11은 막음 24·묻기 52·판정 없음 31, 0.4.14는 24·58·25였고, 차이는 git stash 계열 6개가 묻기로 바뀐 것입니다. 공개 뒤에 올라온 사고 보고로 만든 홀드아웃 셋은 아직 없습니다. 따로 두는 게 맞다고 봅니다. 2) 경로는 명령 문자열이 아니라, 판정할 때 디스크에서 실제 경로를 풀어서 봅니다. 같은 줄에서 cd 한 뒤의 상대 경로, ~와 $HOME, 프로젝트 밖을 가리키는 링크·정션, 8.3 짧은 이름(C:\PROGRA~1), \\?\나 \\localhost\c$\ 같은 UNC 경로 모두 프로젝트 밖으로 보고 막습니다. 검사와 실행 사이에 링크가 바뀌는 경우는 guard가 닫지 못하는 틈입니다. 훅은 Claude Code에 판정만 돌려주고, 명령은 셸이 따로 실행하면서 경로를 다시 풉니다. guard가 직접 지우거나 파일 핸들을 쥐는 구조가 아니라서, 그 사이에 바뀐 것은 보지 못합니다. 3) 말씀하신 꼴은 대부분 이미 판정합니다. python -c·node -e는 코드를 읽어서 지우기·다른 프로그램 실행·덮어쓰기가 보이면 묻고, 모르는 언어나 변수로 넘긴 코드는 무조건 묻습니다. eval은 안쪽을 읽어서 판정하고(eval "rm -rf ~"는 막음), echo ~ | xargs rm -rf처럼 지울 곳을 실행 전에 알 수 없는 경우와 find ~ -exec rm -rf {} +는 막습니다. base64 -d | bash처럼 인터프리터로 넘기는 파이프는 묻습니다. 다만 전부 묻기는 아니어서, 아는 언어의 무해한 코드(python -c "print(1)" 같은)는 판정 없이 넘어갑니다. 4) README에 적어 두었습니다. "Fails closed. If the guard itself cannot run, the command is blocked, not waved through." 예외는 Read·Grep 검사 하나로, guard가 고장 나도 파일을 여는 것까지 막지는 않습니다. 플러그인을 지우면 새로 시작한 세션부터는 판정이 없습니다. 판정표는 릴리스마다 같은 기준으로 이어서 내겠습니다.

박스던

@boxdawn · guard 만드는 중 · 1인 개발자
Boxdawn을 혼자 만들고 있는 전세원입니다. guard는 Claude Code와 GitHub Copilot CLI가 실행하려는 셸 명령을 실행 전에 확인합니다. 거절하거나, 이유를 붙여 묻거나, 판정하지 않습니다. 무엇을 판정하고 어디서 말하지 않는지 개발 일지에 적습니다. 무료이고 소스를 공개합니다. 질문·피드백 환영합니다.
↗ GitHub↗ X (Twitter)↗ Instagram↗ 개인 사이트

성장 캘린더

최근 1년 활동: 업데이트·댓글·조회가 늘어날 수록 진해져요
적음
많음

비슷한 결의 한국 서비스

같은 분야에서 한국 개발자가 만든 서비스를 Dreamboat 앱·서비스 모음에 정리해 두었습니다.

방치형 게임 밸런스 계산기
개발도구 · 인크리멘탈 업그레이드 간격 비교 도구. 가격 배율과 수입 증가율을 두 설정으로 넣어 업그레이드를 몇 분째에 사게 되는지와 분당 수입을 나란히 보고 CSV로 저장하는 한국어 PC 계산기입니다.
Boxdawn guard
개발도구 · 클로드 코드 훅으로 셸 명령을 실행 전에 검사. Claude Code와 GitHub Copilot CLI가 명령을 돌리기 직전에 읽어, 위험한 명령은 거절하거나 이유를 붙여 먼저 묻는 무료 플러그인입니다.
노벰버 (Novemver)
AI · 정해 둔 시간에 걸려 오는 AI 전화 루틴 앱. 아침 계획부터 잠들기 전 하루 정리까지 통화를 예약해 두면 AI가 전화를 걸어 이야기를 나누고, 끝나면 통화 요약과 할 일을 남깁니다.
Vibe Guardian (웹사이트 보안 점검)
보안 · 웹사이트 기본 보안 점검. 주소만 넣으면 노출된 API 키·.env·열린 Admin 페이지·와일드카드 CORS 같은 「기본을 안 해서 터지는 것」을 1분 안에 훑어 줍니다. 가입은 없습니다.
AI 노래 만들기·AI 작곡 사이트 2026
AI · 무료·저작권·상업 이용 비교. 가사로 노래를 만드는 수노와 제미나이부터 반주를 짓는 한국 작곡 도구, 축가 음정 연습까지 10곳을 하려는 일별로 나눴습니다.
디스커버 전체 보기