AgentShield의 개요
AgentShield는 코딩 에이전트의 설정, 주로 ~/.claude 디렉터리와 프로젝트별 .claude 폴더를 읽고 잘못될 수 있는 부분을 알려 줍니다. CLAUDE.md에 붙여 넣은 API 키, Bash(*) 같은 허용 규칙, 파일 이름을 셸 명령에 끼워 넣는 훅, npx -y로 실행되는 MCP 서버, 에이전트에게 원격 코드를 받아 실행하라고 지시하는 문구 등입니다. A부터 F까지의 등급과 0부터 100까지의 점수를 보여 주며, 가장 안전한 문제는 스스로 고칠 수 있습니다.
npx ecc-agentshield scan으로 실행하거나, 코드 스캐닝용 SARIF를 쓰는 GitHub Action으로, 또는 GitHub App인 ECC Tools 안에서 돌릴 수 있습니다. 선택 기능인 --opus 모드는 설정을 Claude에 보내 레드 팀, 블루 팀, 감사자로 이루어진 세 에이전트 검토를 받습니다. Affaan Mustafa가 2026년 2월 Cerebral Valley와 Anthropic의 Claude Code 해커톤에서 자신의 Everything Claude Code 프로젝트의 일부로 만들었습니다.
CLI는 MIT 라이선스로 무료이며, 조직 전체를 분석하는 GitHub App ECC Tools Pro는 사용자당 월 19달러입니다.
AgentShield, 쓸 만한 가치가 있습니까?
AgentShield가 제 몫을 하는 이유는 범용 시크릿 스캐너가 이해하지 못하는, 코딩 에이전트 설정에서 중요한 파일을 읽기 때문입니다. 15개 모듈에 걸친 268개 규칙은 허용 목록, 리버스 셸부터 클립보드 유출까지 40개 훅 패턴, 49개 MCP 서버 점검, 에이전트와 CLAUDE.md 지시에 관한 41개 규칙을 다룹니다. 점수는 범주마다 100에서 시작해 발견 사항만 감점하며, 치명적이면 25점, 높음이면 15점이 깎이므로 보여 주기용 거부 규칙을 추가해도 등급은 오르지 않습니다.
채택은 소박하지만 실 제로 있습니다. GitHub 스타 약 1,413개, 2026년 11월 15일까지 30일 동안 ecc-agentshield의 npm 다운로드 66,299회, 그리고 2026년 9월 10일에 공개된 v1.6.0이 있습니다. GitHub Action, SARIF 출력, 새 발견 사항만 표시하는 기준선, 증거 묶음 내보내기 덕분에 노트북뿐 아니라 CI에서도 쓸 수 있습니다.
가장 큰 비용은 잡음입니다. 메인테이너는 저장소에 오탐 감사 파일을 두고 있고, 템플릿 폴더의 MCP 발견 사항은 0.25x로 가중치를 낮추며, 문서는 어떤 발견이 실제 실행 위험이고 어떤 것이 예시인지 설명하는 데 여러 단락을 씁니다. 선별 작업을 각오하십시오. 주 대상은 Claude Code이고, Codex, OpenCode, Zed 같은 다른 환경은 증거 메모 수준으로만 다뤄 같은 깊이를 기대할 수 없습니다.
--opus 모드는 설정을 Anthropic에, --provider orcarouter를 쓰면 OrcaRouter에 보내며, README는 가리지 않은 시크릿이 있는 설정에 후자를 쓰지 말라고 경고합니다. 먼저 로컬 스캔을 돌려 찾은 문제를 고친 뒤에 외부로 보내는 것이 순서입니다. 스킬과 MCP 도구 오염에 초점을 둔 Snyk의 에이전트 스캐너나 NVIDIA의 SkillSpector와 비교하면, AgentShield는 실행 환경 자체를 더 넓게 보지만 정확도는 덜 성숙했습니다.
제 역할을 하는 곳
1년 동안 Claude Code 훅과 MCP 서버를 쌓아 온 1인 개발자
내 설정 중 키를 흘리거나 에이전트가 무엇이든 실행하게 두는 부분이 있는지 알아내기
설치 없이 npx ecc-agentshield scan을 실행하고 치명적·높음 발견 사항부터 읽은 뒤, 하드코딩된 시크릿에는 --fix를 적용합니다. 비용이 들지 않고 파일을 어디에도 보내지 않은 채 로컬에서 끝납니다.
엔지니어 40명에게 공용 .claude 디렉터리를 배포하는 플랫폼 팀
위험한 권한이나 훅이 팀 설정에 병합되지 않게 막기
기준선과 함께 affaan-m/agentshield@v1 GitHub Action을 추가해 새로운 치명적·높음 발견이 있을 때만 풀 리퀘스트가 실패하게 하고, SARIF를 코 드 스캐닝에 올립니다. Action은 무료이며, 19달러/사용자/월의 ECC Tools Pro는 조직 전체 분석을 더합니다.
SOC 2 심사용 증거를 준비하는 보안 엔지니어
에이전트 설정이 어떻게 통제되는지 감사인에게 보여 주기
--compliance와 --evidence-pack으로 스캔해 발견 사항을 통제 ID에 연결하고 이동 가능한 묶음을 내보낸 뒤, HTML 보고서를 심사 자료에 첨부합니다.
도입 전 확인할 점
- 설정
- npx ecc-agentshield scan이 ~/.claude를 자동으로 찾아 명령 하나로 등급이 매겨진 보고서를 출력합니다. agentshield init은 더 엄격한 기본 설정을 씁니다.
- 연동
- SARIF와 작업 요약을 지원하는 GitHub Action. JSON, Markdown, HTML 출력. GitHub App ECC Tools. 외부 규칙 팩. --opus용 Anthropic API 또는 OrcaRouter. --supply-chain-online을 통한 npm 레지스트리 조회.
- 데이터와 개인정보
- 기본 스캔은 로컬에서 실행되고 공급망 점검도 오프라인으로 동작합니다. --opus는 설정 내용을 Anthropic에, 선택한 경우 OrcaRouter에 보내므로 먼저 시크릿을 가려야 합니다.
- 대규모 사용 시 비용
- CLI와 Action은 무료입니다. --opus는 내 Anthropic API 요금으로 Claude Opus를 쓰며, ECC Tools Pro는 사용자당 월 19달러입니다.
- 제한
- 오탐이 잦아 메인테이너가 선별 절차를 문서로 남길 정도입니다. 템플릿의 MCP 발견 사항은 0.25x로 가중치가 낮아지며, 가장 깊이 다루는 대상은 Claude Code입니다.
좋은 점
- Claude Code 설정, 훅, MCP 구성을 이해
- 방어 규칙을 더해도 점수를 부풀릴 수 없음
- SARIF와 기준선 대비 변화를 지원하는 GitHub Action
- 자동 수정으로 하드코딩된 시크릿을 환경 변수로 옮김
아쉬운 점
- 많은 발견 사항에 수동 선별이 필요
- Claude Code 밖에서는 깊이가 떨어짐
- --opus 모드는 설정을 외부 API로 보냄
- 2026년 9월 10일 이후 릴 리스 없음
추천 대상
훅과 MCP 서버를 붙여 Claude Code를 쓰면서 그 설정을 CI에서 반복적으로 감사하려는 개발자와 플랫폼 팀.
AgentShield 대안
AgentShield: 자주 묻는 질문
- AgentShield, 쓸 만한 가치가 있습니까?
- AgentShield는 Claude Code 설정이 실수로 무엇을 허용하는지 가장 빨리 알아내는 방법이며, 그 결과는 액자에 걸 판정이 아니라 하나씩 처리할 점검 목록입니다. 평점은 5점 만점에 3.8점입니다.
- AgentShield의 가격은 얼마입니까?
- CLI와 GitHub Action은 MIT로 무료입니다. --opus 분석 비용은 내 Anthropic API 키로 청구됩니다. GitHub App ECC Tools Pro: 19달러/사용자/월.
- AgentShield의 단점은 무엇입니까?
- 많은 발견 사항에 수동 선별이 필요; Claude Code 밖에서는 깊이가 떨어짐; --opus 모드는 설정을 외부 API로 보냄; 2026년 9월 10일 이후 릴리스 없음.
- AgentShield에 적합한 사람은 누구입니까?
- 훅과 MCP 서버를 붙여 Claude Code를 쓰면서 그 설정을 CI에서 반복적으로 감사하려는 개발자와 플랫폼 팀.
- 팀이나 프로덕션 환경에서 AgentShield의 비용은 얼마입니까?
- CLI와 Action은 무료입니다. --opus는 내 Anthropic API 요금으로 Claude Opus를 쓰며, ECC Tools Pro는 사용자당 월 19달러입니다.
- AgentShield에 회사 데이터를 맡겨도 안전합니까?
- 기본 스캔은 로컬에서 실행되고 공급망 점검도 오프라인으로 동작합니다. --opus는 설정 내용을 Anthropic에, 선택한 경우 OrcaRouter에 보내므로 먼저 시크릿을 가려야 합니다.
- AgentShield의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Snyk Agent Scan, SkillSpector, Cisco Skill Scanner 및 Everything Claude Code (ECC)입니다.
답변 확인일: 2026년 11월 16일.