## 변경 사항 - Claude API 코드를 API 버전 `2026-10-21`로 이동하기 위해 `/claude-api api-versio

원문 발행 2026. 10. 22. 07:17원문 언어 영어AI 한국어 번역Claude Code Releases 원문 보기

요약

Claude API의 버전 관리 및 안정성 개선에 초점을 맞춘 업데이트 내용입니다. `2026-10-21` 버전으로 코드를 이동시키고, OpenTelemetry 이벤트를 추가하여 추적 기능을 강화했습니다. 또한, 다양한 환경(macOS, Linux)에서의 연결 끊김 문제와 대용량 데이터 처리 시 발생하는 오류들을 수정하여 전반적인 안정성을 높였습니다.

핵심 포인트

Claude API를 `2026-10-21` 버전으로 이동 및 관리 기능 추가
OpenTelemetry 이벤트를 통해 안전 이벤트 추적 강화
macOS/Linux 환경에서 연결 끊김 및 절전 모드 문제 해결
대용량 데이터 처리 시 발생하는 오류 수정 및 안정성 개선

변경 사항

Claude API 코드를 API 버전 2026-10-21로 이동하기 위해 /claude-api api-version 추가
권한 규칙, 자동 모드(auto mode), 안전 검사(safety check), 훅(hook) 또는 샌드박스(sandbox)가 중지되거나 프롬프트가 제공되거나 반환될 때마다 claude_code.safety_event OpenTelemetry 이벤트를 추가
CLAUDE_CODE_DISABLE_1M_CONTEXT가 설정되고 모델이 opus[1m]과 같이 [1m] 접미사를 가진 별칭인 경우, 모델을 찾을 수 없다는 오류로 요청 실패하는 문제 수정
효과가 없는 곳에서 커스텀 ANTHROPIC_BASE_URL 게이트웨이와 Foundry에서 prompt-caching-scope 베타 헤더가 전송되도록 하는 문제 수정
macOS에서 로그인 키체인이 잠겨 있을 때 MCP 서버가 claude -p에서 "인증 필요(needs authentication)"를 표시하는 문제를 수정했습니다. 이제 그 이유를 표시하며, 잠금 해제 후 다음 실행에서는 새로운 로그인 없이 연결됩니다.
MCP 서버가 연결되는 동안 macOS 또는 Linux 컴퓨터가 절전 모드로 들어갔을 때, MCP 서버가 시간 초과로 보고되고 헤드리스(headless) 실행에서 실패 상태를 유지하는 문제 수정
연결이 도중에 끊길 때 HTTP MCP 도구 호출이 두 번 전송되던 문제를 수정했습니다. 이제 읽기 전용 또는 반복 가능한(idempotent) 도구만 재시도됩니다.
백그라운드 작업이 실행되는 동안 턴(turn)이 간혹 SDK MCP 서버의 최신 도구 없이 시작되던 문제 수정
많은 PDF 페이지, 이미지 또는 기타 대용량 도구 결과를 읽는 턴에서 일부 "Autocompact is thrashing" 오류가 발생하던 문제 수정
세션이 다시 시작된 후 클라우드 세션의 /autocompact가 기본 창으로 돌아가는 문제 수정
클라우드 또는 자체 호스팅 러너(self-hosted runner) 세션이 재시작될 때, /clear로 지워진 대화 내용이 가끔 복구되던 문제 수정
Claude 앱 게이트웨이 세션에서 CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS가 무시되던 문제 수정
OTEL_EXPORTER_OTLP_HEADERS가 설정된 경우, Claude 앱 게이트웨이 뒤의 Claude 데스크톱 세션에서 발생하는 원격 측정(telemetry) 데이터가 거부되던 문제 수정
/permissions 수정: 최근 거부된 항목에 거부된 셸 명령이 표시되지 않던 문제와, 자동 모드(auto mode)의 로컬 분류기가 재시도된 명령을 확인할 때 해당 승인을 무시하던 문제를 해결했습니다. 이제 행을 승인하면 설명 대신 명령 이름이 지정됩니다.
/help 및 / 명령어 메뉴가 /claude-api와 같은 번들링된 스킬에 대해 짧은 설명 대신 모델용 긴 설명을 표시하던 문제를 수정했습니다.
서브 에이전트(subagent) 기록에서 플레이스홀더 토큰 사용과 스트리밍 응답의 빈 중지 이유를 기록하던 문제를 수정했습니다.
Agent SDK의 setModel()을 통해 모델을 전환하고 이를 기반으로 구축된 앱들이 API가 모델 확인에 5초 이상 걸릴 경우 거부되던 문제를 수정했습니다. Claude Code는 이제 최대 15초까지 대기합니다.
연결된 앱(예: 비활성 세션을 보관하는 데스크톱 앱)을 통해 중지된 백그라운드 명령이 Claude에게 사용자에 의해 중지된 것으로 보고되던 문제를 수정했습니다. 이제 알림은 출력 파일 이름을 지정합니다.
Cowork 클라우드 세션에서 WebFetch가 사이트가 4xx 상태를 반환하거나 robots.txt 거부로 응답할 때 도구 오류를 보고하던 문제를 수정했습니다. 이제 로컬 세션과 마찬가지로 정상적인 결과입니다.
직접 구성된 GitHub MCP 서버의 쓰기 도구가 데스크톱 앱의 Code 탭에 아무것도 생성하지 않고 닫힌 양식을 표시하던 문제를 수정했습니다.
Artifact 도구 읽기 실패 시 서버가 재사용된 연결을 닫았을 때 연결 초기화(connection reset) 오류를 보고하던 문제를 수정했습니다.
셀프 호스팅 러너(Self-hosted runner): --use-anthropic-git-proxy를 사용한 세션이 이전 세션에 의해 클론된 .claude/settings.local.json 파일을 커밋하던 문제를 수정했습니다.
셀프 호스팅 러너: 체크아웃 훅(checkout hook) 중에 세션을 보관하거나 재큐(requeue)하거나 러너를 중지할 때, 훅의 프로세스가 계속 실행되고 러너 슬롯이 점유되던 문제를 수정했습니다.
파싱할 수 없는 도구 호출로부터 복구 개선: Claude Code는 이제 턴을 오류로 종료하기 전에 해당 호출을 최대 두 번까지 재시도합니다.
함께 시작되는 포크 서브 에이전트 개선: 각 에이전트에 어떤 실행이 자신만의 것인지 알려주어, 포크들이 서로의 작업을 시작하려고 시도할 가능성이 훨씬 줄었습니다.
브라우저 로그인 개선: 이제 계정 프로필 로딩을 기다릴 필요 없이, 로그인이 완료되는 즉시 성공 페이지가 표시됩니다.
클라우드 및 자체 호스팅 러너 세션의 웹 검색 오류 개선: 403으로 검색이 거부되면서 이유를 제공하는 경우, 일반적인 "인증 오류" 대신 해당 이유가 표시됩니다.
데스크톱 앱의 MCP 서버 중 하나에 연결할 수 없을 때 클라우드 세션에서 첫 응답까지 걸리는 시간 개선
전사(transcript)에 대용량 붙여넣은 이미지나 PDF 읽기 내용이 포함된 세션의 원격 제어 연결 시간 개선
WebSearch 예산이 소진되었을 때 Claude가 받는 공지 변경: 이제 브라우저 또는 컴퓨터 사용을 통해 검색 엔진을 쿼리하지 않도록 지시하는 내용도 추가되었습니다.
설정 env 블록에서 axScreenReader 설정 및 CLAUDE_AX_SCREEN_READER를 사용자, 관리자 또는 --settings 설정에서만 적용되도록 변경 (2.1.305부터)
자체 호스팅 러너: 체크아웃 훅(checkout hooks)이 기본적으로 30분 후에 중지되어 세션 설정에 실패하도록 변경되었습니다. 더 긴 시간이 필요한 경우, --checkout-hook-timeout-min을 높이거나 0으로 설정하십시오.
자체 호스팅 러너: Anthropic 관리형 git용으로 빌드된 인증서 파일이 CLI와 동일하게 신뢰하는 인증서를 필터링하도록 변경되었습니다. 제외된 인증서의 개수가 포함된 [runner:warn] 줄을 제공합니다.
[VSCode] 음성 받아쓰기가 스스로 멈출 때(인식된 음성이 15초 동안 없거나, 2분 제한 도달 시) 마이크 버튼에 공지 추가: 중단 이유와 현재까지의 텍스트가 유지된다는 내용을 표시합니다.
[VSCode] '더 보기'로 확장된 긴 프롬프트가 전체 채팅 패널을 덮는 문제 수정: 이제 고정된 프롬프트는 패널의 40%로 제한되며 스크롤됩니다.
[VSCode] LaTeX 수학 붙여넣기가 리치 텍스트 편집기에서 새로운 목록이나 표로 인식되는 경우, 목록 항목 또는 테이블 셀 일부가 손상되던 문제 수정
[VSCode] NODE_EXTRA_CA_CERTS가 ~/.claude/settings.json에만 설정된 경우 TLS 검사 프록시 뒤에서 받아쓰기가 실패하던 문제 수정: 이제 CLAUDE_CODE_CERT_STORE도 따릅니다.
[VSCode] '다른 곳에 여전히 열려 있음' 알림이 확장 프로그램 재시작 후 남은 Claude 프로세스에도 적용되도록 변경되었습니다. 이 프로세스는 보통 약 10분 내에 자동으로 종료됩니다.
[VSCode] 음성 받아쓰기가 CLI와 동일하게 신뢰하는 인증서를 필터링하도록 변경되었습니다.
[VSCode] 확장 프로그램 자체의 요청도 CLI와 동일하게 신뢰하는 인증서를 필터링하고, 환경 변수 또는 사용자 설정에 지정된 NODE_EXTRA_CA_CERTS 파일을 신뢰하도록 변경되었습니다.
[Cloud sessions] 검색이 진행 중일 때 리포지토리 선택기가 '일치하는 레포지토리가 없습니다'라고 표시되는 문제를 수정했습니다. 이제 결과가 도착할 때까지 '검색 중...'을 표시합니다.
[Cloud sessions] 자체 호스팅 환경에서 '러너를 기다리는 중' 상태가 잘리는 문제를 수정했습니다. 온디맨드 러너의 경우, 마지막 메시지부터 카운트하여 실패한 시도를 보여줍니다.
[Code Review] Code Review에 @claude review stop (또한 off 및 pause) 기능을 추가하여, 풀 리퀘스트에서 @claude review always 구독을 새로운 검토를 시작하지 않고 종료할 수 있게 되었습니다.

