Claude Code v2.1.314 — 에이전트의 쓰기 범위를 조직이 잠근다
AI

Claude Code v2.1.314 — 에이전트의 쓰기 범위를 조직이 잠근다

zaq · · 4 min read

v2.1.314의 얼굴은 permissions.blockWritesOutsideWorkingDirectories입니다. Write·Edit·NotebookEdit가 모든 권한 모드에서 작업 디렉터리 바깥 경로를 거부하는 스위치로, 조직이 에이전트의 파일 쓰기 범위를 정책으로 잠글 수 있게 됐습니다.

한마디로 말하면, "사용자가 승인했으니 괜찮다"를 넘어 설정 자체가 경계를 만드는 하드 제약 시대의 릴리스입니다. GUI 클라이언트 확산과 조용한 실패 제거가 뒤따릅니다.

쓰기 범위 잠금 — 승인 위의 설정

이전까지 경로 제한은 권한 프롬프트에 의존했습니다. 사용자가 실수로 승인하거나, auto mode가 허용하면 에이전트는 작업 디렉터리 밖에 쓸 수 있었죠. 이 스위치가 켜지면 어떤 권한 모드에서도 바깥 쓰기 자체가 거부됩니다 — 304의 decider: "person"(사람만 승인)을 뛰어넘어, 물어볼 필요조차 없는 영역을 설정으로 소거하는 단계입니다. 하위 디렉터리 대형 파일 덮어쓰기를 막은 312와 함께, 파일 쓰기라는 가장 위험한 작업에 두 겹의 안전장치가 완성됐습니다.

엔터프라이즈 3종 — 라우팅·감사·상한의 정밀화

게이트웨이 운영자를 위한 신규 기능이 밀집했습니다. 업스트림에 groups 목록을 지정하면 나열된 IdP 그룹의 개발자만 해당 업스트림으로 라우팅되고, 페일오버 때도 유지됩니다 — 팀별로 다른 모델·예산 정책을 쓰는 조직의 필수품이죠. **guardrail_trace**는 Bedrock 업스트림에서 어떤 가드레일 필터가 발동했는지 매칭 텍스트 없이 로그로 남겨, 감사 요건과 프라이버시를 동시에 충족합니다. 그리고 조직 관리자가 모델의 effort를 상한 제한하면 세션이 "Invalid effort level"로 매 턴 실패하던 문제가 자동으로 하위 레벨로 낮춰 재시도하고 어떤 레벨을 쓰는지 알려주는 방식으로 바뀌었습니다.

조용한 실패의 종말 — GUI 확산과 exit code

idle compaction이 VS Code와 Claude Desktop의 Code 탭에도 도착했습니다. 200K 토큰을 넘긴 대화가 방치되면 요약되고, 프롬프트 캐시가 만료된 뒤 다음 메시지에 요약이 사용됩니다 — 299에 CLI에서 시작된 이 기능의 GUI 완주입니다. 실패 처리도 잡혔습니다. 시작에 실패한 claude -p가 exit code 0과 빈 출력으로 조용히 끝나던 것이 이제 에러를 출력하고 1로 종료됩니다 — CI 파이프라인에서 성공처럼 보이던 최악의 실패 유형이 사라진 것이죠. Bedrock 다중 이미지 세션의 "400 Input is too long" 반복(이제 오래된 이미지를 걷어내고 컴팩션), Foundry 기본 모델 배포 부재 시 패밀리 폴백, 교차 서명된 갱신 루트 인증서의 TLS 실패 등 인프라 엣지 케이스도 정리됐습니다.

마무리로 — 311(세션 생존)→312(쓰기 안전)→314(정책 하드 제약)로 이어진 3주를 한 문장으로 요약하면, Claude Code가 '도구'에서 '관리 대상 인프라'로 편입되는 과정입니다. 조직에서 도입을 검토하는 팀이라면 이번 릴리스의 설정 몇 줄이 보안 검토 회의 몇 번을 아껴줄 겁니다.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.314

태그: AI Claude Claude Code 개발도구