Claude Code v2.1.318 — 로그인 만료가 보이고, 설정 파일에 잠금이 달린다
v2.1.318은 "언제 끝나는가"를 정면으로 다룬 릴리스입니다. claude auth status에 로그인 만료일(loginExpiresAt) 이 표시되고, claude -p JSON 결과에도 credential_expires_at이 담기며, 만료 10일 전부터는 stderr에 한 줄 경고가 뜹니다.
한마디로 말하면, 인증 수명의 투명화와 — 여러 터미널·공유 홈이 얽힌 환경에서 설정 파일을 둘 이상이 동시에 쓰면서 생기던 사고들을 잡은 신뢰성 정리입니다.
로그인 만료의 투명화 — 예고 없는 로그아웃의 끝
지금까지 자격 증명은 만료가 다가와도 조용했습니다. 사용자는 어느 날 갑자기 "Not logged in"을 만났죠. 이번엔 만료일이 상태 명령과 JSON 출력으로 공개되고, claude -p로 돌리는 자동화는 만료 10일 전부터 stderr 한 줄로 예고를 받습니다. 307에서 고쳤던 "느린 토큰 갱신 저장 전에 종료" 문제가 claude plugin 명령에도 확장 적용된 점, 그리고 다른 터미널·호스트가 같은 홈에서 재로그인하면 기존 잡이 "Not logged in"으로 죽던 충돌이 잡힌 점도 같은 맥락입니다 — 인증을 공유하는 환경의 경합 조건 정리입니다.
공유 홈의 동시 쓰기 — 잠금과 정직한 실패
더 근본적인 수정은 설정 파일의 동시성입니다. claude mcp add·remove가 잠금 없이 설정을 써서 서로의 변경을 덮어쓸 수 있었는데, 이제 잠금을 기다리거나 exit 1로 실패합니다. 또 /logout·claude auth logout·claude mcp remove가 공유 네트워크 홈에서 설정 갱신에 실패했는데도 성공을 보고하던 문제 — 신뢰·동의·MCP 설정이 말없이 사라지던 사례 — 가 잡혔습니다. 306의 "조용한 실패 제거", 314의 exit code 정직화에 이어, 이번엔 동시 쓰기와 가짜 성공이라는 마지막 조용한 실패가 닫혔습니다.
314 회귀 수정과 제어의 미세화
314에서 생긴 회귀도 잡혔습니다. 잘못된 형식의 도구 호출 재시도가 끝난 뒤 --continue가 이전 대화를 잃어버리는 문제입니다. macOS에서 Bash 명령이 많이 돌 때 메모리가 늘며 세션이 멈추던 것, 메시지 전송 직후 타이핑된 키가 느린 권한 프롬프트를 대신 눌러버리던 경합도 수정됐습니다. 신기능 쪽은 제어의 미세화 — 모드의 $.model.fork에 effort 옵션이 붙어 사이드 잡을 세션과 무관하게 low로 돌릴 수 있고(결과는 실제 보낸 effort를 보고), 게이트웨이 mantle 업스트림에 assume_role이 추가돼 개발자별 AWS 비용 귀속이 가능해졌습니다. stdio MCP 서버가 버전 프로브에서 죽으면 매번 재프로브하던 것도, 3초 안에 자체 사유로 죽은 서버를 7일간 레거시 핸드셰이크에 고정하는 방식으로 정리됐습니다.
실전 가이드
SSH·공유 홈에서 여러 터미널로 Claude를 쓰는 분, claude -p 자동화를 돌리는 팀은 즉시 업데이트 대상입니다. 만료 10일 전 경고는 CI에서 stderr를 무시하는 파이프라인이라면 로그 수집 규칙에 추가해둘 것을 권합니다. --continue로 긴 세션을 이어 쓰던 사용자도 314 회귀를 피하려면 이번 버전이 필요합니다.
마무리로 — 317이 비용을 쿼리 가능하게 만들었다면 318은 자격 증명과 설정 파일의 '수명과 동시성'을 정면으로 잡았습니다. 무인 에이전트의 두 번째 신뢰 축 — 언제 끝나는지 알고, 동시에 써도 안 부서지는 — 이 여기서 완성됩니다.
출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.318
태그: AI Claude Claude Code 개발도구