MemoryLake
모든 글로 돌아가기
Tutorial2026년 8월 27일·11 분 소요

Claude 프로젝트가 RAG 모드로 전환된 후 작업하는 방법 (2026)

Claude 프로젝트에 작은 표시가 나타나지만 아무런 안내도 제공되지 않습니다. 답변은 여전히 잘 돌아옵니다. 깨진 것처럼 보이는 것도 없습니다. 하지만 Claude가 파일을 읽는 방식이 바뀌었으며, 이 변화는 이해할 가치가 있습니다. 이전에는 무의미했던 두 가지 조언이 이제는 매우 중요해졌기 때문입니다.

Anthropic의 문서에서는 이 전환을 정확하게 설명합니다. "프로젝트 지식이 컨텍스트 창 제한에 도달하면, Claude는 프로젝트 용량을 최대 10배까지 확장하면서도 고품질 답변을 유지하기 위해 RAG 모드를 자동으로 활성화합니다."

그리고 가장 중요한 메커니즘을 설명하는 문장은 다음과 같습니다. "모든 프로젝트 콘텐츠를 한 번에 메모리에 로드하는 대신, Claude는 질문에 답하는 데 필요한 가장 관련성 높은 정보만 지능적으로 검색하고 가져옵니다."

이전에는 업로드한 모든 내용이 존재했습니다. 이제는 올바른 구절을 찾아 가져옵니다. Anthropic은 답변 품질이 유지된다고 명시하고 있으며 이를 의심할 이유는 없습니다. 하지만 "모든 것이 존재함"과 "올바른 것을 찾아냄"은 실패하는 방식이 다르며, 그 차이는 전적으로 파일을 찾을 수 있는지 여부에 달려 있습니다. 이 글에서는 실제로 무엇이 바뀌는지, 어떻게 대처해야 하는지, 그리고 어느 쪽이든 프로젝트 지식에 여전히 담을 수 없는 것은 무엇인지 다룹니다.

RAG가 켜질 때 실제로 바뀌는 것

실제 존재하던 한계를 해결했으며, 이 부분은 명확합니다

프레이밍이 중요하므로 먼저 언급할 가치가 있습니다. 이전 동작에 대한 Anthropic 자체의 설명은 다음과 같습니다. "이전에는 프로젝트에 컨텍스트 창을 기반으로 한 지식 용량 제한이 있었습니다. 이 임계값에 도달하면 더 이상 콘텐츠를 추가할 수 없었습니다."

엄격한 중단이었습니다. 파일을 더 이상 추가할 수 없었습니다. RAG 모드는 이를 제거하여 용량을 최대 10배까지 늘려주며, Anthropic은 "원활한 전환: 필요할 때 자동 활성화, 설정 필요 없음"이라고 명시하고 있습니다.

따라서 이것은 피해야 할 성능 저하가 아닙니다. 한계가 해제된 것이며, 이 글의 나머지 부분은 이 모드를 피하는 방법이 아니라 이 모드와 함께 작업하는 방법에 대한 것입니다.

검색 단위가 "전체"에서 "관련 있는 부분"으로 변경됩니다

"프로젝트에 RAG가 활성화되면, Claude는 프로젝트 지식 검색 도구를 사용하여 업로드된 문서에서 관련 정보를 검색합니다."

실제로 일어나는 것을 볼 수 있습니다. Anthropic은 "업로드된 콘텐츠에서 관련 정보를 찾아야 할 때 Claude가 프로젝트 지식 검색 도구를 사용하는 것을 볼 수 있습니다"라고 언급합니다. 이는 웹 검색이 도구 호출로 표시되는 것과 같은 방식입니다.

실제적인 결과는 이제 사실이 단순히 업로드된 것만으로는 부족하고, 검색 가능해야 한다는 것입니다. 전체 컨텍스트 모드에서는 이름이 잘못 지정된 PDF의 40페이지에 묻혀 있는 세부 정보도 Claude가 항상 볼 수 있었습니다. 하지만 검색 모드에서는 선택될 수 있을 만큼 쿼리와 잘 일치해야 합니다.

