Claude Code 데일리 브리핑 - 2026-10-28

최신 릴리스 요약

버전날짜핵심 변경
v2.1.31210/27oidc.user_id_claim 추가, 대용량 CLAUDE.md 덮어쓰기 방지, Code Review가 지연된 push 이벤트에서도 PR 최신 커밋을 리뷰하도록 수정 등 40여 건
v2.1.31110/26ultrathink 턴 중 effort 상승, Claude Tag Skills 뷰 추가, 200K 토큰 초과 자동 압축 등 100여 건 (10/27 브리핑에서 다룸)
v2.1.31010/23Monitor 도구 Bedrock·Vertex·Foundry 확장, Windows 훅 우회 결함 수정 등 25여 건 (10/24 브리핑에서 다룸)

10/26 v2.1.311 이후 하루 만에 10/27 v2.1.312가 나왔습니다. 신규 OIDC 클레임 설정과 게이트웨이별 시스템 프롬프트 변경 외에도, 매우 긴 CLAUDE.md나 rules 파일을 시작 부분만 보고 덮어쓰던 데이터 손실 위험, --add-dir로 하위 디렉터리에 cd한 뒤 paths: 스킬을 찾지 못하던 문제, 이름이 잘못된 명령 하나가 모든 명령 로딩을 막아 claude -p가 아무 출력도 내지 않던 문제 등 체감이 큰 안정성 수정이 다수 포함됐습니다.

전체 릴리스 노트


주요 신규 기능 & 실전 활용

Claude apps gateway에 oidc.user_id_claim이 추가됐습니다 (v2.1.312)

Claude apps gateway에서 사용자를 식별할 때 기본 sub 클레임 대신, Microsoft Entra ID의 oid처럼 조직이 실제로 쓰는 다른 id_token 클레임을 지정할 수 있게 됐습니다. 지금까지는 sub 클레임 하나만 사용자 식별에 쓸 수 있어, 자체 ID 체계를 쓰는 조직은 매핑을 따로 관리해야 했습니다.

# Claude apps gateway 설정 예시
oidc:
  user_id_claim: oid  # Microsoft Entra ID의 경우

Claude apps gateway를 Entra ID 등 sub 외 클레임으로 사용자를 식별하는 OIDC 공급자와 연동하고 있다면, 이 설정으로 기존에 따로 관리하던 사용자 매핑 로직을 걷어낼 수 있습니다. 전체 릴리스 노트

Bedrock·Vertex·Foundry·Mantle에서 인식하지 못하는 모델명에도 짧은 시스템 프롬프트가 적용됩니다 (v2.1.312)

커스텀 배포명이나 추론 프로파일 ARN처럼 Claude Code가 인식하지 못하는 이름으로 Sonnet이나 Haiku를 운영해도, 이제 Bedrock·Vertex·Foundry·Mantle에서는 더 짧은 시스템 프롬프트가 적용됩니다. 기존 전체 프롬프트를 유지하고 싶다면 환경변수로 끌 수 있습니다.

# 기존 전체 시스템 프롬프트를 유지하려면
export CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0

Bedrock·Vertex·Foundry에서 커스텀 배포명이나 ARN으로 Claude Code를 연결해 쓰고 있다면, v2.1.312부터 토큰 사용량이 줄어드는지 확인하고 기존 동작이 필요하면 이 환경변수로 되돌릴 수 있다는 점을 기억해두면 좋습니다. 전체 릴리스 노트


개발자 워크플로우 팁

Write 도구가 대용량 CLAUDE.md·rules 파일을 일부만 보고 덮어쓰지 않습니다 (v2.1.312)

하위 디렉터리의 매우 긴 CLAUDE.md, rules 파일, @로 포함한 파일을 시작 부분만 읽은 뒤 Claude가 그대로 덮어쓰던 문제가 수정돼, 이제 Write는 파일 전체를 읽거나 제자리에서 편집하도록 Claude에게 요청합니다. 지금까지는 파일 뒷부분의 내용이 통째로 사라질 위험이 있었습니다.

여러 하위 패키지마다 자체 CLAUDE.md나 rules 파일을 길게 두고 있다면, 이번 수정으로 Claude가 뒷부분을 보지 않고 섣불리 덮어쓰는 사고를 막아준다는 점을 믿고 계속 써도 됩니다. 전체 릴리스 노트

paths:로 지정한 스킬이 Bash cd로 하위 디렉터리에 들어간 뒤에도 다시 검색됩니다 (v2.1.312)

Bash로 git 저장소 하위 디렉터리에 cd한 뒤 디렉터리별 또는 paths: 조건이 붙은 스킬을 찾지 못하던 문제가 수정됐습니다. 지금까지는 셸에서 깊은 경로로 이동하면 그 경로에 맞춰 설계된 스킬이 갑자기 보이지 않는 경우가 있었습니다.

모노레포에서 패키지별로 paths: 조건을 둔 스킬을 운영하고 있다면, Bash로 하위 디렉터리를 옮겨다니는 작업이 많을수록 이번 수정의 체감이 클 것입니다. 전체 릴리스 노트

프롬프트·에이전트 훅이 세션당 동시에 최대 24개까지만 실행됩니다 (v2.1.312)

