Claude Code 데일리 브리핑 - 2026-06-24

최신 릴리스 요약

버전날짜핵심 변경
v2.1.1876/23sandbox.credentials(샌드박스 명령이 크리덴셜 파일·시크릿 env를 못 읽게 차단), 조직 단위 모델 제한(모델 피커·--model·/model·ANTHROPIC_MODEL), 풀스크린 메뉴 마우스 클릭, 원격 MCP 도구 호출 5분 행 → 자동 중단(CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT), 한국어/CJK 붙여넣기 mojibake 수정, /install-github-app 워크플로 설정 선택화 등
v2.1.1866/22claude mcp login/logout <name>, ! bash 출력에 Claude 자동 응답(respondToBashCommands), CLAUDE_CODE_MAX_RETRIES 캡 15 + RETRY_WATCHDOG, background 서브에이전트 권한 프롬프트를 메인에 표시 (6/23 상세)

어젯밤(6/23) v2.1.187이 올라왔습니다 — v2.1.186(6/22)에 이은 이틀 연속 기능 릴리스입니다. 헤드라인은 **샌드박스 명령에서 크리덴셜·시크릿 읽기를 차단하는 sandbox.credentials**와, 조직이 사용 가능한 모델을 제한하는 기능입니다(아래 신규 기능). 두 번째 축은 6/23에 또 한 번 있었던 플랫폼 인시던트입니다 — 이번 주 세 번째 안정성 잡음입니다(보안/제한).

전체 릴리스 노트


주요 신규 기능 & 실전 활용

sandbox.credentials — 샌드박스 명령이 ‘크리덴셜 파일·시크릿 환경변수’를 못 읽게 막는다 (v2.1.187)

이번 릴리스의 헤드라인입니다. 새 설정 **sandbox.credentials**는 샌드박스에서 실행되는 명령크리덴셜 파일(예: ~/.aws/credentials, .env, 토큰 파일)과 시크릿 환경변수를 읽지 못하게 차단합니다.

// .claude/settings.json — 샌드박스 명령의 크리덴셜·시크릿 접근을 막는다
{
  "sandbox": {
    "credentials": "deny"   // 정확한 키/값 표기는 공식 settings 문서를 따르세요
  }
}

실무 의미가 분명합니다 — 에이전트가 도는 환경에는 거의 항상 API 키·클라우드 크리덴셜·토큰이 어딘가에 놓여 있고, 자동화로 임의의 셸 명령을 돌리다 보면 그 비밀이 명령 출력·로그·외부 호출을 통해 새어 나갈 경로가 생깁니다. sandbox.credentials는 이 경로를 모델의 선의가 아니라 런타임 차단으로 닫습니다 — 6/22에 다룬 “반드시 지켜야 할 규칙은 프롬프트가 아니라 hook으로 강제하라”와 같은 결입니다(여기선 hook이 아니라 샌드박스 설정이 그 역할을 합니다). 6/24 추천 읽을거리의 ‘AI로 구글 API를 찔러 $50만 버그바운티’ 사례가 정확히 짝이 됩니다 — 거기서 드러난 가장 흔한 취약점이 인증이 빠진 API·권한 체크 누락이었던 만큼, 에이전트가 만질 수 있는 크리덴셜 자체를 줄이는 것이 가장 값싼 1차 방어입니다. GitHub v2.1.187

조직이 ‘사용 가능한 모델’을 제한한다 — 피커·--model·ANTHROPIC_MODEL 전 경로에 적용 (v2.1.187)

관리자가 조직 단위로 허용 모델을 정할 수 있게 됐습니다. 이제 사용자가 모델 피커·--model 플래그·/model 명령·ANTHROPIC_MODEL 환경변수 중 어느 경로로든 제한된 모델을 고르면, “restricted by your organization’s settings” 메시지가 뜹니다.

핵심은 모든 진입점에 일관되게 걸린다는 점입니다 — 누군가 ANTHROPIC_MODEL을 환경변수로 우회해도 같은 제한을 받습니다. 최근 흐름과 겹쳐 보면 의미가 또렷합니다 — 수출통제로 모델 가용성이 흔들리고(아래 보안/제한의 Fable 5·Mythos 5) 모델이 조용히 deprecated·자동 교체되던(6/20) 상황에서, 조직이 **“우리 팀은 이 모델만 쓴다”**를 중앙에서 못 박는 레버가 생긴 것입니다. CI·팀 표준에서 컴플라이언스·비용·재현성을 위해 모델을 고정하고 싶을 때, 이제 개별 개발자의 설정이 아니라 조직 정책으로 강제할 수 있습니다. GitHub v2.1.187


개발자 워크플로우 팁

무인 자동화의 ‘시크릿 유출 경로’를 sandbox.credentials로 닫아라

sandbox.credentials를 가장 먼저 적용할 곳은 무인으로 도는 자동화입니다. CI·cron·background 세션에서 에이전트가 임의의 셸 명령을 돌릴 때, 그 명령은 머신에 놓인 크리덴셜 파일과 시크릿 환경변수에 기본적으로 접근할 수 있었습니다 — 의도된 동작이든 아니든, 한 번 출력에 실리면 로그·아티팩트·외부 호출로 새어 나갈 수 있습니다.