AI 자동 생성 콘텐츠

본 콘텐츠는 Claude Code Releases의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기

변경 사항

Claude API 코드를 API 버전 2026-10-21로 이동하기 위해 /claude-api api-version 추가

권한 규칙, 자동 모드(auto mode), 안전 검사(safety check), 훅(hook) 또는 샌드박스(sandbox)가 중지되거나 프롬프트가 제공되거나 반환될 때마다 claude_code.safety_event OpenTelemetry 이벤트를 추가

CLAUDE_CODE_DISABLE_1M_CONTEXT가 설정되고 모델이 opus[1m]과 같이 [1m] 접미사를 가진 별칭인 경우, 모델을 찾을 수 없다는 오류로 요청 실패하는 문제 수정

효과가 없는 곳에서 커스텀 ANTHROPIC_BASE_URL 게이트웨이와 Foundry에서 prompt-caching-scope 베타 헤더가 전송되도록 하는 문제 수정

macOS에서 로그인 키체인이 잠겨 있을 때 MCP 서버가 claude -p에서 "인증 필요(needs authentication)"를 표시하는 문제를 수정했습니다. 이제 그 이유를 표시하며, 잠금 해제 후 다음 실행에서는 새로운 로그인 없이 연결됩니다.

MCP 서버가 연결되는 동안 macOS 또는 Linux 컴퓨터가 절전 모드로 들어갔을 때, MCP 서버가 시간 초과로 보고되고 헤드리스(headless) 실행에서 실패 상태를 유지하는 문제 수정

