최신 소식

Claude Code 업데이트 2.1.326, 자동화 점검법

Claude Code 업데이트 2.1.326에서 늘어난 권한 확인과 샌드박스 쓰기 제한을 정리했습니다. 사람 없이 돌리는 자동화부터 점검하세요.

GROWBEAT Editorial
첫 공개
11분

이 소식, 나한테 해당될까요?

  • 조건 확인 후claude -p·hook·bypass permissions 모드로 사람 없이 작업을 돌리는 사람업데이트 뒤 자동화를 한 번 직접 돌려 묻기·거부 메시지가 생기는지 로그부터 확인하기
  • 지금 해 보기터미널이나 VS Code에서 Claude Code를 대화하며 쓰는 사람claude --version으로 2.1.326인지 보고, 새로 뜨는 승인 질문은 내용을 읽고 답하기
  • 기다려도 됨자동화가 업무에 바로 물려 있어 변화가 부담스러운 사람stable 채널(보통 약 1주 전 버전)로 옮기는 방법을 공식 문서에서 확인하기

변경 기록은 어떤 명령이 새로 묻거나 거부되는지 하나하나 밝히지 않습니다. 실제 영향은 직접 돌려 봐야 압니다.

대표 이미지 — Claude Code 로고

Claude Code로 보고서 정리, 파일 정리, 예약 작업 같은 일을 맡겨 둔 실무자를 위한 글입니다. 잘 돌던 자동화가 업데이트 다음 날 갑자기 멈추거나, 평소 묻지 않던 승인 질문이 뜨면 원인을 찾기까지 시간이 꽤 걸립니다.

Anthropic은 2026년 11월 16일자 변경 기록으로 Claude Code 2.1.326을 공개했습니다. 이 글에서는 이번 버전에서 무엇이 새로 묻거나 거부되는지, 사람 없이 돌리는 작업은 무엇을 점검할지, 업데이트·버전 확인 방법과 요금·한국 사용 여부를 공식 문서 기준으로 정리합니다.

Claude Code 2.1.326에서 무엇이 바뀌었나요?

Claude Code 2.1.326은 권한 확인과 샌드박스(명령이 건드릴 수 있는 파일·네트워크 범위를 운영체제 수준에서 막는 울타리)를 여러 곳에서 조인 업데이트입니다. 공식 변경 기록에는 2026년 11월 16일로 적혀 있습니다.

GitHub 릴리스는 2026년 11월 16일 22시 11분(UTC), 한국 시간으로 11월 17일 오전 7시 11분에 게시됐습니다. 변경 기록 기준으로 추가 11개, 변경·삭제 64개, 개선 59개, 버그 수정 233개 항목이 실렸습니다.

구분실무자가 알아 둘 내용
권한 확인 강화전에는 그냥 실행되던 일부 명령이 이제 먼저 묻거나 거부됨
샌드박스 쓰기 제한샌드박스 안 명령이 쓸 수 있는 폴더가 줄어듦
로그인 파일 보호.credentials.json 같은 Claude Code 로그인 파일에 쓰는 것을 파일 도구가 거부
속도·편의 개선휴대폰·브라우저로 Remote Control 답변이 실시간으로 흘러나옴, 입력·화면 크기 조절 반응 개선

어떤 작업이 갑자기 묻거나 거부될 수 있나요?

전에는 바로 실행되던 일부 명령이 이번 버전부터 승인을 묻거나 거부됩니다. 변경 기록은 대부분 '일부(some)'라고만 적어, 정확히 어떤 명령인지는 공개하지 않았습니다.

바뀐 곳공식 변경 기록 내용(요약)
cp·mv복사·이동 명령 중 몇 가지는 실행 전에 확인
macOS Bash지난 버전까지 통과하던 명령 가운데 몇 가지가 승인 질문이나 차단으로 바뀜
auto 모드셸 명령 몇 가지가 새로 멈춤. 프로그램 이름이 없거나 $HOME으로 시작하는 wildcard 허용 규칙 일부는 무시되고 안전 검사가 판단
bypass permissions 모드승인을 건너뛰는 모드라도 예외가 생김. 무인 실행이면 그 호출은 실패
hook"decision": "block"이 적용되는 경우가 넓어져, 이 값을 고정으로 내보내던 hook이 실제 차단 원인이 될 수 있음
환경 변수 설정 줄자동 허용이 꺼져 있으면 Bash 샌드박스가 일부 줄 앞에서 묻고, 무인 실행은 거부할 수 있음

auto 모드는 별도의 분류 모델이 사람 대신 동작을 검토하는 방식이고(검토를 건너뛰는 동작도 있음), bypass permissions는 대부분의 승인을 건너뛰는 모드입니다. 이번 변경으로 bypass permissions 모드에서도 일부 호출은 승인을 묻고, auto 모드는 일부 셸 명령을 멈추거나 판단을 안전 검사에 맡깁니다.

사람 없이 돌리는 자동화는 무엇을 점검해야 하나요?

가장 영향이 큰 쪽은 사람이 지켜보지 않는 실행입니다. 변경 기록은 여러 곳에서 '물어볼 사람이 없으면 거부'한다고 적었기 때문에, 예약 작업이나 claude -p 스크립트는 승인 요청에서 멈추거나 거부돼 실패할 수 있습니다.

점검 순서는 다음과 같습니다.