서브에이전트를 포함해 한 세션에서 동시에 실행되는 프롬프트·에이전트 훅이 최대 24개로 제한되고, 각 훅의 타임아웃보다 오래 대기 중인 훅은 최대 12개까지 추가로 허용되며, 1초 미만으로 설정한 타임아웃은 1초로 처리됩니다. 지금까지는 다수의 서브에이전트가 동시에 훅을 트리거할 때 동시 실행 수에 제한이 없었습니다.

많은 서브에이전트나 fork를 동시에 띄우면서 각 턴마다 훅을 트리거하는 자동화를 쓰고 있다면, 이 동시 실행 한도를 넘는 순간 일부 훅이 대기열에 밀릴 수 있다는 점을 염두에 두고 훅 설계를 점검해볼 만합니다. 전체 릴리스 노트


보안/제한 이슈

Claude 서비스 현황 — 10/27 오류 2건 모두 해결, 10/28 현재 전체 정상입니다

공식 status.claude.com을 직접 확인한 결과, 10/27 09:14(UTC) Claude 서비스 전반의 오류 증가 조사가 시작돼 09:56(UTC) 해결됐고, 이어 14:42(UTC) Claude Sonnet 5.5 오류 증가가 claude.ai·Claude API·Claude Code·Claude Cowork에 영향을 줬다가 15:17(UTC) 영향이 끝나고 15:50(UTC) 해결 처리됐습니다. 10/28 현재 새로 보고된 인시던트는 없으며, claude.ai·Claude API·Claude Code·Claude Console·Claude Cowork·Claude for Government 전체가 정상(Operational) 상태입니다.

10/27 오후 Claude Sonnet 5.5로 보낸 요청에서 오류를 겪었다면, 이미 해결된 인시던트였을 가능성이 높고 오늘은 새로 보고된 문제가 없는 만큼 재시도해도 괜찮은 상태입니다. Claude Status

Anthropic, 불법 입수한 Stanford 교수들의 책으로 Claude를 학습시켰다는 판결이 나왔습니다 (10/28)

Anthropic이 Stanford 교수 10명 이상의 저작물을 불법 입수해 Claude 학습에 사용한 것으로 확인됐으며, 연방 판사 William Alsup은 해적판 도서로 영구적인 중앙 라이브러리를 구축하는 행위를 금지하는 판결을 내렸습니다. 다만 이 판결은 불법 복제 자체와 AI 학습에서의 공정 이용을 구분해, 합법적으로 취득한 저작물을 학습에 쓰는 것과는 별개로 다뤘습니다.

Claude Code나 Claude API를 기업 환경에 도입하면서 학습 데이터의 저작권 이슈를 검토하고 있다면, 이번 판결이 해적판 수집과 정당한 학습 이용을 어떻게 구분하는지 그 경계선을 눈여겨볼 만합니다. GeekNews

Tailscale SSH 권한 상승 취약점을 조사 중입니다 — 불필요한 SSH 포워딩은 비활성화를 권고합니다 (10/28)

Tailscale SSH에서 확인된 문제 대부분은 이미 SSH 접속 권한이 있는 사용자가 특정 조건에서 지정된 로컬 계정의 권한 범위를 넘어 작업할 수 있는 권한 상승 문제입니다. SSH 포워딩이 필요하지 않다면 tailscaled 서비스 환경에 TS_SSH_DISABLE_FORWARDING=1을 설정해 공격 표면을 줄이도록 권고하고 있습니다.

Claude Code의 self-hosted runner나 원격 개발 환경을 Tailscale SSH로 접속하고 있다면, 조사가 끝날 때까지 불필요한 SSH 포워딩을 꺼두는 것이 안전합니다. GeekNews


생태계 & 플러그인

Show GN: Claude Code Desk Look (mod) — 클로드 코드 CLI를 데스크탑 앱처럼 바꿉니다 (10/27)

터미널에서 쓰는 Claude Code CLI를 선호하지만 다수의 세션을 동시에 돌리기엔 Electron 기반 데스크탑 앱이 무겁다는 문제의식에서, 이미 로그인된 claude -p 등을 감싸 데스크탑 앱처럼 보이게 만든 mod입니다. CLI의 가벼움은 유지하면서 데스크탑 앱 특유의 창 분리나 시각적 구성을 더했습니다.

여러 Claude Code 세션을 터미널로 동시에 돌리면서도 창 전환이 번거로웠다면, Electron 앱 없이 CLI 그대로의 가벼움을 유지한 이 mod를 시도해볼 만합니다. GeekNews

Show GN: Translate Book: arXiv — arXiv 논문을 원문 구조 그대로 번역해 주는 Claude Code 스킬 (10/27)

영어 논문을 일반 번역기에 넣으면 수식과 그림, 표가 깨져 가독성이 떨어지는 문제를 풀기 위해, PDF를 바로 번역하지 않고 arXiv 원문 구조를 그대로 유지한 채 번역본으로 변환하는 Claude Code 스킬입니다.

arXiv 논문을 자주 읽으면서 번역기의 수식·표 깨짐 때문에 결국 원문으로 돌아가곤 했다면, Claude Code에 이 스킬을 추가해 원문 구조를 보존한 번역본을 바로 받아보는 것이 유용합니다. GeekNews


커뮤니티 뉴스


알아두면 좋은 소소한 변경사항

아래는 모두 v2.1.312(10/27) 항목입니다.


추천 칼럼 & 읽을거리


흥미로운 프로젝트 & 도구