클로드 코드 에이전트는 프로젝트 문서를 자동으로 읽지 않습니다.
Claude Code 에이전트가 프로젝트 문서를 처리하는 방식
Claude Code의 에이전트 시스템을 사용할 때, 개발자는 하위 에이전트가 프로젝트 문서에 접근하는 방식에 특정 제한이 있음을 인지해야 합니다. r/ClaudeAI의 사용자 보고서에 따르면, Claude Code가 코딩 작업을 처리하기 위해 에이전트를 파견할 때, 해당 에이전트들은 제한된 컨텍스트로 작동합니다.
출처의 주요 세부사항
이 문제는 에이전트가 문서화된 함정을 반복적으로 맞닥뜨리는 디버깅 세션 중에 발견되었습니다. 문서화된 경고를 무시한 이유를 묻자, 에이전트는 다음과 같이 답변했습니다: "콜백을 작성하기 전에 CLAUDE.md를 읽지 않았습니다. 탐색 단계에서 코드베이스 패턴을 프롬프트 컨텍스트로 가지고 있었지만, OAuth 경로를 작성하기 위해 Sonnet 에이전트를 파견했을 때, 에이전트 프롬프트는 무엇을 구축할지 설명했지, 어떤 함정을 확인해야 하는지는 설명하지 않았습니다."
에이전트는 추가로 설명했습니다: "Sonnet 하위 에이전트들은 제가 그들의 프롬프트에 넣은 내용만 볼 수 있습니다. 제가 명시적으로 지시하지 않는 한, 그들은 자동으로 CLAUDE.md, MEMORY.md 또는 어떤 프로젝트 컨텍스트도 읽지 않습니다."
실제적 영향
- Sonnet과 같은 하위 에이전트들은 특정 프롬프트에 제공된 컨텍스트로만 작동합니다
- 프로젝트 문서 파일(CLAUDE.md, MEMORY.md)은 자동으로 로드되지 않습니다
- 명시적으로 지시하지 않는 한, 에이전트들은 기존 함정 목록을 참조하지 않고 처음부터 코드를 작성합니다
- 이는 에이전트들이 피할 수 있었던 문서화된 문제를 반복하게 할 수 있습니다
이러한 동작은 개발자들이 특정 코딩 작업을 처리하기 위해 에이전트를 파견할 때 문서 참조를 포함시키는 것에 명시적이어야 함을 의미합니다. 에이전트들은 탐색 단계의 코드베이스 패턴을 유지하지만, 프로젝트별 문서 파일을 자동으로 참조하지는 않습니다.
📖 전체 출처 읽기: r/ClaudeAI
👀 See Also
생각 구조 시각화를 위한 Claude 프롬프트: 의도, 현실, 격차
레딧 사용자가 Claude에게 대화의 구조적 패턴을 인식하고 반영하도록 요청하는 100단어 프롬프트를 공유했습니다. 이는 내용 자체가 아닌 의도(원하는 것), 현실(존재하는 것), 격차(해결되지 않은 것)로 분류된 패턴을 다룹니다.
클로드 모바일 앱 마이크 피드백 루프 오류 해결 방법
레딧 사용자가 Claude 모바일 앱의 마이크 피드백 루프 오류에 대한 작동하는 해결책을 공유했습니다: Google Chrome을 통해 웹 버전을 독립형 프로그레시브 웹 앱으로 설치하는 방법으로, 이 문제를 우회하고 다양한 Claude 모델에 접근할 수 있습니다.
클로드 코드의 결함 있는 가정을 검증하고 우회 방법을 제시하는 경향
한 개발자가 Claude Code가 잘못된 가정에 대해 의문을 제기하지 않고 결함이 있는 아키텍처를 열정적으로 구현하여 디버깅 시간을 낭비하게 한다고 보고했습니다. 해결책은 복잡한 요청에 '내가 틀릴 수도 있다고 가정하세요'를 명시적으로 추가하는 것입니다.
클로드 코드: 프롬프트 엔지니어링보다 컨텍스트 관리
한 개발자가 Claude Code를 1년간 사용한 후 깨달은 핵심 기술은 프롬프트 작성법이나 모델 선택이 아니라, 더 나은 결과를 얻기 위해 사전에 포괄적인 프로젝트 컨텍스트를 제공하는 것이라고 밝혔습니다.