연결이 도중에 끊길 때 HTTP MCP 도구 호출이 두 번 전송되던 문제를 수정했습니다. 이제 읽기 전용 또는 반복 가능한(idempotent) 도구만 재시도됩니다.

백그라운드 작업이 실행되는 동안 턴(turn)이 간혹 SDK MCP 서버의 최신 도구 없이 시작되던 문제 수정

많은 PDF 페이지, 이미지 또는 기타 대용량 도구 결과를 읽는 턴에서 일부 "Autocompact is thrashing" 오류가 발생하던 문제 수정

세션이 다시 시작된 후 클라우드 세션의 /autocompact가 기본 창으로 돌아가는 문제 수정

클라우드 또는 자체 호스팅 러너(self-hosted runner) 세션이 재시작될 때, /clear로 지워진 대화 내용이 가끔 복구되던 문제 수정

Claude 앱 게이트웨이 세션에서 CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS가 무시되던 문제 수정

OTEL_EXPORTER_OTLP_HEADERS가 설정된 경우, Claude 앱 게이트웨이 뒤의 Claude 데스크톱 세션에서 발생하는 원격 측정(telemetry) 데이터가 거부되던 문제 수정

/permissions 수정: 최근 거부된 항목에 거부된 셸 명령이 표시되지 않던 문제와, 자동 모드(auto mode)의 로컬 분류기가 재시도된 명령을 확인할 때 해당 승인을 무시하던 문제를 해결했습니다. 이제 행을 승인하면 설명 대신 명령 이름이 지정됩니다.

