기능 요청: AGENTS.md 지원

20 hours ago 3

Claude Code가 여러 코딩 에이전트의 공통 프로젝트 지침 파일인 AGENTS.md를 읽어, CLAUDE.md를 별도로 복제하지 않아도 코드베이스 맥락을 활용하게 해달라는 요청임 제안된 이중 파일 방식은 CLAUDE.md를 우선 로드하고, 없을 때만 AGENTS.md를 대체 파일로 사용해 기존 프로젝트와의 호환성을 유지함 AGENTS.md는 2만 개가 넘는 오픈소스 프로젝트에서 사용되며 Codex, Amp, Cursor 등도 채택하기 시작했지만, Claude Code는 해당 파일의 지침을 자동으로 읽지 않음 공식 지원 전에는 CLAUDE.md에 @AGENTS.md를 넣거나 심볼릭 링크를 만들고, SessionStart 훅으로 저장소 내 모든 AGENTS.md를 컨텍스트에 추가하는 우회책을 사용할 수 있음 이슈는 닫혔지만 제공된 본문에는 Anthropic의 최종 답변과 종료 사유가 포함되지 않았으며, 참가자들은 파일 중복·컨텍스트 낭비·도구별 지침 불일치를 계속 문제로 지적함 요청 배경 AGENTS.md는 코딩 에이전트가 코드베이스를 이해하는 데 사용하는 통합 Markdown 형식으로, Codex, Amp, Cursor 등 여러 도구가 채택하기 시작함 openai/agents.md에 따르면 이 형식은 2만 개 이상의 오픈소스 프로젝트에서 사용됨 Claude Code 전용 CLAUDE.md는 다른 도구 사용자와 협업할 때 공유하기 어려워, 팀이 도구별 지침 파일을 중복 관리해야 함 AGENTS.md만 제공하는 저장소를 Claude Code로 열면 해당 컨텍스트가 무시되며, 사용자가 CLAUDE.md를 만들고 지침을 복제해야 함 여러 도구를 오가면 CLAUDE.md, AGENTS.md, Cursor 규칙 등의 내용이 서로 달라져 같은 저장소에서도 에이전트 동작이 불일치할 수 있음 제안된 파일 탐색 순서 Claude Code 시작 시 다음과 같은 우선순위 기반 탐색을 적용하자는 제안임 프로젝트 디렉터리에서 CLAUDE.md를 먼저 검색함 발견하면 해당 내용을 컨텍스트에 넣고 탐색을 중단하며 AGENTS.md는 무시함 CLAUDE.md가 없을 때 같은 디렉터리의 AGENTS.md를 검색함 발견한 AGENTS.md를 프로젝트 지침으로 로드함 선택적으로 AGENTS.md를 읽었을 때 Claude Code 전용 지침이 필요하면 CLAUDE.md를 만들 수 있다는 일회성 메시지를 보여줄 수 있음 이 방식은 기존 CLAUD...

Read Entire Article