claudekit / updates / claude-code-2-1-219
[ PATCH · ]

Claude Code 2.1.219

Claude Opus 5(`claude-opus-5`)가 추가돼 기본 Opus 모델이 됐습니다. 1M 컨텍스트를 지원하고 fast mode 요금은 Mtok당 $10/$50이며, `/fast`는 Opus 5와 Opus 4.8에 적용되고 Opus 4.7은 fast mode에서 제외됐습니다. 서브에이전트가 기본으로 3단계까지 중첩 생성할 수 있게 됐고, 다이나믹 워크플로는 에이전트 15개 미만을 권장하는 medium 가이드라인이 기본값이 됐습니다. 샌드박스 명령에서 허용 목록에 없는 호스트를 프롬프트 없이 차단하는 `sandbox.network.strictAllowlist`, 세션 중간에 작업 디렉토리가 등록되면 실행되는 `DirectoryAdded` 훅이 추가됐고, `claude -p`가 스트림 도중 API 오류로 턴이 끊길 때 이미 만들어둔 답변을 버리던 문제도 수정됐습니다.

Claude Code
공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

무엇이 바뀌었나?

Claude Code 2.1.219가 2026년 7월 24일 출시됐습니다. Claude Opus 5 추가가 중심입니다. 새 모델이 기본 Opus 자리를 차지하면서 fast mode 대상 모델, /model 피커 표시, claude-api 스킬 기본값이 함께 정리됐습니다. 에이전트 오케스트레이션 쪽도 함께 바뀌어, 서브에이전트 중첩 깊이 기본값이 1에서 3으로 올라가고 다이나믹 워크플로에는 권장 크기 가이드라인이 생겼습니다. 여기에 샌드박스 네트워크 차단 설정, 새 훅, 헤드리스 진단 정보가 추가되고, 모델 표시와 자체 호스팅 러너, 터미널 입력 관련 수정이 함께 들어왔습니다.

새 기능

  • Claude Opus 5 추가

    기존 기본 Opus 모델은 Opus 4.8이었습니다. 이번 릴리스로 Claude Opus 5(claude-opus-5)가 추가되면서 기본 Opus 모델이 됐습니다. 1M 컨텍스트를 지원하고, fast mode 요금은 Mtok당 $10/$50입니다.

  • sandbox.network.strictAllowlist 설정

    샌드박스로 실행하는 명령이 허용 목록에 없는 호스트에 접근하면 그때마다 확인을 요청해, 자동화된 실행이 중간에 멈췄습니다. 이제 sandbox.network.strictAllowlist를 켜면 허용 목록에 없는 호스트를 프롬프트 없이 거부합니다.

  • DirectoryAdded 훅

    세션 도중 작업 디렉토리가 새로 등록돼도 이를 감지해 후속 작업을 걸어둘 방법이 없었습니다. 이제 /add-dir이나 SDK의 register_repo_root 제어 요청으로 작업 디렉토리가 등록되면 DirectoryAdded 훅이 실행됩니다.

  • 헤드리스 stream-json init 이벤트의 mcp_server_errors

    --mcp-config로 넘긴 항목이 설정 검증에서 걸러져도 헤드리스 실행에서는 아무 신호가 없어, MCP 서버가 왜 빠졌는지 알 수 없었습니다. 이제 stream-json init 이벤트에 건너뛴 항목을 담은 mcp_server_errors가 포함되고, 터미널 실행에서는 시작 시 경고를 출력합니다.

  • workflowSizeGuideline 설정 키

    다이나믹 워크플로의 권장 크기는 /config에서만 조정할 수 있어, 팀이나 조직 단위로 값을 배포하기 어려웠습니다. 이제 workflowSizeGuideline 키로 아무 설정 파일에서나 지정할 수 있고, 이 키가 설정돼 있으면 /config의 해당 행은 숨겨집니다.

  • stream-json의 중첩 서브에이전트 전달

    --forward-subagent-text를 켜도 최상위 서브에이전트의 출력만 전달돼, 그 아래에서 생성된 서브에이전트의 작업은 보이지 않았습니다. 이제 depth-2 이상에서 생성된 서브에이전트도 자신을 생성한 Agent tool_use id를 키로 함께 전달됩니다.

