Claude Code 위험한 명령 차단: 실행 전에 막는 안전 모드

이 모드는 Claude Code 위험한 명령 차단 기능을 제공하여, Claude Code가 Bash 도구로 실행하려는 위험한 명령을 막아 줍니다. 셸 명령이 실행되기 전에 짧은 규칙 목록과 대조하여 검사합니다. 규칙에 일치하면 명령이 거부되고, Claude에게는 어떤 규칙이 왜 작동했는지 전달되며, 사용자 화면에는 규칙 이름이 담긴 토스트가 표시됩니다. 안전한 명령은 아무 영향 없이 그대로 통과합니다.

내장 규칙은 다음을 다룹니다. /, ~, $HOME, . 또는 *에 대한 rm -rf, main이나 master로의 git push --force, git clean -fdx, SQL의 DROP TABLE, DROP DATABASE, DROP SCHEMA, TRUNCATE, chmod -R 777 /, mkfs, 디스크 장치에 쓰는 dd, 원시 디스크로의 출력 리디렉션, curl이나 wget의 출력을 셸로 파이프하는 명령, 그리고 고전적인 포크 폭탄입니다. git reset --hard는 선택적으로 켤 수 있는 규칙으로 제공됩니다. Claude Code 2.1.287 이상이 필요합니다.

녹화 영상에서는 데모 프로젝트에서 Claude에게 파괴적인 작업을 요청합니다. 모드가 Bash 호출을 거부하고, 토스트에 일치한 규칙 이름이 표시되며, Claude는 거부 이유를 읽은 뒤 명령을 실행하지 않고 응답합니다.

설치 블록에 있는 방법 중 하나를 사용하십시오. 가드는 다음 도구 호출부터 바로 적용되며, /reload-plugins 이후에는 재시작할 필요가 없습니다.

모든 로직은 하나의 tool.call 훅 안에 있습니다. hooks/register.ts의 코드는 다음과 같습니다.

on('tool.call', { tool: 'Bash' }, ($, e, next) => {
  const match = findMatch(e.command, settings)
  if (match === undefined) return next(e)

  if (settings.mode === 'warn') {
    $.ui.toast(`${$.plugin.name}: "${match.name}" is running (warn mode)`)
    return next(e)
  }

  $.ui.toast(`${$.plugin.name}: blocked "${match.name}"`)
  return { deny: denyReason($.plugin.name, match) }
}).catch(($, e, next) =>
  next.called
    ? next(e)
    : { deny: `${$.plugin.name}: its check failed, so the command was not run to be safe.` },
)

매처 { tool: 'Bash' }는 이 훅이 셸 명령만 본다는 뜻입니다. hooks/rules.ts의 findMatch는 먼저 allowPatterns를 확인하고, 이어서 내장 규칙(꺼 둔 규칙은 건너뜀), 마지막으로 사용자의 extraPatterns를 확인합니다. 일치하는 규칙이 없으면 next(e)가 평소처럼 명령을 실행합니다. 일치하면 훅이 { deny: reason }을 반환하고, 그 이유가 Claude가 읽는 도구 결과가 됩니다.

이 모드를 단순한 필터가 아닌 가드로 만드는 것은 .catch 핸들러입니다. next가 호출되기 전에 검사가 예외를 던지면 호출은 허용되지 않고 거부됩니다. 즉, 모드는 실패 시 차단(fail closed) 방식으로 동작합니다. 또한 session.start 훅은 사용자 지정 패턴 중 올바른 정규식이 아닌 것이 있으면 토스트를 한 번 표시합니다.

rules.ts의 각 규칙은 ID, 이름, 한 문장짜리 사유, 그리고 테스트에서 검증하는 예시 명령으로 이루어진 단순한 데이터입니다.

다음 옵션은 /config에서 변경할 수 있습니다. mode: warn으로 설정하면 가드가 알림 도구로 바뀌어, 일치하는 명령도 그대로 실행되고 토스트만 표시됩니다. extraPatterns와 allowPatterns는 항목 하나에 JavaScript 정규식 하나를 받습니다. 내장 규칙을 바꾸려면 hooks/rules.ts의 RULES 배열에서 해당 규칙의 pattern을 수정하십시오.

도구 호출 가로채기는 이 모드가 존재하는 이유 그 자체입니다. 모드는 모든 Bash 명령을 실행 전에 확인하고 거부할 수 있습니다. 명령을 고쳐 쓰지 않으며, 직접 명령을 실행하지도 않습니다. UI 변경은 토스트 표시에 해당합니다. 그 밖에 자체적인 파일, 네트워크, 모델, 명령 접근 권한은 없습니다.

이 모드는 실수를 막기 위한 보호 장치이지 샌드박스가 아닙니다. 패턴을 피하도록 만든 명령은 통과할 수 있으므로 Claude Code의 권한 확인 프롬프트는 켜 두십시오. 모드를 끄려면 /plugin disable cm-block-dangerous-commands를 실행하고, 모든 모드를 끈 채 세션을 시작하려면 claude --safe-mode를 사용하십시오.

macOS 터미널에서 Claude Code 2.1.291로 테스트했습니다. 차단되어야 할 명령이 여전히 실행된다면 다음을 확인하십시오.

• claude --version이 2.1.287 이상인지, 그리고 /plugin에서 모드가 활성화되어 있는지 확인하십시오.
• 셸에서 설치했다면 /reload-plugins를 실행하십시오.
• /config에서 mode가 warn이 아니라 block인지 확인하십시오.
• allowPatterns 항목이 의도보다 넓은 범위와 일치하고 있지 않은지 확인하십시오.
• 가드는 Bash 도구만 다룹니다. Edit과 Write를 통한 파일 편집은 검사하지 않습니다.

안전한 명령이 거부된다면 모드 전체를 경고 모드로 바꾸기보다 범위가 좁은 허용 패턴을 추가하십시오.