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가 자동으로 읽어들입니다.
그 후에는 자유롭게 작성하기만 하면 됩니다. 예를 들어:
# 개인용 메모
## 외부 파일 읽기
@/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는 그대로 유지하면서, 자신만의 작업 메모나 규칙을 부담 없이 작성할 수 있게 됩니다.
