Repository navigation
Releases
Releases · M1nu0x0/claude-safe-zsh
v0.2.0
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
세션 시작 때 훅이 모델에게 안내 한 줄을 더 출력합니다. 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
첫 릴리스입니다. 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
새 세션부터 적용됩니다.