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

최신 릴리스 요약

버전날짜핵심 변경
v2.1.1626/3claude agents --jsonwaitingFor 모니터링, WebFetch 권한 우선순위·Windows 경로 규칙 수정, MCP 1초 미만 타임아웃 처리 변경, 다수 안정화
v2.1.1616/2OTEL 커스텀 라벨, 병렬 도구 호출 격리, claude mcp 시크릿 마스킹
v2.1.1606/2dynamic-workflow 트리거 workflowultracode, shell 시작·빌드 설정 쓰기 전 확인, grep 후 Edit 허용

어제(6/3) v2.1.162가 나왔습니다. 새 기능보다 안정화·하드닝에 무게가 실린 릴리스로, claude agents 무인 운영 가시성을 높이는 작은 개선 하나와 권한 규칙 정확성 수정이 핵심입니다. (v2.1.160·v2.1.161의 상세는 어제 브리핑에서 다뤘습니다.)

전체 릴리스 노트


주요 신규 기능 & 실전 활용

claude agents 무인 운영 가시성 — waitingFor (v2.1.162)

v2.1.162는 새 기능보다 버그 수정·안정화가 대부분인 릴리스입니다. 그중 병렬·무인 에이전트 운영에 가장 실용적인 변화claude agents --json 출력에 waitingFor 필드가 추가된 것입니다. 대기 중인 세션이 정확히 무엇에(예: 권한 프롬프트) 막혀 있는지 프로그래밍적으로 알 수 있습니다.

# 팬아웃된 에이전트 중 무엇이, 왜 막혀 있는지 한눈에
claude agents --json | jq '.[] | {name, waitingFor}'

CI·대시보드에서 “왜 멈춰 있지?”를 사람이 일일이 attach해 확인하던 작업을, 권한 프롬프트 대기인지 다른 블로커인지 자동으로 가려낼 수 있습니다. 넓은 터미널에서 상태 텍스트가 60~120열에서 잘리던 문제와 긴 세션명이 40열에서 잘리던 문제도 함께 수정돼, 에이전트 뷰의 가독성이 전반적으로 좋아졌습니다.

GitHub v2.1.162


개발자 워크플로우 팁

파일을 쓰는 서브에이전트는 worktree로 격리하라 — isolation: worktree

서브에이전트를 병렬로 돌려 파일을 동시에 수정하면 단일 작업트리에서 쓰기가 충돌할 수 있습니다. 커스텀 서브에이전트(.claude/agents/)의 frontmatter에 isolation: worktree를 넣으면, 각 호출이 default 브랜치에서 분기된 임시 git worktree에서 실행되고, 변경이 없으면 worktree는 자동으로 정리됩니다. (마침 v2.1.161에서 “worktree 격리 에이전트가 worktree 파일을 못 고치던” 버그가 수정되며 이 경로가 한층 안정화됐습니다.)

worktree는 새 체크아웃이라 .env 같은 untracked 파일이 빠집니다. 프로젝트 루트에 .worktreeinclude(.gitignore 문법)를 두면, gitignore된 파일 중 매칭되는 것을 worktree로 자동 복사해 줍니다.

# .claude/agents/feature-dev.md 의 frontmatter
---
name: feature-dev
description: 병렬 구현 작업에 사용
isolation: worktree
---
# .worktreeinclude  (프로젝트 루트)
.env
.env.local
config/secrets.json

세션 전체를 격리하려면 claude --worktree feature-auth(별칭 -w)로 시작할 수도 있습니다.

Claude Code Docs — Worktrees

서브에이전트마다 모델을 고정해 비용을 통제하라 — model: + CLAUDE_CODE_SUBAGENT_MODEL

서브에이전트 정의에 model:을 명시하지 않으면 기본값은 inherit라, 값싼 탐색 작업도 비싼 메인 모델로 돌아갈 수 있습니다. 읽기 전용 탐색·검색은 model: haiku, 일상 구현 워커는 model: sonnet, 오케스트레이션·난도 높은 추론만 opus로 두면 비용이 크게 갈립니다.

