## 변경 사항 - 세션에서 Claude Code가 작성하는 모드(mods)를 켜도록 요청할 때 사용자의 답변 기록이 추가되었습니다
요약
이번 업데이트는 Claude Code의 안정성과 개발자 경험을 대폭 개선한 변경 사항 목록입니다. 세션 관리, 인증(auth), 그리고 다양한 CLI 명령어 사용 시 발생하던 수많은 버그와 오류가 수정되었습니다. 특히 AWS 역할 지정 및 모드 옵션(`effort`) 추가 등 핵심 기능을 강화하여 개발 워크플로우를 지원합니다.
핵심 포인트
- Claude Code 모드 요청 시 사용자 답변 기록이 추가되어 컨텍스트가 개선됨.
- AWS 계정 역할을 위한 `assume_role` 기능이 추가되어 비용 할당 및 권한 관리가 용이해짐.
- 모드의 `effort` 옵션으로 낮은 수준의 빠른 보조 작업(side job) 실행이 가능함.
- 로그인 만료일(`loginExpiresAt`) 정보가 CLI 명령어에 반영되어 인증 상태 확인이 쉬워짐.
- 메모리 증가나 권한 요청 오류 등 다양한 환경에서의 세션 안정성이 크게 향상됨.
변경 사항
-
세션에서 Claude Code가 작성하는 모드(mods)를 켜도록 요청할 때 사용자의 답변 기록이 추가되었습니다.
-
AWS 계정의 역할 지정 및 개발자별 비용 할당을 위해, Claude apps gateway의
mantle업스트림에assume_role기능이 추가되었습니다. -
모드의
$.model.fork에effort옵션이 추가되어, 세션이 어떤 노력을 사용하든 간에 낮은(low) 수준으로 빠른 보조 작업(side job)을 실행할 수 있으며, 결과가 전송된 노력을 보고합니다. -
저장된 claude.ai 로그인 종료 날짜가
claude auth status에 (loginExpiresAt) 및claude -pJSON 결과물에 (credential_expires_at) 추가되었습니다. -
저장된 claude.ai 로그인 종료 10일 전부터
claude -p텍스트 출력에 한 줄의 stderr 경고가 추가되었습니다. -
잘못된 도구 호출(malformed tool call) 재시도가 끝난 후,
--continue옵션이 때때로 이전 대화를 손실하던 문제(2.1.314 버전의 회귀 현상)가 수정되었습니다. -
메모리가 증가함에 따라 많은 Bash 명령을 실행하는 macOS 세션에서 멈추던 문제가 수정되었습니다.
-
메시지를 보낸 직후 키를 입력하거나 느린 프롬프트가 나타나기 전에 발생하는 권한 요청(permission prompts) 응답 오류가 수정되었습니다.
-
공유 네트워크 홈 디렉터리에서 구성 파일 업데이트가 불가능할 때,
/logout,claude auth logout, 및claude mcp remove가 성공을 보고하고, 신뢰(trust), 동의(consent) 또는 MCP 설정 변경 사항이 아무런 경고 없이 무시되던 문제가 수정되었습니다. -
다른 터미널이나 호스트가 동일한 계정과 조직에 다시 로그인할 때, 작업(jobs)이
Not logged in상태로 종료되던 문제가 수정되었습니다. -
claude mcp add및remove가 잠금(lock) 없이 설정을 작성하던 문제: 이제는 잠금을 기다리거나 1로 종료됩니다. (다른 작업의 저장으로도 서버를 대체할 수 있습니다.) -
느린 토큰 새로고침이 저장되기 전에
claude plugin명령이 종료되어 다음 실행 시 로그아웃될 수 있던 문제가 수정되었습니다. -
claude plugin validate가claude plugin marketplace add에서 거부하는 사용자 정의 이름의 마켓플레이스 파일을 전달하던 문제가 수정되었습니다. -
시작할 때마다 버전 프로브가 재확인되어 종료되는 stdio MCP 서버를 수정했습니다. 자체적인 이유로 3초 이내에 다운되는 서버도 7일 동안 레거시 핸드셰이크(legacy handshake)에 고정됩니다.
-
동일한 장치에서 다른 로그인 세션이 저장했던
allowedProviders목록으로 인해 시작 시 세션이 거부되던 문제를 수정했습니다. -
유휴 압축(idle compaction) 기능이 요약본이 아닌 답변으로 대화를 대체하던 문제를 수정했습니다.
-
백그라운드 서브 에이전트가 실행되는 동안 "현재 사용량 크레딧을 사용 중입니다(Now using usage credits)" 알림이 약 30초마다 다시 나타나던 문제를 수정했습니다.
-
실패하거나 오직 Claude만 호출할 수 있는 사용자 지정 슬래시 명령어(custom slash commands)가
claude -p및 SDK 세션에서 아무것도 출력하지 않던 문제를 수정했습니다. -
모듈이
turn.step을 후킹(hooked)하는 동안 API 오류로 답변이 중단되었음에도 불구하고,claude -p및 에이전트 SDK 세션에서 성공했다고 보고하던 문제를 수정했습니다. -
모델 변경 직후 전송된 메시지가 헤드리스(headless) 세션에서 'Stop' 이후에도 계속 실행되던 문제를 수정했습니다. 이제 'Stop'은 큐에 대기된 메시지처럼 이를 취소하거나 중단합니다.
-
유휴 비대화형(non-interactive) 세션이 종료될 때 삭제된 세션 기록(transcript)이 마지막 프롬프트와 함께 재 생성되던 문제를 수정했습니다.
-
업데이트 또는 버전 정리로 인해 실행 중인 프로세스의 바이너리가 제거된 후,
claude remote-control호스트, 백그라운드 데몬(daemon), 자체 호스팅 러너가 새 세션을 시작하지 못하던(spawn ENOENT) 문제를 수정했습니다. -
다른 사용자(예:
sudo claude로 남겨진 프로세스)가 소유한 실행 중인 Claude Code 프로세스가 버전 정리 과정에서 죽은 것으로 간주되어 바이너리가 삭제될 수 있던 문제를 수정했습니다. -
연결 실패 후에도
/remote-control이 세션을 사용 가능하다고 표시하던 문제를 수정했습니다. -
요청이 404 오류로 실패했음에도 불구하고
/design revoke가 성공했다고 보고하던 문제를 수정했습니다. -
자체 호스팅 러너 또는 클라우드 세션 재시작 후 승인된 셸 명령어(shell command)가 요청된 폴더가 아닌 세션 시작 폴더에서 실행되던 문제를 수정했습니다. 해당 폴더에 진입할 수 없으면 실행되지 않습니다.
-
클라우드 세션 재시작 후 승인된 커넥터 도구(connector tool)가 사용 불가능해졌을 때 Claude에게 알리지 않던 문제를 수정했습니다.
다음과 같은 문제들을 수정했습니다:
- 서비스가 몇 분 동안 업로드를 거부할 때, 대화 중간에 중단되던 클라우드 세션 문제를 수정했습니다.
- 일부 클라우드 세션에서
Setup훅이CLAUDE_ENV_FILE에 작성하는 변수가 Bash 도구에 전달되지 않던 문제를 수정했습니다. - 응답이 도구 호출에서 잘리거나 거부된 이미지 또는 문서가 제거된 후에도 클라우드 세션의 턴(turn)이 계속 실행되는 동안 iPhone 앱에 완료된 것으로 표시되던 문제를 수정했습니다.
- 재시작된 세션에서 뒤따라 대기 중인 새 메시지보다 먼저 API 오류로 실패했던 메시지를 다시 전송하던 문제를 수정했습니다.
- 재시작된 세션에서 Claude가 대용량 이미지를 읽거나 도구 호출을 재시도한 직후에 재시작이 발생할 경우, 중단되었던 턴(turn)을 손실하던 문제를 수정했습니다.
NODE_EXTRA_CA_CERTS파일이 비어 있거나, PEM 형식이 아니거나, 손상된 인증서로 시작할 경우 모든 연결이 실패하던 문제를 수정했습니다. 이제 읽을 수 있는 인증서를 사용하며, stderr에 경고 메시지를 표시합니다.- 사용량 제한 이후 재개될 때 완료된 에이전트(agent)가 워크플로우에서 다시 실행되던 문제를 수정했습니다.
- 클라우드 세션의
/mcp가 모델이 사용할 수 없는 도구까지 계산하던 문제를 수정했습니다. 이제 서버의 행은 사용 가능한 도구의 개수를 표시합니다. - Claude가
PushNotification호출에서 상태 필드를 누락했을 때 중복 알림이 발생하던 문제를 수정했습니다. - 이미지 20개 이상을 포함하는 요청에서 너무 큰 이미지를 처리할 때 항상 제한이 2000px라고 표시되던 오류를 수정했습니다. 이제 API의 실제 제한을 표시합니다.
- 대화 상자가 열려 있는 동안 백그라운드 셸(shell) 세부 정보의 실행 시간(runtime)이 업데이트되지 않던 문제를 수정했습니다.
- 모드의
turn.step훅이 헤드리스(headless) 실행에서 중단된 응답을 성공으로 처리하던 문제를 수정했습니다. - 보존 정리(retention cleanup)가 백업 파일인
~/.claude.json없이 오직claude -p만 실행되는 홈을 남기던 문제를 수정했습니다. 이제 마지막으로 정상 작동했던 파일을 삭제하기 전에 새로운 백업을 수행합니다. - 네트워크 홈 디렉터리가 데이터 공간이 남아있지 않음에도 불구하고 새 파일을 계속 받으면서 저장된 로그인 정보가 빈 파일로 대체되던 문제를 수정했습니다.
- 토큰이 허용된 조직에 속함에도 불구하고,
forceLoginOrgUUID가 설정된 장치에서 시작 시setup-token의 토큰이 거부되던 문제를 수정했습니다.
-
유효하지 않은 JSON인
~/.claude.json파일을 기본값으로 대체하는 비대화형(non-interactive) 실행 문제를 수정했습니다. 이제 시작 시 실패하며, 파일 복원 방법을 안내하고 기존 파일을 그대로 유지합니다 (#87551) -
백업 파일이 없는 빈
~/.claude.json이 손상되었다고 보고되는 문제를 수정했습니다. 이제 Claude Code는 해당 파일이 누락되었을 때와 동일하게 시작합니다. -
손상되거나 누락된
~/.claude.json에 대해 빈 백업 또는 잘린 백업을 지정하거나 읽기 전용 파일에서 실패하는 복원 명령어 출력을 수정했습니다. -
저장된 claude.ai 로그인이 시간 제한에 도달하여 발생하는 로그인 실패 문제를 수정했습니다. 이제 해당 사실을 알리고,
claude -p명령어 내에서claude auth login과claude setup-token을 안내합니다. -
공유 네트워크 홈 디렉터리에서
~/.claude.json, 설정 파일 및 저장된 로그인이 백업되는 방식을 개선했습니다. 이제 삭제되거나 일시적으로 비워지거나 거의 빈 또는 이전 버전의 사본으로 대체되는 경우가 줄어듭니다. -
네트워크 파일 시스템에서의 세션이 구성 파일이 잘못 누락되었다고 보고될 때 다시 확인하도록 개선되어, MCP 서버 및 신뢰 폴더 없이 시작되는 경우가 줄었습니다.
-
MCP 도구 오류를 개선했습니다. 이제 도구가 로드되기 전에 호출된 경우 해당 도구의 입력 스키마(input schema)를 반환합니다.
-
Bash 도구가 macOS 내장
/bin/bash를 실행할 때 Git 커밋 및 풀 리퀘스트(pull request) 생성의 신뢰성을 개선했습니다. -
사용량 제한 메뉴에서 "관리자에게 더 많은 사용량을 요청하세요(Ask your admin for more usage)" 기능을 한 단계로 요청을 보낼 수 있도록 개선했습니다.
-
일시 중지 또는 절전 모드 후에 원격 세션이 재연결되는 속도를 개선했습니다.
-
터미널에서만 작동하는 "2를 누르세요(press 2)" 대신 "다시 시도하세요(try again)"라는 메시지를 표시하는 알림창(toast)을 개선했습니다.
-
자동 업데이트 신뢰성을 개선했습니다. 릴리스를 확인하는 동안 일시적인 네트워크 오류가 발생할 경우, 다음 확인을 기다리는 대신 즉시 재시도됩니다.
-
변경된 내용이 없을 때 매번
~/.claude.json을 다시 쓰는 것을 방지하도록 비대화형 실행(claude -p, SDK 앱)을 개선했습니다. -
Claude Code가 IDE 터미널에서 시작될 때 더 이상 IDE 확장을 설치하거나 업데이트하지 않도록 변경되었습니다. 외부 터미널 또는 에디터의 확장 프로그램 보기에서 /ide를 사용하십시오.
-
"메시지에 플래그가 지정될 때 모델 전환 (Switch models when a message is flagged)"이 "매번 묻기 (Ask each time)"로 설정된 경우, 서브 에이전트(subagents)가 모델을 전환하는 대신 중지하도록 변경되었습니다.
-
모든 제공업체(providers)에서 백그라운드 서브 에이전트가 실행되는 동안 프롬프트 캐시(prompt cache)가 만료되지 않도록 3분 후에 셸 명령어(shell command)를 백그라운드로 이동하도록 변경되었습니다.
-
Bedrock, Vertex, Foundry 또는 원격 측정(telemetry)이 꺼진 경우 서브 에이전트 진행 요약 정보가 변경되었습니다: 콜드 프롬프트 캐시(cold prompt cache)의 경우, 이제 최대 5분까지 서브 에이전트의 보류 응답을 기다릴 수 있습니다.
-
모드(mod)가
prompt.submit시 첨부하는 내용이 시스템 메시지(system message)로 나가는 대신 사용자 턴(user's turn)에 머무르도록 변경되었습니다. -
deniedMcpServersURL 항목이 업스트림 URL(upstream URL)이 일치하는 Anthropic 제공 서버도 차단하도록 변경되었으며, 클라우드 세션 및 자체 호스팅 러너(self-hosted runners)에서 해당 세션에 커넥터 자체의 URL이 부여되는 경우에도 동일하게 적용됩니다. 그렇지 않은 경우에는 이름으로 커넥터를 거부합니다. -
/permissions규칙 상세 정보, 내장 규칙 및 삭제 확인 보기에서 표준 대화 상자(standard dialog)를 사용하도록 변경되었습니다. 여기서 Ctrl+C를 두 번 누르면 종료하는 대신 뒤로 가거나 취소됩니다. -
/claude-api managed-agents-onboard를 변경하여 새 에이전트의 내장 도구와 퀵스타트 템플릿의 MCP 도구에 기본적으로 Claude Console과 일치하는 자동 권한 정책("위험한 동작 판단 (Judge risky actions)")을 부여합니다. 제외하려면 "묻지 않고 실행하기 (run without asking)"라고 말하십시오. -
2.1.286 또는 그 이전 버전에서 시작된 대화를 재개할 때 모델의 이전 사고 과정을 유지하던 2.1.288 수정 사항이 제거되었습니다. 이제 해당 사고 과정은 삭제될 수 있습니다.
-
게이트웨이(Gateway): 페더레이션(
external_account) 자격 증명 파일의 Google 액세스 토큰이 만료될 예정일 때 로그 경고가 추가되었습니다. -
게이트웨이(Gateway):
listen.trusted_proxies에 대한 로그 힌트가 개선되었습니다: 이제 연결 주소를 X-Forwarded-For 헤더 자체에 추가하는 프록시만 나열하도록 안내합니다. -
Gateway: Amazon Bedrock에서 AWS CountTokens가 실패할 때 경고 메시지를 개선했습니다. 501 오류 이후에 카운트하는 것은 게이트웨이가 아니라 Claude Code이며, AWS가 액세스를 거부할 때만 IAM을 가리킨다고 명시합니다.
-
Self-hosted runner: 오케스트레이터(orchestrator)의 spawn-runner 훅 환경에
CLAUDE_RUNNER_SPAWN_REASON을 추가했습니다. Anthropic이 요청을 보낸 이유(예:runner_lost,resumed)를 나타내며, 전송된 이유가 없을 때는 설정되지 않습니다. -
Self-hosted runner:
--release-idle-session-min이 값이 없는 마지막 인자일 때(여전히 무시됨) 또는 공백만 값으로 지정되었을 때(여전히0으로 읽힘) 시작 경고를 추가했습니다. -
Self-hosted runner: 오케스트레이터의 로그 라인을 변경했습니다:
ok session=…이 이제 stdout에서 모든 로그 레벨로 출력되며(jti=…뒤에reason=…포함),nack session=…은 필드를retryable=…뒤에reason=…으로 끝냅니다.retryable=true:또는retryable=false:와 일치하는 스크립트를 업데이트해야 합니다. -
Remote Control: 세션의 작업 폴더가 누락되었을 때 표시되던 오해의 소지가 있는 "spawn error: ENOENT"를 수정했습니다. 이제 오류 메시지에 해당 폴더 이름이 명시됩니다.
-
Remote Control: 앱이 제목을 설정하지 않은 경우 터미널 포크의 포크가 생성될 때 사용되는 제목을 개선했습니다: "Name (fork 2)".
-
[VSCode] 조직 설정에서 로그인이 새로운 Claude Code 프로세스를 매분 백그라운드에서 시작하는 것을 거부하여 발생하던 창 문제를 수정했습니다.
-
[VSCode] 채팅 패널의 오류 배너에 있는 긴 단어가 닫기 버튼을 화면 밖으로 밀어내는 문제를 수정했습니다.
-
[VSCode] 로그인 화면을 개선하여 Claude Code의 로그인 상태 확인이 실패했을 때 무엇이 출력되었는지 보여주도록 했습니다.
-
[클라우드 세션] '저장소 없음(No repository)' 옵션을 추가했습니다. Anthropic 호스팅 환경의 클라우드 세션이 이제 저장소를 선택하지 않고 시작할 수 있습니다.
-
[클라우드 세션] 클라우드 세션에 일반적인 Chrome 이름을 추가하여 Playwright 외의 도구들도
google-chrome및CHROME_PATH를 통해 내장된 Chromium을 찾을 수 있게 했습니다. -
[클라우드 세션] 클라우드 세션 환경이 삭제되었을 때 표시되는 카드에 '새 세션(New session)' 버튼을 추가했으며, 이 경우 메시지 상자는 숨겨집니다.
-
[Cloud sessions] 클라우드 세션에서 GitHub Actions 로그 읽기 기능 수정:
gh run view --log및gh api로그 요청이 대부분의 환경에서 도달할 수 없는 리디렉션 대신 로그를 가져옵니다. -
[Cloud sessions] 클라우드 및 원격 제어 세션에서 대부분의 PR 생성 실패 메시지 개선: 이제 '다시 시도'라고 표시하는 대신 이유 또는 GitHub 링크를 제공합니다.
-
[Cloud sessions] 커넥터 검색 결과가 검색 범위가 커넥터 디렉토리의 일부임을 Claude에게 알리도록 변경했습니다.
-
[Remote Control] 환경 메뉴의 원격 제어 행에서 하나의 저장소에 대한 나란히 체크아웃이 동일하게 보이는 문제를 수정했습니다. 이제 각 항목은 자체 폴더 이름을 표시합니다.
-
[Claude Tag] Claude Tag 관리 설정에서 키보드 포커스와 스크린 리더 안내를 수정했습니다. 연결 양식(connect form)에서 Escape를 누르는 것이 더 이상 추가 대화 상자를 닫지 않게 되었습니다.
-
[Code Review] 서버 또는 네트워크 오류 발생 후 Code Review 분석 페이지가 한 번 재시도하도록 개선되었으며, 빈 카드 대신 '다시 시도' 배너를 표시합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 RSS: GitHub anthropics/claude-code releases의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기