저희는 개발자가 AI 권한을 더 잘 관리할 수 있도록 전용 제품을 구축했으며, 이를 오픈소스로 공개할 예정입니다. stoplight.ai에서 확인하세요.

Claude Code Guardrails

Example Table

settings.json이 적합한 경우:

JSON을 편집하고 정책이 변경될 때마다 Claude Code 세션을 종료해도 괜찮은 경우
보안 팀이 PR을 작성하는 데 문제가 없는 경우
차단된 항목, 시기, 대상을 알 필요가 없는 경우
Bash(rm:*)와 같은 기본 패턴 매칭으로 충분한 경우

이 도구를 사용해야 하는 경우:

정책 변경 사항을 팀 전체에 즉시 적용해야 하며, git pull이나 재시작이 필요 없는 경우
보안/규정 준수 부서에서 차단된 모든 명령어에 대한 명확한 감사 추적이 필요한 경우
조건부 로직이 필요한 경우: "node_modules에서는 rm -rf 허용, 다른 곳에서는 거부"
비개발자가 설정 파일을 건드리지 않고 규칙을 편집해야 하는 경우

Rulebricks는 하나의 훅으로 즉각적인 거버넌스를 제공합니다.

Claude Code → PreToolUse hook → Rulebricks API → allow / deny / ask

설정 (5분)

1. 규칙 생성

rulebricks.com으로 이동하여 계정을 만듭니다.
"AI Agents" 카테고리에서 다음 템플릿 중 하나를 포크합니다.
- Claude – Bash Guardrails — 셸 명령어 제어
- Claude – File Access Policy — 파일 읽기/쓰기/편집 제어
- MCP Tool Governance — MCP 서버 작업 제어
팀에 맞게 규칙을 사용자 지정합니다.
규칙을 게시합니다.
API 탭에서 API 키를 복사합니다.

2. 설치

규칙을 자동으로 찾습니다

git clone https://github.com/rulebricks/claude-code-guardrails
cd claude-code-guardrails
./install.sh

Claude가 게시된 규칙을 감지하고 적절한 훅을 연결합니다.

3. Claude Code 재시작

완료되었습니다.

확인되는 항목

템플릿	매처	제어 대상
Bash Command Guardrails	`Bash`	셸 명령어
File Access Policy

설정

~/.claude/settings.json의 환경 변수:

{
  "env": {
    "RULEBRICKS_API_KEY": "your-api-key",
    "RULEBRICKS_VERBOSE": "1"
  }
}

변수	설명
`RULEBRICKS_API_KEY`	Rulebricks API 키 (필수)
`RULEBRICKS_VERBOSE`	`1`로 설정하면 결정 사항을 stderr에 기록

규칙 업데이트

의사 결정 테이블을 편집하고 새 버전을 게시하세요. 변경 사항이 즉시 적용됩니다. 재시작이나 재배포가 필요 없습니다.

기록 검토

차단된 명령어의 기록은 로그 탭에서 검토할 수 있습니다. 도구, 승인 결정 등으로 조회할 수 있습니다. 이 데이터에는 가장 많이 차단된 도구를 확인하는 등 유용한 추가 기능이 있습니다.

Example Logs

데이터 개인정보 보호

민감한 데이터가 당사 플랫폼에 도달하기 전에 이를 수정하려면 가드레일을 자유롭게 편집할 수 있습니다.

또한, 이 기능은 클라우드 환경에서 작동하지만, 자체 로깅 제공자를 사용하여 프라이빗 인프라에서도 실행할 수 있습니다. 관심이 있으시면 연락 주세요.

제거

# 훅 스크립트 제거
rm ~/.claude/hooks/guardrail.py

# settings.json에서 제거 (수동)
# ~/.claude/settings.json을 편집하고 다음 항목을 삭제:
#   - hooks.PreToolUse 항목
#   - env.RULEBRICKS_* 변수

또는 다음 한 줄 명령어로 훅과 설정을 제거할 수 있습니다:

rm ~/.claude/hooks/guardrail.py && python3 -c "
import json
p = '$HOME/.claude/settings.json'.replace('\$HOME', '$HOME')
s = json.load(open(p))
s.get('hooks', {}).pop('PreToolUse', None)
for k in list(s.get('env', {}).keys()):
    if k.startswith('RULEBRICKS_'): s['env'].pop(k)
json.dump(s, open(p, 'w'), indent=2)"

claude-code-guardrails

인기