---
name: explorer
description: 읽기 전용 코드베이스 검색
tools: Read, Grep, Glob
model: haiku
---

모델 해석 우선순위는 CLAUDE_CODE_SUBAGENT_MODEL 환경변수 → 호출 시 파라미터 → 서브에이전트 model: frontmatter → 메인 대화 모델 순서입니다. 한 세션의 모든 서브에이전트를 일괄로 값싼 티어로 내리고 싶으면 환경변수 한 줄이면 됩니다.

# 이 세션의 모든 서브에이전트를 Haiku로 강제 (frontmatter 무관)
export CLAUDE_CODE_SUBAGENT_MODEL=claude-haiku-4-5-20251001

토큰 종량제와 6/15 Programmatic Usage Credits를 앞둔 지금, “어디에 어떤 모델을 쓸지”를 정의 파일에 박아두는 것이 비용 거버넌스의 기본기입니다.

Claude Code Docs — Subagents


보안/제한 이슈

v2.1.162 — 권한 규칙 정확성 수정 (WebFetch 우선순위·Windows 경로) (6/3)

v2.1.162에 권한 규칙이 의도대로 적용되지 않던 보안 관련 버그 두 가지가 수정됐습니다.

권한 규칙으로 접근을 통제하던 팀이라면 v2.1.162로 올린 뒤 규칙이 실제로 적용되는지 재확인할 가치가 있습니다.

GitHub v2.1.162

6월 3일 추가 인시던트 — Opus 4.7 오류·Claude Code 일부 저하 (6/3)

6/2 대규모 장애 다음 날인 6월 3일, Anthropic 상태 페이지에 두 건의 짧은 인시던트가 기록됐습니다. Claude Opus 4.7에서 “오류 증가”(약 07:10 UTC 조사 → 07:38 UTC 복구)가 있었고, 별개로 일부 Claude Code 서비스가 저하돼 보안 리뷰·코드 리뷰·routines·일부 Claude Code 웹 세션에 영향이 있었습니다(07:36 UTC 복구). 두 건 모두 약 30분 내 해소됐으며, 6/2의 용량 제약 장애와는 별개의 사건입니다.

Claude Status


생태계 & 플러그인

Harness, 공식 Claude 커넥터 디렉터리에 MCP 서버 등재 (6/1)

CI/CD 플랫폼 Harness가 Anthropic 공식 Claude Connectors Directory에 MCP 서버를 올렸습니다. Claude가 파이프라인·배포·승인, 장애 진단, 보안 상태(SBOM·취약점 스캔), 카오스 실험, 클라우드 비용 이상을 구조적으로 조회할 수 있습니다. 단순 API 래핑이 아니라 Harness의 “Software Delivery Knowledge Graph”(타입이 있는 엔티티 + 선언된 관계)를 노출하는 것이 특징으로, 복잡한 교차 도메인 질의를 5회 이상의 순차 LLM 호출에서 2~3회 구조적 질의로 줄인다고 합니다. 모든 동작은 기존 RBAC·감사 로그를 거칩니다.

Harness 블로그

Anthropic, Claude Partner Network에 Services Track·Partner Hub 추가 (6/3)

Anthropic이 Claude Partner Network에 두 가지 구조를 더했습니다. Services Track은 실제 Claude 배포·인증 실적으로 매기는 3단계(Select / Preferred / Global Premier) 등급제이고, Claude Partner Hub는 파트너가 등급 현황을 매일 추적하고 고객이 적격 파트너를 찾는 디렉터리/대시보드로 MCP 커넥터를 통해 Claude와 연동됩니다. 작년 3월 출범한 $100M 규모 파트너 네트워크는 현재 4만 건 이상의 신청과 1만 명 이상의 인증 컨설턴트를 모았습니다.

Anthropic Newsroom


커뮤니티 뉴스


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


추천 칼럼 & 읽을거리


흥미로운 프로젝트 & 도구