settings.json 제대로 먹게 쓰기

settings.json 에 deny 와 훅을 적어 두었습니다. 그런데 정말 먹었는지 확인해 본 적이 있나요.

끝 쉼표 하나가 남은 settings.json 은 파일 전체가 오류 없이 무시됐고, 그 안의 deny 도 함께 사라져 막아 둔 명령이 그대로 돌았습니다. 종료 코드 0, 경고 0줄.

이 책은 Claude Code 의 설정 파일이 정말 먹었는지를 Claude 의 말이 아니라 흔적(표시 값 · 거절 수 · 훅 기록)으로 확인합니다.

이런 일을 하고 계신다면

· settings.json 에 deny · 훅을 적어 두고 확인해 본 적이 없다

· 설정을 손으로 고친 뒤로 뭔가 안 먹는 것 같다

· 하위 폴더에서 claude 를 켜는 버릇이 있다

· 프로젝트 settings 의 allow 가 안 먹는다

· claude -p 를 작업 스케줄러 · CI 로 돌린다

이 책에 들어 있는 것

레시피 열네 개 · 열다섯 단계 · 88쪽

01 settings.json 은 '먹었는지' 부터 — Claude 에게 묻지 말고 표시 값을 봅니다

02 첫 settings.json — 없으면 (없음), 있으면 첫설정

03 세 자리 — 로컬이 프로젝트를, --settings 가 로컬을, 셸의 환경 변수가 모두를 이겼습니다

04 작업 폴더 — 위 폴더도, git 저장소 뿌리도, 아래 폴더도 안 읽혔습니다

05 끝 쉼표 · 주석 · 홑따옴표 — 파일 전체가 오류 없이 무시됐습니다

06 글자판 — cp949(메모장 ANSI)만 한글 값이 깨졌습니다. BOM · UTF-16 은 됐습니다

07 키 이름 — 오타 · 대문자 · 배열은 조용히 무시, 숫자 7 은 들어갔습니다

08 deny 와 끝 쉼표 — 막혀야 할 명령이 그대로 돌았습니다

09 훅 — 끝 쉼표에도, 로컬의 disableAllHooks 한 줄에도 훅이 사라졌습니다

10 --settings — 없는 파일 · 깨진 글은 멈췄고, 끝 쉼표 파일은 조용했습니다

11 --setting-sources — project 만이면 프로젝트, local 만이면 로컬이 읽혔습니다

12 model — 설정의 sonnet 은 먹었고 --model 이 이겼고, 오타 sonet 은 멈췄습니다

13 allow — 처음 쓰는 폴더에서는 프로젝트의 allow 만 무시됐습니다 (경고는 표준 오류 한 줄)

14 Claude 없이 settings 를 훑는 검사기 — 놀이터의 설정 파일 48개

15 설정 한 벌로 실제 일 맡기기 — 표시 값 · 막기 · 훅 · 결과 파일로 5/5

조용히 빠진 것을 다 실었습니다

· 끝 쉼표 · // 주석 · 홑따옴표 — settings.json 전체가 무시됨

· 그 안의 deny · 훅도 함께 사라짐 — 막아 둔 printenv 가 그대로 돎

· 하위 폴더 · git 저장소 아래에서 켜면 뿌리의 settings 가 빠짐

· 처음 쓰는 폴더에서는 프로젝트 allow 만 무시 (경고는 표준 오류 한 줄)

· 로컬의 disableAllHooks 한 줄에 프로젝트 훅이 꺼짐

· 메모장 ANSI(cp949)로 저장하면 한글 값이 깨진 채 들어감

먹었는지는 흔적이 압니다

설정마다 env 에 표시 값을 넣고 printenv 로 꺼낸 글자 · 결과의 거절 수 · 훅이 직접 쓴 기록 파일로 판정했습니다.

--settings 로 넘긴 깨진 글처럼 시끄럽게 멈춘 경우와, 조용히 지나간 경우를 나란히 실었습니다.

전부 실제로 돌려 확인했습니다

2026년 10월 9일, Windows 10 · Claude Code 2.1.286 에서 레시피 열네 개를 세 판 만들어 돌렸습니다.

기록이 남은 호출 143번. 본문의 검은 상자는 그때 나온 화면 그대로이고, 부록의 코드도 실제로 돌아간 파일 그대로입니다.

설정 파일은 연습용 놀이터에만 썼고, 내 사용자 설정은 건드리지 않았습니다. 막기 시험의 명령은 해가 없는 printenv 였습니다.

이런 분께

· Claude Code 에 deny · 훅으로 안전장치를 걸어 둔 분

· 팀에서 .claude/settings.json 을 함께 고치는 분

· claude -p 로 자동화를 돌리는 분

포함 파일

PDF (A4 · 88쪽) · EPUB (모바일 · 리더용)

두 가지가 ZIP 하나에 들어 있습니다.

「Claude Code 실전」 시리즈입니다. 이 책은 Anthropic 과 관계가 없는 개인의 사용기입니다.