01자동화를 한 번 수동으로 돌려 보고, 결과 로그에 승인 요청·거부 메시지가 있는지 찾습니다.
02파일을 복사·이동하는 단계(cp·mv)와 홈 폴더 아래에 쓰는 단계를 따로 확인합니다.
03hook을 쓰면 "decision": "block"을 무조건 출력하는 코드가 있는지 봅니다.
04샌드박스 쓰기가 막힌 곳이 일반 폴더라면 공식 문서의 sandbox.filesystem.allowWrite로 그 경로만 허용합니다. 홈 폴더의 민감한 폴더는 일부만, user·managed 설정에서만 다시 열 수 있습니다.

샌드박스 문서를 보면 울타리 안 명령이 처음부터 파일을 만들 수 있는 위치는 세 군데입니다. 지금 작업하는 폴더, 사용자마다 따로 잡히는 임시 폴더, 그리고 --add-dir 등으로 직접 지정한 폴더입니다. 2.1.326부터는 macOS·Linux·WSL에서 홈 폴더 아래 민감한 폴더 몇 곳도 기본 쓰기 대상에서 빠졌습니다. 이 가운데 몇 곳은 user 설정이나 managed 설정에 allowWrite 경로를 적어 다시 열 수 있습니다.

막힌 경로는 하나씩만 열기

자동화가 멈췄다고 샌드박스나 권한 확인을 통째로 끄지 마세요. 로그에 나온 경로가 열 수 있는 곳이라면 그 하나만 allowWrite에 넣고 다시 돌려 보세요. 어디까지 열었는지 기록이 남습니다.

플러그인을 쓰는 팀도 확인할 것이 있습니다. 켜 둔 플러그인 가운데 plugin.json 표시용 값 오류로 막혔던 것이 이제는 켜지고, 그 안의 hook·MCP 서버도 함께 동작합니다. 변경 기록은 플러그인을 나눠 주는 관리자에게 점검을 권했습니다.

업데이트는 어떻게 하고 버전은 어떻게 확인하나요?

공식 설치 스크립트로 설치한 경우 Claude Code는 백그라운드에서 스스로 업데이트됩니다. 터미널에서 claude --version을 입력하면 지금 버전을 볼 수 있습니다.

설치 방식업데이트 방법(공식 문서 기준)
공식 설치 스크립트(native)백그라운드 자동 업데이트, 직접 하려면 claude update
Homebrew기본으로는 자동 업데이트 안 됨, brew upgrade claude-code 또는 brew upgrade claude-code@latest
WinGet기본으로는 자동 업데이트 안 됨, winget upgrade Anthropic.ClaudeCode

claude doctor를 실행하면 세션을 열지 않고 설치 상태, 설정 파일 오류, 마지막 업데이트 시도 결과를 읽기 전용으로 보여 줍니다. 업데이트 뒤 설정이 이상하면 이 명령부터 돌려 보세요.

변화가 부담스러우면 업데이트 채널을 고를 수 있습니다. 기본값 latest는 새 버전이 나오는 즉시 받습니다. stable은 한 주가량 늦게 따라가는 대신 큰 결함이 보고된 판을 피해 갑니다. native 설치는 /config의 Auto-update channel에서 바꾸고, Homebrew는 설치한 cask 이름으로 채널이 정해집니다(claude-code는 stable, claude-code@latest는 latest).

다만 native 설치에서 stable로 바꾸면 지금 버전보다 오래된 stable 버전으로 내려갈 수 있습니다. 내려가지 않으려면 공식 문서대로 minimumVersion을 지금 버전으로 함께 정합니다.

요금과 한국 사용에는 영향이 있나요?

2.1.326 변경 기록에 요금제나 가격을 바꾼다는 내용은 없습니다(2026년 11월 17일 확인). 다만 비용에 영향을 줄 수 있는 변경이 있습니다.

긴 대화를 요약해 맥락을 줄이는 자동 압축이 plan 모드에서는 지금 대화에 답하고 있는 모델로 돌아갑니다. opusplan 설정이라 Opus가 답하고 있다면 압축도 Opus가 맡으니, 그만큼 비용이 늘 수 있다는 것이 변경 기록의 설명입니다.

반대로 터미널의 /update-config는 맥락 사용량이 93,000토큰에서 약 13,000토큰으로 줄었습니다.

한국에서는 그대로 쓸 수 있습니다. Anthropic 공식 지원 지역 목록에 South Korea가 있고, 이 목록은 Claude Code를 포함한 제품에 적용됩니다. 이번 변경 기록에 지역 조건은 따로 없습니다.

지금 업데이트할 사람과 기다릴 사람은 누구인가요?

터미널이나 VS Code에서 대화하며 쓰는 사람은 지금 써도 됩니다. 새 승인 질문이 늘 수 있지만, 질문을 읽고 답하면 되고 로그인 파일 보호 같은 안전장치가 함께 들어왔습니다.

사람 없이 돌리는 자동화가 있다면 조건을 확인한 뒤 쓰는 편이 안전합니다. 업데이트 직후 한 번 직접 돌려 로그를 보고, 문제가 보이면 경로·규칙을 하나씩 조정합니다.

자동화가 매출·고객 응대에 바로 물려 있다면 stable 채널로 옮겨 일주일 정도 다른 사용자의 반응을 본 뒤 받는 방법도 있습니다. 자동화가 조용히 멈췄는지 알아차리는 방법은 n8n 오류 알림 점검 글을, 서브에이전트 비용 관리는 Claude Code 서브에이전트 모델 비용 글을 함께 보세요.

참고 자료

태그
#Claude Code 업데이트#Claude Code 2.1.326#클로드 코드 샌드박스#클로드 코드 권한#Claude Code 자동화
무료 맞춤 보고서 받기