활용 사례 · 코딩 에이전트
개발자 PC의 코딩 에이전트를 실행 직전에 통제합니다
Claude Code와 Cursor는 셸 명령을 실행하고, 파일을 수정하고, 외부로 요청을 보냅니다. 이 호출은 MCP를 거치지 않으므로 네트워크 게이트웨이로는 검사할 수 없습니다. GuardTrail은 에디터가 도구를 호출하는 지점에서 실행 직전에 판정합니다.
네트워크 프록시의 검사 범위는 8.4%에 그칩니다
개발자 PC 한 대에서 시스템 변경을 일으키는 도구 호출 55,741건을 측정했습니다. MCP 서버를 거치는 호출은 일부였고, 대부분은 에디터 내장 도구로 실행됐습니다.
8.4%
MCP를 거치는 호출 비율. 네트워크 게이트웨이의 검사 범위입니다.
91.6%
에디터 내장 도구 호출 비율. 셸 명령, 파일 읽기·쓰기, 외부 요청이 포함되며 프록시를 거치지 않습니다.
따라서 검사 지점은 네트워크가 아니라 도구 호출 지점이어야 합니다.
에디터 설정에 훅 한 줄을 추가합니다
Claude Code는 도구 실행 전에 지정된 명령(PreToolUse 훅)을 호출합니다. 이 훅에 GuardTrail을 등록하면 내장 도구와 MCP 도구를 동일한 정책으로 판정합니다. 에이전트와 모델은 변경할 필요가 없습니다.
| 검사 대상 | 주요 차단 사례 |
|---|---|
| 셸 명령 | 시스템 삭제, 권한 변경, 다운로드한 스크립트 실행 |
| 파일 쓰기 | 자격증명을 설정 파일·파이프라인 변수로 복사 |
| 외부 요청 | 사내 데이터를 외부로 전송 |
| MCP 도구 | 내장 도구와 동일한 정책으로 판정 |
차단된 호출마다 판정 근거를 기록합니다