CLAUDE.md 에 import 문법 질문
29
작성한 질문수 4
궁금한게 있습니다 2026 05 06 기준 Docs 에서 200줄 이하로 CLAUDE.md 를 유지하라고했는데 만약 import 문법으로 CLAUDE.md 파일을 줄였는데 import 로 가져온 md 내용의 길이가 200줄이 넘거나 좀 많다고 가정하면 그건 괜찮은 건가요?... import 문법으로 줄인다고해도 결국.. claude 가 import 한 md 파일을 읽을 텐데 그건 import로 해서 CLAUDE.md 가 줄어들었다고 해도 읽는 양은 똑같지 않나하는 궁금증에 여쭤봅니다..
답변 2
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를 줄이는 것이 내용을 덜어내는 것은 아니며, 클로드 코드의 최종 처리 성능에 영향을 줄 수 있습니다. 하지만, 이 방법은 관리와 접근성 측면에서 큰 이점을 제공할 수 있습니다.
참고 자료 및 권장 사항
관련된 더 많은 정보는 아래의 게시글에서 찾아보실 수 있습니다:
저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.
/output-style 이 안뜹니다
0
4
2
프로젝트 초기화 문제
0
2
1
섹션8,9부터는 진짜 못따라가겠어요...ㅠㅠ
0
6
1
파워쉘에서 이미지 복붙이 안됩니다.
0
8
1
160 강의 ppt-maker에 대해
0
10
1
이벤트 관리 앱 프로젝트 개발 순서
0
8
0
supabase next.js와 mcp
0
7
0
스테이징 10000개
0
8
1
160. Claude Code로 PPT 만들기 관련 질문
0
10
1
task master 관련질문입니다.
0
13
1
터미널 시작폴더가 달라요
0
25
2
my-profile-site 404 error
0
19
2
노션 .env.local
0
26
1
shrimp_data - WebGUI.md
0
21
2
powershell 복붙 문제
0
26
2
디렉토리가 보이지 않아요.
0
25
1
쉬림프 설치
0
20
2
tsakmaster api키
0
23
1
terminal-setup을 해도 shift+Enter 키로 줄바꿈이 되지 않아요.
0
24
2
ll- al 명령어 관련 문의
0
29
1
cursor ui 변경 문의
0
28
1
상태 표시줄 설치 오류
0
30
1
API 400알람 관련문의
0
37
2
사이트가 너무 달라요
0
64
2





