Skip to content

Releases

v0.2.0

Choose a tag to compare

@M1nu0x0 M1nu0x0 released this 05 Nov 08:29
d6fc394

Claude Code의 안전 검사는 ${(s/:/)PATH} 같은 zsh ${(flags)...} 확장을 파싱하지 못해, rm이 없는 명령도 This command could not be checked for dangerous rm operations로 실행 전에 거부합니다(anthropics/claude-code#104925). zsh가 시작되기도 전이라 setopt로는 막을 수 없습니다. 이번 버전은 이 거부를 모델이 이해하고 피하게 합니다.

추가

  • PreToolUse 훅이 안전 검사보다 먼저 Bash 명령을 읽고, 작은따옴표 밖에 ${(가 있으면 거부합니다. 거부 사유로 모델에게 진짜 이유와 POSIX sh로 고쳐 쓰는 방법(printf '%s\n' "$PATH" | tr ':' '\n', while IFS= read -r line; do ...; done < file)을 알려 줍니다.
  • 훅은 거부만 하고 승인은 하지 않습니다. ${(가 없으면 아무것도 출력하지 않으므로 Claude Code는 플러그인이 없을 때와 똑같이 판단합니다. 안전 검사를 피할 수 있는 zsh -c 자동 변환은 넣지 않았습니다.
  • 셸이 zsh이면 세션 시작 안내에 한 줄이 더 붙습니다. ${(flags)...}를 쓰지 말고 POSIX sh로 쓰라는 내용입니다.
  • CI가 매일 #104925의 상태도 확인합니다.

알아 둘 점

  • 권한 모드와 관계없이 거부합니다. 기본 모드에서 승인 창이 떠서 승인하면 실행되던 명령도 이제는 항상 거부되고, 플러그인을 끄는 것 말고는 우회할 방법이 없습니다.
  • 백슬래시로 이스케이프한 \${(, 주석이나 quoted heredoc 본문 안의 ${(도 거부합니다.
  • macOS의 claude -p --permission-mode auto에서 확인했고, 다른 모드와 대화형 앱, Linux에서는 시험하지 않았습니다.

업데이트

claude plugin update safe-zsh@claude-safe-zsh

새 세션부터 적용됩니다.

전체 변경: v0.1.1...v0.2.0

v0.1.1

Choose a tag to compare

@M1nu0x0 M1nu0x0 released this 01 Nov 10:43
7f6d451

세션 시작 때 훅이 모델에게 안내 한 줄을 더 출력합니다. Bash 도구 안에서 직접 띄운 zsh -c는 옵션을 물려받지 않으니, 스크립트 맨 앞에 setopt no_nomatch sh_word_split no_equals;를 붙이거나 bash 문법이면 bash -c를 쓰라는 내용입니다.

변경

  • 셸이 zsh일 때만 출력합니다(CLAUDE_CODE_SHELL이 있으면 그 값, 없으면 $SHELL). CLAUDE_ENV_FILE이 없으면 이전처럼 아무것도 출력하지 않습니다.
  • 모델이 따르지 않을 수 있는 안내이고, 도구나 스크립트가 띄우는 자식 zsh에는 닿지 않습니다.
  • 소개 페이지를 Astro로 옮겨 언어별 페이지가 따로 만들어집니다. 플러그인 동작에는 영향이 없습니다.

업데이트

claude plugin update safe-zsh@claude-safe-zsh

새 세션부터 적용됩니다.

전체 변경: v0.1.0...v0.1.1

v0.1.0

Choose a tag to compare

@M1nu0x0 M1nu0x0 released this 01 Nov 07:54
83f78e6

첫 릴리스입니다. Claude가 bash 문법으로 쓴 명령을 Bash 도구의 zsh가 bash처럼 읽게 해 주는 Claude Code 플러그인입니다. anthropics/claude-code#103027의 우회책입니다.

기능

  • 세션이 시작될 때(startup, resume, clear, compact) SessionStart 훅이 CLAUDE_ENV_FILE에 한 줄을 더해, 셸이 zsh일 때만 no_nomatch, sh_word_split, no_equals를 켭니다. bash에서는 아무것도 바꾸지 않습니다.
    • --include=*.ts처럼 매치되지 않는 glob이 명령을 멈추지 않고 그대로 전달됩니다.
    • 따옴표 없는 $var가 bash처럼 단어로 나뉩니다.
    • echo =====처럼 =로 시작하는 단어가 그대로 남습니다.
  • 터미널, ~/.zshrc, 명령 안에서 직접 실행한 zsh -c에는 영향이 없습니다.
  • Ubuntu와 macOS CI에서 zsh와 bash로 훅을 테스트하고, 실제 Claude Code를 띄워 CLAUDE_ENV_FILE에 남는 내용을 확인합니다. 매일 최신 Claude Code로 돌며 upstream 이슈의 상태도 보고합니다.
  • 한국어, English, 日本語 소개 페이지: https://m1nu0x0.github.io/claude-safe-zsh/

설치

/plugin install safe-zsh --marketplace M1nu0x0/claude-safe-zsh

새 세션부터 적용됩니다.

README: 한국어 | English | 日本語