Claude Code 2.1.318 릴리스 노트
📌 이 글은 Claude Code 2.1.318 릴리스 노트를 한국어로 번역한 것입니다.
✨ 새 기능
- Claude Code가 세션에서 직접 작성한 mod 활성화를 요청할 때 사용자의 응답 기록을 저장하도록 추가함
- 다른 AWS 계정의 역할 사용 및 개발자별 AWS 비용 할당을 위해 Claude 앱 게이트웨이의 Mantle 업스트림에
assume_role옵션을 추가함 - 세션의 노력 수준과 관계없이 빠른 보조 작업을 낮은 노력 수준으로 실행할 수 있도록 mod의
$.model.fork에effort옵션을 추가함 (결과에 전송된 노력 수준 보고) - 저장된 claude.ai 로그인 만료일을
claude auth status(loginExpiresAt) 및claude -pJSON 결과(credential_expires_at)에 추가함 - 저장된 claude.ai 로그인이 만료되기 10일 전부터
claude -p텍스트 출력의 stderr에 한 줄 경고 메시지를 표시하도록 추가함 - Gateway: 페더레이션(
external_account) 자격 증명 파일의 Google 액세스 토큰이 만료 임박했을 때 로그 경고를 추가함 - Self-hosted runner: 오케스트레이터의
spawn-runner훅 환경 변수로 Anthropic이 요청을 전송한 이유(예:runner_lost,resumed)를 나타내는CLAUDE_RUNNER_SPAWN_REASON을 추가함 (전송되지 않은 경우 설정 해제됨) - Self-hosted runner:
--release-idle-session-min이 값 없이 마지막 인수로 전달되거나(무시됨) 공백만 있는 경우(0으로 처리됨) 시작 시 경고를 출력하도록 추가함 - Cloud sessions: Anthropic 호스팅 환경의 클라우드 세션에서 저장소를 선택하지 않고도 시작할 수 있는 "No repository" 옵션을 추가함
- Cloud sessions: Playwright 외의 도구도
google-chrome및CHROME_PATH를 통해 기본 탑재된 Chromium을 찾을 수 있도록 일반적인 Chrome 바이너리 명칭을 추가함 - Cloud sessions: 클라우드 세션의 환경이 삭제되어 메시지 입력창이 숨겨졌을 때 표시되는 카드에 "New session" 버튼을 추가함
🔧 개선 및 변경 사항
- 공유 네트워크 홈 디렉터리에서
~/.claude.json, 설정 파일, 저장된 로그인 정보의 저장 안정성을 개선하여 삭제되거나 일시적으로 비워지거나 오래된 복사본으로 대체되는 현상을 줄임 - 네트워크 파일 시스템 세션에서 설정 파일이 누락된 것으로 잘못 보고될 때 다시 확인하도록 개선하여 MCP 서버나 신뢰할 수 있는 폴더 설정 없이 시작되는 문제를 줄임
- MCP 도구 로드 전에 호출이 발생할 경우 입력 스키마를 반환하도록 MCP 도구 오류 처리를 개선함
- Bash 도구가 macOS 기본 내장
/bin/bash를 실행할 때 git 커밋 및 풀 리퀘스트 생성 안정성을 개선함 - 사용량 제한 메뉴의 "Ask your admin for more usage"를 클릭 한 번으로 요청할 수 있도록 개선함
- 일시 중지 또는 절전 모드 후 원격 세션이 다시 연결되는 속도를 개선함
- 터미널에서만 작동하는 "press 2" 대신 "try again"으로 안내하도록 알림(You should know toast) 문구를 개선함
- 릴리스 확인 중 일시적인 네트워크 오류 발생 시 다음 확인 주기까지 기다리지 않고 즉시 재시도하도록 자동 업데이트 안정성을 개선함
- 변경 사항이 없을 경우
~/.claude.json을 매번 다시 쓰지 않도록 비대화형 실행(claude -p, SDK 앱) 동작을 개선함 - IDE 터미널에서 실행 시 IDE 확장 프로그램을 더 이상 자동으로 설치하거나 업데이트하지 않도록 변경함 (외부 터미널에서
/ide를 실행하거나 에디터 확장 프로그램 뷰 사용 필요) - "Switch models when a message is flagged" 설정이 "Ask each time"일 때 모델을 전환하는 대신 하위 에이전트(subagent)를 중지하도록 변경함
- 셸 명령 실행 중 프롬프트 캐시가 만료되지 않도록 모든 제공자에서 백그라운드 하위 에이전트가 3분 후 셸 명령을 백그라운드로 이동하도록 변경함
- Bedrock, Vertex, Foundry 환경 또는 텔레메트리가 비활성화된 환경에서 하위 에이전트 진행 요약 동작을 변경함 (콜드 프롬프트 캐시 상태에서 대기 중인 응답을 최대 5분까지 대기 가능)
- mod가
prompt.submit시점에 첨부하는 데이터가 시스템 메시지로 전송되지 않고 사용자 턴에 유지되도록 변경함 deniedMcpServersURL 항목이 업스트림 URL이 일치하는 Anthropic 제공 서버 및 커넥터 자체 URL이 세션에 제공되는 클라우드 세션/셀프 호스팅 러너의 커넥터도 차단하도록 변경함 (그 외에는 이름으로 커넥터 거부)/permissions규칙 세부 정보, 기본 제공 규칙 및 삭제 확인 화면을 표준 대화상자로 변경함 (해당 화면에서 Ctrl+C를 두 번 누르면 종료되지 않고 뒤로 이동하거나 취소됨)- Claude Console과 일치하도록
/claude-api managed-agents-onboard가 새 에이전트의 기본 제공 도구와 퀵스타트 템플릿의 MCP 도구에 기본적으로 자동 권한 정책("Judge risky actions")을 부여하도록 변경함 (제외하려면 "run without asking" 지정) - 2.1.286 이하 버전에서 시작된 대화를 재개할 때 모델의 이전 사고(thinking) 과정을 유지하던 2.1.288의 임시 패치를 제거함 (해당 사고 과정은 이제 삭제될 수 있음)
- Gateway:
listen.trusted_proxies관련 로그 힌트를 개선하여 연결 주소를X-Forwarded-For에 직접 추가하는 프록시만 나열하도록 안내 문구를 수정함 - Gateway: Amazon Bedrock에서 AWS
CountTokens실패 시 경고를 개선함 (501 오류 후 게이트웨이가 아닌 Claude Code가 직접 토큰을 계산함을 명시하고, AWS에서 액세스를 거부할 때만 IAM을 안내함) - Self-hosted runner: 오케스트레이터의 로그 형식을 변경함 (
ok session=…이 모든 로그 레벨에서 stdout으로 출력되며jti=…뒤에reason=…이 추가됨,nack session=…의 필드는retryable=…뒤에reason=…으로 끝남.retryable=true:또는retryable=false:를 매칭하는 스크립트 수정 필요) - Remote Control: 앱에서 타이틀을 지정하지 않을 때 터미널 포크의 포크 생성 타이틀을 "Name (fork 2)" 형식으로 표시하도록 개선함
- VSCode: 로그인 상태 확인에 실패했을 때 Claude Code가 출력한 내용을 로그인 화면에 표시하도록 개선함
- Cloud sessions: 클라우드 및 Remote Control 세션에서 PR 생성 실패 시 "Try again" 대신 구체적인 이유나 GitHub 링크를 제공하도록 오류 메시지를 개선함
- Cloud sessions: 커넥터 검색이 전체 디렉터리의 일부만 포함함을 모델에 알리도록 커넥터 검색 결과를 변경함
- Code Review: 서버나 네트워크 오류 발생 시 한 번 재시도한 후 빈 카드 대신 "Try again" 배너를 표시하도록 Code Review 분석 페이지를 개선함
🐛 버그 수정
- 형식에 맞지 않는 도구 호출의 재시도가 모두 소진된 후
--continue사용 시 이전 대화 내용이 손실되던 문제를 수정함 (2.1.314의 회귀 버그) - 실행 중인 Bash 명령이 많은 macOS 세션에서 메모리가 증가하면서 응답이 멈추던 문제를 수정함
- 메시지 전송 직후 입력한 키나 느린 프롬프트가 나타나기 전에 입력한 키로 인해 권한 확인 프롬프트가 응답 처리되던 문제를 수정함
- 공유 네트워크 홈 디렉터리에서 설정 파일을 업데이트할 수 없을 때
/logout,claude auth logout,claude mcp remove가 성공으로 보고되고 신뢰·동의·MCP 설정 변경 사항이 안내 없이 무시되던 문제를 수정함 - 동일한 홈 디렉터리에서 다른 터미널이나 호스트가 동일한 계정 및 조직으로 다시 로그인할 때 작업이
Not logged in오류와 함께 종료되던 문제를 수정함 claude mcp add및claude mcp remove가 파일 락 없이 설정을 작성하던 문제를 수정함 (이제 락을 대기하거나 exit 1로 종료됨)- 토큰 갱신 작업이 저장되기 전에
claude plugin명령어가 종료되어 다음 실행 시 로그아웃될 수 있던 문제를 수정함 claude plugin marketplace add가 거부하는 사용자 지정 이름의 마켓플레이스 파일을claude plugin validate가 통과시키던 문제를 수정함- 버전 확인(probe) 시 종료되는 stdio MCP 서버가 시작될 때마다 다시 확인되던 문제를 수정함 (자체 원인으로 3초 이내에 종료되는 서버는 레거시 핸드셰이크로 7일간 고정됨)
- 동일한 컴퓨터의 다른 로그인이 저장한
allowedProviders목록으로 인해 시작 시 세션이 거부되던 문제를 수정함 - 유휴 압축(idle compaction) 시 요약이 아닌 일반 응답으로 대화가 대체되던 문제를 수정함
- 백그라운드 하위 에이전트 실행 중 "Now using usage credits" 안내 문구가 약 30초마다 다시 나타나던 문제를 수정함
claude -p및 SDK 세션에서 실패한 커스텀 슬래시 명령어나 Claude만 호출할 수 있는 명령어가 아무것도 출력하지 않던 문제를 수정함- mod가
turn.step을 후킹한 상태에서 API 오류로 응답이 중단되었을 때claude -p및 Agent SDK 세션이 성공으로 보고되던 문제를 수정함 - 헤드리스 세션에서 모델 변경 직후 전송된 메시지가 Stop 이후에도 계속 실행되던 문제를 수정함 (이제 대기열 메시지와 마찬가지로 Stop 시 취소되거나 중지됨)
- 유휴 상태의 비대화형 세션이 종료될 때 삭제된 세션 트랜스크립트가 마지막 프롬프트와 함께 다시 생성되던 문제를 수정함
- 업데이트나 버전 정리로 인해 실행 중인 프로세스의 바이너리가 제거된 후
claude remote-control호스트, 백그라운드 데몬, 셀프 호스팅 러너가 새 세션을 시작하지 못하던 문제(spawn ENOENT)를 수정함 - 다른 사용자가 소유한 실행 중인 Claude Code 프로세스(예:
sudo claude로 남겨진 프로세스)를 버전 정리 시 비활성 상태로 간주하여 바이너리를 삭제하던 문제를 수정함 - 연결 실패 후에도
/remote-control에 세션이 사용 가능한 상태로 표시되던 문제를 수정함 - 요청이 404로 실패했을 때
/design revoke가 성공으로 보고되던 문제를 수정함 - 셀프 호스팅 러너 또는 클라우드 세션 재시작 후 승인된 셸 명령이 요청된 폴더가 아닌 세션의 시작 폴더에서 실행되던 문제를 수정함 (해당 폴더로 진입할 수 없는 경우 실행되지 않음)
- 클라우드 세션 재시작 후 승인된 커넥터 도구를 사용할 수 없을 때 모델에 해당 사실이 전달되지 않던 문제를 수정함
- 서비스에서 몇 분 동안 업로드를 거부할 때 클라우드 세션이 턴 중간에 중지되던 문제를 수정함
- 일부 클라우드 세션에서 Setup 훅이
CLAUDE_ENV_FILE에 작성한 환경 변수가 Bash 도구에 전달되지 않던 문제를 수정함 - 도구 호출 시 응답이 끊기거나 거부된 이미지/문서가 제거된 후, 세션이 계속 실행 중임에도 iPhone 앱에서 클라우드 세션의 턴이 완료된 것으로 표시되던 문제를 수정함
- 재시작된 세션에서 뒤에 대기 중인 새 메시지보다 API 오류로 실패했던 메시지를 먼저 다시 전송하던 문제를 수정함
- 모델이 대용량 이미지를 읽거나 도구 호출을 재시도한 직후 세션이 재시작될 때 중단된 턴의 내용이 유실되던 문제를 수정함
NODE_EXTRA_CA_CERTS파일이 비어 있거나 PEM 형식이 아니거나 손상된 인증서로 시작할 때 모든 연결이 실패하던 문제를 수정함 (이제 읽을 수 있는 인증서를 사용하고 stderr에 경고를 출력함)- 사용량 제한 이후 재개될 때 워크플로가 이미 완료된 에이전트를 다시 실행하던 문제를 수정함
- 클라우드 세션의
/mcp에서 모델이 사용할 수 없는 도구까지 계산하던 문제를 수정함 (이제 서버 행에 사용 가능한 도구 수가 표시됨) - 모델이
PushNotification호출에서 상태 필드를 누락했을 때 중복 알림이 생성되던 문제를 수정함 - 이미지가 20개 이상 포함된 요청에서 용량 초과 오류 발생 시 제한값이 항상 2000px로 표시되던 문제를 수정함 (이제 API의 실제 제한값이 표시됨)
- 백그라운드 셸 세부 정보 대화상자가 열려 있는 동안 실행 시간이 업데이트되지 않던 문제를 수정함
- 헤드리스 실행에서 mod의
turn.step훅으로 인해 중지된 응답이 성공으로 완료 처리되던 문제를 수정함 claude -p만 실행하는 환경에서 보존 정리(retention cleanup) 후~/.claude.json백업이 남지 않던 문제를 수정함 (마지막 유효 백업을 삭제하기 전에 새 백업을 생성함)- 데이터 저장 공간이 부족하지만 새 파일 생성은 가능한 네트워크 홈 디렉터리에서 저장된 로그인 정보가 빈 파일로 대체되던 문제를 수정함
forceLoginOrgUUID가 설정된 머신에서 토큰이 허용된 조직에 속해 있음에도setup-token으로 생성된 토큰이 시작 시 거부되던 문제를 수정함- 유효하지 않은 JSON 형식의
~/.claude.json파일이 비대화형 실행 시 기본값으로 덮어써지던 문제를 수정함 (이제 파일 변경 없이 시작이 실패하며 복구 방법이 안내됨) - 백업이 없는 빈
~/.claude.json파일이 손상된 것으로 보고되던 문제를 수정함 (파일이 누락되었을 때와 동일하게 시작됨) - 손상되거나 누락된
~/.claude.json에 대해 출력되는 복구 명령어가 비어 있거나 잘린 백업을 가리키거나 읽기 전용 파일에서 실패하던 문제를 수정함 - 저장된 claude.ai 로그인이 유효 기간에 도달했을 때 로그인 실패 원인을 명확히 안내하지 않던 문제를 수정함 (원인을 명시하고
claude -p에서는claude auth login및claude setup-token명령어를 안내함) - Remote Control: 세션의 작업 폴더가 누락되었을 때 잘못된 "spawn error: ENOENT"가 출력되던 문제를 수정함 (이제 오류 메시지에 해당 폴더명이 표시됨)
- VSCode: 조직 설정에 의해 로그인이 거부된 창에서 백그라운드로 매분마다 새 Claude Code 프로세스를 시작하던 문제를 수정함
- VSCode: 채팅 패널의 오류 배너에 긴 단어가 포함될 경우 닫기 버튼이 화면 밖으로 밀려나던 문제를 수정함
- Cloud sessions: 클라우드 세션에서 GitHub Actions 로그를 읽을 때
gh run view --log및gh api로그 요청이 도달할 수 없는 리다이렉트 대신 정상적으로 로그를 가져오도록 수정함 - Remote Control: 환경 메뉴의 Remote Control 행에서 동일한 저장소를 나란히 체크아웃했을 때 구분이 불가능하던 문제를 수정함 (이제 각 행에 고유 폴더명이 표시됨)
- Claude Tag: Claude Tag 관리자 설정의 키보드 포커스 및 스크린 리더 안내 동작을 수정함 (연결 폼에서 Escape를 눌러도 Add 대화상자까지 함께 닫히지 않음)