Claude Code 데일리 브리핑 - 2026-06-24
최신 릴리스 요약
| 버전 | 날짜 | 핵심 변경 |
|---|---|---|
| v2.1.187 | 6/23 | sandbox.credentials(샌드박스 명령이 크리덴셜 파일·시크릿 env를 못 읽게 차단), 조직 단위 모델 제한(모델 피커·--model·/model·ANTHROPIC_MODEL), 풀스크린 메뉴 마우스 클릭, 원격 MCP 도구 호출 5분 행 → 자동 중단(CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT), 한국어/CJK 붙여넣기 mojibake 수정, /install-github-app 워크플로 설정 선택화 등 |
| v2.1.186 | 6/22 | claude 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·availableModels로 Opus 4.8 같은 대체 경로를 깔아 두고, 모델 가용성이 회사가 아니라 지정학과 정책에 좌우될 수 있다는 전제로 자동화를 설계하세요. Anthropic 성명 · cryptobriefing
알아두면 좋은 소소한 변경사항
v2.1.187에서 위에서 다 다루지 못한 실용적 변경·수정들입니다.
- 한국어/CJK 붙여넣기 mojibake 수정: 붙여넣기를 바이트 단위 확장키 이벤트로 전달하는 터미널에서 한국어·CJK 텍스트가 깨져 들어가던 문제가 고쳐졌습니다 — 한·일 사용자에게 직접 닿는 수정입니다 (v2.1.187)
/install-github-app워크플로 설정 선택화: 이제 GitHub App만 설치하고 GitHub Actions 워크플로·시크릿 설정 단계는 건너뛸 수 있습니다 (v2.1.187)- 풀스크린 모드 메뉴에 마우스 클릭: 권한 프롬프트·
/model·/config같은 선택 메뉴를 풀스크린에서 마우스로 클릭해 고를 수 있습니다 (v2.1.187) - 서브에이전트 depth 추적 수정: 재개된(resumed) 서브에이전트가 원래 스폰 depth를 복원하고, fork된 서브에이전트가 depth 상한에 포함되도록 고쳐졌습니다. 또 죽은 에이전트가 남긴 잠긴
.git/worktrees/등록을 자동 정리합니다 (v2.1.187) --resume“No conversation found” 수정: 원래-p실행이 모델 턴을 하나도 만들지 않았을 때--resume이 실패하던 문제가 고쳐졌습니다 (v2.1.187)- 구조적 출력 무한 재호출 수정:
--json-schema·workflowagent({schema})에서 모델이 성공 후에도StructuredOutput을 무한 재호출하던 문제가 고쳐졌고, background job이 구조적 출력 없이 턴을 끝낼 때 “working”에 영원히 갇히던 문제도 수정됐습니다 (v2.1.187) /plugin정리 유도 +/btw탐색:/plugin이 최근 안 쓴 플러그인을 표시해 정리를 돕고,/btw는 ←/→ 화살표로 이전 답변을 넘겨 볼 수 있습니다 (v2.1.187)
추천 칼럼 & 읽을거리
- “AI로 구글을 해킹해 $50만 벌기” (brutecat): 보안 연구자가 Claude를 MCP 에이전트로 붙여 Google API를 자동으로 찔러 본 실전 기록입니다. 규모가 인상적입니다 — Android APK·트래픽 인터셉트·바이너리 분석으로 모은 3,600개 API 키로 1,500개 이상의 API를 3개월이 채 안 되는 기간에 자동 probe해 $50만의 버그바운티를 벌었습니다. 핵심 통찰은 두 가지입니다. ① 발견된 취약점 대부분이 정교한 익스플로잇이 아니라 인증이 빠진 API·권한 체크 누락 같은 기본적인 실수였다는 것 — AI는 거대한 공격 표면에 같은 테스트를 끈질기게 반복하는 데 강합니다. ② 그러나 효과는 ‘AI 단독’이 아니라 구조에서 나왔습니다 — API를 통째로 던지지 않고 논리적 그룹으로 묶어 컨텍스트를 공유시키고, 리포트에 probe 응답의 operation ID를 강제로 포함시켜 검증 가능한 발견으로 바꾼 것입니다. 위
sandbox.credentials와 정확히 짝이 되는, “에이전트로 공격 표면을 훑되 검증은 사람이 잠그는” 실전 레시피입니다. GeekNews - “에이전틱 테스팅 — E2E 테스트 스택에서 에이전트의 역할” (Slack Engineering): Slack 엔지니어링 팀이 200개 이상의 에이전틱 워크플로 실험으로 에이전트 기반 테스트가 전통적 결정론적 테스트와 어디서 갈리는지 측정한 글입니다. 결론이 균형 잡혀 있습니다 — 에이전트 실행은 회당 $15~30으로 전통 테스트보다 훨씬 비싸고 느리지만, 특정 UI 경로를 강제하는 대신 목표 달성 여부를 검증한다는 점에서 결이 다릅니다. 그래서 복잡한 UI 동작 탐색·불안정한(flaky) 워크플로 디버깅·프로덕션 버그 재현에 강하고, 테스트 피라미드의 꼭대기에 두어 기존 E2E 테스트를 대체가 아니라 보완하라고 권합니다. 흥미로운 실측 — Playwright MCP가 단순 시나리오 0%, 복잡 워크플로 **0~12%**의 낮은 실패율로 다른 접근을 앞섰습니다. 에이전트에 테스트를 맡길 때 “무엇을, 어디에 두어야 비용 대비 효과가 나는가”에 대한 데이터 기반 가이드입니다. GeekNews
흥미로운 프로젝트 & 도구
- gh-orbit — 여러 worktree의 PR·CI·diff를 ‘한 터미널 대시보드’로: 여러 Git worktree를 하나의 터미널 대시보드로 모아 주는
gh(GitHub CLI) 익스텐션입니다. 각 브랜치의 열린 PR과 CI 상태를 한눈에 보여주고, 구문 강조된 diff를 그 자리에서 확인하며, PR 머지까지 터미널에서 처리합니다. 핵심은 터미널 ↔ git 명령 ↔ 브라우저 탭을 끊임없이 오가던 마찰을 없애는 것 — 여러 worktree를 병렬로 굴리는 흐름에 맞춤합니다. 6/20에 다룬 auto 모드·worktree 격리, 그리고 “AI는 feature branch만 푸시하고 머지는 사람이 PR로”라는 게이트와 정확히 짝이 됩니다 — 에이전트를 worktree별로 병렬로 돌리는 사람이 그 결과(PR·CI)를 한 화면에서 검수하는 데 실용적입니다. GeekNews - CVERader — 매일 쏟아지는 CVE·보안 뉴스를 한곳에 모은 브리핑: 여러 출처에 흩어진 CVE 정보와 보안 뉴스를 한 플랫폼으로 모아 주는 서비스입니다. 보안 사이트를 일일이 돌지 않고도 지금 당장 손봐야 할 치명적 취약점을 빠르게 가려내도록, 일일 보안 브리핑·주간 리포트·CVSS 점수 기반 CVE 모니터링을 제공합니다. 위 ‘AI로 구글 해킹’ 사례가 보여주듯 취약점의 대부분이 기본적인 실수인 만큼, “내가 쓰는 의존성에 오늘 무엇이 터졌나”를 매일 한 번에 확인하려는 개발자에게 실용적입니다. GeekNews