Claude Code v2.1.277, AGENTS.md 지원 추가 및 충돌 버그 수정

Claude Code v2.1.277이 소규모 기능 추가와 함께 세션, 도구, 게이트웨이 처리 전반에 걸친 긴 버그 수정 목록을 내놓았습니다. 실제로 바뀐 내용은 다음과 같습니다.

AGENTS.md 지원

CLAUDE.md가 없는 프로젝트에서 Claude Code가 이제 AGENTS.md를 대신 읽습니다. /config의 "Project instructions"에서 전환할 수 있습니다. Bedrock, Vertex, Foundry에서는 아직 사용할 수 없습니다.

게이트웨이 및 프록시 변경

• CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1: 외부로 나가는 유일한 경로가 포워드 프록시인 Claude 앱 게이트웨이용으로, 모든 아웃바운드 요청이 호스트명을 로컬에서 해석하지 않고 프록시에 전달합니다.
• Claude 앱 게이트웨이 업스트림에 선택적 headers: 매핑을 추가해 공급자 앞에서 실행하는 프록시에 정적 헤더를 보낼 수 있습니다.
• /tasks 같은 패널이 열려 있을 때 백그라운드 작업이 완료되면 해당 업데이트가 대기 중임을 알리는 줄이 표시됩니다.

세션 및 CLI 수정

• 내부 오류 후 결과 없이 멈출 수 있었던 claude -p 및 Agent SDK 세션이 이제 오류를 보고하고 코드 1로 종료됩니다.
• 이전 어시스턴트 턴에 다른 콘텐츠와 함께 빈 텍스트 블록이 있었을 때, --resume 이후를 포함해 모든 요청이 "text content blocks must be non-empty"로 실패하던 대화 문제.
• 구버전 Claude Code 빌드(예: IDE 확장 프로그램에 번들된 CLI)가 현재 버전과 같은 머신에서 실행될 때 발생하던 예기치 않은 로그아웃.
• ~/.claude.json에 잘못된 형식의 customApiKeyResponses 값이 있을 때 ANTHROPIC_API_KEY 사용자의 대화형 시작이 멈추거나 오류가 나던 문제.
• 프록시가 잘못된 버전을 반환할 때 30분마다 업데이트 확인이 오류를 내고, min/max 버전이 설정된 경우 claude update가 멈추던 문제. 이제 잘못된 minimumVersion은 무시됩니다.
• winget 또는 apk로 관리되는 설치에서 버전 조회가 실패했을 때 claude update가 "up to date"라고 보고하던 문제.
• 사용 중인 플러그인 버전을 재설치할 때 claude plugin install이 때때로 실패하고 설치된 복사본을 깨뜨리던 문제. 이제 변경되지 않은 복사본은 그대로 유지됩니다.

도구 수정 (Grep, Glob, Write, Edit)

• Grep과 Glob은 프로세스, 메모리 또는 파일 핸들 부족으로 검색을 시작할 수 없을 때 이제 일치 항목 없음으로 보고하는 대신 오류를 반환합니다.
• Write는 대상 경로가 기존 디렉터리일 때 더 이상 권한 거부로 턴을 조용히 종료하지 않습니다.
• Edit는 이스케이프된 백슬래시 뒤에 uXXXX가 오는 것을 \uXXXX 이스케이프로 취급하지 않아, 비ASCII 문자를 편집할 때 이스케이프된 백슬래시 시퀀스를 다시 쓰는 문제가 사라졌습니다.
• Edit는 일치하지 않는 매우 큰 비ASCII 편집에 대해 "Invalid regular expression: regular expression too large" 대신 "String not found in file"을 보고합니다.
• 도구 호출의 파일 경로에 이스케이프 시퀀스로 작성된 \u0000가 포함되어 있을 때 "Path contains null bytes"로 턴이 일찍 끝나지 않습니다.

안정성 수정

• 백그라운드 세션(claude --bg)은 플러그인의 LSP 서버가 종료되거나 stdin을 닫아도 더 이상 종료되지 않습니다.
• 잘못된 형식의 claudeAiMcpEverConnected, theme, 또는 저장된 기록의 일반 문자열 어시스턴트 메시지로 인한 크래시.
• 프롬프트에 터미널 색상 코드가 포함되어 있을 때 발생하던 크래시("unrecoverable interface error").
• 느린 머신의 세션이 첫 스피너가 나타날 때 종료되던 문제.
• 내부 렌더링 오류 후 드물게 발생하던 화면 멈춤.
• Windows에서 응답 직후 "Out of memory"로 턴이 중단되어 도구 호출이 실행되지 않던 문제.
• SessionStart 훅이 출력을 인쇄할 때 /clear 이후 계속된 세션(재시작, --continue, --resume)이 첫 메시지의 일부를 누락하여 전체 프롬프트 캐시 미스가 발생하던 문제.

프록시 뒤에서 Claude Code를 실행하거나 LSP 서버가 있는 플러그인을 사용한다면 이 릴리스를 받을 가치가 있습니다.