JW's AI_Stash

2026-04-23_08-45

11 min read

Claude / Claude Code / Cowork AI 업데이트 정리

체크 날짜: 2026년 4월 23일 08:45 (KST)

⚠️ 이 파일에는 2026-04-22_00-00.md 이후 새롭게 확인된 내역만 포함됩니다.

🔧 Claude Code v2.1.117 — 서브에이전트 외부 빌드 지원, 기본 Effort high 전환, Opus 4.7 컨텍스트 계산 수정 외 대규모 개선 (2026년 4월 22~23일)

업데이트 날짜: 2026년 4월 22~23일

제목: Claude Code v2.1.117 출시 — 포크된 서브에이전트 외부 빌드 활성화, Agent frontmatter에서 mcpServers 로드, Pro/Max 구독자 기본 노력 수준 high로 상향, Opus 4.7 컨텍스트 윈도우 계산 버그 수정(200K→1M), /resume 대용량 세션 자동 요약 제안, macOS/Linux 네이티브 빌드 속도 향상(bfs·ugrep 내장), 다수 버그 수정

주요 업데이트 내역

  • 포크된 서브에이전트 외부 빌드 지원: CLAUDE_CODE_FORK_SUBAGENT=1 환경 변수 설정으로 외부 빌드에서도 포크 서브에이전트 활성화 가능 — CI/CD 파이프라인·커스텀 빌드 환경에서 멀티에이전트 활용 범위 확장
  • Agent frontmatter mcpServers 로드: --agent 플래그로 실행되는 메인 스레드 에이전트 세션에서 Agent frontmatter에 정의된 mcpServers가 자동 로드 — 에이전트별 MCP 서버 구성이 일관되게 적용
  • /model 선택 영속성 개선: 모델 선택이 재시작 후에도 유지됨(프로젝트가 다른 모델을 고정해도) — 시작 헤더에서 현재 활성 모델이 프로젝트 핀인지 관리 설정 핀인지 표시
  • /resume 오래된 대용량 세션 자동 요약 제안: /resume 명령어가 오래되고 큰 세션을 다시 읽기 전에 요약 제안 — 기존 --resume 동작과 동일하게 작동, 컨텍스트 윈도우 효율 향상
  • MCP 서버 동시 연결 기본값 적용: 로컬 MCP 서버와 claude.ai MCP 서버가 모두 구성된 경우 동시(concurrent) 연결이 기본값으로 설정 — Claude Code 시작 속도 향상
  • 플러그인 의존성 자동 처리 개선: 이미 설치된 플러그인에 plugin install 실행 시 누락된 의존성 자동 설치(기존: “already installed” 오류로 종료) — claude plugin marketplace add가 구성된 마켓플레이스에서 누락 의존성 자동 해결
  • 관리형 설정 마켓플레이스 제한 강화: blockedMarketplaces 및 strictKnownMarketplaces가 플러그인 설치·업데이트·새로고침·자동업데이트 시 모두 적용
  • Advisor Tool 실험적 레이블 추가: 실험적 도구임을 명확히 표시하는 레이블·링크·시작 알림 추가, “Advisor tool result content could not be processed” 오류로 세션이 멈추는 버그 수정
  • 정리 보존 기간 확장: cleanupPeriodDays 보존 정리가 ~/.claude/tasks/, ~/.claude/shell-snapshots/, ~/.claude/backups/까지 확장 — 오래된 세션 데이터 자동 정리 범위 확대
  • OpenTelemetry 개선: user_prompt 이벤트에 슬래시 커맨드의 command_name·command_source 포함, cost.usage·token.usage·api_request·api_error에 모델이 지원하는 경우 effort 속성 포함 — 커스텀/MCP 커맨드명은 OTEL_LOG_TOOL_DETAILS=1 설정 없이 기본 난독화
  • macOS·Linux 네이티브 빌드 속도 향상: Glob과 Grep 도구가 내장 bfs와 ugrep으로 대체 — 별도 툴 라운드트립 없이 더 빠른 파일 검색(Windows·npm 빌드는 변경 없음)
  • Windows 실행 파일 조회 캐싱: 프로세스당 where.exe 실행 파일 조회 결과 캐싱 — Windows에서 서브프로세스 실행 속도 향상
  • Pro/Max 구독자 기본 Effort high로 상향: Opus 4.6과 Sonnet 4.6 모델에서 Pro/Max 구독자의 기본 노력 수준이 medium에서 high로 변경 — 별도 설정 없이도 더 높은 품질의 응답 제공
  • Opus 4.7 컨텍스트 윈도우 계산 버그 수정: Opus 4.7 세션에서 /context 비율이 부풀려지고 너무 일찍 자동 압축되는 버그 수정 — 200K 컨텍스트 윈도우 대신 Opus 4.7의 실제 1M 컨텍스트 윈도우를 기준으로 올바르게 계산