Anthropic 자체의 모범 사례가 힌트입니다

RAG 문서의 네 가지 팁을 읽어보고 어떤 두 가지가 검색 모드에서만 의미가 있는지 확인해 보세요.

"명확하고 설명적인 파일 이름 사용" — 그 이유는 다음과 같습니다. "이름이 잘 지정된 파일은 Claude가 올바른 정보를 더 효과적으로 이해하고 검색하는 데 도움이 됩니다." 그리고 "특정 문서 참조": "특정 문서를 이름으로 참조하여 Claude가 검색에 집중하도록 도울 수 있습니다."

전체 컨텍스트 처리에서 파일 이름은 라벨일 뿐입니다. 질문에서 문서를 언급하는 것은 일종의 배려였습니다. 하지만 검색 모드에서는 둘 다 선택 단계의 입력값이 됩니다. Q3-pricing-decision-memo.pdfdoc_final_v3.pdf는 이제 더 이상 동일하지 않습니다.

다른 두 가지 팁인 "포괄적인 콘텐츠 업로드" 및 "관련 콘텐츠를 함께 정리"도 같은 방향을 가리킵니다. 검색은 흩어진 더미보다 일관된 코퍼스에서 더 잘 작동합니다.

사용자가 제어할 수 없으며, 다시 돌아갈 수도 있습니다

Anthropic은 이에 대해 직접적으로 밝히고 있습니다. "RAG 활성화는 프로젝트 지식의 크기에 따라 자동으로 처리됩니다. 가능한 경우, 프로젝트는 최적의 성능을 위해 인컨텍스트(in-context) 처리를 사용합니다."

그리고 이는 되돌릴 수 있습니다. "프로젝트 지식이 나중에 컨텍스트 창 임계값 아래로 떨어지면, Claude는 컨텍스트 기반 처리로 자동으로 다시 전환할 수 있습니다."

따라서 동일한 프로젝트라도 최근에 업로드한 양에 따라 두 모드 중 하나에 있을 수 있으며, 시각적 표시기만이 유일한 신호입니다. 두 달 전에 어떤 세부 정보에 대해 프로젝트가 더 날카롭게 느껴졌다면, 모델이 아니라 모드가 달랐을 수 있습니다.

알아두어야 할 문서상의 충돌 한 가지

두 개의 공식 페이지가 사용 가능 여부에 대해 서로 다르게 설명하고 있으므로, 하나만 믿기보다는 두 가지 해석이 모두 존재한다는 점을 알아두어야 합니다.

RAG 문서에서는 "프로젝트용 RAG는 모든 Claude 요금제(Free, Pro, Max, Team, Enterprise)에서 사용할 수 있습니다"라고 명시하고 있습니다. 반면 더 최근에 업데이트된 프로젝트 개요 문서에서는 "RAG를 통한 향상된 프로젝트 지식은 유료 Claude 요금제(Pro, Max, Team 또는 Enterprise)를 사용하는 사용자만 사용할 수 있습니다"라고 명시하고 있습니다.

더 새로운 페이지가 더 제한적입니다. 무료 계정을 사용 중이라면 유료 전용을 기본 가정으로 삼고 본인 프로젝트의 표시기를 통해 확인해 보세요. 무료 계정에는 별도로 문서화된 제한 사항도 있습니다. "무료 사용자는 최대 5개의 프로젝트를 생성할 수 있습니다."

사람들이 시도하는 것들

임계값 아래로 돌아가기 위해 파일 삭제하기. 이는 실제로 작동하며 모드가 다시 전환됩니다. 하지만 처리 모드를 바꾸기 위해 콘텐츠를 버리는 셈이 되므로 주객전도입니다.

