클로드 코드가 사용 기록 수집 기능이 켜져 있을 때만 AGENTS.md 파일을 읽습니다
1. 이게 뭔가요?
인공지능 보조 도구인 클로드 코드(Claude Code)의 특정 버전에서 프로젝트 지침을 담은 파일인 AGENTS.md를 읽어들이는 기능이, 사용 기록 수집 기능이나 외부 통신 기능이 켜져 있을 때만 작동하는 문제를 다룹니다. 프로그램은 사용자가 개인정보 보호를 위해 사용 기록 수집이나 부가 통신을 차단하면 내 컴퓨터에 있는 파일을 읽는 기능까지 함께 차단하는데, 사용자는 이 사실을 전혀 안내받지 못합니다.
2. 왜 화제인가요?
이 문제가 주목받는 이유는 사용자가 개인정보 보호를 위해 관련 기능을 꺼두었을 때 외부 서버와 상관없이 내 컴퓨터에 저장된 로컬 파일 읽기 기능까지 조용히 작동하지 않기 때문입니다. 파일을 읽지 못해도 아무런 경고 메시지가 나오지 않아 사용자는 인공지능이 지시사항을 무시한다고 오해하고 엉뚱한 부분을 수정하며 시간을 낭비하게 됩니다.
3. 핵심 내용
클로드 코드 버전 2.1.277은 AGENTS.md 파일 지원 기능을 추가했지만, 이 기능을 불러오는 장치는 원격 서버의 설정 확인 기능 뒤에 숨겨져 있습니다. 사용 현황 데이터 수집 기능인 원격 측정이나 부가 통신을 꺼두면 경고 메시지 없이 컴퓨터에 있는 AGENTS.md 파일을 건너뛰게 됩니다. 필자가 직접 실험해 본 결과 이러한 환경 변수들이 켜져 있으면 파일이 절대 로드되지 않았으며, 프로젝트 설정 파일에서 이를 해결할 방법도 없었습니다. 이에 대한 임시 우회 방법으로 파일 바로 옆에 한 줄짜리 CLAUDE.md 파일을 두어 다른 경로의 파일을 불러오는 기능을 사용하면 원격 측정이 꺼진 상태에서도 파일을 불러올 수 있습니다.
4. 나에게 어떤 영향이 있나요?
개인정보 보호나 보안상의 이유로 프로그램의 사용 기록 수집이나 부가적인 데이터 전송을 차단해 온 개발자는 자신도 모르게 새로운 지시사항 파일 기능이 작동하지 않는 상황을 겪을 수 있습니다. 경고가 전혀 나오지 않기 때문에 사용자는 파일이 읽히지 않는 이유를 스스로 프로그램 내부 코드를 분석하거나 실험을 통해 직접 찾아내야 합니다. 이 글은 원본 파일 대신 다른 설정 파일을 이용해 연결 코드를 넣는 임시 해결책을 제시하며, 프로그램이 로컬 파일을 읽을 때 불필요한 서버 확인 과정을 거치지 않아야 한다는 점을 지적합니다.