주요 버그 수정

  • OAuth 토큰 만료 시 자동 갱신: Plain-CLI OAuth 세션에서 액세스 토큰이 세션 중 만료될 때 “Please run /login” 오류 대신 401 응답 시 토큰 자동 갱신
  • WebFetch 대용량 HTML 행업 수정: 매우 큰 HTML 페이지에서 WebFetch가 멈추는 현상 수정 — HTML-to-markdown 변환 전 입력 잘라내기
  • HTTP 204 No Content 크래시 수정: 프록시가 HTTP 204를 반환할 때 TypeError 대신 명확한 오류 메시지 표시
  • Devanagari 등 인도 문자 터미널 렌더링 수정: Devanagari 및 기타 인도 문자 스크립트가 터미널 UI에서 열 정렬이 깨지던 문제 수정
  • MCP elicitation/create 요청 자동 취소 버그 수정: 서버가 턴 중간에 연결을 완료할 때 print/SDK 모드에서 요청이 자동 취소되던 버그 수정
  • 서브에이전트 파일 읽기 멀웨어 경고 오탐 수정: 메인 에이전트와 다른 모델을 실행하는 서브에이전트가 파일 읽기 시 멀웨어 경고를 잘못 표시하던 버그 수정
  • 백그라운드 작업 메모리 누수 수정: 백그라운드 작업이 있을 때 발생하던 유휴 재렌더링 루프 수정 — Linux에서 메모리 증가 감소
  • [VSCode] 대형 마켓플레이스 구성 시 플러그인 관리 패널 오류 수정

상세 내용

v2.1.117은 v2.1.116에 이어 성능, 안정성, 개발자 경험 전반에 걸친 폭넓은 개선을 담은 중요한 릴리즈입니다. 특히 두 가지 변화가 실무에 큰 영향을 미칩니다.

Pro/Max 구독자 기본 Effort high 전환은 사용자가 별도 설정 없이도 Opus 4.6과 Sonnet 4.6에서 더 신중하고 철저한 응답을 받게 됨을 의미합니다. 기존에는 high 노력을 원하면 /effort high를 명시적으로 설정해야 했지만, 이제 구독자라면 기본적으로 더 높은 품질의 코딩·분석 응답을 경험합니다. 단, 토큰 소비가 증가할 수 있으므로 속도와 비용이 중요한 파이프라인에서는 /effort medium을 명시적으로 설정하는 것이 좋습니다.

Opus 4.7 컨텍스트 계산 버그 수정은 Opus 4.7 사용자에게 즉각적인 실용적 개선을 가져옵니다. 기존에는 Opus 4.7이 실제 1M 컨텍스트 윈도우를 가짐에도 200K 기준으로 계산되어, /context에서 사용률이 5배 과도하게 표시되고 불필요하게 일찍 압축이 트리거됐습니다. 이 수정으로 Opus 4.7의 1M 컨텍스트 장점을 실제로 활용할 수 있게 됩니다.

macOS·Linux 네이티브 빌드에서 bfs·ugrep 내장은 파일 시스템 검색이 별도 툴 호출 없이 직접 실행되어 대용량 코드베이스에서의 검색 속도가 유의미하게 향상됩니다. 특히 수천 개 파일이 있는 모노레포 환경에서 에이전트가 코드를 탐색할 때 체감할 수 있는 속도 개선입니다.

활용방법 예시

  • Pro 구독자가 v2.1.117 업데이트 후 복잡한 버그 수정이나 코드 리뷰 작업을 수행할 때, 기본 Effort high가 적용되어 별도 설정 없이도 엣지 케이스까지 꼼꼼히 검토하는 더 철저한 응답을 받고, Opus 4.7 사용자는 1M 컨텍스트 윈도우를 올바르게 활용하여 훨씬 더 긴 코드베이스를 한 번에 분석하는 대규모 에이전트 코딩 세션 수행

  • 기업 CI/CD 파이프라인을 운영하는 개발팀이 CLAUDE_CODE_FORK_SUBAGENT=1 환경 변수를 빌드 서버에 설정하여 외부 빌드 환경에서도 포크된 서브에이전트를 활성화하고, 각 PR 검토 시 서브에이전트가 보안 검사·테스트 커버리지 분석·코드 스타일 검사를 병렬로 수행하는 멀티에이전트 CI 파이프라인 구축

참고 출처: Claude Code CHANGELOG

Graph View