Claude Code, CLAUDE.md가 없으면 AGENTS.md를 읽도록 지원 추가 — 에이전트 지시 파일 표준화
Anthropic의 AI 코딩 도구 Claude Code가 프로젝트에 CLAUDE.md가 없을 때 AGENTS.md를 프로젝트 지시 파일로 읽는 기능을 추가했습니다. AGENTS.md는 OpenAI Codex 등 여러 에이전트가 채택한 공통 규약으로, 개발자들이 도구별 지시 파일을 중복 관리할 부담이 줄어듭니다. 이번 릴리스에는 대기 메시지 일괄 전송 키, claude.ai 스킬·플러그인 동기화, 플러그인 보안 강화 등 다수의 개선도 함께 담겼습니다.
본문
Anthropic의 CLI 기반 AI 코딩 도구인 Claude Code가 새 버전에서 AGENTS.md 파일 지원을 추가했습니다. 프로젝트에 CLAUDE.md가 없는 경우 Claude Code가 대신 AGENTS.md를 읽어들이며, 이 동작은 /config의 'Project instructions' 항목에서 변경할 수 있습니다. 다만 Bedrock, Vertex, Foundry 환경에는 아직 적용되지 않았습니다. AGENTS.md는 OpenAI Codex를 비롯한 여러 AI 코딩 에이전트가 채택한 공통 지시 파일 규약으로, 이번 지원으로 개발자들은 도구마다 다른 설정 파일을 유지하지 않고 하나의 표준 파일로 여러 에이전트를 운용할 수 있게 됐습니다.
AGENTS.md 지원의 의미
이번 변경은 Claude Code가 자체 포맷인 CLAUDE.md만을 요구하던 기존 방식에서 벗어나 범용 규약을 수용했다는 점에서 주목됩니다. 프로젝트에 CLAUDE.md가 있으면 기존 동작이 그대로 유지되고, 없을 때만 AGENTS.md가 대체로 사용되는 하위 호환 방식입니다. 에이전트 도구가 늘어나면서 저장소마다 CLAUDE.md, AGENTS.md, 각 도구 전용 rules 디렉터리를 중복 관리해야 하는 부담이 있었는데, 이번 지원으로 AGENTS.md 하나로 통합하는 선택지가 열렸습니다. Hacker News에서 475점, 댓글 176개를 기록할 만큼 개발자들의 관심이 컸습니다.
이번 릴리스의 다른 주요 변경 사항
대규모 변경 로그에는 수많은 수정과 개선이 담겼습니다. 우선 ctrl+enter(또는 ctrl+x ctrl+s)로 현재 턴을 중단하고 큐에 쌓인 메시지를 한 번에 전송하는 send-now 키가 추가됐고, claude.ai 계정에서 활성화한 스킬과 플러그인을 해당 계정으로 로그인한 터미널 세션과 동기화하는 기능이 들어왔습니다. 동기화를 원하지 않으면 syncClaudeAiSkills: false 또는 syncClaudeAiPlugins: false로 끌 수 있습니다.
플러그인 관련 보안 수정도 눈에 띕니다. npm 소스에서 설치한 플러그인은 npm pack --ignore-scripts로 가져와 무결성을 검증하도록 바뀌어 패키지의 install 스크립트가 더 이상 실행되지 않으며, git·ssh·marketplace URL에 포함된 비밀번호나 토큰이 메시지·로그·마켓플레이스 목록에 노출되던 문제도 수정됐습니다. 프롬프트 인젝션 방어 측면에서는 서브에이전트의 결과물이 '서브에이전트 출력'이라는 헤더 아래 들여쓰기되어 본 에이전트에 전달되도록 바뀌어, 서브에이전트 결과의 텍스트가 세션 자체의 지시인 것처럼 위장하지 못하게 됐습니다. 샌드박스에서는 복합 Bash 명령의 일부만 glob 패턴에 매칭돼도 전체가 면제되던 문제가 고쳐져 이제 모든 부분이 매칭되어야 하고, Linux에서 zsh 사용 시 샌드박스 내 명령 실패가 exit code 0으로 보고되던 버그도 수정됐습니다.
이 외에도 프롬프트에서 보이지 않는 유니코드 서식 문자를 제거하고 정리된 프롬프트를 전송 전 보여주는 처리, --system-prompt의 __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ 위쪽 텍스트를 전역 캐시하는 프롬프트 캐싱 개선, headless(-p) 세션의 첫 턴이 디렉터리별 CLAUDE.md 조회를 기다리지 않는 시작 속도 개선, TaskOutput 도구 제거(백그라운드 태스크 출력은 Read로 읽음), VS Code 확장의 메모리 편집·변경 단위 수락/거부 버튼·세션 비용 표시 등 수십 건의 수정과 개선이 포함됐습니다.
Hacker News 반응
- @hbarka — "좋네요, 이제 제 스캐폴드 하니스를 다시 만들어야겠습니다. 이 agent.md 인식이 시스템 프롬프트의 일부인 걸까요?"
- @sync — "아닙니다! 그들은 'Claude Code mods'라는 걸 출시할 예정입니다. 'Claude Code 하니스를 커스터마이즈하는 다가올 방식'으로 소개됐죠. AGENTS.md 구현도 오픈소스로 공개돼 있습니다(github.com/anthropics/claude-code의 mods 디렉터리)."
- @vindex10 — "OpenAI 저장소를 들여다본 뒤 처음으로 가져온 기능인가요? ))"
- @askonomm — "드디어 독점 워크플로를 강요하는 대신 표준을 따르는 일을 하는군요."
- @mlnj — "일어나 베이비, 새로운 재귀적 자기 학습 기법이 막 떴어."
원문: Claude Code Changelog / 번역·요약: Trawling