Claude Code가 AGENTS.md를 읽지만, 개인 파일을 추가하면 이를 비활성화할 수 있음

v2.1.277 (9월 18일) 이후로 Claude Code는 프로젝트 지침으로 AGENTS.md를 사용할 수 있게 되어, Codex나 Cursor용으로 설정된 리포지토리도 CLAUDE.md 없이 작동합니다. 좋은 변화입니다. 다만, 실제로 어떤 파일이 읽히는지에 대한 기본 규칙을 아는 것이 중요합니다. 그중 몇 가지는 조용히 실패하기 때문입니다.

Claude Code 문서에 따르면, 기본적으로 다음과 같습니다: 프로젝트 리포지토리는 작업 디렉토리 또는 그 상위 경로 어디에도 CLAUDE.md가 없는 경우 AGENTS.md를 읽습니다.

• AGENTS.md만 있는 경우
• CLAUDE.md와 AGENTS.md 둘 다 있는 경우
• u/AGENTS .md를 가져오는 CLAUDE.md
• 둘 다, import를 통해 가져오는 경우

주의할 점은 다음과 같습니다: CLAUDE.local.md는 해당 확인에서 CLAUDE.md로 간주됩니다. 따라서 AGENTS.md에 의존하는 팀 리포지토리에 몇 가지 개인적이고 커밋되지 않은 메모를 보관하기 위해 CLAUDE.local.md를 추가하면, Claude가 당신을 위해 AGENTS.md 읽기를 중단합니다. 하지만 팀의 다른 멤버들은 여전히 그것을 받습니다. 당신만 안 되고 오류는 발생하지 않습니다.

같은 페이지에서 가져온 몇 가지 세부 정보: AGENTS.md와 함께 로드되지만 카운트되지 않는 파일은 다음과 같습니다: ~/.claude/CLAUDE.md, 조직 관리 CLAUDE.md, 그리고 .claude/rules/ 파일입니다. 절대 읽지 않는 파일은 AGENTS.local.md, AGENTS.override.md, 또는 .agents/ 디렉토리 아래의 어떤 것도 아닙니다. 팀의 다른 도구가 이들을 사용하는 경우, Claude는 이를 볼 수 없습니다.

대화형 세션에서는 어느 것이 로드되었는지 알 수 있습니다. AGENTS.md가 사용되면

한 어시스턴트에서 저장한 지침은 다음 어시스턴트로 이어지지 않습니다. 이것이 제가 직접 만든 확장 프로그램인 AI Toolbox에 프롬프트를 보관하는 주된 이유입니다. 동일하게 저장된 프롬프트는 ChatGPT, Claude, Gemini, Grok 모두에서 작동하므로 도구를 전환한다고 해서 다시 작성할 필요가 없습니다. submitted by /u/Ok_Negotiation_2587 [link] [comments]