코딩 에이전트
HOL Guard란 무엇인가: Claude Code, Codex, Cursor 등 AI 코딩 에이전트 작업을 실행 전에 승인하기
HOL Guard는 무료 오픈소스 로컬 런타임으로, AI 코딩 에이전트의 위험한 작업을 승인할 때까지 멈추고 영수증을 남길 수 있다. Guard Cloud는 선택적 유료 옵션이다.
HOL Guard는 AI 코딩 에이전트를 위한 로컬 우선 런타임 보안 계층이다. 지원되는 연동에서는 도구 호출이 실행되기 전에 허용하거나, 확인을 요청하거나, 차단할 수 있고, 무슨 일이 있었는지 기록을 남긴다. 핵심인 Guard Local 런타임은 Apache-2.0 라이선스의 오픈소스다. 유료 요금제나 클라우드 계정 없이 pipx install hol-guard로 설치할 수 있다. Guard Cloud는 별개의, 선택적인 유료 서비스다. HOL의 공식 문서와 요금 페이지, 그리고 hashgraph-online/hol-guard 저장소를 2026년 11월 14일에 확인한 것이다. 완전한 보호를 주장하는 글이 아니다. 적용 범위는 에이전트와 이벤트 유형에 따라 달라진다.
OrigoTech에는 공식 요금 페이지에서 확인한 같은 가격을 담은 HOL Guard 디렉터리 항목도 있다.
어떤 도구인가
HOL은 Guard를 AI 에이전트를 위한 로컬 우선 런타임 보안 계층이라고 설명한다. 초점은 에이전트가 사용자 기기에서 위험한 작업을 시도하는 순간이다. 파괴적 명령, 비밀 정보 접근, 소프트웨어 설치, 데이터 반출 같은 일이다. 지원되는 연동에서 Guard는 그 작업을 허용하거나, 먼저 묻거나, 차단한 뒤, 나중에 검토할 수 있는 기록을 남길 수 있다.
프로젝트에 따르면 Guard Local은 사용자 컴퓨터에서 실행되고, 그 로컬 런타임에서는 파일이 기기를 떠나지 않으며, 인터넷 연결 없이도 계속 동작할 수 있다. Guard Cloud는 동기화, 공유 정책, 여러 대 기기 파악, 팀 워크플로를 위한 선택적 계층으로 소개되며, 로컬 차단을 집행하는 구성 요소로는 나오지 않는다.
2026년 11월 14일 공식 사이트에 안내된 안정 버전은 2026년 11월 4일에 공개된 HOL Guard v3.59.0이었다. PyPI에도 같은 버전이 올라 있었다.
작동 방식
결정 경로는 지원되는 도구 호출이 실행되기 전의 정책 확인이다.
- 정책에 맞는 대상 작업을 허용한다.
- 모호하거나 위험한 작업은 승인을 요청하고, 결정할 때까지 멈춘다.
- 정책이 거부하는 대상 작업을 차단한다.
- 결정의 영수증을 기록해 나중에 검토할 수 있게 한다. 프로젝트 README에는
hol-guard receipts명령도 안내되어 있다.
공식 사이트와 저장소가 드는 대상은 같다. 셸 명령과 파일 접근, 패키지 설치, 플러그인, 스킬, 에이전트 설정, MCP 서버와 도구 호출, 그리고 지원되는 이벤트에서 프롬프트나 도구 결과에 대한 프롬프트 인젝션과 민감한 내용 검사. Guard는 에이전트의 네이티브 훅, 관리되는 MCP 프록시, 실행 연동으로 연결된다. 훅이 없거나 꺼져 있으면, README에 따르면 Codex 예에서처럼 관리되는 실행이 거부될 수 있다.
지원 에이전트
프로젝트 README에 따르면 Guard에는 Codex, Claude Code, GitHub Copilot CLI, Cursor, Cline, Gemini CLI, Grok, Hermes, Kimi Code, Pi, oh-my-pi, OpenClaw, OpenCode, Antigravity, ZCode, Devin용 어댑터가 포함된다. 공식 사이트도 Claude Code, Codex, Cursor를 포함한 여러 환경의 설치 안내를 공개한다. Paseo는 이런 네이티브 연동을 통해 지원된다고 설명되어 있다.
적용 범위는 균일하지 않다. HOL은 통제 깊이가 에이전트와 이벤트 유형에 따라 다르다고 하며, 차단, 검토, 관찰만, 대상 외를 구분한 지원 표를 공개한다. 관찰만 되거나 대상이 아닌 작업은 멈추지 않는다. 이 한계 때문에 이 글은 Guard를 완전한 보호라고 쓰지 않는다.
설치
GitHub README와 HOL 시작 가이드에 적힌 설치에는 Python 3.10 이상, pipx, 맞는 네이티브 런타임이 필요하다. Windows ARM64를 포함한 플랫폼 안내를 먼저 확인한다.
pipx install hol-guard
hol-guard init
첫 실행 마법사는 지원 에이전트를 찾고 설정을 안내한다. README에 따르면 대시보드를 열거나, 에이전트 연동을 설치하거나, 선택적 클라우드 서비스에 연결하는 등 각 변경 전에 확인을 요청한다. 설치 확인은 hol-guard --version과 hol-guard status로 할 수 있다.
공식 사이트는 에이전트별 설치 명령도 제공한다. 패키지 이름은 그대로 hol-guard이고, 라이선스는 Apache-2.0이며, 공개 저장소는 hashgraph-online/hol-guard다.
요금
아래 가격은 2026년 11월 14일에 hol.org/guard/pricing에서 확인했다. 페이지에는 두 달이 무료인 연간 결제도 있지만, 확인한 표에는 별도의 연간 금액이 보이지 않아 그 숫자는 여기서 만들지 않는다. 로컬 보호는 계정도 신용카드도 없이, 한 대의 기기에서는 영구 무료라고 설명되어 있다.
| 요금제 | 가격 | 요금 페이지에 적힌 내용 |
|---|---|---|
| Free (Guard Local) | 영구 $0 | 한 대의 기기에서 로컬 런타임, 승인, 영수증 |
| Solo | 월 $4.99 | 기기 2대에서 클라우드 동기화, 보관 30일, 저장공간 1 GB |
| Pro | 월 $15 | 기기 5대, 보관 180일, 저장공간 5 GB, 실시간 알림 |
| Team | 좌석당 월 $30 | 최대 기기 25대, 공유 정책과 팀 워크플로, 보관 365일 |
| Enterprise | 문의 | 신원, 로그 파이프라인, 자체 호스팅 또는 VPC 배포 검토 |
HOL 요금 FAQ는 파괴적 명령을 막는 데 Guard Cloud가 필요 없다고 한다. Guard Local은 클라우드 연결 없이 기기에서 작업을 가로채 정책을 적용한다. 또한 Guard Local은 소스 코드나 비밀을 업로드하지 않으며, Guard Cloud를 켜면 동기화가 저장하는 것은 편집된 결정 요약이지 소스 코드나 비밀 자체가 아니라고 한다.
HOL Guard 사용해 보기(제휴 링크 — OrigoTech가 수수료를 받을 수 있습니다). 공식 사이트는 hol.org/guard다. 같은 출처의 가격은 HOL Guard 도구 페이지에도 있다.
한계
HOL 자체 문서에서 나오는 한계가 있으며, 도구를 검토할 때 중요하다.
- 통제는 지원되는 에이전트, 이벤트, 연동에 한정된다. 일부 작업은 관찰만 되거나 아예 대상이 아닐 수 있다.
- Guard를 완전한 보호라고 쓰는 것은 정직하지 않다. 지원되는 도구 호출을 멈추는 정책 계층도, 그 훅이 있고, 제대로 설치되어 있으며, 해당 이벤트를 볼 수 있는지에 달려 있다.
- 공유 정책, 대시보드, 더 긴 기록, 기기 간 동기화는 Guard Cloud 기능이고 유료다. 로컬 차단은 이들에 의존하지 않는다.
- 맞는 네이티브 런타임이 필요하다. 프로젝트는 Windows ARM64를 포함한 플랫폼 안내를 먼저 읽으라고 한다.
출처
- HOL Guard: 공식 사이트, 2026-11-14 확인
- HOL Guard: 요금, 2026-11-14 확인
- GitHub: hashgraph-online/hol-guard(Apache-2.0 라이선스), 2026-11-14 확인
핵심: HOL Guard는 무료 오픈소스 로컬 런타임으로, 지원되는 AI 코딩 에이전트 도구 호출을 실행 전에 허용·확인 요청·차단하고 영수증을 남길 수 있다. Guard Cloud는 선택적 유료 옵션이며, 적용 범위는 완전하지 않다.