동일한 문서를 반복해서 다시 업로드하기. 답변에서 무언가를 놓쳤을 때 흔히 하는 본능적인 행동이지만, 코퍼스에 거의 중복된 파일을 넣어 검색을 더 어렵게 만듭니다. 이러한 습관에 대한 일반적인 해결책은 how to stop re-uploading PDFs to Claude에서 확인할 수 있습니다.

하나의 프로젝트를 여러 개로 나누기. 때로는 올바른 방법일 수 있지만, 각 프로젝트는 자체 지식 베이스를 가진 독립된 메모리 공간이므로 컨텍스트가 서로 공유되지 않는다는 점을 기억해야 합니다. 경계를 만들어 용량 문제를 해결한 것에 불과합니다.

프로젝트 지침에 핵심 사실 붙여넣기. 지침은 항상 로드되므로 소수의 사실에 대해서는 실제로 효과가 있습니다. 하지만 확장성이 없으며, 지침은 콘텐츠를 저장하기보다는 행동을 규정하기 위한 것입니다.

품질이 떨어졌다고 가정하기. Anthropic은 명시적으로 그렇지 않다고 말합니다. "RAG는 더 큰 프로젝트 용량을 제공하면서도 인컨텍스트 처리와 일관된 답변 품질을 유지합니다." 특정 답변이 나빠졌다면 전반적인 성능 저하보다는 특정 사실을 찾을 수 없게 되었을 가능성이 더 높으며, 이는 해결 가능합니다.

검색을 메모리로 취급하기. 가장 본질적인 부분입니다. 검색은 업로드한 문서에서 구절을 찾는 것이지, 지난달 채팅에서 누군가 내린 결정을 기억하는 것이 아닙니다. 이 차이점은 why RAG isn't memory에서 다룹니다.

해결책: 파일을 찾을 수 있게 만들고, 결정 사항은 문서 더미에서 분리하기

두 가지 조치가 있으며, 첫 번째는 비용이 들지 않습니다.

검색을 위해 이름 바꾸기. 프로젝트 지식을 살펴보고 모든 파일 이름이 해당 문서가 결정하거나 포함하고 있는 내용을 나타내도록 만드세요. notes.md 대신 pricing-model-decision-2026-Q3.md로, spec_v2_final.pdf 대신 checkout-flow-spec-post-legal-review.pdf로 변경하세요. 이는 Anthropic이 직접 권장하는 첫 번째 사항이며, 대부분의 프로젝트에서 20분 정도면 충분합니다.

그런 다음 정확성이 중요한 질문에서는 문서 이름을 언급하세요. 특정 문서를 이름으로 참조하면 Claude가 검색에 집중하는 데 도움이 된다는 Anthropic의 가이드는 이제 단순한 배려가 아니라 실질적인 해결책이 됩니다.

그 다음, 한 곳에 저장해 온 두 가지 종류의 지식을 분리하세요. 프로젝트 지식은 문서입니다. 이는 "사양서에 무엇이라고 적혀 있는가"에는 매우 유용하지만, 구조적으로 "우리가 왜 그렇게 결정했는가"를 처리하도록 설계되지 않았습니다. 대화 중에 도달한 결정, 누군가 한 번 언급한 제약 조건, 아무도 기록하지 않은 이유로 거부된 접근 방식 등은 문서가 아니므로 파일 이름을 어떻게 지정하든 검색할 수 없습니다. 그럼에도 모든 프로젝트에는 이러한 정보가 쌓이기 마련이며, 이 때문에 단 세 문장만을 담기 위해 존재하는 회의록과 녹취록으로 용량이 가득 차게 됩니다.

바로 이 부분을 MemoryLake가 해결합니다. 도구가 쿼리하는 레이어에 프로젝트의 영구적인 사실을 보관하므로 문서 더미는 문서로만 유지될 수 있습니다. 설정은 세 단계로 진행됩니다.

1단계: API 키 생성

로그인하고 API 키를 생성합니다. 연결하는 도구 전반에서 하나의 자격 증명으로 사용됩니다.

