2026년 11월 10일 Claude Code CHANGELOG와 공식 설정 문서(code.claude.com)를 확인하고, 이 PC의 Claude Code 2.1.322로 테스트 폴더(C:\demo\my-app)에서 직접 실행했습니다. 필요한 버전: ① 2.1.314 이상 · ② 2.1.319 이상 · ③ 2.1.316 이상.

어떤 설정 세 가지인가요?
10월 30일부터 11월 6일 사이 Claude Code 업데이트에 조용히 들어간 설정 세 가지입니다. 모두 설정 파일 몇 줄로 켜고, 바이브코딩을 오래 맡겨 둘 때 생기는 문제를 하나씩 막아 줍니다.
| 설정 | 하는 일 | 버전 · 날짜 |
|---|---|---|
permissions.blockWritesOutsideWorkingDirectories |
Write · Edit · NotebookEdit가 모든 권한 모드에서 작업 폴더 밖 경로를 거부 | 2.1.314 · 10월 30일 |
permissions.denyInsteadOfPrompting |
허락 창을 기다릴 도구 호출을 거절하고 턴을 계속 | 2.1.319 · 11월 6일 |
CLAUDE_CODE_SUBAGENT_EFFORT (환경 변수) |
effort를 따로 정하지 않은 서브에이전트의 effort를 세션과 다르게 | 2.1.316 · 10월 31일 |
날짜는 CHANGELOG의 버전과 npm 배포일 기준입니다.
폴더 밖 쓰기 막기는 실제로 어떻게 막나요?
설정을 켜면 작업 폴더 밖 파일을 쓰려는 호출이 오류로 끝납니다. 테스트 폴더의 .claude/settings.json에 "blockWritesOutsideWorkingDirectories": true를 넣고, 편집을 묻지 않고 허용하는 모드(accept edits on)에서 "Write 도구로 상위 폴더에 ../outside.txt 파일을 만들어 줘"라고 시켰습니다.

결과는 C:\demo\outside.txt is outside C:\demo\my-app; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories.라는 오류였고, 파일은 만들어지지 않았습니다. 공식 문서에 따르면 이 차단은 bypassPermissions 모드에서도 똑같이 걸립니다. 프로젝트 하나에만 켜도 되고, 어느 설정 파일이든 true가 하나라도 있으면 적용됩니다.
꼭 바깥 폴더 하나를 열어야 하면 /add-dir 폴더로 작업 폴더에 더하면 됩니다. 허용 규칙(allow)으로는 이 차단을 풀 수 없습니다.
자리를 비웠을 때 허락 창에서 멈추지 않게 하려면?
denyInsteadOfPrompting을 켜면 허락이 필요한 호출은 기다리지 않고 거절되고, 클로드는 할 수 있는 나머지 일을 계속합니다. 같은 폴더에서 "curl로 example.com 제목을 알려 주고, 안 되면 README.md를 읽고 요약해 줘"라고 시켜 비교했습니다.
설정이 없을 때는 아래처럼 허락 창이 뜨고, 누가 답할 때까지 그 자리에서 멈춥니다. 밤새 맡겨 둔 작업이 아침까지 한 줄도 진행되지 않는 이유가 대부분 이것입니다.

설정을 켜고 같은 요청을 보내면 curl 호출은 denied automatically로 거절되고, 클로드는 README.md를 읽어 요약까지 끝냈습니다.

자동 허락이 아니라 자동 거절이라는 점이 중요합니다. 위험한 명령이 저절로 실행되지는 않습니다. 미리 허용 규칙에 넣었거나 권한 모드가 허용하는 호출만 실행되고, 나머지는 거절된 채 이유가 남습니다.
이 설정은 사용자 설정(~/.claude/settings.json) · 관리 설정 · --settings 옵션에서만 먹습니다. 저장소의 프로젝트 설정에 넣으면 적용되지 않습니다(이번 시험은 --settings 옵션으로 켰습니다).

