본문으로 건너뛰기
이 페이지는 기계 번역이며 충분한 검토를 거치지 않았습니다. 영어 원문이 기준입니다. 보안, 개인정보 보호, 데이터 처리, 규정 준수 및 라이선스에 관한 설명은 기술 검토가 끝날 때까지 영어로 유지됩니다. 영어 원문 보기

소프트웨어 개발자를 위한 설정

적용 지점: 코딩 어시스턴트 훅 지원 모드: Local Hosted Hybrid 플랜: Free Solo Teams

대상 독자​

AI 코딩 어시스턴트를 사용하며, 작업 흐름을 늦추지 않으면서 어시스턴트가 내 머신과 저장소에 할 수 있는 일을 엄격한 정책으로 강제하고 싶은 분입니다. Claude Code, Gemini CLI, Cursor IDE, Kiro CLI는 거부된 도구 호출을 실행되기 전에 결정론적으로 중단시킵니다.

일반적으로 통제하려는 대상​

  • 파괴적인 셸 명령. rm -rf, main으로의 force-push, curl 출력을 셸로 파이프하는 동작은 금지합니다.
  • 민감한 파일. 어시스턴트는 프로젝트를 읽고 쓸 수 있지만, SSH 키, 클라우드 자격 증명, /etc는 안 됩니다.

영어 원문 -- 번역은 기술 검토 대기 중입니다

  • Secret egress. Tokens and keys do not leave in a tool call.

설치할 적용 지점​

코딩 훅입니다. 명령 하나로 어시스턴트에 Control Zero를 연결합니다. Claude Code, Gemini CLI, Cursor IDE, Kiro CLI에서는 실행 전 훅에 노출되는 모든 도구 호출이 정책에 따라 검사되고, 거부(deny)되면 실행되기 전에 중단됩니다. 적용 범위는 호스트에서 추론하지 않고 이벤트별로 기록됩니다.

controlzero install claude-code

필요에 따라 claude-code를 cursor, kiro, gemini-cli로 바꾸세요. 개발자 혼자라면 가입이나 계정 없이 완전히 로컬로 실행할 수 있습니다.

시작용 정책​

설치 프로그램은 ~/.controlzero/policy.yaml에 시작용 정책을 둡니다. 이 버전은 전형적인 위험 동작을 차단하고 나머지는 모두 허용하므로, 평소 작업에서는 방해가 되지 않습니다.

코딩 훅은 각 도구 호출을 표준 이름으로 정규화합니다. 셸 명령은 Bash:<command>가 되고(따라서 rm -rf는 Bash:rm), 파일 접근은 대상 path가 호출 컨텍스트에 담긴 file_read:read / file_write:write가 됩니다. 규칙은 이 이름을 대상으로 작성합니다.

version: '1'
settings:
  # Permissive default: only the explicit denies below stop anything.
  default_action: allow
  default_on_missing: allow
  default_on_tamper: warn
rules:
  - id: block-rm
    deny: 'Bash:rm'
    reason: 'Review deletes manually instead of letting the assistant run rm.'
  - id: block-secret-file-read
    deny: 'file_read:read'
    when:
      path: '*/.ssh/*'
    reason: 'SSH keys are off-limits to the assistant.'
  - id: block-aws-creds
    deny: 'file_read:read'
    when:
      path: '*/.aws/*'
    reason: 'Cloud credentials are off-limits to the assistant.'
  - id: allow-everything-else
    allow: '*'
    reason: 'Default-allow so normal coding is never interrupted.'

이 정책은 rm과 ~/.ssh / ~/.aws 읽기를 차단하고 나머지는 그대로 둡니다. 더 많은 명령과 경로(force-push, curl-into-shell, /etc, 나머지 시크릿 디렉터리 등)를 다루려면 범위가 지정된 파일 접근과 아웃바운드 네트워크 차단의 더 완전한 패턴을 복사하세요. 두 문서에는 각 에이전트가 내보내는 정확한 토큰이 나와 있습니다.

확인할 수 있는 내용​

  • 어시스턴트가 차단된 액션을 시도하면 훅이 실행 전에 이를 거부하며, 어시스턴트는 대응할 수 있는 명확한 “정책에 의해 차단됨” 신호를 받습니다.

  • 영어 원문 -- 번역은 기술 검토 대기 중입니다

    Every decision is logged locally.

    작업하는 동안 로그를 실시간으로 확인할 수 있습니다.

    controlzero tail

다음 단계​

영어 원문 -- 번역은 기술 검토 대기 중입니다