Claude Code는 AGENTS.md 지원을 추가합니다

Claude Code는 CLAUDE.md가 없을 경우 AGENTS.md를 읽습니다

핵심 요약: 2026년 9월 18일 릴리스부터 Claude Code는 프로젝트에 CLAUDE.md가 없을 경우 AGENTS.md 파일을 대체로 읽습니다. 이 변경은 필수 단계를 제거하고 사용자가 지침 파일을 제공자에 관계없이 유지할 수 있게 하며, 표준 에이전트 정의 형식에 대한 커뮤니티 기대에 부합하게 만듭니다.

변경의 의미

저항 감소 – 이전에는 모든 Claude Code 프로젝트가 리포지토리 루트에 CLAUDE.md가 필요했습니다. AGENTS.md를 선호하거나 다른 허브에서 마이그레이션한 사용자는 심볼릭 링크를 생성하거나 파일을 중복 생성해야 했습니다. 새로운 대체 기능은 이러한 추가 유지보수를 제거합니다.
새로운 관행과의 일치 – 여러 개발자가 Claude, Codex, Gemini 등 다양한 AI-코드 보조 도구에서 사용 가능한 중립적인 AGENTS.md 이름을 지지해 왔습니다. Anthropic가 AGENTS.md를 기본적으로 지원함으로써 커뮤니티 표준에 민감하게 반응하고 있음을 보여줍니다.
더 깔끔한 프로젝트 구조 – 이제 프로젝트는 심볼릭 링크나 중복 파일 없이 에이전트 지침의 유일한 소스를 유지할 수 있습니다.

릴리스 노트 내용

2026년 9월 18일 – AGENTS.md 지원 추가: CLAUDE.md가 없는 프로젝트에서 Claude Code는 AGENTS.md를 읽습니다. /config의 "프로젝트 지침"에서 변경 가능 (아직 Bedrock, Vertex, Foundry에는 적용되지 않음).

이 변경은 CLI와 VS Code 확장 기능에만 적용되며, Bedrock, Vertex 또는 Foundry에서 호스팅되는 클라우드 기반 Claude Code 세션은 향후 업데이트에서 이 기능을 받게 됩니다.

Hacker News 커뮤니티 반응

댓글 작성자	감정	주요 포인트
@askonomm	긍정적	"마침내 독점적인 워크플로우를 강요하지 않고 표준을 따르기 시작했습니다."
@stillpointlab	관찰적	Claude Fable이 자동으로 `AGENTS.md`와 그에 대한 심볼릭 링크를 생성한다는 점을 지적하며, 이미 중립 파일의 필요성을 도구가 인식하고 있음을 시사합니다.
@neverrroot	긍정적	"고마워요, 올바른 결정을 했네요."
@bcorigliano	긍정적	산업 전반의 표준으로 나아가는 움직임을 축하합니다.
@TomGarden	혼합적	변경을 환영하지만, 이전 요구사항을 "절대적으로 최소한의 요구사항"이라고 평가합니다.
@mococa	비판적	이 변경이 늦어졌으며, 표준은 더 일찍 도입되어야 했다고 주장합니다.
@clutter55561	경고적	Claude Code가 여전히 `.agents/skills`에 있는 기술을 감지하지 못한다는 점을 상기시킵니다.
@aroman	실용적	"마침내 `sync-agent-docs.sh`를 삭제할 수 있게 되었어요. 이 스크립트는 `AGENTS.md`를 `GEMINI.md`와 `CLAUDE.md`로 재귀적으로 심볼릭 링크로 연결했거든요…"
@jtbaker	유머러스	Shopify CEO가 Claude Code가 `AGENTS.md`를 존중하기 전까지는 사용을 금지할 수 있다고 언급한 뉴스 기사를 공유했습니다.
@mitchitized	회의적	이 변경이 커뮤니티 압박에 대한 반응일 뿐 진정한 관심이 아니라고 주장합니다.
@perganomoly	실망감	"이와 같은 기본 기능을 이렇게 오랫동안 추가하지 않은 것은 부끄러운 일입니다."
@albatross79	비꼬는	Claude Code를 "과도하게 복잡하다"고 부르며, 결코 `AGENTS.md` 지침을 완전히 존중하지 않을 것이라고 의심합니다.

전반적으로 감정은 긍정적이며, 대부분의 댓글 작성자는 단순화를 환영하고 더 넓은 상호운용성으로 나아가는 단계라고 평가합니다.

새로운 동작 사용 방법

프로젝트 루트(또는 작업 중인 하위 디렉터리)에 AGENTS.md 파일을 생성합니다. CLAUDE.md에서 사용하던 동일한 지침 구문을 포함하세요.
CLAUDE.md 파일을 제거하거나 존재하지 않게 두세요. Claude Code는 자동으로 AGENTS.md를 감지하고 로드합니다.
필요 시 대체 경로 설정 – /config 패널의 프로젝트 지침에서 설정 가능. 이 설정은 현재 CLI와 VS Code UI에서만 사용 가능하며, Bedrock/Vertex/Foundry 배포에는 적용되지 않습니다.
claude --version을 실행한 후 세션을 시작하여 확인하세요. 시작 로그에 "Reading project instructions from AGENTS.md"라는 메시지가 표시되면 성공입니다.

변경되지 않는 사항

기술 로딩 – Claude Code는 여전히 .agents/skills 디렉터리에서 기술을 자동으로 로드하지 않습니다. 사용자는 여전히 기술을 명시적으로 등록하거나 기존의 skills/ 메커니즘에 의존해야 합니다.
클라우드 호스팅 세션 – 대체 기능은 아직 Bedrock, Vertex, Foundry 인스턴스에 적용되지 않았으며, 이후 패치에서 업데이트될 예정입니다.
레거시 동작 – CLAUDE.md와 AGENTS.md가 모두 존재할 경우 CLAUDE.md가 우선권을 가지며, 기존 프로젝트의 호환성을 유지합니다.

기존 프로젝트를 위한 빠른 체크리스트

CLAUDE.md → AGENTS.md를 가리키는 모든 심볼릭 링크를 제거하세요.
AGENTS.md가 필요한 모든 에이전트 지침을 포함하고 있는지 확인하세요.
새 Claude Code 세션을 테스트하여 파일이 제대로 읽히는지 확인하세요.
내부 문서를 업데이트하여 AGENTS.md를 공식 지침 파일로 참조하도록 하세요.

결론

Claude Code의 AGENTS.md 대체 기능 추가는 소소하지만 의미 있는 품질 향상입니다. 불필요한 파일을 제거하고, 여러 AI-코드 보조 도구에서 사용 가능한 이름 규칙을 존중하며, Anthropic가 개발자 피드백에 귀 기울이려는 의지를 보여줍니다. 이 변경은 이미 CLI와 VS Code 확장 기능에서 적용되었으며, 커뮤니티 반응은 AI 지원 개발 생태계의 보다 광범위한 표준화로 나아가는 단계로 환영받을 것으로 보입니다.