앤스로픽, 클로드 코드에 AGENTS.md 공식 지원 추가

앤스로픽이 결국 표준을 받아들였다

클로드 코드(Claude Code)에 AGENTS.md 네이티브 지원이 추가됐다. 해커뉴스와 레딧에서 1.5시간 전 처음 언급됐고, 양쪽 반응은 합쳐서 댓글 2개에 그쳤다. 화제성은 낮지만 의미는 작지 않다.

AGENTS.md는 AI 에이전트에게 어떤 파일을 읽고, 어떤 명령어를 쓰고, 어떻게 테스트할지를 알려주는 설정 파일이다. 지금까지 클로드 코드는 이 파일을 공식 지원하지 않았다. 개발자가 심볼릭 링크(symlink)로 억지로 연결해 쓰던 방식이 정식 기능이 된 셈이다.

왜 지금인가

해커뉴스 댓글은 시점을 짚는다. **"쇼핑파이 CEO 트윗과 아스트라(Astra)가 코덱스(Codex)로 대규모 이동을 일으킨 뒤에야 앤스로픽이 양보했다"**는 지적이다. 쇼핑파이(Shopify) CEO 토비 뤼트케가 공개적으로 코덱스를 칭찬했고, 아스트라라는 도구가 개발자들을 코덱스로 끌어당겼다는 이야기다.

앤스로픽은 그동안 독자 노선을 고수했다. 클로드 코드만의 설정 방식(CLAUDE.md 등)을 밀었다. 그런데 경쟁사가 표준을 선점하자 따라가는 쪽을 택했다. 한 댓글러는 "몇 달 뒤면 다들 잊을 테니 결국 이득일 수도 있다"고 냉소했다.

한국 개발자가 당장 확인할 것

클로드 코드는 맥·리눅스·윈도(WSL)에서 작동한다. 한국어 인터페이스는 없다. 터미널에서 claude 명령어를 치면 영문 프롬프트가 뜬다.

AGENTS.md를 쓰려면 프로젝트 루트에 파일을 만들면 된다. 예시 구조는 이렇다.

# AGENTS.md
## 빌드 명령어
- npm run build
## 테스트 명령어
- npm test
## 린트 명령어
- npm run lint

클로드 코드가 이 파일을 읽고 자동으로 빌드·테스트·린트를 수행한다. 별도 스크립트 없이 에이전트가 프로젝트 규칙을 따른다.

무료 티어는 일일 메시지 제한이 있다. 정확한 수치는 공개되지 않았다. 프로 플랜(월 20달러)부터 제한이 풀린다. 한국 카드 결제 가능하다.

쉽게 풀어보면

앤스로픽이 클로드 코드에 AGENTS.md 지원을 추가했습니다. 클로드 코드는 터미널에서 돌아가는 AI 코딩 도우미입니다. 이전까지는 이 도우미에게 "이 프로젝트에서는 이렇게 빌드하고 저렇게 테스트해"라는 규칙을 알려주려면 편법을 써야 했습니다. 이제는 프로젝트 폴더에 AGENTS.md 파일 하나만 두면 클로드 코드가 알아서 규칙을 읽고 따릅니다.

비유하자면 새 알바생에게 인수인계 문서 한 장을 건네는 일과 같습니다. 문서가 없으면 알바생이 매번 묻거나 실수합니다. 문서가 있으면 말하지 않아도 척척 진행합니다. 클로드 코드도 마찬가지입니다.

경쟁 도구인 **코덱스(Codex)**가 먼저 이 방식을 밀었고, 쇼핑파이 같은 큰 회사 CTO가 공개 추천하면서 개발자들이 몰렸습니다. 앤스로픽은 뒤늦게 "우리도 할게"라고 따라온 셈입니다. 한국에서 쓰려면 터미널을 열 줄 알아야 하고, 메뉴는 전부 영어입니다. 무료로도 쓸 수 있지만 하루 제한이 있고, 월 20달러 프로 플랜을 쓰면 제한이 사라집니다.

나에게 미치는 영향

오늘 바로 해볼 수 있는 것: 깃허브에 있는 본인 프로젝트 루트에 AGENTS.md를 만들어 넣으세요. 빌드·테스트·린트 명령어 세 줄만 적으면 됩니다. 클로드 코드 최신 버전(claude update로 갱신)에서 claude를 켜고 "테스트 돌려줘"라고 말하면 AGENTS.md에 적힌 대로 실행합니다.

주의할 점:

한국어 문서화는 거의 없다. 영문 위키·깃허브 이슈를 읽어야 한다
무료 티어 하루 제한에 걸리면 그날은 더 못 쓴다. 프로 플랜(월 20달러)이 실질적 무제한
윈도우라면 WSL2(우분투) 설치가 필수다. 네이티브 윈도우 지원은 아직 불안정하다

기존 도구와 비교: 커서(Cursor)나 윈드서프(Windsurf) 같은 IDE 내장형과 달리, 클로드 코드는 터미널 기반이라 기존 워크플로(깃, 도커, CI/CD)에 끼워 넣기 쉽다. 단, GUI 편집기처럼 마우스로 클릭하며 쓰는 맛은 없다.

남은 건 검증

앤스로픽 공식 블로그·문서·트위터 어디에도 공식 발표문은 없다. 해커뉴스·레딧 커뮤니티 발굴이 전부다. 출시 버전 번호, 적용 날짜, 마이그레이션 가이드 모두 아직 공개되지 않았습니다.

이번에도 사후 대응 성격이 강하다. 본지가 7일 전 다룬 이란 해커가 클로드로 미 군함 표적 분석… Anthropic "차단했다"지만 사후 대응 그쳐 기사에서 보듯, 앤스로픽은 사건이 터진 뒤 조치하는 패턴을 반복해 왔다. 이번에도 경쟁사가 선점한 표준을 뒤따라 수용했다.

개발자 입장에선 표준화가 반갑다. AGENTS.md 하나면 도구 바꿔도 설정 재사용 가능하다. 하지만 문서화 부재·한국어 지원 부재·공식 채널 침묵은 여전히 걸림돌이다. 앤스로픽이 "드디어"가 아니라 "미리" 움직이는 모습을 보여주길 기다린다.