보안 제품 오픈소스
azet-guard
AI 코딩 에이전트를 위한 런타임 가드레일입니다. azet-guard는 Claude Code 훅에 연결되어 에이전트가 일하는 동안 도구 호출을 하나하나 확인합니다. 파괴적인 명령을 막고, API 키가 모델에 들어가지 않게 하며, 위험한 작업은 실행 전에 묻습니다.
지금 하는 일
치명적인 명령 차단
rm -rf ~, 디스크 지우기,.env를 네트워크로 보내는 명령은 실행되기 전에 거부합니다..git/,~/.ssh/,/etc/에 쓰는 것도 거부합니다.비밀값을 모델 밖에 둠
명령줄에 API 키가 있으면 거부하고, 명령 출력에 나온 키는 에이전트가 보기 전에 가립니다. 프롬프트에 키를 붙여 넣으면 그 키를 다시 말하지 말라는 안내를 덧붙입니다.
위험한 작업은 먼저 묻기
curl … | sh,main강제 푸시,.env나 SSH 키 읽기, 환경 변수 전체 출력,git add .env는 멈추고 답을 기다립니다.돌리지 않은 “테스트 통과” 잡기
에이전트가 그렇게 말하며 끝내려는데 그 턴에 테스트 명령이 한 번도 실행되지 않았다면, 테스트를 돌리라고 한 번 되돌려 보냅니다.
프롬프트 인젝션 표시
가져온 웹페이지나 파일 속 “이전 지시를 무시하라” 같은 문장에 표시를 붙여, 에이전트가 지시가 아닌 데이터로 다루게 합니다.
감사 로그
모든 판단을 덧붙이기만 하는 로그
~/.azet-guard/audit.jsonl(권한 600)에 남기며, 쓰기 전에 비밀값을 가립니다.azet-guard log로 최근 기록을 봅니다.
설치. pipx install azet-guard 또는 uv tool install azet-guard로 설치한 뒤, 모든 Claude Code 프로젝트에 걸려면 azet-guard install(~/.claude/settings.json), 저장소 하나에만 걸려면 azet-guard install --project .(.claude/settings.json, 커밋하면 팀과 같이 씁니다)을 실행합니다. 훅이 적용되도록 Claude Code를 다시 시작하거나 /hooks를 여십시오. azet-guard doctor는 설치 위치와 적용 중인 정책을 보여 주고, azet-guard uninstall은 자기 항목만 지우고 다른 훅은 그대로 둡니다.
정책. 설치한 그대로 기본값이 동작합니다. 개인은 ~/.azet-guard/policy.toml, 팀은 저장소의 .azet-guard.toml에서 규칙을 끄거나, 규칙의 동작을 거부·묻기·경고 중에서 바꾸거나, 직접 명령 패턴을 더할 수 있습니다. mode = "monitor"로 두면 막지 않고 무엇을 했을지 기록만 합니다. azet-guard check "<명령>"로 어떤 명령을 어떻게 처리할지 미리 봅니다.
알아보는 비밀값. AWS 액세스 키, GitHub 토큰, Anthropic·OpenAI 키, Stripe 키, Slack 토큰, Google API 키, 개인 키 블록, JWT.
한계
- 샌드박스가 아니라 가드레일입니다. 규칙은 정규식이라, 작정한 에이전트는 명령을 감춰 돌아갈 수 있습니다. Claude Code 권한 설정과 함께 쓰고, 믿기 어려운 작업은 컨테이너에서 돌리십시오.
- 알아볼 수 있는 접두어가 있는 비밀값만 잡습니다. 일반 비밀번호와 자체 토큰은 규칙을 더하지 않으면 잡지 못합니다.
- 테스트 확인은 테스트 명령이 있었는지만 봅니다. 그 테스트가 바꾼 코드를 다루는지는 판단하지 않습니다.
- 오류가 나면 막지 않고 통과시킵니다. azet-guard 자체가 멈추면 세션은 계속 동작하고 오류는 감사 로그에 남습니다. 정책 파일을 읽지 못하면 그때는 분명하게 실패합니다.
- 지금은 Claude Code만 지원합니다. Codex CLI·Cursor 연결, 정책 공유와 감사 검색을 갖춘 팀 대시보드, SSO는 로드맵에 있습니다. 팀 버전을 먼저 써 보려면 hello@azet.io로 연락하십시오.
보안
취약점은 비공개로 알려 주십시오. GitHub 비공개 취약점 신고(저장소 Security 탭의 Report a vulnerability 버튼)나 hello@azet.io 메일로 받습니다. 거부 규칙 우회, 가려지지 않은 채 모델이나 감사 로그에 들어간 비밀값, 훅을 멈추게 하는 오류가 모두 해당합니다. 무엇을 적어 보내야 하는지와 답하는 기한은 보안 정책에 있습니다. 이 프로젝트는 OpenSSF Best Practices passing 기준을 충족합니다(자가 인증, 2026년 10월).
저장소는 OpenSSF Scorecard로 점검받으며, 푸시와 풀 리퀘스트마다 Python 3.11, 3.12, 3.13에서 CI 테스트가 돕니다.
한눈에 보기
| 상태 | 출시 · 버전 0.1.0 · 무료 |
|---|---|
| 만든 곳 | AZET LLC |
| 함께 쓰는 도구 | Claude Code(훅으로 연결) |
| 필요 환경 | Python 3.11 이상, 다른 의존성 없음 |
| 설치 | pipx install azet-guard · uv tool install azet-guard |
| 라이선스 | Apache-2.0 |
| 소스와 배포본 | GitHub · 릴리스 v0.1.0 · PyPI |
| 내 데이터 | 네트워크 호출이 없습니다. 감사 로그는 내 컴퓨터에만 남습니다. |
| 보안 신고 | 보안 정책 · GitHub 비공개 취약점 신고 |
| 문의 | hello@azet.io |