Claude Code 2.1.277, CLAUDE.md 없으면 AGENTS.md를 읽는다
- Claude Code 2.1.277부터 프로젝트에 CLAUDE.md가 없으면 AGENTS.md를 대신 읽는다.
/config의 "Project instructions"에서 이 동작을 바꿀 수 있고 Bedrock, Vertex, Foundry에서는 아직 지원하지 않는다. - AGENTS.md 지원 구현은 오픈소스로 공개됐다. 저장소의
mods/agents.md경로에 있고, Anthropic은 하네스를 커스터마이즈하는 Claude Code mods를 별도로 준비 중이다. - 같은 릴리스에 30여 건의 수정이 함께 들어갔다.
claude -p와 Agent SDK가 내부 오류 뒤 결과 없이 멈추던 문제, 빈 텍스트 블록 때문에 모든 요청이 실패하던 문제, 구버전 빌드와 같은 머신에서 돌 때 로그아웃되던 문제 등이다. - 해커뉴스 반응은 엇갈린다. 표준을 따르는 건 최소한이라는 평가와 1년 반 늦었다는 비판이 함께 나오고, Tobi Lütke가 Shopify에서 Claude Code를 금지하겠다고 압박한 일이 배경으로 언급된다.
- Claude Code는 아직
.agents/skills를 인식하지 못한다. 사용자들은ln -s AGENTS.md CLAUDE.md나 post-checkout git hook으로 우회해 왔다.
Hacker News opinions
이거 때문에 scaffold harness를 다시 짜야 하네. agent.md 인식이 시스템 프롬프트에 들어간 건가?
아님. "Claude Code mods"라는 걸 준비 중이고, AGENTS.md 구현은 저장소에 오픈소스로 공개돼 있음.
오픈AI 저장소 훔쳐본 뒤에 가져온 첫 기능이네.
드디어 독자 워크플로 강요 대신 표준을 따르는구나.
근데 CLAUDE.md가 먼저 나왔잖아. AGENTS.md도 결국 이름만 바꿔서 따라한 거고.
마크다운 파일 이름만 바꿔서 자기들 것으로 만드는 건 웃기지.
thariq 말처럼 프롬프트는 모델별로 튜닝해야 함. AGENTS.md를 무조건 적용하면 모델들이 하나의 애매한 지시 따르기로 수렴해서 다양성이 죽음.
고맙긴 한데 Claude Code는 아직 .agents/skills를 못 읽더라.
걱정 마, Q4 2029 로드맵에 있음.
그 기능 하나 추가하는 데 토큰 예산 20달러도 안 드는데 안 하는 거 보면 웃김.
post-checkout git hook으로 우회하면 됨. .agents/skills 있으면 .claude/skills로 심볼릭 링크 걸게 만들면 끝.
이제 "AGENTS.MD"라고만 적힌 한 줄짜리 Claude.md 파일들은 지워도 되겠네.
Tobi Lutke 덕분이지. Shopify에서 Claude Code 금지하겠다고 했던 사람임.
칭찬하려다 참았음. 이건 최소한이고 이제 심볼릭 링크나 지우면 됨.
2025년엔 시장 지배력으로 경쟁 하네스 경험을 망가뜨렸고, 2026년엔 자기들이 밀려서 사용자 불만을 뒤늦게 처리한 거임.
커뮤니티가 화내고 사용자가 다른 하네스로 빠져나가니까 한 거지, 개발자 커뮤니티를 생각해서 한 게 아님.
다시 말하지만 닫힌 소스 하네스는 쓰지 마라. 이래서 문제임.
이제 sync-agent-docs.sh를 지울 수 있겠다. AGENTS.md를 GEMINI.md, CLAUDE.md로 재귀 심볼릭 링크하던 스크립트.
Claude가 시킨 적도 없는데 AGENTS.md 만들고 CLAUDE.md 심볼릭 링크까지 걸어줬음. Codex로 세팅한 프로젝트를 보고 알아서 맞춘 듯.
그냥 프롬프트 변경임.
마크다운 파일이 프롬프트에 텍스트 더하는 것 말고 무슨 의미가 있나? 컨텍스트만 흐리는 거 아님?
내용은 네가 씀. 짧게 핵심만 적으면 됨. skills는 요약만 읽으니까 너무 많으면 컨텍스트가 흐려짐.
Claude 구독을 다른 하네스에서 쓰고 싶은데 밴당할까 봐 못 쓰겠음. 특정 provider에 묶이는 건 싫음.
skills 폴더랑 MCP 설정도 표준화해 주면 좋겠다.