← 에디토리얼

클로드 코드 팁 · 2026.11.10 · 8분

클로드 코드 설정 3줄

AItoZ 개발팀 · 2026.11.10 발행

클로드 코드 설정 3줄 — 클로드 코드 팁

클로드 코드(Claude Code)에 최근 2주 사이 생긴 설정 3개를 사용자 설정 파일(~/.claude/settings.json)에 넣는 법입니다. 2026년 11월 10일 테스트 폴더에서 Claude Code 2.1.322로 직접 실행해 확인했습니다.

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 이상.

클로드 코드 설정 꼭 켤 3줄

어떤 설정 세 가지인가요?

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를 읽어 요약까지 끝냈습니다.

denyInsteadOfPrompting을 켠 뒤 거절하고 계속한 실제 화면

자동 허락이 아니라 자동 거절이라는 점이 중요합니다. 위험한 명령이 저절로 실행되지는 않습니다. 미리 허용 규칙에 넣었거나 권한 모드가 허용하는 호출만 실행되고, 나머지는 거절된 채 이유가 남습니다.

이 설정은 사용자 설정(~/.claude/settings.json) · 관리 설정 · --settings 옵션에서만 먹습니다. 저장소의 프로젝트 설정에 넣으면 적용되지 않습니다(이번 시험은 --settings 옵션으로 켰습니다).

공식 문서의 denyInsteadOfPrompting 설명

서브에이전트 effort는 무엇을 바꾸나요?

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

메인 대화는 그대로, 서브에이전트만 low

바꾸는 것은 모델이 아니라 effort(생각하는 양) 입니다. 서브에이전트 모델을 바꾸는 CLAUDE_CODE_SUBAGENT_MODEL과는 다른 설정입니다. 공식 모델 설정 문서는 "effort가 낮을수록 단순한 일은 더 빠르고 싸다"고 설명합니다. 파일 찾기 · 요약처럼 가벼운 심부름을 서브에이전트에 많이 맡긴다면 low로 두고, 어려운 일은 서브에이전트 정의의 effort 칸으로 따로 올리면 됩니다.

세 줄은 어디에 어떻게 넣나요?

세 가지를 모두 쓰려면 홈 폴더의 사용자 설정 파일 ~/.claude/settings.json에 넣는 것이 가장 간단합니다. 환경 변수는 설정 파일의 env 칸에 넣으면 모든 세션에 적용됩니다.

사용자 설정 파일에 세 줄을 넣은 화면

{
  "permissions": {
    "blockWritesOutsideWorkingDirectories": true,
    "denyInsteadOfPrompting": true
  },
  "env": {
    "CLAUDE_CODE_SUBAGENT_EFFORT": "low"
  }
}
  1. 터미널에서 claude update로 최신 버전을 받습니다(세 설정 모두 쓰려면 2.1.319 이상).
  2. ~/.claude/settings.json을 열고 위 내용을 기존 설정과 합칩니다. 이미 permissions가 있으면 그 안에 두 줄만 더합니다.
  3. 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.

다음 글에서는 클로드 코드에 먼저 깔 스킬 다섯 개를 정리합니다.

출처

다음 글클로드 페이블 5.2, Pro 요금제도 11월 16일까지→