## 변경 사항 - AGENTS.md 지원 추가: CLAUDE.md가 없는 프로젝트의 경우, Claude Code는 대신 AGENTS.md를
요약
이번 업데이트는 Claude Code 및 Agent SDK 사용성을 대폭 개선하는 데 초점을 맞추고 있습니다. AGENTS.md 지원 추가, 프록시 설정 강화, 그리고 다양한 내부 오류 처리 로직 수정이 주요 내용입니다. 특히 세션 관리와 도구 호출의 안정성이 향상되었습니다.
핵심 포인트
- AGENTS.md 지원으로 CLAUDE.md가 없는 프로젝트도 Claude Code 사용 가능
- 프록시 환경에서 호스트 이름 전달 및 헤더 전송 기능 추가
- 세션 시작, 재개 등 다양한 상황에서의 오류 처리 및 로직 안정화 개선
- Grep/Glob 검색 실패 시 명확한 오류 반환 및 Write 도구 권한 문제 수정
변경 사항
-
AGENTS.md 지원 추가: CLAUDE.md가 없는 프로젝트의 경우, Claude Code는 대신 AGENTS.md를 읽습니다. 이 파일은
/config내 'Project instructions'에서 변경할 수 있습니다 (아직 Bedrock, Vertex 또는 Foundry에서는 지원되지 않음). -
출구(egress)가 포워드 프록시인 Claude 앱 게이트웨이에
CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1추가: 모든 아웃바운드 요청 시, 로컬에서 IP를 해석하는 대신 프록시에 호스트 이름을 전달합니다. -
Claude 앱 게이트웨이 업스트림에 선택적
headers:맵 추가: 제공업체 앞에 실행하는 프록시로 정적 헤더를 전송할 수 있습니다. -
패널(예:
/tasks)이 열려 있는 동안 백그라운드 작업의 업데이트가 대기 중임을 알리는 문구 추가 -
내부 오류 후 결과 없이 멈출 수 있던
claude -p및 Agent SDK 세션 수정: 이제 오류를 보고하고 코드 1로 종료됩니다. -
이전 어시스턴트 턴에서 다른 콘텐츠와 함께 빈 텍스트 블록을 포함했을 경우,
--resume사용 후에도 요청마다 -
Grep 및 Glob이 시스템 프로세스, 메모리 또는 파일 핸들 부족으로 검색을 시작할 수 없을 때 일치하는 항목이 없다고 보고하지 않던 문제를 수정했습니다. 이제 이러한 경우 오류를 반환합니다.
-
대상 경로가 이미 존재하는 디렉터리일 때 Write 도구가 권한 거부로 조용히 턴을 종료하던 문제를 수정했습니다. 이제 명확한 오류를 보고합니다.
-
Edit 도구가 이스케이프된 백슬래시 뒤에
uXXXX텍스트가 오는 경우 이를ꪪ이스케이프로 처리하는 문제를 수정했습니다. 이로 인해 비(非) ASCII 문자의 편집이 이스케이프된 백슬래시 시퀀스를 재작성할 수 있었습니다. -
Edit 도구가 매우 큰 비(非) ASCII 텍스트를 포함하는 편집 내용이 파일과 일치하지 않을 때
-
Windows에서 Claude가 응답한 직후 'Out of memory'와 같은 오류로 인해 턴이 중단되는 희귀한 경우를 수정하여 해당 응답의 도구 호출(tool calls)이 실행되지 않도록 했습니다.
-
SessionStart 후크가 출력을 출력할 때
/clear(재시작,--continue,--resume) 이후 세션이 첫 번째 메시지의 일부를 누락하는 문제를 수정했습니다. 이로 인해 전체 프롬프트 캐시 미스(prompt-cache miss)가 발생했습니다. -
다른 에이전트(예: 서브에이전트의 SendMessage)로부터 도착한 중간 턴의 메시지가 도착한 위치가 아닌 'N개 셸 명령어 실행됨' 행 아래에 표시되는 문제를 수정했습니다.
-
전체 화면
/resume피커 및 프롬프트 영역을 가리는 다른 패널에서 텍스트를 드래그 선택한 후 '복사됨(copied)' 알림이 나타나지 않던 문제를 수정했습니다. -
샌드박싱이 활성화된 상태에서 샌드박스 외부에서 실행되는 Bash 명령어의
$TMPDIR가 빈 문자열로 확장되던 문제를 수정했습니다. -
Cowork 클라우드 세션에서 WebFetch 및 WebSearch가 요청이 거부된 이유(예: 사용 가능한 페치 예산 소진 또는 관리자 정책)를 Claude에게 알리지 않던 문제를 수정했습니다.
-
프록시가 설정된 경우, Claude 앱 게이트웨이의 텔레메트리 릴레이가
NO_PROXY에 나열된 컬렉터 호스트 이름이나 도메인을 무시하던 문제를 수정했습니다. -
잘못 구성된
strictKnownMarketplaces또는blockedMarketplaces항목 하나가 전체 엔터프라이즈 마켓플레이스 정책을 조용히 비활성화시키던 문제를 수정했습니다. -
실패한 자동 업데이트로 인해 대규모 스테이징 다운로드 파일이
~/.cache/claude/staging에 남아있던 문제를 수정했습니다. -
/plugin에서 설치된(Installed) 탭의 메시지, 예를 들어 플러그인 업데이트 실패 오류와 같은 터미널 제어 문자가 제거되지 않던 문제를 수정했습니다. -
/plugin→ Installed 및/skills가constructor나toString과 같이 내장 객체 속성처럼 이름 지어진 스킬이나 레거시 명령어에 의해 충돌하던 문제를 수정했습니다. -
다중 선택(multi-select)에서 모든 설치가 실패했을 때
/plugin이 메시지 없이 닫히던 문제를 수정했습니다. -
제거된 플러그인이
/pluginInstalled에 -
공식 마켓플레이스의 플러그인이 커밋 정보 없이
installed_plugins.json에 기록되는 문제와, 핀 고정(pinned-commit) 플러그인을 업데이트한 후에도installed_plugins.json이 이전 커밋을 유지하는 문제를 수정했습니다. -
플러그인 리로드 미리보기가 종료될 때까지 플러그인 아카이브의 모든 미리보기 복사본을 압축 해제 상태로 유지하고, 재로드가 실패할 때 폴백(fallback) 하는 캐시된
--plugin-url아카이브를 덮어쓰는 문제를 수정했습니다. -
~/.claude.json에 잘못 구성된 플레이스홀더 레코드가 있을 때 원격 제어 세션 북키핑이 실패하는 문제를 수정했습니다. -
claude.ai 로그인 취소 후 만료된 Anthropic 프로필을 탓하며 오류가 발생하는 문제와, 이제는
/login으로 안내하는 문제를 수정했습니다. -
키 반복 또는 매우 빠른 입력 중
claude agents디스패치 입력에서 타이핑하거나 붙여넣은 텍스트가 가끔 깨져 나오는 문제를 수정했습니다. -
저장된 기록에 잘 구성되지 않은 후크 목록이 포함된 정지 후크 요약(stop hook summary)을 가진 세션을 재개할 때 충돌(
-
대화 초기에 기록된 첨부 파일이 재개 또는 재실행 후 다시 렌더링될 때 누락되던 확장 사고(extended thinking) 및 프롬프트 캐시를 수정했습니다.
-
서버가 API 키 생성을 거부할 때 콘솔에 'Request failed with status code 400'만 표시되는 문제를 수정하여, 이제는 서버의 메시지를 표시합니다.
-
Claude가 작업 중일 때 입력된 메시지가 모델에 의해 무시되던 문제를 수정했습니다.
-
SDK 및 헤드리스(
-p) 사용 시 세션 시작 과정을 개선했습니다: 첫 번째 턴이 더 이상 디렉터리별CLAUDE.md조회에 기다리지 않습니다. -
Claude 앱 게이트웨이의 루프백 오류 메시지를
CLAUDE_GATEWAY_ALLOW_LOOPBACK으로 이름 지정하여 개선했습니다. -
/plugin설치 개선: 플러그인과 분리되어 나열된 MCP 서버가 어떤 플러그인에 속하는지 표시하도록 했습니다. -
이미 설치된 플러그인에 대한
claude plugin install개선: 이제 마켓플레이스에서 더 새로운 버전을 제공할 때 이를 알려주고claude plugin update명령어를 명시합니다. -
로고 아래의 시작 알림 오버플로우 라인을 개선했습니다: 이제 '+N more · /status' 대신 'N more notices hidden'으로 표시됩니다.
-
프롬프트 처리 개선: 프롬프트 내에 있는 보이지 않는 유니코드 서식 및 태그 문자가 제거되며, 정리된 프롬프트를 검토할 수 있도록 보여준 후 전송합니다.
-
리뷰할 내용이 없을 때
/ultrareview개선: 메시지가 현재 상황을 알려주고 최신 커밋을 검토하는 명령어와 새 저장소의 첫 번째 커밋 전체를 검토하도록 제공합니다. -
Artifact 도구 사용 시 Claude가 WebFetch 대신 claude.ai 아티팩트 링크를 읽도록 처리하여 개선했습니다.
-
위험한
rm권한 프롬프트를 개선하여 플래그된rm명령어를 이름 지정하고${VAR:?}가드를 제안함으로써, 헤드리스 실행이 복구될 수 있도록 했습니다. -
Artifact 도구의 권한 프롬프트 개선: 문장을 더 짧게 하고, 페이지와 아티팩트 이름을 제목이나 파일명으로 명시하며, 링크를 텍스트 뒤에 나열하도록 했습니다.
-
Anthropic API에서 Fable이 항상
/model에 표시되도록 변경되었습니다. 이제 조직 설정으로 비활성화된 경우에만 회색 처리됩니다. -
Bedrock, Vertex 및 Foundry의 Bash 샌드박스 지침이 첫 번째 파티(first-party) 문구로 변경되어, 해당 샌드박스가 작업에 주어진 경계임을 명시합니다.
-
비대화형 세션에서
/ultrareview가 저장소에 기본 브랜치나 공유 기록이 없는 경우 거부하도록 변경되었습니다. -
서브 에이전트 결과가 메인 에이전트 아래에 헤더로 표시되어 서브 에이전트 출력임을 나타내고, 결과는 들여쓰기 처리됩니다. 따라서 서브 에이전트의 텍스트가 세션 자체의 지침으로 인식되는 것을 방지합니다.
-
Bedrock, Vertex 및 Foundry에서 워크플로우 스크립트의 계산된
agent()프롬프트가 서브 에이전트로 구성된 텍스트로 표시되도록 변경되어, 안전 분류기(safety classifier)가 이를 사용자 입력으로 읽지 않게 합니다. -
SDK나 IDE 외부에서 실행되는
claude -p의 백그라운드 Haiku 자동 제목 요청 기능이 제거되었습니다. -
더 이상 사용되지 않는 TaskOutput 도구가 제거되었습니다. 이제 Claude는 Read를 사용하여 백그라운드 작업의 출력 파일을 읽으며,
taskOutputMaxChars설정과TASK_MAX_OUTPUT_LENGTH는 더 이상 영향을 미치지 않습니다. -
[VSCode] 패널 메뉴에 '로그아웃(Sign out)' 항목이 추가되었고, 입력 명령어 메뉴에는
/logout이 포함되었습니다. -
[VSCode] 백그라운드 셸 및 기타 실행 중인 작업들이 에이전트 지도에 추가되었으며, 각 항목마다 '중지(Stop)' 버튼과 이를 열어주는 입력
/tasks가 생겼습니다. -
[VSCode] 응답에 복사(Copy) 버튼이 추가되었고, 입력 명령어
/copy를 사용할 수 있게 되었습니다. -
[VSCode] 비활성 세션이 자동으로 보관될 때 일회성 알림이 추가되었으며, '보관된 세션(Archived sessions)' 그룹에 '모두 복원(Unarchive all)' 액션이 추가되었습니다.
-
[VSCode] 플랜 제한이 적용되지 않는 계정 및 사용량 대화 상자(Vertex, Bedrock, Foundry, API 키)와 세션 관리자에 해당 세션의 비용과 토큰 사용량이 표시됩니다.
-
[VSCode]
-
[VSCode]
/effort로 이미 레벨이 저장된 모델에서 노력 슬라이더(effort slider)의 레벨이 이후 세션에 유지되지 않던 문제 수정 -
[VSCode] 저장된 모델 설정이
AI 자동 생성 콘텐츠
본 콘텐츠는 Claude Code Releases의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기