MemoryLake API 키 생성하기
MemoryLake API 키 생성하기

2단계: 첫 번째 메모리 업로드

각각 하나의 사실을 담은 짧은 항목들입니다. 단 한 문장을 저장하기 위해 업로드했던 파일들이 가장 좋은 대상입니다:

MemoryLake 워크스페이스에 첫 번째 메모리 업로드하기
MemoryLake 워크스페이스에 첫 번째 메모리 업로드하기

이유가 포함된 결정 사항. "월간 이탈률이 4배 더 높았기 때문에 연간 결제를 청구합니다." 현재 40페이지짜리 발표 자료에 묻혀 있는, 영구적으로 유용한 한 줄짜리 정보입니다.

대화에서 비롯된 제약 조건. 법적 검토 결과, 통화 중에 누군가 언급한 공급업체 제한, 변경된 마감일 등입니다.

이미 거부된 접근 방식과 그 이유. 어떤 문서에도 포함되어 있지 않아 새로운 세션마다 계속 다시 제안되는 범주입니다.

팀원들이 논쟁하는 정의. 활성 사용자의 기준이 무엇인지, 계약 시작일이 언제인지 등입니다. 이러한 사항들은 누구의 파일에도 명확히 적혀 있지 않기 때문에 계속해서 다시 논쟁거리가 됩니다.

3단계: AI 및 에이전트 연결

MemoryLake는 MCP 및 API를 통해 접근할 수 있으므로, Claude, Claude Code, Codex, OpenClaw를 포함한 MCP 네이티브 에이전트는 MCP 서버를 가리켜 연결하고, 다른 어시스턴트는 API를 통해 동일한 메모리를 읽습니다. 즉, "우리가 무엇을 결정했는가"에 대한 답변이 검색 단계에서 녹취록이 우연히 선택되었는지 여부에 좌우되지 않습니다.

MCP 및 API를 통해 AI 어시스턴트 및 에이전트를 MemoryLake에 연결하기
MCP 및 API를 통해 AI 어시스턴트 및 에이전트를 MemoryLake에 연결하기

세 가지 명확한 한계가 있습니다. MemoryLake는 Claude 프로젝트 지식을 읽거나 쓰거나 대체하지 않습니다. 업로드, RAG 표시기, 모드 전환은 모두 Anthropic의 영역이며 Claude 외부의 어떤 것도 이에 영향을 미치지 않습니다. 사용자가 직접 또는 에이전트가 입력한 내용만 보관하므로 2단계는 수동으로 진행됩니다. 또한 용량이나 임계값을 변경하지 않습니다. 다른 도구를 실행하든 상관없이 프로젝트 지식은 문서화된 대로 정확하게 작동합니다.

실제 업무에서 바뀌는 점

파일 이름이 실질적인 기능을 하게 됩니다. 파일 이름은 단순한 라벨이 아니라 검색의 입력값이 됩니다.

질문에서 문서 이름을 언급하는 것이 실질적인 해결책이 됩니다. Anthropic이 바로 이 이유 때문에 이를 권장합니다.

이전의 엄격한 한계가 사라집니다. 이전에는 불가능했던 시점 이후에도 콘텐츠를 계속 추가할 수 있습니다.

모드는 사용자가 선택할 수 없습니다. 양방향 모두 자동으로 전환되며, 표시기만이 유일한 신호입니다.

중복 업로드가 실질적인 해를 끼치게 됩니다. 거의 동일한 중복 파일들이 동일한 검색 과정에서 서로 경쟁하게 됩니다.

문서와 결정 사항이 더 이상 같은 컨테이너를 공유하지 않습니다. 이는 프로젝트 지식이 세 문장짜리 녹취록으로 가득 차는 것을 방지하는 방법이기도 합니다. 자세한 형태는 how to turn project docs into AI memory에서 다룹니다.

RAG가 활성화된 Claude 프로젝트를 위한 모범 사례

