【Claude Code】개인용 CLAUDE.local.md를 .gitignore 없이 팀에 공유하지 않고 유지하는 방법

Claude Code는 프로젝트 루트(Project Root)에 CLAUDE.md를 배치함으로써 AI를 위한 컨텍스트(Context) 및 규칙을 정의할 수 있습니다.

하지만 CLAUDE.md는 git에 커밋(Commit)되기 때문에 팀원 모두에게 공유됩니다. "나만의 메모나 선호하는 지시 사항을 쓰고 싶지만, 팀에는 보여주고 싶지 않다"라는 케이스에 대응하는 것이 CLAUDE.local.md입니다.

이 기사에서는:

• CLAUDE.local.md로 개인용 설정을 갖는 방법
• .gitignore를 사용하지 않고 팀과 공유하지 않는 방법

을 소개합니다.

Claude Code가 읽어들이는 설정 파일에는 크게 3가지 종류가 있습니다.

파일	위치	공유
CLAUDE.md	프로젝트 루트	git에 커밋 → 팀원 전체에게 공유
CLAUDE.local.md	프로젝트 루트	git 관리 외로 설정하면 나만 사용
~/.claude/CLAUDE.md	홈 디렉토리	로컬 전용 · 모든 프로젝트 공통

이번에 사용할 것은 CLAUDE.local.md입니다. 프로젝트 루트에 두면 Claude Code가 자동으로 읽어들입니다.

touch CLAUDE.local.md

그 후에는 자유롭게 작성하기만 하면 됩니다. 예를 들어:

# 개인용 메모
## 외부 파일 읽기
@/Users/yourname/Documents/my-rules.md
...

@파일 경로 표기법으로 다른 파일을 인클루드(Include)할 수도 있습니다.

CLAUDE.local.md를 git 관리 외로 두려면 .gitignore에 추가하는 것이 일반적이지만, "프로젝트의 .gitignore는 건드리고 싶지 않다"라는 상황도 있습니다.

그럴 때 사용할 수 있는 두 가지 방법을 소개합니다.

.git 디렉토리 내에 있는 파일로, git에 커밋되지 않습니다. .gitignore와 동일한 서식으로 작성할 수 있습니다.

echo "CLAUDE.local.md" >> .git/info/exclude

• 프로젝트의 .gitignore를 변경하지 않음 - 이 리포지토리(Repository)에만 적용됨
• .git 디렉토리는 커밋되지 않으므로 팀에게 전달되지 않음

# 글로벌 gitignore에 추가
echo "CLAUDE.local.md" >> ~/.gitignore_global
# 아직 설정하지 않은 경우 Git에 등록
...

• 모든 리포지토리에서 자동으로 무시됨
• 한 번 설정하면 이후 어떤 프로젝트에서도 사용 가능
• CLAUDE.local.md는 Claude Code의 관습적인 파일명이므로 글로벌 설정에 적합함

상황	추천
이 리포지토리에만 개인 메모를 두고 싶다	.git/info/exclude
어떤 리포지토리에서도 CLAUDE.local.md를 사용하고 싶다	글로벌 .gitignore
팀원 전체가 공통의 제외 규칙을 사용하고 싶다	.gitignore (커밋함)

• CLAUDE.local.md를 프로젝트 루트에 두면 Claude Code가 자동으로 읽어들임
• .gitignore를 변경하지 않고 git에서 제외하려면 .git/info/exclude 또는 글로벌 .gitignore를 사용할 수 있음
• "이 리포지토리만"이라면 .git/info/exclude, "모든 리포지토리에서 사용하고 싶다"라면 글로벌 설정을 추천

팀의 CLAUDE.md는 그대로 유지하면서, 자신만의 작업 메모나 규칙을 부담 없이 작성할 수 있게 됩니다.