Claude Code의 행동 기록 및 정책 관리를 위한 Keel 도구 공개

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

Claude Code 세션의 행동 기록(WAL)과 정책 일관성을 유지하기 위해 외부 저장소와 승인 게이트를 제공하는 도구 Keel이 공개됐다.

배경

Claude Code 세션이 길어짐에 따라 에이전트의 행동 기록, 차단 내역, 승인 요청 등을 추적하고 검증하는 데 어려움을 느껴, 이를 해결하기 위한 외부 정책 및 로그 관리 도구인 Keel을 개발하여 공유했다.

의미 / 영향

에이전트의 신뢰성 확보를 위해서는 LLM 내부의 프롬프트 엔지니어링뿐만 아니라 외부의 엄격한 정책 엔진과 로깅 시스템이 결합되어야 함이 확인됐다. 특히 멀티 에이전트 환경으로 확장될수록 중앙 집중식 상태 관리가 시스템의 일관성을 유지하는 결정적 요소가 된다.

커뮤니티 반응

작성자가 직접 도구를 개발하여 공유했으며, Claude Code의 한계를 보완하는 실용적인 접근법으로 평가받고 있다.

주요 논점

01찬성다수

컨텍스트 윈도우 외부에서 정책과 로그를 관리하는 것이 에이전트의 신뢰성을 높이는 핵심적인 방법이다.

합의점 vs 논쟁점

합의점

긴 세션에서 LLM의 지침 준수 능력이 저하되는 현상이 실질적인 문제로 존재한다.
에이전트의 행동에 대한 감사 추적(Audit Trail)은 프로덕션 환경에서 필수적이다.

실용적 조언

Claude Code 세션이 길어져 에이전트가 규칙을 무시하기 시작한다면 Keel과 같은 외부 정책 관리 도구 도입을 고려하라.
비가역적인 작업을 수행하는 에이전트에는 반드시 구조화된 승인 게이트를 설정하여 안전성을 확보하라.

섹션별 상세

LLM의 컨텍스트 윈도우 내에서만 관리되는 정책은 세션이 길어지면 압축되거나 왜곡되는 컨텍스트 표류 문제가 발생한다. Keel은 정책을 디스크나 클라우드에 별도로 저장하고 액션 실행 시마다 새로 읽어와 일관성을 유지한다. 이를 통해 에이전트가 세션 후반부에도 초기 설정된 규칙을 엄격히 준수하도록 강제한다.

Keel 활성화 상태 요약 정보 — Screenshot현재 활성화된 정책 수, WAL 이벤트 수, 에이전트 종류, 스냅샷 해시 등 시스템의 전반적인 운영 상태를 요약하여 표시한다. CLI 모드에서 도구가 어떻게 작동 중인지 한눈에 파악할 수 있게 한다.

에이전트가 수행한 모든 작업을 WAL(Write-Ahead Log) 형식으로 디스크에 영구 기록한다. 사용자는 전체 채팅 내역을 다시 읽지 않고도 사후에 어떤 작업이 수행되었는지, 무엇이 차단되었는지 명확하게 확인하고 검증할 수 있다. 로그 뷰어 기능을 통해 복잡한 세션의 흐름을 한눈에 파악하는 것이 가능하다.

에이전트 활동 로그(WAL) 쿼리 결과 — Screenshot파일 읽기, 쓰기, 삭제 시도 및 정책 체크 결과(APPROVED, BLOCKED 등)를 타임스탬프와 함께 나열한 로그 화면이다. 에이전트가 수행한 작업의 세부 내역을 사후에 추적할 수 있음을 증명한다.

이벤트 체인 무결성 검증 화면 — Screenshot기록된 10개의 이벤트 체인이 손상되지 않았음을 확인하는 'verify-chain' 명령 결과를 보여준다. 암호학적 해시를 통해 로그의 변조 여부를 검증할 수 있는 기능을 나타낸다.

여러 에이전트나 프로젝트가 섞여 있는 멀티 에이전트 환경에서 중앙 집중식 클라우드 저장소를 통해 동일한 규칙을 적용한다. 각 에이전트가 개별적인 지침 레이어에 따라 다르게 행동하는 현상을 방지하고 통합된 활동 기록을 유지한다. 클라우드 모드를 사용하면 여러 실행 환경 간의 정책 동기화가 실시간으로 이루어진다.

이메일 전송이나 파일 삭제와 같은 비가역적인 파괴적 작업에 대해 구조화된 승인 절차를 강제한다. 사용자가 특정 액션을 명시적으로 참조하여 확인 메시지를 입력해야만 실행되도록 설계되어 오작동으로 인한 피해를 방지한다. 이는 단순한 텍스트 확인을 넘어 규칙 기반의 엄격한 게이트웨이 역할을 수행한다.

비가역적 작업에 대한 승인 요청 화면 — Screenshot이메일 전송과 같은 파괴적인 작업에 대해 특정 규칙(Rule 3)에 근거하여 사용자의 명시적인 구조화된 승인을 요구하는 인터페이스를 보여준다. 이는 에이전트의 자율적 행동에 안전 장치를 설정하는 방식을 시각화한다.

코드 예제

bash

pip install threshold-keel
clawhub install threshold-keel

Keel 라이브러리 및 ClawHub를 통한 설치 명령어

bash

/plugin marketplace add threshold-signalworks/keel
/plugin install threshold@threshold-signalworks-keel

Claude Code 내에서 Keel 플러그인을 추가하고 설치하는 명령어

실무 Takeaway

LLM 컨텍스트 외부에서 정책을 관리함으로써 세션 길이에 상관없이 에이전트의 행동 일관성을 보장할 수 있다.
WAL(로그 선행 기입) 방식을 도입하여 에이전트의 모든 활동을 투명하게 기록하고 사후에 무결성을 검증하는 체계를 구축했다.
중앙 집중식 정책 관리를 통해 멀티 에이전트 환경에서 발생하기 쉬운 지침 파편화 문제를 해결했다.

언급된 도구

Keel추천

에이전트 행동 기록(WAL) 및 정책 관리 도구

Claude Code중립

Anthropic의 CLI 기반 코딩 에이전트

언급된 리소스

GitHubKeel GitHub Repository

문서Keel on ClawHub