Claude Code v2.1.270 — AGENTS.md 표준 지원과 빈 응답 400 픽스가 핵심인 업데이트

이번 주에도 두 가지가 정리됐습니다. 드디어 AGENTS.md 표준을 공식 지원하기 시작했고, "text content blocks must be non-empty"로 모든 요청이 실패하던 400 에러가 잡혔습니다.

한마디로 말하면, CLAUDE.md가 없는 프로젝트에서 Claude Code가 업계 표준인 AGENTS.md를 대신 읽어주는 생태계 수렴 기능과, 세션 복원을 망가뜨리던 데이터 결함 픽스가 핵심인 릴리스입니다.

AGENTS.md 지원 — 생태계 표준 수렴의 신호

CLAUDE.md가 없는 프로젝트에서는 이제 AGENTS.md를 대신 읽습니다. /config의 "Project instructions"에서 파일을 바꿀 수도 있습니다. OpenAI를 비롯한 주요 코딩 에이전트들이 AGENTS.md 표준으로 수렴하는 가운데, Claude Code도 같은 파일 하나로 여러 에이전트에 지침을 공급할 수 있게 된 것입니다. 멀티 에이전트 사용자에게는 실질적인 편의 — 어느 도구를 쓰느냐에 따라 지침 파일을 이중으로 관리할 필요가 없어졌습니다. 참고로 Bedrock, Vertex, Foundry 환경에는 아직 미지원입니다.

"text content blocks must be non-empty" — 원인은 빈 텍스트 블록

모든 요청이 "text content blocks must be non-empty"로 실패하던 문제가 잡혔습니다. 원인은 이전 어시스턴트 턴이 다른 콘텐츠 옆에 빈 텍스트 블록을 남겨둔 경우로, --resume 이후에도 재현되던 문제였습니다. 희귀해 보이지만 막상 걸리면 모든 요청이 막히는 유형이라, 해당 증상을 겪던 사용자에게는 필수 픽스입니다.

안정성 픽스 — 예기치 못한 로그아웃과 묵묵부답

claude -p와 Agent SDK 세션이 내부 에러 후 결과 없이 영원히 멈추던 문제는 이제 에러를 보고하고 exit code 1로 종료됩니다. 오래된 빌드(IDE 확장의 번들 CLI)가 같은 머신에서 돌 때 예기치 않게 로그아웃되던 문제, ~/.claude.json의 malformed customApiKeyResponses 때문에 시작이 멈추던 문제, winget·apk 관리 설치에서 조회 실패 시 "up to date"라고 거짓 보고하던 문제도 정리됐습니다. Grep·Glob이 프로세스·메모리·파일 핸들 부족으로 검색을 시작조차 못 했을 때 "no matches"라고 거짓 답하던 것도 이제 명확한 에러를 돌려줍니다.

실전에서 어떻게 쓸까?

멀티 에이전트 사용자라면 이번 버전부터 AGENTS.md 하나로 통일하는 것을 권합니다. 제 경우에도 이번 주에 4개 프로젝트의 AGENTS.md에 디자인 코퍼스 포인터를 넣어뒀는데, 이제 CLAUDE.md 없이도 그 포인터가 Claude Code에 전달됩니다. 프록시 환경이라면 업데이트 체크 에러 픽스도 체감될 것이고요. 플러그인 재설치 시 사용 중인 사본을 깨뜨리던 문제는 "변경 없는 사본은 그대로 둔다"로 바뀌어 CI 재설치 안전성이 올라갔습니다.

마무리로 — AGENTS.md 지원은 기능보다 생태계 신호입니다. 에이전트 지침의 단일 표준으로 수렴이 본격화되고 있다는 뜻이니, 여러 코딩 에이전트를 섞어 쓰는 팀이라면 지침 파일 정리에 좋은 타이밍입니다.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.270

태그: AI Claude Claude Code 개발도구