답변게시됨18 소스
Claude Code, 이제 CLAUDE.md가 없으면 AGENTS.md를 읽는다
2026년 9월 18일 공개된 Claude Code 2.1.277은 프로젝트에 CLAUDE.md가 없을 때 AGENTS.md를 프로젝트 지침으로 읽을 수 있다. AGENTS.md 중심 저장소는 여러 코딩 에이전트에서 공통 지침을 재사용하기 쉬워졌지만, 기존 CLAUDE.md 프로젝트는 공통 규칙과 Claude 전용 규칙을 의도적으로 분리해야 한다.
게시자GPT-5.6 Terra로 편집GPT Image 2로 이미지 생성
연구 답변
주요 시사점
- 2026년 9월 18일 공개된 Claude Code 2.1.277은 프로젝트에 CLAUDE.md가 없을 때 AGENTS.md를 프로젝트 지침으로 읽을 수 있다.
- AGENTS.md 중심 저장소는 여러 코딩 에이전트에서 공통 지침을 재사용하기 쉬워졌지만, 기존 CLAUDE.md 프로젝트는 공통 규칙과 Claude 전용 규칙을 의도적으로 분리해야 한다.
- AGENTS.md는 저장소 수준의 상시 지침이고, SKILL.md는 필요할 때 불러오는 재사용형 기능 패키지다.
AI 프롬프트
openai.comCreate a landscape editorial hero image for this Studio Global article: What changed in Claude Code version 2.1.277, released on September 18, 2026, regarding support for the open AGENTS.md project-instructions f. Article summary: Claude Code 2.1.277 adds native, opt-in-configurable fallback support for `AGENTS.md`: a repository without `CLAUDE.md` can now supply Claude Code’s project instructions through the shared open format instead. It is a fa. Topic tags: general, general web, user generated. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fa
Claude Code 2.1.277은 오픈 형식인 AGENTS.md를 프로젝트 지침의 폴백 파일로 지원한다. 기본적으로 프로젝트에 CLAUDE.md가 없으면 Claude Code가 AGENTS.md를 읽는다. 여러 코딩 에이전트가 공유하는 지침 파일을 이미 쓰는 저장소라면, Claude 전용 파일을 별도로 만들지 않고도 Claude Code를 사용할 수 있게 된 셈이다. 1
핵심 규칙: 폴백이지 자동 병합은 아니다
이번 변경의 기본 동작은 간단하다.
CLAUDE.md가 없는 프로젝트: Claude Code가AGENTS.md를 프로젝트 지침으로 사용할 수 있다.1
CLAUDE.md가 있는 프로젝트:CLAUDE.md는 기존의 프로젝트 지침 파일로 유지된다. 릴리스 공지의 기본 폴백 설명에는 두 파일을 자동으로 함께 읽거나 병합한다는 내용이 없다.
이 동작은 Claude Code에서 /config를 실행한 뒤 Project instructions 설정에서 활성화하거나 변경할 수 있다. 다만 Anthropic은 Amazon Bedrock, Google Vertex AI, Azure AI Foundry 환경의 Claude Code에서는 아직 이 기능을 지원하지 않는다고 밝혔다. 1
AGENTS.md란 무엇인가
AGENTS.md는 코딩 에이전트에 저장소별 작업 지침을 제공하는 공개 Markdown 형식이다. 흔히 ‘에이전트를 위한 README’라고 설명되며, 프로젝트 배경, 개발 환경 설정, 빌드·테스트 명령, 코드 규칙, 기여 방식 등을 담을 수 있다. 19
32
이 형식은 OpenAI Codex, Amp, Google Jules, Cursor, Factory 등이 참여한 협업 과정에서 나왔으며, 현재는 Linux Foundation 산하 Agentic AI Foundation이 관리한다. 프로젝트 측은 6만 개가 넘는 오픈소스 저장소에서 채택됐다고 밝히고 있다. 19
21
공개된 생태계에는 OpenAI Codex, Google Jules, Cursor, GitHub Copilot 코딩 에이전트, Gemini CLI, Aider, Zed, Warp, VS Code, Devin, JetBrains Junie, Factory, Goose, OpenCode 등이 포함된다. 다만 도구마다 파일을 찾는 위치와 우선순위, 디렉터리별 지침 처리 방식은 다를 수 있다. 파일 하나를 둔다고 해서 모든 도구가 완전히 같은 방식으로 읽는 것은 아니다. 19
이번 지원이 실무에서 중요한 이유
기존에 AGENTS.md를 공통 규칙으로 쓰던 팀은 Claude Code를 위해 별도의 CLAUDE.md를 관리하거나, 두 파일을 심볼릭 링크로 연결하거나, AGENTS.md를 불러오는 짧은 CLAUDE.md를 만들어야 하는 경우가 많았다. 과거에는 Claude Code가 AGENTS.md를 기본적으로 읽지 않았기 때문에 이런 import·심볼릭 링크 방식이 우회책으로 안내됐다. 10
이제 CLAUDE.md가 필요 없는 저장소라면 그 추가 관리가 줄어든다. 하나의 공유 파일에 기본 작업 규칙을 적어 Claude Code와 다른 호환 도구에 함께 제공할 수 있기 때문이다.
그렇다고 모든 지침 체계가 서로 완전히 호환되는 것은 아니다. 팀은 각 코딩 에이전트가 파일을 어떤 순서로 발견하는지, 하위 디렉터리 지침을 어떻게 적용하는지, 충돌이 났을 때 무엇을 우선하는지를 계속 확인해야 한다.
AGENTS.md와 SKILL.md는 역할이 다르다
AGENTS.md와 SKILL.md는 대체 관계가 아니라 서로 보완하는 형식이다.
AGENTS.md: 특정 코드베이스에서 지켜야 할 상시적인 저장소 수준 지침이다.19
32
SKILL.md: 재사용 가능한 Agent Skill의 일부다. 지침과 메타데이터, 선택적인 보조 리소스를 담는 파일시스템 기반 패키지이며, Claude는 요청과 관련성이 있을 때 이를 사용해 전문 워크플로 또는 도메인 지식을 제공한다.33
Claude Code는 Skills가 도구 간 Agent Skills 표준을 따른다고 설명한다. Claude Code 문서에서 프로젝트 스킬은 보통 .claude/skills/<name>/SKILL.md처럼 SKILL.md를 포함한 디렉터리로 구성된다. 37
39
아직 남아 있는 제한
이번 릴리스는 지침 파일 폴백을 추가한 것이지, 모든 에이전트 규약을 동일하게 맞춘 것은 아니다.
특히 Claude Code의 문서화된 프로젝트 스킬 위치는 .claude/skills/<name>/SKILL.md다. 2.1.277 변경 로그는 AGENTS.md 프로젝트 지침 지원을 다루지만, .agents/skills/ 디렉터리를 탐색한다는 발표는 하지 않았다. 1
37
또한 문서화된 폴백 동작을 CLAUDE.md와 AGENTS.md의 자동 병합 규칙으로 받아들여서는 안 된다. 이식 가능한 공통 규칙과 Claude Code 전용 동작을 모두 써야 한다면, 폴백에 기대기보다 두 파일의 관계를 명시하는 편이 안전하다.
기존 Claude Code 프로젝트에 권할 만한 구성
이미 CLAUDE.md에 의존하는 프로젝트라면 다음과 같이 나누는 방식을 고려할 수 있다.
- 여러 도구에서 공유할 저장소 규칙은
AGENTS.md에 둔다. - Claude Code에만 해당하는 지침은
CLAUDE.md에 유지한다. - 필요하다면
CLAUDE.md에서 공통 지침을 명시적으로 참조하거나 import한다. 두 파일이 자동으로 함께 로드될 것이라고 가정하지 않는다.
이렇게 하면 이식성은 확보하면서 Claude 전용 워크플로도 분리할 수 있다. Claude Code 2.1.277은 CLAUDE.md가 없는 경우 AGENTS.md 중심 저장소를 바로 사용할 수 있게 했다는 점에서 의미 있는 상호운용성 개선이다. 다만 지침 파일과 스킬 탐색 규칙이 모든 도구에서 같아졌다는 뜻은 아니다.
Studio Global AI
연구를 계속하세요
이 페이지에는 Studio Global 내에서 계속할 수 있는 소스 기반 답변이 포함되어 있습니다.
사람들은 또한 묻습니다.
"Claude Code, 이제 CLAUDE.md가 없으면 AGENTS.md를 읽는다"에 대한 짧은 대답은 무엇입니까?
2026년 9월 18일 공개된 Claude Code 2.1.277은 프로젝트에 CLAUDE.md가 없을 때 AGENTS.md를 프로젝트 지침으로 읽을 수 있다.
먼저 검증할 핵심 포인트는 무엇인가요?
2026년 9월 18일 공개된 Claude Code 2.1.277은 프로젝트에 CLAUDE.md가 없을 때 AGENTS.md를 프로젝트 지침으로 읽을 수 있다. AGENTS.md 중심 저장소는 여러 코딩 에이전트에서 공통 지침을 재사용하기 쉬워졌지만, 기존 CLAUDE.md 프로젝트는 공통 규칙과 Claude 전용 규칙을 의도적으로 분리해야 한다.
실무에서는 다음으로 무엇을 해야 합니까?
AGENTS.md는 저장소 수준의 상시 지침이고, SKILL.md는 필요할 때 불러오는 재사용형 기능 패키지다.