Claude Code, 이제 CLAUDE.md가 없으면 AGENTS.md를 읽음
요약
본 글은 Claude Code와 Codex 같은 LLM들이 프로젝트 지침 파일(CLAUDE.md, AGENTS.md 등)을 처리하는 방식의 변화를 관찰한 내용입니다. 모델들이 사용자에게 표준화된 에이전트 작업 흐름을 강요하려는 경향을 보이며, 이는 프롬프트 조정 및 모델별 접근 방식에 대한 신중한 고려가 필요함을 시사합니다.
핵심 포인트
- LLM은 프로젝트 지침 파일 처리에서 표준화를 선호하는 경향을 보인다.
- 모델마다 최적의 프롬프트와 작업 흐름이 다를 수 있으므로 주의해야 한다.
- AGENTS.md 같은 표준화된 구조는 유용하지만, 모델 다양성 측면에서는 신중한 접근이 필요하다.
- LLM은 자체적인 버그나 사용자가 제시하는 문제에 대한 해결책을 스스로 찾아내는 능력을 보인다.
장난삼아 AGENTS.md만 있는 디렉터리에서 Claude Code에 “이 디렉터리의 지침을 따라 달라”고 요청해 봤음. 지침을 찾을 수 없다면서도 이 AGENTS.md 파일을 확인해 봐야 할 것 같다고 하는데, 꼭 죽은 쥐를 발견하고 집어 들어 살펴보는 태도였음.
다른 플랫폼에서 Claude로 이전하는 중이라고 했다면, 기꺼이 AGENTS.md를 찾아 변환해 줬을 것 같음.
Codex와도 황당한 대화를 나눈 적 있음. 기존 CLAUDE.md를 가리키는 심볼릭 링크로 AGENTS.md를 만들어 뒀는데, 첫 요청부터 AGENTS.md의 지침이 Claude를 대상으로 한다고 지적함.
그러더니 너그럽게도 자신을 위한 지침으로 재해석해 주겠다며, 올바른 에이전트를 가리키도록 AGENTS.md를 고치는 게 좋겠다고 함. 참 당돌한 Codex임!
드디어 사용자에게 독자적인 작업 흐름을 강요하는 대신 표준을 따르는 일을 함.
https://x.com/trq212/status/2092302273099796842의 thariq와 같은 생각임. 프롬프트는 모델별로 조정해야 함. 모든 모델이 모호한 공통 수준의 지시 수행 방식으로 수렴하길 바라는 게 아니라면, agents.md를 무작정 적용하는 건 오히려 피해야 할 패턴일 수 있음.
국소적으로는 좋은 최적점이어도 모델의 다양성과 지능 탐구라는 전체 관점에서는 나쁜 최적점일 수 있음. 표준을 강제하기엔 너무 이른 때도 있는 법임.
CLAUDE.md에 @AGENTS.md를 넣으면 됨.
“드디어”라는 표현이 농담인지 모르겠지만, claude.md가 먼저 존재했음. agents.md는 꽤 명백하게 “괜찮네, 이름을 바꿔서 우리도 해 보자”에 가까웠음.
최근 Claude Fable에 새 프로젝트 구성을 맡기면서, 내가 선호하는 구조를 참고하도록 기존 프로젝트들을 보여 줬음. 별도 요청도 없었는데 AGENTS.md와 이를 가리키는 CLAUDE.md 심볼릭 링크를 만들어 줌.
다른 프로젝트에도 그런 링크는 없었음. Codex로 만든 프로젝트의 AGENTS.md를 보고 두 도구를 함께 쓴다고 추론해 양쪽을 챙겨 준 걸까? 아니면 최근 변경으로 기본 동작이 된 걸까? 놀라웠고, 앞으로도 표준을 지향해 주길 바람.
이제 에이전트가 자기 버그도 이해하는 것 같음. https://github.com/openai/codex/issues/9252에는 공감 표시 88개와 댓글에서 찾은 우회책인 Alt+R로 원시 모드 전환이 있음.
오늘 Codex 코드 블록의 두 칸 들여쓰기 때문에 여러 줄짜리 bash 명령을 붙여 넣으면 깨진다고 불평했더니, Codex가 이 우회책을 알려 줌.
그냥 프롬프트가 바뀐 것임.
조금 다른 얘기지만 skills.md, skill.md, skills.sh 도메인을 다들 어떻게 보는지 궁금함. 서로 다른 회사가 소유하고 있다는 게 영 찜찜함. Vercel은 그나마 덜 생뚱맞지만, AI 에이전트용 스킬을 만들고 찾는 방법을 안내하는 한곳으로 모여야 하는 것 아닌가?.
AI 자동 생성 콘텐츠
본 콘텐츠는 GeekNews의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기