주요 개선

  • 서브에이전트 중첩 깊이 기본값 3

    서브에이전트는 다시 서브에이전트를 만들 수 없어(기본 깊이 1), 여러 단계로 나뉘는 작업을 한 번에 위임하기 어려웠습니다. 이제 기본 깊이가 3으로 올라가 서브에이전트가 3단계까지 중첩 생성할 수 있습니다. 중첩을 끄려면 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1을 설정합니다.

  • 다이나믹 워크플로 기본 크기 가이드라인

    다이나믹 워크플로에 크기 기준이 없어 한 워크플로가 필요 이상으로 많은 에이전트를 띄우는 경우가 있었습니다. 이제 에이전트 15개 미만을 권장하는 medium 가이드라인이 기본값입니다. /config의 Dynamic workflow size에서 다른 크기나 무제한을 선택할 수 있고, 실행 중인 워크플로 상태 줄에 현재 기본 크기와 변경 위치 안내가 표시됩니다.

  • fast mode 대상 모델 변경

    fast mode는 Opus 4.7까지 포함하고 있었습니다. 이번 릴리스에서 Opus 4.7이 fast mode에서 제외되면서, /fast는 Opus 5와 Opus 4.8에 적용됩니다.

  • claude-api 스킬 기본 모델 갱신

    claude-api 스킬이 이전 세대 모델을 기준으로 안내하고 있었습니다. 이제 Claude Opus 5를 기본으로 삼고, Opus 4.8에서 넘어오는 마이그레이션 경로를 함께 안내합니다.

  • /model 피커 하이라이트 기준 정리

    /model 피커의 하이라이트가 목록 중 일부를 임의로 강조해, 무엇이 새 모델인지 구분되지 않았습니다. 이제 가장 최신 모델의 이름만 강조해 새로 나온 모델을 표시합니다.

  • 관리형 MCP 허용, 차단 목록의 ${VAR} 해석 위치 변경

    관리형 MCP 허용, 차단 목록의 ${VAR} 항목이 설정 파일의 env를 참조해, 설정 파일을 수정할 수 있는 쪽에서 값을 바꿀 여지가 있었습니다. 이제 시작 시점의 환경 변수와 managed-settings env에서 값을 읽습니다.

  • MCP 연결 실패 진단 정보

    MCP 서버 연결이 실패해도 원인을 알기 어려웠습니다. 이제 claude mcp list와 /mcp가 연결 실패 시 HTTP 상태와 에러 텍스트를 함께 보여주고, MCP 설정 값에 눈에 보이지 않는 앞뒤 공백이 있으면 경고합니다.

  • 자체 호스팅 러너 실패 원인 분류

    자체 호스팅 러너의 spawn, 세션 실패가 한 덩어리로 보고돼 훅 오류인지, 러너 크래시인지, 설정 오류인지 구분할 수 없었습니다. 이제 실패가 구조화된 카테고리로 기록돼 원인별로 구분됩니다.

  • Remote Control 오류 메시지에 원인 설정 명시

    “Remote Control is only available via api.anthropic.com” 오류만으로는 어떤 설정이 문제인지 알 수 없었습니다. 이제 오류 메시지가 원인이 된 설정 이름을 함께 표시합니다.

  • claude --teleport의 리포 불일치 안내

    현재 체크아웃이 세션의 리포와 다를 때 무엇이 어긋났는지 알기 어려웠습니다. 이제 claude --teleport가 현재 체크아웃이 가리키는 리포를 함께 표시합니다.

주요 버그 수정

모델 표시

  • /model 피커가 병합된 Opus 행을 “Opus (1M context)“가 아닌 “Opus”로만 표시하던 문제 수정.
  • 해당 요금제에 Fable이 포함돼 있는데도 모델 행에 “Requires usage credits”가 표시되던 문제 수정 — 오래된 캐시에 라벨이 굳어 있던 경우입니다.
  • Remote Control 클라이언트가 모델 전환, 재접속, 조직 확인 실패 후에도 이전 fast mode 상태를 유지하던 문제 수정.

세션과 자체 호스팅 러너

  • claude -p가 스트림 도중 API 오류로 턴이 끊길 때, 이미 만들어둔 답변까지 함께 버리던 문제 수정.
  • 자체 호스팅 러너가 재시작되는 동안 승인한 권한이 세션 재개 시 유실되던 문제 수정 — 이제 승인한 동작이 실행됩니다.
  • 자체 호스팅 러너 기동 중에 SIGTERM이 들어오면 리스(lease)가 만료될 때까지 오래된 active 행이 남던 문제 수정 — 이제 정상적으로 등록 해제됩니다.

터미널과 입력

  • GNU screen 안에서 copy-on-select가 선택 영역을 복사하지 않고 base64 문자열을 터미널에 출력하던 문제 수정.
  • Vim 모드에서 빈 프롬프트일 때 ←가 INSERT 모드에서만 agent 뷰로 돌아가던 문제 수정 — 이제 NORMAL 모드에서도 동작합니다.
  • 스크린리더 모드가 키를 누를 때마다 입력한 글자만 읽지 않고 입력 줄 전체를 다시 출력하던 문제 수정.
  • Windows에서 CLAUDE_CODE_GIT_BASH_PATH가 bash, sh 바이너리가 아닌 경로를 가리켜도 그대로 bash로 사용되거나 실행이 종료되던 문제 수정 — 이제 경고와 함께 무시합니다.

알아두면 좋은 점

  • 기본 Opus 모델이 Claude Opus 5 — claude-opus-5가 기본 Opus 모델이며 1M 컨텍스트를 지원합니다. fast mode 요금은 Mtok당 $10/$50입니다.
  • /fast는 Opus 5와 Opus 4.8에만 적용 — Opus 4.7은 fast mode 대상에서 제외됐습니다.
  • 서브에이전트 중첩이 기본으로 켜져 있음 — 기본 깊이가 3이므로, 중첩을 원하지 않으면 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1로 끕니다.
  • 다이나믹 워크플로는 medium 가이드라인이 기본 — 에이전트 15개 미만을 권장하며, /config의 Dynamic workflow size에서 다른 크기나 무제한으로 바꿀 수 있습니다.
  • sandbox.network.strictAllowlist는 직접 켜야 함 — 기본값이 아니므로, 허용 목록에 없는 호스트를 프롬프트 없이 차단하려면 설정에서 활성화합니다.
  • workflowSizeGuideline을 설정하면 /config 행이 숨겨짐 — 설정 파일로 값을 배포한 환경에서는 /config에서 해당 항목이 보이지 않습니다.