인턴 및 신규 입사자를 위한 설정

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

대상 독자

인턴, 신규 입사자, 또는 코드베이스를 배우는 중인 분입니다. AI 도구를 활용해 빠르게 일하고 싶지만, 적응하는 동안 실수로 프로덕션을 망가뜨리거나, 엉뚱한 것을 삭제하거나, 시크릿을 유출하는 일이 없다는 확신이 필요합니다.

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

• 파괴적인 작업 금지. 삭제, force-push, 프로덕션 쓰기는 없습니다.
• 읽기는 자유. 코드와 데이터를 마음껏 살펴보세요.
• 실수는 처벌이 아니라 방지. 차단된 액션은 실패가 아니라 가드레일입니다.

설치할 적용 지점

AI 코딩 어시스턴트 앞에 두는 코딩 훅입니다. Claude Code, Gemini CLI, Cursor IDE, Kiro CLI에서는 거부(deny)가 도구 호출이 실행되기 전에 이를 중단시킵니다. 팀에서 이미 정책을 중앙에서 관리하고 있다면, 관리자에게 노트북을 등록해 달라고 요청하세요. 그러면 팀 정책이 자동으로 적용됩니다.

controlzero install claude-code

시작용 정책

모든 것을 읽을 수 있고 위험한 변경은 하지 못하는 샌드박스입니다. 훅은 어시스턴트의 호출을 표준 이름으로 정규화합니다. 파일 읽기는 file_read:read, 검색은 file_search:search, 셸 명령은 Bash:<command>가 됩니다. 이 정책은 안전한 액션을 허용하고 파괴적인 액션을 차단합니다. ~/.controlzero/policy.yaml에 넣으세요(또는 설치 프로그램이 파일을 만들게 한 뒤 내용을 교체하세요).

version: '1'
settings:
  default_action: deny
  default_on_missing: deny
  default_on_tamper: warn
rules:
  - id: allow-file-read
    allow: 'file_read:read'
    reason: 'Reading and exploring files is always fine.'
  - id: allow-file-search
    allow: 'file_search:search'
    reason: 'Searching the codebase is safe.'
  - id: allow-safe-shell
    allow:
      - 'Bash:ls'
      - 'Bash:cat'
      - 'Bash:grep'
      - 'Bash:git'
    reason: 'Read-only shell commands are fine for learning.'
  - id: allow-db-read
    allow: 'database:read'
    reason: 'SELECT queries are fine for learning.'
  - id: deny-rm
    deny: 'Bash:rm'
    reason: 'Deletes are blocked while you learn the ropes.'
  - id: deny-db-changes
    deny: 'database:write'
    reason: 'No data changes from a learning sandbox.'
  - id: deny-db-admin
    deny: 'database:admin'
    reason: 'No schema or permission changes.'

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

This policy denies anything not explicitly allowed, so it is safe by default.

허용 규칙은 훅이 내보내는 정확한 표준 이름을 사용하므로, 읽기와 검색은 실제로 통과합니다. 익숙해지면 팀에서 더 넓은 정책을 전달해 줄 수 있습니다.

확인할 수 있는 내용

• 본인(또는 어시스턴트)이 차단된 액션을 시도하면 “Deletes are blocked while you learn the ropes.” 같은 명확한 사유와 함께 중단됩니다. 나쁜 일은 일어나지 않습니다. 가드레일이 동작하고 있다는 뜻입니다.

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

  Every decision and its coverage is logged.

  이 기록은 실행되지 않은 차단된 액션과, 실행되었지만 아무것도 찾지 못한 허용된 액션을 구분합니다. 도구가 실제로 무엇을 하는지 알아보려면 실시간으로 지켜보세요.

  controlzero tail

차단된 액션이 본인의 평가에 불리하게 작용하는 일은 없습니다. 가드레일이 제 역할을 했다는 뜻입니다. 정책이 막고 있는데 정당하게 필요한 작업이 있다면, 팀에 정책을 넓혀 달라고 요청하세요.

다음 단계

• Claude Code, Cursor, Codex CLI, Gemini CLI 통제하기 -- 코딩 훅 전체 가이드.
• 읽기 전용 데이터베이스 -- 읽기/쓰기/관리 구분을 이해하세요.
• 빠른 시작 -- Control Zero가 처음부터 끝까지 동작하는 방식.
• 관찰 전용 설정 -- 먼저 관찰만 하고 아무것도 차단하지 않으려는 경우.