[Claude Code] 2.1.221, 샌드박스가 실제 키를 못 봐요

[Claude Code] 2.1.221, 샌드박스가 실제 키를 못 봐요

Claude Code 2.1.221부터 샌드박스 안에서 도는 명령이 자격 증명 파일의 실제 값 대신 가짜 값을 읽게 만들 수 있어요. 자격 증명 파일용 mask 모드가 changelog에 올라왔는데 지금은 Linux와 WSL에서만 동작해요. 같은 릴리스에 권한 체크 우회 수정도 들어갔어요.

01. 명령은 통과하는데 키 실물은 안 넘어가요

새로 생긴 값은 자격 증명 파일 설정의 mode: "mask"예요. 파일 접근을 아예 막는 대신, 읽히는 값을 바꿔치기하는 방식이에요.

changelog 설명으로는 샌드박스 안 명령이 sentinel 사본을 읽어요. 실제 값 치환은 샌드박스 프록시가 바깥으로 나가는 순간에 해줘요. 파일 전체를 사본으로 돌릴 수도 있고, extract 정규식으로 잡은 구간만 가릴 수도 있어요.

정규식 옵션이 있다는 게 실무에선 꽤 실용적인 부분이에요. .env 파일 하나에 키가 여러 개 들어 있어도 토큰 값 구간만 잡아 가리고 나머지 설정값은 그대로 읽히게 둘 수 있으니까요.

changelog 설명대로라면 샌드박스 안에서 curl로 API를 호출하는 명령은 그대로 성공하고, 그 명령이 읽는 파일에는 진짜 토큰이 안 들어가요. 다만 마스킹은 샌드박스 안 명령에만 걸리는 범위라, 샌드박스를 안 거치는 읽기까지 덮어주는 건 아니에요.

02. macOS에서는 deny로 떨어져요

changelog에 macOS는 파일 마스킹이 deny로 폴백한다고 명시돼 있어요. 맥에서 mask를 걸어도 값이 가려진 채 읽히는 게 아니라, 그 파일에 대한 접근 자체가 막힌다는 뜻이에요.

동작 차이가 꽤 커요. Linux나 WSL에서는 명령이 정상적으로 끝나는데, 같은 설정이 맥에서는 파일을 못 읽는 쪽으로 떨어지니까요.

맥으로 개발하는 사람이 많은 한국 환경에서는 당장 체감이 갈리는 지점이에요. 이 기능을 그대로 써보려면 Linux 서버나 WSL 쪽 셋업이 필요해요. 맥이면 당분간은 기존 deny 흐름을 그대로 쓴다고 보면 돼요.

03. zsh 조건문에 숨은 명령이 권한 체크를 빠져나가던 게 막혔어요

같은 릴리스에 Bash 도구 권한 체크 우회 수정이 들어갔어요. zsh에서 [[ ]] 정규식 조건문 안에 명령을 숨기면 승인 없이 실행되던 경로였어요.

이제 해당 명령도 권한 프롬프트를 띄워요. Windows에서 따옴표가 들어간 경로를 PowerShell 권한 체크가 잘못 처리하던 문제도 같이 잡혔어요. 권한 우회 수정이라 버전을 올려둘 이유가 되는 릴리스예요.

04. Focus view와 prompt-audit도 같이 들어왔어요

VSCode 확장에 Focus view가 생겼어요. 채팅 메뉴 토글로, 도구 실행 로그를 펼칠 수 있는 턴 단위 요약 뒤로 접고 실행 중인 도구는 실시간으로 표시해줘요. Ctrl+Alt+F 또는 "Claude Code: Toggle Focus view" 커맨드로 켜고 끌 수 있어요.

claude-api 스킬에는 prompt-audit 서브커맨드가 붙었어요. 프롬프트와 도구 설명이 옛날 모델 기준으로 쓰인 패턴을 잡아주는 용도라고 나와 있어요.

그 밖에 백그라운드 세션이 작업 보존을 위해 커밋·푸시까지 하도록 바뀌었어요. /fork로 갈라진 세션은 원본 체크아웃 대신 자체 워크트리를 만들어요. /status는 세션 종류를 interactive인지, 아니면 attached·unattended 백그라운드 작업인지까지 표시해줘요.

출처: Claude Code CHANGELOG (2.1.221)

이 글은 공식 발표 내용을 정리한 것이고, Anthropic으로부터 어떤 형식의 협찬도 받지 않았습니다.