텔레메트리를 껐는데 지침도 빠진다면: AI 코딩 도구의 설정 신뢰

핵심 요약

• Claude Code의 텔레메트리 설정과 AGENTS.md 로딩 오류가 연결됐다는 주장이 있지만, 발생 조건과 수정 여부는 확인이 필요합니다.
• 사용 통계를 보내는 기능과 프로젝트 지침을 읽는 기능은 목적이 다릅니다.
• AI가 지침을 어겼다는 결과만으로 지침 파일을 읽지 못했다고 단정할 수는 없습니다.
• 설정을 믿고 쓰려면 사용자가 어떤 지침을 불러왔는지 확인할 수 있어야 합니다.

Claude Code에서 텔레메트리를 끄면 AGENTS.md를 읽지 못했고 이후 수정됐다는 주장이 있습니다. 사용 통계를 보내지 않으려던 설정이 프로젝트의 작업 규칙을 읽는 데까지 영향을 줬다는 이야기입니다. 다만 어떤 조건에서 발생했고 어느 버전에서 수정됐는지는 불명확하므로, 확인된 수정 소식으로 단정해서는 안 됩니다.

사용 통계와 작업 지침은 목적이 다릅니다

텔레메트리는 프로그램의 사용 현황이나 오류 같은 운영 정보를 수집하고 전송하는 기능입니다. 실제로 어떤 정보를 다루는지는 제품과 설정에 따라 달라집니다. 사용자는 대개 외부로 보내는 정보를 줄이려고 이 기능을 끕니다.

AGENTS.md는 AI 코딩 도구에 프로젝트의 작업 규칙을 전달할 때 쓰는 파일입니다. 예를 들어 “변경 후 테스트를 실행하세요”나 “기존 코드 스타일을 유지하세요” 같은 내용을 담을 수 있습니다. 다만 파일이 있다고 모든 도구가 자동으로 읽지는 않습니다. 해당 도구가 이 파일을 지원하는지, 어떤 방식으로 지침을 불러오는지부터 살펴봐야 합니다.

사용 통계를 보내는 일과 프로젝트 규칙을 읽는 일은 목적이 다릅니다. 사용 통계를 보내지 않겠다고 설정했다고 해서 프로젝트 규칙까지 읽지 않을 이유는 없습니다. 실제로 그런 일이 생겼다면, 사용자가 기대한 설정의 효과와 도구의 동작이 어긋난 것입니다.

규칙을 어겼다고 파일을 못 읽은 것은 아닙니다

지침 문제를 살펴볼 때는 파일을 읽었는지와 읽은 내용을 따랐는지를 나눠 봐야 합니다. 지침 로딩과 지침 준수는 별도로 확인할 문제입니다.

가령 프로젝트 지침에 테스트를 실행하라고 적었는데 AI가 테스트 없이 작업을 마쳤다고 해보겠습니다. 파일을 읽지 못했을 수도 있습니다. 파일은 읽었지만 다른 지침과 충돌했거나, 작업 도중 요구 사항을 놓쳤을 수도 있습니다. 결과만 보고 원인을 하나로 단정하면 엉뚱한 설정을 고치게 됩니다.

그래서 AGENTS.md 관련 오류를 살펴보려면 해당 환경에서 파일을 어떻게 읽도록 설정했는지부터 알아야 합니다. 도구가 직접 읽을 수도 있고, 다른 지침을 통해 참조할 수도 있습니다. 별도 연동을 거치는 경우도 있으므로, 읽는 방식에 따라 확인할 부분이 달라집니다.

텔레메트리를 끈 상태에서 지침을 어겼다고 해서 둘 사이에 인과관계가 있다고 볼 수는 없습니다. 같은 프로젝트와 실행 조건에서 설정만 바꿨을 때, 파일 로딩 자체가 달라지는지를 확인해야 합니다.

‘수정 완료’라면 실제 동작도 확인할 수 있어야 합니다

이런 오류를 두고 “수정됐다”고 하려면 무엇을 고쳤는지 구체적으로 설명해야 합니다. 문제가 생긴 조건과 수정 버전이 명확해야 하고, 변경 후 어떤 동작이 정상으로 돌아왔는지도 알 수 있어야 합니다. 그래야 사용자도 자기 환경에 해당하는 문제인지 판단할 수 있습니다.

이를 확인하는 데 필요한 기능은 복잡하지 않습니다. 현재 세션에서 읽은 지침 파일을 보여주고, 읽지 못했다면 이유를 알려주면 됩니다. 여러 지침을 함께 적용한다면 적용 순서도 확인할 수 있어야 합니다. AI에게 “규칙을 읽었나요?”라고 물어 얻는 답변보다 도구가 직접 보여주는 로딩 기록이 더 명확한 근거가 됩니다.

파일을 정상적으로 읽었다고 AI가 모든 규칙을 반드시 지키는 것은 아닙니다. 그래도 파일을 읽었는지 알 수 있으면 원인을 찾을 범위가 좁아집니다. 파일을 못 찾은 것인지, 읽고도 지침대로 실행하지 않은 것인지부터 구분할 수 있기 때문입니다.

사용자는 AI 코딩 도구가 자신이 선택한 설정대로 작동하리라 기대합니다. 이번 주장이 사실인지와 별개로, 도구를 평가할 때는 코드 생성 능력과 함께 설정이 어떻게 적용됐는지 보여주는 능력도 살펴봐야 합니다. 지금 쓰는 도구에서 어떤 프로젝트 지침을 읽었는지 확인할 수 있는지가 그 기준 중 하나입니다.