/help 및 / 명령어 메뉴가 /claude-api와 같은 번들링된 스킬에 대해 짧은 설명 대신 모델용 긴 설명을 표시하던 문제를 수정했습니다.

서브 에이전트(subagent) 기록에서 플레이스홀더 토큰 사용과 스트리밍 응답의 빈 중지 이유를 기록하던 문제를 수정했습니다.

Agent SDK의 setModel()을 통해 모델을 전환하고 이를 기반으로 구축된 앱들이 API가 모델 확인에 5초 이상 걸릴 경우 거부되던 문제를 수정했습니다. Claude Code는 이제 최대 15초까지 대기합니다.

연결된 앱(예: 비활성 세션을 보관하는 데스크톱 앱)을 통해 중지된 백그라운드 명령이 Claude에게 사용자에 의해 중지된 것으로 보고되던 문제를 수정했습니다. 이제 알림은 출력 파일 이름을 지정합니다.

Cowork 클라우드 세션에서 WebFetch가 사이트가 4xx 상태를 반환하거나 robots.txt 거부로 응답할 때 도구 오류를 보고하던 문제를 수정했습니다. 이제 로컬 세션과 마찬가지로 정상적인 결과입니다.

직접 구성된 GitHub MCP 서버의 쓰기 도구가 데스크톱 앱의 Code 탭에 아무것도 생성하지 않고 닫힌 양식을 표시하던 문제를 수정했습니다.

Artifact 도구 읽기 실패 시 서버가 재사용된 연결을 닫았을 때 연결 초기화(connection reset) 오류를 보고하던 문제를 수정했습니다.

셀프 호스팅 러너(Self-hosted runner): --use-anthropic-git-proxy를 사용한 세션이 이전 세션에 의해 클론된 .claude/settings.local.json 파일을 커밋하던 문제를 수정했습니다.

셀프 호스팅 러너: 체크아웃 훅(checkout hook) 중에 세션을 보관하거나 재큐(requeue)하거나 러너를 중지할 때, 훅의 프로세스가 계속 실행되고 러너 슬롯이 점유되던 문제를 수정했습니다.

파싱할 수 없는 도구 호출로부터 복구 개선: Claude Code는 이제 턴을 오류로 종료하기 전에 해당 호출을 최대 두 번까지 재시도합니다.

함께 시작되는 포크 서브 에이전트 개선: 각 에이전트에 어떤 실행이 자신만의 것인지 알려주어, 포크들이 서로의 작업을 시작하려고 시도할 가능성이 훨씬 줄었습니다.

브라우저 로그인 개선: 이제 계정 프로필 로딩을 기다릴 필요 없이, 로그인이 완료되는 즉시 성공 페이지가 표시됩니다.

