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 -p JSON 결과(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 시점에 첨부하는 데이터가 시스템 메시지로 전송되지 않고 사용자 턴에 유지되도록 변경함
  • deniedMcpServers URL 항목이 업스트림 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 대화상자까지 함께 닫히지 않음)