
Claude Code v2.1.219|Opus 5가 새로운 기본값으로|매일 Changelog 해설
요약
Claude Code v2.1.219 업데이트를 통해 Opus 5가 새로운 기본 모델로 지정되었습니다. 1M 컨텍스트 지원과 함께 서브 에이전트 중첩 기능 강화, 다이내믹 워크플로우 설정 변경 등 주요 변경 사항을 다룹니다.
핵심 포인트
- Opus 5가 새로운 기본 모델로 채택되었으며 1M 컨텍스트 지원
- 서브 에이전트 중첩(Nest) 깊이 기본값이 1에서 3으로 상향
- Dynamic workflow 기본 사이즈가 medium(15 에이전트 미만)으로 변경
- sandbox 네트워크 보안을 위한 strictAllowlist 옵션 추가
v2.1.219의 주인공은 Opus 5입니다. 새로운 기본 Opus 모델로, 1M context와 fast mode를 지원합니다. /fast에서는 Opus 4.7이 제외되고, 대상이 Opus 5와 Opus 4.8로 변경되었습니다.
Opus 5가 새로운 기본 Opus로 1M context 지원, fast mode는 100만 토큰당 입력 10달러/출력 50달러. claude-opus-5로 지정 (v2.1.219)
Opus 4.7이 제외되고, Opus 5와 Opus 4.8 두 가지로 변경 (v2.1.219)
/fast의 대상 모델이 교체됨
서브 에이전트(Sub-agent)가 3단계까지 중첩(Nest) 가능해짐 기본값이 1에서 3으로 변경. CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1로 비활성화 가능 (v2.1.219)
allowlist 외의 호스트를 프롬프트 없이 거부 (v2.1.219) sandbox.network.strictAllowlist 추가
Dynamic workflow의 기본 사이즈가 medium으로 기준은 15 에이전트 미만. workflowSizeGuideline으로 설정 (v2.1.219)
턴(Turn)이 API 에러로 중단되어도 이미 생성된 답변이 유지됨 (v2.1.219) claude -p의 답변 드롭(drop) 현상 수정
Opus의 기본값이 claude-opus-5로 전환되었습니다. 1M context를 가지며, fast mode 요금은 100만 토큰당 입력 10달러, 출력 50달러입니다. 모델을 명시하지 않은 환경은 그대로 Opus 5로 동작합니다.
대상 독자: /model에서 모델을 고정하지 않고 Opus 계열을 사용 중인 사람, fast mode를 일상적으로 사용하는 사람.
/model 피커(Picker) 측도 함께 정리되었습니다. 병합된 Opus 행의 표시가 단순한 「Opus」에서 「Opus (1M context)」로 변경되었습니다. 하이라이트도 최신 모델의 이름으로만 압축되어, 리스트 중 어떤 것이 신규 릴리스인지 한눈에 알 수 있습니다.
/fast의 대상 모델이 교체되었습니다. Opus 4.7이 fast mode에서 제외되었으며, 대상은 Opus 5와 Opus 4.8 두 가지가 됩니다. 4.7을 fast로 사용하던 분들은 전환을 전제로 확인해 두시기 바랍니다.
claude-api skill도 Opus 5를 기본값으로 업데이트되었으며, Opus 4.8로부터의 이행 절차가 추가되었습니다.
# 중첩을 비활성화하여 기존의 1단계로 되돌림
export CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1
서브 에이전트의 중첩 깊이 기본값이 1에서 3으로 올라갔습니다. 자식 에이전트가 손자 에이전트를 spawn할 수 있게 되어, 다단계 구성을 짤 수 있습니다. 기존처럼 1단계로 되돌리려면 위의 환경 변수를 1로 설정하십시오.
stream-json 측도 이를 따랐습니다. --forward-subagent-text를 붙이면, depth-2 이후에 spawn된 서브 에이전트의 출력이 spawn 원본 Agent의 tool_use id를 키(key)로 하여 흘러 들어옵니다.
Dynamic workflow의 기본 사이즈도 medium이 되었습니다. 기준은 15 에이전트 미만입니다. /config의 Dynamic workflow size에서 다른 사이즈나 unrestricted를 선택할 수 있습니다. 설정은 임의의 settings 파일에서 workflowSizeGuideline으로 지정할 수 있으며, 실행 중인 사이즈는 status line에 표시됩니다.
sandbox.network.strictAllowlist가 추가되었습니다. sandboxed 명령이 allowlist 외의 호스트로 나가려고 하면, 프롬프트를 띄우지 않고 즉시 거부합니다.
외부 통신을 허용된 호스트로 한정하고 싶은 sandbox 운영 시 사용합니다. 기본값은 비활성화이므로, 설정을 넣은 환경에서만 동작이 변경됩니다.
| 버전 | 카테고리 | 변경 사항 | 개요 |
|---|---|---|---|
| v2.1.219 | 신기능 | DirectoryAdded hook | /add-dir 또는 SDK의 register_repo_root를 통해 세션 도중에 작업 디렉터리를 등록하면 트리거됨 |
| v2.1.219 | 신기능 | MCP 설정 오류 가시화 | headless의 init 이벤트에, config 검증에서 제외된 --mcp-config를 나열하는 mcp_server_errors를 추가. claude mcp list와 /mcp는 연결 실패 시 HTTP 상태 코드와 에러 본문을 표시 |
| v2.1.219 | 수정 | claude -p의 답변 유지 | 턴이 mid-stream인 상태에서 API 에러로 중단되어도, 이미 생성된 텍스트를 버리지 않음 |
| v2.1.219 | 변경 | managed MCP의 ${VAR} 해결 | allowlist/denylist의 변수를 settings 파일의 env가 아닌, 실행 시 환경(runtime environment)과 managed-settings env에서 해결 |
| v2.1.219 | 수정 | self-hosted runner의 승인 유지 | runner 재시작 중에 승인한 permission이 세션 재개 시 삭제되던 문제 수정 |
| v2.1.219 | 수정 | Remote Control의 fast-mode 표시 | 모델 전환, 재연결, org 체크 실패 이후에 이전 fast-mode 상태가 남아있던 문제 수정 |
v2.1.219의 핵심은 Opus 5의 기본값 설정과 그에 따른 fast mode 및 /model 주변의 정리입니다. 서브 에이전트(sub-agent)는 최대 3계층까지 중첩(nesting)할 수 있으며, Dynamic workflow는 15개 미만의 에이전트를 기본값으로 합니다. sandbox의 네트워크 제한이나 managed MCP의 변수 해결 대상 등, 운영 측면의 동작도 변경되었습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기