AI 도서관 · Claude · 하네스 설정 · 실전 셋업

팀에 올릴 것과 내 것만 가르기

.local 이 붙은 파일은 나만 씁니다. 이걸 안 나누면 남의 설정이 섞입니다

내용

📌 짝으로 존재합니다

CLAUDE.md              팀 공유 — 프로젝트 규칙
CLAUDE.local.md        나만  — 내 로컬 경로, 임시 메모

.claude/settings.json       팀 공유 — 권한·훅
.claude/settings.local.json 나만  — 내 컴퓨터 사정

[ .gitignore 에 넣을 것 ]
CLAUDE.local.md
.claude/settings.local.json

[ 무엇을 어디에 두나 ]

팀 공유 쪽
• 프로젝트 구조·기술 스택
• 코드 규칙, 커밋 규칙
• 절대 하면 안 되는 것
• 팀 전체가 같아야 하는 권한

나만 쓰는 쪽
• 내 컴퓨터의 경로
• 실험 중인 설정
• 개인 취향 (색·단축키)
• 내 계정에만 있는 접근 권한

⚠️ 안 나누면 생기는 일
내 로컬 경로가 팀 저장소에 올라가고,
다른 사람 환경에서 그 경로가 없어서 헤맵니다.
반대로 팀이 공유해야 할 규칙을 로컬에만 두면 나만 지키게 됩니다.

💡 판단 기준 한 줄
"새로 온 사람에게도 똑같이 적용돼야 하는가?"
그렇다면 공유 쪽, 아니면 로컬 쪽입니다.

💡 비밀값은 어느 쪽에도 넣지 마세요
토큰·비밀번호는 파일이 아니라 환경변수로 참조하세요.
로컬 파일이라도 실수로 올라갈 수 있습니다.

궁금한 점: {{INPUT}}

{{INPUT}} 자리에 내 내용을 넣어 쓰는 프롬프트입니다. 아래 버튼으로 열면 넣는 칸이 나옵니다.

근거

유형
설정 가이드 — 지정된 파일이나 설정에 적용합니다
사용 환경
Claude Code (터미널)
주의
비밀값은 로컬 파일에도 넣지 마세요. 환경변수로 참조하세요.
공식 출처
https://code.claude.com/docs/en/claude-directory
확인일
2026-09-09 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기