모든 파일의 이름을 해당 파일이 결정하거나 포함하는 내용을 설명하도록 변경하세요. Anthropic의 첫 번째 권장 사항이며, 노력 대비 가장 큰 효과를 얻을 수 있습니다.

정확성이 중요할 때는 문서를 이름으로 참조하세요. 검색 범위를 좁혀줍니다.

일관된 작업 단위당 하나의 프로젝트를 유지하세요. 검색은 혼합된 더미보다 관련된 콘텐츠 전반에서 더 잘 작동합니다.

RAG 모드를 피하기 위해 콘텐츠를 삭제하지 마세요. 처리 방식에 대한 선호도를 위해 용량을 희생하는 셈입니다.

업로드하기 전에 중복을 제거하세요. 동일한 문서의 두 버전은 신호를 분산시킵니다.

성능 저하를 진단하기 전에 표시기를 확인하세요. 모드는 양방향으로 변경되며, 이는 "이전에는 이걸 알고 있었는데"라는 문제 보고의 가장 큰 원인입니다.

단일 사실은 파일이 아닌 지침에 넣으세요. 프로젝트 지침은 항상 로드됩니다. 한 문장만 담고 있는 한 페이지짜리 PDF는 코퍼스에 포함될 가치가 없습니다.

결정 사항과 그 이유는 문서 더미 외부에 보관하세요. 이들은 문서가 아니므로 검색으로 찾을 수 없으며, 사람들이 실제로 묻는 내용이기도 합니다. 또한 각 프로젝트는 고유한 독립된 지식 및 메모리 공간을 가지고 있으며, 이 경계는 ChatGPT의 사례를 통해 ChatGPT projects don't share memory에서 설명되어 있습니다.

결론

Claude 프로젝트의 RAG 모드는 성능 저하가 아니라 한계가 해제된 것입니다. 이전에는 프로젝트 지식에 엄격한 용량 제한이 있어 더 이상 추가할 수 없었지만, 이제는 Claude가 자동으로 전환하여 용량을 최대 10배까지 확장하며, Anthropic은 답변 품질이 유지된다고 명확히 밝히고 있습니다. 설정할 것도, 켤 것도 없습니다.

바뀌는 것은 읽기 모드입니다. 모든 프로젝트 콘텐츠가 한 번에 존재하는 대신, Claude는 "가장 관련성 높은 정보만 지능적으로 검색하고 가져옵니다." 이것이 바로 Anthropic의 모범 사례 목록에 설명적인 파일 이름과 질문에서 문서 이름 언급하기가 갑자기 포함된 이유입니다. 모든 것이 로드되던 시절에는 무의미했던 두 가지가 이제는 중요한 해결책이 되었습니다. 사용자는 이 전환을 제어할 수 없으며, 지식이 임계값 아래로 떨어지면 다시 되돌아갑니다. 유일한 신호는 작은 표시기뿐입니다. 또한 두 공식 페이지가 무료 계정의 지원 여부에 대해 서로 다르게 설명하고 있으며, 더 새로운 페이지에서는 유료 요금제 전용이라고 명시하고 있다는 점에 유의하세요.

그러니 20분 정도 시간을 내어 파일 이름을 변경하고, 정확성이 중요할 때 문서 이름을 언급하고, 중복을 제거하고, Claude가 나빠졌다고 결론 내리기 전에 표시기를 확인하세요. 그런 다음 애초에 문서가 아니었던 것들 — 결정 사항, 제약 조건, 이유, 정의 — 을 문서 더미에서 꺼내 직접 물어볼 수 있는 곳으로 옮기세요. 이제는 검색 가능 여부가 핵심이며, 아무도 기록하지 않은 결정 사항은 어떤 용량에서도 찾을 수 없습니다.

자주 묻는 질문

내 Claude 프로젝트에 RAG가 활성화되었다는 것은 무엇을 의미하나요?

