에이전트를 실제로 제어하는 AGENTS.md 및 CLAUDE.md 작성법
요약
AGENTS.md와 CLAUDE.md를 활용하여 AI 에이전트의 동작을 제어하는 온보딩 문서 작성법을 설명합니다. 에이전트가 컨텍스트로 참조하는 이 파일들을 통해 명령, 아키텍처 맵, 명확한 규칙을 효율적으로 전달하는 것이 핵심입니다.
핵심 포인트
- AGENTS.md와 CLAUDE.md는 에이전트의 컨텍스트를 결정하는 온보딩 문서임
- Claude Code는 CLAUDE.md를 읽으며 AGENTS.md를 임포트하는 방식 권장
- 토큰 비용 절감을 위해 포괄적인 내용보다 간결하고 명확한 규칙 위주로 작성
- 문서를 살아있는 코드처럼 취급하며 에이전트의 행동에 따라 지속적으로 업데이트
원문은 AI Tech Connect에 게시되었습니다.
알아야 할 사항: 이 파일들은 에이전트의 온보딩 문서 (onboarding doc)입니다. AGENTS.md, CLAUDE.md, .cursor/rules 및 Copilot 지침은 자동으로 읽혀 모델의 컨텍스트 (context) 앞에 추가되므로, 에이전트가 수행하는 모든 편집 작업의 형태를 결정합니다. AGENTS.md는 휴대 가능한 표준이 되어가고 있습니다. 2026년 6월 기준으로 점점 더 많은 에이전트가 루트 레벨 (root-level)의 AGENTS.md를 읽고 있습니다. Claude Code는 AGENTS.md 대신 CLAUDE.md를 읽으며, 해당 메모리 문서 (memory docs)는 두 파일이 하나의 소스를 공유할 수 있도록 AGENTS.md를 임포트 (import)하는 CLAUDE.md를 권장합니다. 포괄적인 것보다 간결한 것이 승리합니다. 모든 라인은 매 턴 (turn)마다 토큰 (tokens) 비용을 발생시킵니다. 명령, 아키텍처 맵 (architecture map), 그리고 명확하지 않은 규칙들을 넣으세요. 다시 언급할 필요가 있는 당연한 조언은 제외하십시오. 이를 살아있는 코드 (living code)처럼 취급하세요. 규칙이 있을 때와 없을 때 작업을 실행하여 변경 사항을 테스트하고, 에이전트가 잘못 행동하면 수정하며, 중첩된 파일들을 작게 유지하세요...
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기