클라우드 및 자체 호스팅 러너 세션의 웹 검색 오류 개선: 403으로 검색이 거부되면서 이유를 제공하는 경우, 일반적인 "인증 오류" 대신 해당 이유가 표시됩니다.

데스크톱 앱의 MCP 서버 중 하나에 연결할 수 없을 때 클라우드 세션에서 첫 응답까지 걸리는 시간 개선

전사(transcript)에 대용량 붙여넣은 이미지나 PDF 읽기 내용이 포함된 세션의 원격 제어 연결 시간 개선

WebSearch 예산이 소진되었을 때 Claude가 받는 공지 변경: 이제 브라우저 또는 컴퓨터 사용을 통해 검색 엔진을 쿼리하지 않도록 지시하는 내용도 추가되었습니다.

설정 env 블록에서 axScreenReader 설정 및 CLAUDE_AX_SCREEN_READER를 사용자, 관리자 또는 --settings 설정에서만 적용되도록 변경 (2.1.305부터)

자체 호스팅 러너: 체크아웃 훅(checkout hooks)이 기본적으로 30분 후에 중지되어 세션 설정에 실패하도록 변경되었습니다. 더 긴 시간이 필요한 경우, --checkout-hook-timeout-min을 높이거나 0으로 설정하십시오.

자체 호스팅 러너: Anthropic 관리형 git용으로 빌드된 인증서 파일이 CLI와 동일하게 신뢰하는 인증서를 필터링하도록 변경되었습니다. 제외된 인증서의 개수가 포함된 [runner:warn] 줄을 제공합니다.

[VSCode] 음성 받아쓰기가 스스로 멈출 때(인식된 음성이 15초 동안 없거나, 2분 제한 도달 시) 마이크 버튼에 공지 추가: 중단 이유와 현재까지의 텍스트가 유지된다는 내용을 표시합니다.

[VSCode] '더 보기'로 확장된 긴 프롬프트가 전체 채팅 패널을 덮는 문제 수정: 이제 고정된 프롬프트는 패널의 40%로 제한되며 스크롤됩니다.

[VSCode] LaTeX 수학 붙여넣기가 리치 텍스트 편집기에서 새로운 목록이나 표로 인식되는 경우, 목록 항목 또는 테이블 셀 일부가 손상되던 문제 수정

[VSCode] NODE_EXTRA_CA_CERTS가 ~/.claude/settings.json에만 설정된 경우 TLS 검사 프록시 뒤에서 받아쓰기가 실패하던 문제 수정: 이제 CLAUDE_CODE_CERT_STORE도 따릅니다.

[VSCode] '다른 곳에 여전히 열려 있음' 알림이 확장 프로그램 재시작 후 남은 Claude 프로세스에도 적용되도록 변경되었습니다. 이 프로세스는 보통 약 10분 내에 자동으로 종료됩니다.

[VSCode] 음성 받아쓰기가 CLI와 동일하게 신뢰하는 인증서를 필터링하도록 변경되었습니다.

[VSCode] 확장 프로그램 자체의 요청도 CLI와 동일하게 신뢰하는 인증서를 필터링하고, 환경 변수 또는 사용자 설정에 지정된 NODE_EXTRA_CA_CERTS 파일을 신뢰하도록 변경되었습니다.

[Cloud sessions] 검색이 진행 중일 때 리포지토리 선택기가 '일치하는 레포지토리가 없습니다'라고 표시되는 문제를 수정했습니다. 이제 결과가 도착할 때까지 '검색 중...'을 표시합니다.

[Cloud sessions] 자체 호스팅 환경에서 '러너를 기다리는 중' 상태가 잘리는 문제를 수정했습니다. 온디맨드 러너의 경우, 마지막 메시지부터 카운트하여 실패한 시도를 보여줍니다.

[Code Review] Code Review에 @claude review stop (또한 off 및 pause) 기능을 추가하여, 풀 리퀘스트에서 @claude review always 구독을 새로운 검토를 시작하지 않고 종료할 수 있게 되었습니다.

## 변경 사항 - Claude API 코드를 API 버전 `2026-10-21`로 이동하기 위해 `/claude-api api-versio

요약

핵심 포인트

변경 사항

댓글

변경 사항