서브에이전트 effort는 무엇을 바꾸나요?
CLAUDE_CODE_SUBAGENT_EFFORT는 effort를 따로 정하지 않은 서브에이전트가 메인 세션의 effort를 물려받지 않고 이 값으로 돌게 합니다. 값은 effort 단계(low · medium · high · xhigh · max, 모델마다 다름)를 씁니다.

바꾸는 것은 모델이 아니라 effort(생각하는 양) 입니다. 서브에이전트 모델을 바꾸는 CLAUDE_CODE_SUBAGENT_MODEL과는 다른 설정입니다. 공식 모델 설정 문서는 "effort가 낮을수록 단순한 일은 더 빠르고 싸다"고 설명합니다. 파일 찾기 · 요약처럼 가벼운 심부름을 서브에이전트에 많이 맡긴다면 low로 두고, 어려운 일은 서브에이전트 정의의 effort 칸으로 따로 올리면 됩니다.
세 줄은 어디에 어떻게 넣나요?
세 가지를 모두 쓰려면 홈 폴더의 사용자 설정 파일 ~/.claude/settings.json에 넣는 것이 가장 간단합니다. 환경 변수는 설정 파일의 env 칸에 넣으면 모든 세션에 적용됩니다.

{
"permissions": {
"blockWritesOutsideWorkingDirectories": true,
"denyInsteadOfPrompting": true
},
"env": {
"CLAUDE_CODE_SUBAGENT_EFFORT": "low"
}
}
- 터미널에서
claude update로 최신 버전을 받습니다(세 설정 모두 쓰려면 2.1.319 이상). ~/.claude/settings.json을 열고 위 내용을 기존 설정과 합칩니다. 이미permissions가 있으면 그 안에 두 줄만 더합니다.- Claude Code를 다시 시작하고, 폴더 밖 파일을 만들어 보라고 시켜 거절되는지 확인합니다.
켜기 전에 알아 둘 점은?

- 셸 명령은 못 막습니다. 폴더 밖 쓰기 차단은 Write · Edit · NotebookEdit 도구만 막습니다. 셸 명령 · MCP 도구 · 훅이 쓰는 파일까지 막으려면 샌드박스를 켜야 한다고 문서에 적혀 있습니다.
- 설정 파일은 클로드가 못 고칩니다. 폴더 밖 쓰기 차단을 켜면 작업 폴더 안의 Claude Code 설정 파일도 클로드가 고칠 수 없습니다. 설정은 직접 고칩니다.
- 워크트리 도구가 빠집니다. 폴더 밖 쓰기 차단을 켜면
EnterWorktree·ExitWorktree도구가 빠지거나 거절됩니다. - 끄는 법: 키를 모든 설정 파일에서 지우고 Claude Code를 다시 시작합니다.
- 작업 폴더 신뢰 확인 창과 프로젝트 MCP 서버 승인 창은
denyInsteadOfPrompting을 켜도 뜹니다. 자리를 비우기 전에 미리 답해 둡니다.
한 번에 정리
- 폴더 밖 쓰기 막기:
blockWritesOutsideWorkingDirectories: true— 편집 자동 허용 모드에서도 거절(직접 확인). - 허락 대기 없애기:
denyInsteadOfPrompting: true— 기다리지 않고 거절한 뒤 할 수 있는 일을 계속(직접 확인). 사용자 설정에만. - 서브에이전트 effort:
env에CLAUDE_CODE_SUBAGENT_EFFORT: "low"— effort를 안 정한 서브에이전트만. - 먼저
claude update.
다음 글에서는 클로드 코드에 먼저 깔 스킬 다섯 개를 정리합니다.
출처
- Claude Code CHANGELOG(2.1.314 · 2.1.316 · 2.1.319): https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
- Claude Code 설정 문서(settings-reference): https://code.claude.com/docs/en/settings-reference
- Claude Code 모델 설정 문서(effort): https://code.claude.com/docs/en/model-config
- 화면: 2026년 11월 10일 테스트 폴더에서 직접 실행한 Claude Code 2.1.322의 출력을 다시 그린 화면(요금제 정보는 뺐습니다)
