LLM 시스템과 AI 에이전트를 레드팀 테스트하고, 공격을 시뮬레이션해 취약점을 찾으며 프로덕션 가드레일을 제공하는 오픈소스 Python 프레임워크입니다.
kenryu42/cc-safety-net
Claude Code와 Codex 같은 AI 코딩 에이전트가 위험한 Git·파일 시스템 명령을 실행하거나 비밀 파일에 접근하지 못하도록 차단하는 실행 전 보호 도구입니다.
- 스타
- 1,742
- 포크
- 88
- 열린 이슈
- 6
- 마지막 커밋
- 2시간 전
어떤 프로젝트인가요?
CC Safety Net은 AI 코딩 에이전트의 도구 호출 앞에서 동작하며, git reset --hard, git push --force, 위험한 대상에 대한 rm -rf 같은 파괴적인 명령이 실행되기 전에 차단합니다. 명령이 실제로 무엇을 하는지 분석하므로 bash -c나 python -c로 감싸거나 플래그 순서를 바꿔도 탐지를 피할 수 없습니다. 또한 셸과 에이전트의 파일 도구 양쪽에서 SSH 키, .env 파일, ~/.aws, 코딩 CLI 인증 정보 같은 비밀 정보에 대한 접근도 차단합니다.
Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Hermes Agent를 비롯한 다양한 코딩 CLI를 Windows, macOS, Linux에서 지원합니다. GUI에서 Standard, Strict, Paranoid 프리셋으로 정책을 조정하고, Terraform, AWS, gcloud, Azure용 공식 룰북이나 사용자 지정 JSON 규칙으로 확장할 수 있습니다. .cc-safety-net/ 디렉터리를 커밋해 팀과 정책을 공유할 수도 있습니다.
CC Safety Net은 샌드박스가 아니라 보호 장치입니다. 프로세스를 격리하거나 파일 시스템 권한을 변경하거나 네트워크 트래픽을 모니터링하지 않습니다. 훅을 설치하지 않아도 Node.js에서 checkCommand를 호출해 검사기를 사용할 수 있습니다.
핵심 기능
- 01bash -c나 python -c로 감싼 경우를 포함해 파괴적인 Git 및 rm 명령을 차단합니다.
- 02SSH 키, .env 파일, ~/.aws, CLI 인증 정보에 대한 접근을 차단합니다.
- 03GUI에서 설정할 수 있는 Standard, Strict, Paranoid 프리셋을 제공합니다.
- 04Terraform, AWS, gcloud, Azure용 공식 룰북과 사용자 지정 JSON 규칙을 지원합니다.
- 05.cc-safety-net/ 디렉터리를 커밋해 팀과 정책을 공유할 수 있습니다.
활용 사례
- 실제 저장소와 인증 정보가 있는 컴퓨터에서 Claude Code나 Codex 같은 AI 코딩 에이전트를 실행하는 경우.
- 팀의 로컬 클론과 클라우드 에이전트 세션에 공통 안전 정책을 적용하는 경우.
- 에이전트가 사용하는 Terraform 같은 인프라 도구나 클라우드 CLI에 보호 장치를 추가하는 경우.
빠른 시작
- 1
Node.js 18 이상이 설치되어 있는지 확인합니다
- 2
이 머신의 코딩용 CLI에 설치합니다
npx -y cc-safety-net@latest install - 3
보호 기능이 작동하는지 확인합니다
npx -y cc-safety-net@latest doctor
사용 전 알아둘 점
- 샌드박스가 아니므로 프로세스를 격리하거나 파일 시스템 권한을 설정하거나 네트워크 송신 트래픽을 감시하지 않습니다.
- 보호 기능은 README에 나열된 지원 코딩용 CLI에만 적용됩니다.
- CLI마다 설치 요구 사항이 다르며 자세한 내용은 전체 문서에 설명되어 있습니다.
토픽
자주 묻는 질문
- cc-safety-net은(는) 무엇인가요?
- Claude Code와 Codex 같은 AI 코딩 에이전트가 위험한 Git·파일 시스템 명령을 실행하거나 비밀 파일에 접근하지 못하도록 차단하는 실행 전 보호 도구입니다. CC Safety Net은 AI 코딩 에이전트의 도구 호출 앞에서 동작하며, git reset --hard, git push --force, 위험한 대상에 대한 rm -rf 같은 파괴적인 명령이 실행되기 전에 차단합니다. 명령이 실제로 무엇을 하는지 분석하므로 bash -c나 python -c로 감싸거나 플래그 순서를 바꿔도 탐지를 피할 수 없습니다. 또한 셸과 에이전트의 파일 도구 양쪽에서 SSH 키, .env 파일, ~/.aws, 코딩 CLI 인증 정보 같은 비밀 정보에 대한 접근도 차단합니다.
- cc-safety-net은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- cc-safety-net은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- cc-safety-net은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. cc-safety-net의 마지막 커밋은 2026년 10월 22일입니다.
- cc-safety-net은(는) 어디에 사용할 수 있나요?
- 실제 저장소와 인증 정보가 있는 컴퓨터에서 Claude Code나 Codex 같은 AI 코딩 에이전트를 실행하는 경우. 팀의 로컬 클론과 클라우드 에이전트 세션에 공통 안전 정책을 적용하는 경우. 에이전트가 사용하는 Terraform 같은 인프라 도구나 클라우드 CLI에 보호 장치를 추가하는 경우.
- cc-safety-net는 어떻게 설치하나요?
- Node.js 18 이상이 설치되어 있는지 확인합니다 이 머신의 코딩용 CLI에 설치합니다: npx -y cc-safety-net@latest install 보호 기능이 작동하는지 확인합니다: npx -y cc-safety-net@latest doctor
- cc-safety-net은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/kenryu42/cc-safety-net
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Claude Code, Claude.ai와 Codex, Cursor, Gemini CLI 같은 코딩 에이전트용 Claude Skills 및 플러그인 1,000여 개를 엄선해 모아 둔 디렉터리입니다.
Claude Code와 Codex 같은 AI 코딩 에이전트의 실시간 세션을 보여주고 요청을 승인하는 macOS 노치 동반 앱입니다.
Claude Code와 OpenAI Codex가 Gemini 모델을 사용하는 Google Antigravity CLI(agy)에 작업을 맡길 수 있게 해주는 플러그인입니다.
Poteto의 pstack Cursor 스킬 스택을 포팅해 Claude Code, Codex, Copilot, Pi 등의 에이전트 하네스에 코딩 작업용 구조화된 워크플로를 제공하는 프로젝트입니다.
여러 코딩 에이전트를 병렬로 실행하는 터미널 Kanban 보드로, 작업마다 git worktree와 tmux 창을 하나씩 제공합니다.