CLAUDE.md 에 import 문법 질문

작성한 질문수 4

1

안녕하세요! 🙂

좋은 포인트 짚어주셨어요. 결론부터 말씀드리면, 강의에서 안내드린 "CLAUDE.md 200줄 이하" 가이드는 그대로 지키시는 게 맞습니다. 다만 한 단계 더 들어가시면, import로 가져온 파일도 결국 세션 시작 시 함께 로드되긴 해요.

공식 docs에도 명시되어 있어요.

"You can also split content into imports for organization, though imported files still load and enter the context window at launch." (출처: code.claude.com/docs/en/memory)

그래서 import 문법은 컨텍스트 절약용이 아니라 가독성과 유지보수 관점의 정리용으로 이해하시는 게 정확합니다. 예를 들어 git-instructions.md, code-style.md처럼 주제별로 파일을 쪼개두면 팀에서 관리하기 편하고, 다른 도구(AGENTS.md 등)와도 공유하기 좋아요. 하지만 토큰 측면에선 본문에 다 적은 것과 동일합니다.

그럼 강의에서 안내드린 200줄 가이드의 의미는 — "세션마다 항상 로드되는 핵심 규칙 자체를 가볍게 유지하자" 입니다. 그래서 CLAUDE.md는 항상 필요한 핵심 규칙만 짧게 두시고, 그 외 규칙은 다른 메커니즘으로 분리하시는 게 권장 패턴이에요.

정리하면, 항상 필요한 핵심 규칙은 CLAUDE.md에 짧게(200줄 이하 그대로 유지), 특정 파일 작업할 때만 필요한 규칙은 path-scoped rules로, 가끔 호출되는 절차는 skill로 분리하시는 게 깔끔한 구조입니다.

감사합니다 🙂

0

안녕하세요, 인프런 AI 인턴입니다. 이종문님.

CLAUDE.md 파일의 길이와 import 사용에 대한 궁금증이 생기셨군요. 이 부분에 대해서는 약간의 배경 설명이 필요합니다.

CLAUDE.md 파일의 길이와 import 문법

CLAUDE.md는 클로드 코드가 프로젝트 실행 시 참고하는 중요한 파일입니다. 이 파일은 프로젝트의 규칙과 주요 정보를 담고 있어, 적절한 크기로 유지하는 것이 중요합니다.

• Import 문법 사용의 장점: CLAUDE.md 파일을 import 문법을 사용하여 분류하면, 각각의 규칙이나 정보를 별도의 파일에 나누어 관리할 수 있습니다. 이는 파일의 유지보수성을 높이고, 각각의 모듈이 독립적으로 집착될 수 있으므로 유연성이 증가합니다.

• 파일 길이와 용량 문제: 비록 import로 인해 CLAUDE.md 본래 파일의 줄 수는 줄어들 수 있지만, import된 파일들의 내용이 최종적으로 포함되어 읽히기 때문에 클로드가 처리해야 하는 정보의 총량은 사실 늘어납니다.

따라서 import를 통해 CLAUDE.md를 줄이는 것이 내용을 덜어내는 것은 아니며, 클로드 코드의 최종 처리 성능에 영향을 줄 수 있습니다. 하지만, 이 방법은 관리와 접근성 측면에서 큰 이점을 제공할 수 있습니다.

참고 자료 및 권장 사항

관련된 더 많은 정보는 아래의 게시글에서 찾아보실 수 있습니다:

• CLAUDE.md 200줄 이하 기준 질문
  
• 클로드 코드를 관리하기 위한 전략에 대한 질문
  

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.