이런 분께
클로드 코드(Claude Code)에 "다운로드 폴더 정리해 줘", "이 폴더 엑셀 파일 이름 바꿔 줘" 같은 일을 맡기면서, 혹시 다른 폴더 파일까지 건드리면 어쩌나 걱정되는 분께 맞아요. 2026년 10월 30일 나온 클로드 코드 2.1.314부터 설정 한 줄로 "작업 폴더 밖에는 파일을 쓰거나 고치지 마"를 걸 수 있어요. 읽기까지 막는 설정도 따로 있어요.
끝나면 이렇게 됩니다
설정 파일에 두 줄을 넣고 나면, 클로드에게 작업 폴더 밖 파일을 만들라고 시켜도 이렇게 거절돼요.
> 홈 폴더에 block-test.txt 파일 하나 만들어 줘
설정이 작업 폴더 밖 쓰기를 막고 있어서 파일을 만들 수 없다는 안내가 나와요.
이 거절은 권한 모드가 무엇이든 걸려요. "묻지 말고 다 해"에 가까운 모드로 켜 둬도 마찬가지예요. 위 화면은 공식 문서가 안내한 시험 방법과 거절 내용을 기준으로 적었어요(공식 예시 기준).
준비물
- 클로드 코드 2.1.314 이상. 읽기 막기는 2.1.257 이상이에요. 터미널(컴퓨터에 글자로 명령하는 창)에서
claude --version으로 버전을 볼 수 있어요. - 클로드 코드를 쓸 수 있는 클로드 요금제(Pro 이상).
- 메모장 같은 글 편집기. 설정 파일은 JSON(중괄호로 이름과 값을 적는 글 형식)이라 쉼표 하나에도 민감해요.
- 기준: 2026년 11월 8일 공식 문서 확인.
따라 하기
- 설정 파일을 열어요. 내 컴퓨터 모든 작업에 걸려면 사용자 설정 파일(맥:
~/.claude/settings.json, 윈도우:%USERPROFILE%\.claude\settings.json)을 써요. 파일이 없으면 새로 만들어요. 클로드 코드는 처음 설치할 때 이 파일을 만들어 두지 않거든요. - 아래 "설정 넣기" 내용을 붙여 넣어요. 이미 다른 내용이 있으면
permissions안에 두 줄만 더해요. - 저장해요. 클로드 코드는 설정 파일이 바뀌면 다시 읽어서, 대부분 다시 켜지 않아도 적용돼요.
- 정리할 폴더로 이동해 클로드 코드를 켜요. 이 폴더가 작업 폴더가 돼요.
/status를 쳐서 「Setting sources」 줄에 User settings가 보이는지 확인해요. 설정 파일을 제대로 읽었다는 뜻이에요.- 아래 "시험해 보기" 문장을 보내서 거절되는지 봐요.
- 다른 폴더 하나만 같이 써야 할 때는
/add-dir 폴더경로로 작업 폴더에 더해요. 이 설정이 켜져 있으면 허용 규칙으로는 못 뚫고, 이 방법만 돼요.
복사해서 쓰는 프롬프트
설정 넣기(settings.json):
{
"permissions": {
"blockWritesOutsideWorkingDirectories": true,
"blockReadsOutsideWorkingDirectories": true
}
}
읽기는 막지 않고 쓰기만 막고 싶으면 두 번째 줄과 그 앞 쉼표를 지워요.
시험해 보기(클로드 코드 채팅):
Write 도구로 [작업 폴더 밖 경로]에 block-test.txt 파일을 만들어 줘.
안 되면 왜 안 되는지 설정 이름과 함께 알려 줘.
[작업 폴더 밖 경로]에는 맥은 ~/, 윈도우는 C:\Users\내이름\처럼 홈 폴더를 넣어요(홈 폴더가 작업 폴더가 아닐 때).
정리 맡기기:
이 폴더 안 파일만 대상으로 [정리 내용]을 해 줘.
움직이기 전에 바뀔 목록을 표로 먼저 보여 주고, 내가 "진행"이라고 하면 해 줘.