레시피는 단순합니다 — 자동화 프로파일의 .claude/settings.json에서 sandbox.credentials로 크리덴셜·시크릿 읽기를 차단하고, 에이전트가 정말로 비밀이 필요한 작업(예: 특정 API 호출)은 그 비밀을 모델에 노출하지 않는 도구/MCP 서버 뒤로 밀어 넣는 것입니다. 6/21에 다룬 WIF(정적 키 제거), 6/19의 **서브에이전트 최소 권한(tools: 좁히기)**과 같은 자리입니다 — “에이전트가 만질 수 있는 비밀의 표면적을 줄인다”는 한 방향의 세 번째 도구입니다. (정확한 키·값 표기는 공식 settings 문서를 따르세요.) GitHub v2.1.187

멈춘 원격 MCP 도구 호출이 이제 ‘무한 행’ 대신 끊긴다 — CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT

CI·cron으로 Claude Code를 무인 실행한다면 이번 수정 한 줄을 챙기세요 — 응답 없이 5분간 멈춘 원격 MCP 도구 호출이, 이제 무한히 블로킹되는 대신 에러로 자동 중단됩니다. 임계값은 **CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT**로 조정할 수 있습니다.

# 끊긴 원격 MCP 서버에 세션이 통째로 묶이는 걸 막는다 (예: 60초 idle 후 중단)
export CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT=60

핵심은 단일 행(hang)이 무인 작업 전체를 멈추는 사고를 막는 가드라는 점입니다. 원격 MCP 서버가 네트워크 문제로 응답을 끊으면, 그동안에는 도구 호출이 그 자리에서 멈춰 세션이 통째로 행에 빠질 수 있었습니다. 이제는 idle 타임아웃이 그 호출을 끊어 에이전트가 다음 단계로 넘어가거나 깔끔히 실패하게 합니다 — cron 파이프라인에서 “왜 어제 작업이 밤새 멈춰 있었나”를 줄이는 종류의 변경입니다. 무인으로 긴 작업을 돌린다면 이 변수를 워크로드에 맞게 짧게 잡아 두세요. GitHub v2.1.187


보안/제한 이슈

6/23 또 한 번의 인시던트 — 다중 모델 elevated error rate (이번 주 세 번째)

6/23, Claude 전반에 또 한 번 인시던트가 있었습니다. status.claude.com 기록상 14:19 UTC에 다중 모델의 elevated error rate 조사를 시작14:25 UTC에 원인 식별·수정 적용, 그리고 약 16:44 UTC에 해소됐습니다(약 2시간 반). 영향 범위가 넓었습니다 — Claude.ai·Claude Console·Claude API·Claude Code·Claude Cowork가 동시에 영향을 받았고, Downdetector에는 피크에 미국에서만 8,000건 이상의 신고가 접수됐습니다.

개별 인시던트는 복구됐지만, 패턴이 신호입니다 — 6/18 전면 장애, 6/20 ‘Opus 4.8 errors’에 이어 이번 주만 세 번째 안정성 잡음입니다. 터미널의 Claude Code도 같은 백엔드에 묶여 있어, 짧은 장애에도 무인 작업이 통째로 깨질 수 있습니다. CI·cron으로 Claude Code를 돌린다면 재시도·백오프와 실패 알림을 파이프라인에 깔아 두는 것이 변함없는 실무 대응입니다(6/22에 다룬 CLAUDE_CODE_MAX_RETRIES 캡 15·RETRY_WATCHDOG와 함께 점검하세요). Claude Status — Incident History · TechRadar

Fable 5·Mythos 5 — 수출통제 12일째, 여전히 전 사용자 오프라인 + 구독 포함도 종료 (6/23)

여러 날 다룬 사안이라 짧게 짚습니다. 6/23로 두 가지가 겹쳤습니다.수출통제 12일째(6/12 명령) Fable 5·Mythos 5는 여전히 모든 사용자에게 오프라인입니다 — 외국 국적자만이 아니라, 실시간으로 미국인/외국인을 분리할 방법이 없어 전 세계 전원에게 꺼진 상태가 유지됩니다. 6/19 한 임원이 자신한 “며칠 내 복구”는 6/24 기준 아직 현실이 되지 않았습니다. ② 동시에 6/23부로 Fable 5의 구독 무료 포함 기간(6/9~6/22)이 종료됐습니다 — 즉 모델이 돌아오더라도, 무료 번들이 아니라 별도 과금(usage credit) 대상이 됩니다.

요약하면 ‘언제 돌아오는가’와 ‘돌아오면 어떻게 과금되는가’가 둘 다 불리한 쪽으로 정리됐습니다. 외국 국적 개발자(한국·일본 등)에게는 애초에 접근이 막혀 있으니 실무 대응은 그대로입니다 — fallbackModel·availableModelsOpus 4.8 같은 대체 경로를 깔아 두고, 모델 가용성이 회사가 아니라 지정학과 정책에 좌우될 수 있다는 전제로 자동화를 설계하세요. Anthropic 성명 · cryptobriefing


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

v2.1.187에서 위에서 다 다루지 못한 실용적 변경·수정들입니다.


추천 칼럼 & 읽을거리


흥미로운 프로젝트 & 도구