프로젝트 지식이 컨텍스트 창 제한에 도달하여 Claude가 검색 모드로 전환되었음을 의미합니다. 모든 프로젝트 콘텐츠를 한 번에 로드하는 대신, Claude는 프로젝트 지식 검색 도구를 사용하여 각 질문에 가장 관련성 높은 정보를 가져옵니다. 용량이 최대 10배까지 확장되며, 설정 없이 자동으로 활성화되고, 프로젝트에 RAG가 활성화되었음을 나타내는 시각적 표시기가 나타납니다.

RAG 모드가 Claude의 답변 품질을 떨어뜨리나요?

Anthropic은 그렇지 않다고 말합니다. "RAG는 더 큰 프로젝트 용량을 제공하면서도 인컨텍스트 처리와 일관된 답변 품질을 유지합니다." 특정 답변의 정확도가 떨어졌다면, 특정 사실을 검색하기가 더 어려워졌을 가능성이 높습니다. 파일 이름을 설명적으로 변경하고 문서를 이름으로 참조하면 이 문제를 직접 해결할 수 있습니다.

내 프로젝트에서 RAG 모드를 끌 수 있나요?

아니요. Anthropic은 "RAG 활성화는 프로젝트 지식의 크기에 따라 자동으로 처리됩니다"라고 명시하고 있으며, 가능한 경우 프로젝트는 인컨텍스트 처리를 사용합니다. 또한 자동으로 되돌아가기도 합니다. 프로젝트 지식이 나중에 컨텍스트 창 임계값 아래로 떨어지면 Claude는 컨텍스트 기반 처리로 다시 전환할 수 있습니다.

무료 Claude 계정에서도 프로젝트용 RAG를 사용할 수 있나요?

문서마다 설명이 다릅니다. RAG 문서에서는 "모든 Claude 요금제(Free, Pro, Max, Team, Enterprise)에서 사용할 수 있습니다"라고 하는 반면, 더 최근에 업데이트된 프로젝트 개요에서는 "RAG를 통한 향상된 프로젝트 지식은 유료 Claude 요금제(Pro, Max, Team 또는 Enterprise)를 사용하는 사용자만 사용할 수 있습니다"라고 명시하고 있습니다. 유료 전용을 더 안전한 가정으로 삼고 본인 프로젝트의 표시기를 확인해 보세요. 무료 계정은 최대 5개의 프로젝트를 생성할 수 있습니다.

Anthropic이 이제 와서 설명적인 파일 이름을 권장하는 이유는 무엇인가요?

파일 이름이 검색 단계에 영향을 미치기 때문입니다. 문서에서는 "이름이 잘 지정된 파일은 Claude가 올바른 정보를 더 효과적으로 이해하고 검색하는 데 도움이 됩니다"라고 명시하고 있으며, 별도로 "특정 문서를 이름으로 참조하여 Claude가 검색에 집중하도록 도울 수 있습니다"라고 설명합니다. 모든 콘텐츠가 컨텍스트에 로드되던 시절에는 둘 다 크게 중요하지 않았지만, 검색 모드에서는 둘 다 어떤 정보가 선택될지에 영향을 미칩니다.

큰 프로젝트를 여러 개의 작은 프로젝트로 나누어야 하나요?

콘텐츠가 실제로 명확히 구분되는 경우에만 그렇게 하세요. 각 Claude 프로젝트는 자체 채팅 기록과 지식 베이스를 가진 독립된 워크스페이스이며, 프로젝트 간에 컨텍스트가 공유되지 않습니다. 따라서 분할은 장벽을 만들어 용량 문제를 해결하는 것에 불과합니다. RAG가 이미 기존의 엄격한 제한을 제거했으므로, 크기만을 이유로 분할하는 것은 경계를 만드는 단점에 비해 실익이 적습니다. 단일 프로젝트에서 지식이 누락되는 관련 증상은 why Claude forgets project knowledge files에서 다룹니다.