CLAUDE.md ์๋ ๊ด๋ฆฌํ๋ ๊ณต์ ํ๋ฌ๊ทธ์ธ ํด๋ก๋ ์ฝ๋
- ๊ณต์ ๋งํฌ ๋ง๋ค๊ธฐ
- X
- ์ด๋ฉ์ผ
- ๊ธฐํ ์ฑ
๋งค๋ฒ ์ปค์ง๋ ํ๋กฌํํธ ํ์ผ ๋๋ฌธ์ ์ง์น์ จ๋์? ํด๋ก๋ ์ฝ๋๊ฐ ์์์ ์ ๋ฆฌํด์ฃผ๋ ๊ณต์ ํ๋ฌ๊ทธ์ธ์ผ๋ก ๊ฐ๋ฐ ํจ์จ ๊ทน๋ํํ๊ธฐ
ํ๋ก์ ํธ๊ฐ ์ปค์ง์๋ก ๋น๋ํด์ง๋ CLAUDE.md ๊ท์น ํ์ผ์ ๊น๋ํ๊ฒ ์ ์งํด์ฃผ๋ ๊ณต์ ํ๋ฌ๊ทธ์ธ, ํด๋ก๋ MD ๋งค๋์ง๋จผํธ์ ๋ ๊ฐ์ง ํต์ฌ ๋๊ตฌ ํ์ฉ๋ฒ๊ณผ ํจ์จ์ ์ธ ๊ฐ๋ฐ ์ํฌํ๋ก์ฐ ํ์ ๋ฐ๋ปํ ์คํ ๋ฆฌํ ๋ง์ผ๋ก ์ ํด๋๋ฆฝ๋๋ค.
๋ชฉ์ฐจ
- 1. ๊ฐ๋ฐํ ์๋ก ๋์ด๋๋ ๊ท์น, ๋์ด๋๋ ๊ณ ๋ฏผ
- 2. CLAUDE.md ํ์ผ์ด ๋ฌด๊ฑฐ์์ง๋ ์ด์ ์ ๋ฌธ์ ์
- 3. ์์ ์ ๋์ ์๋ฒฝํ๊ฒ ๋งบ์ด์ฃผ๋ '๋ฆฌ๋ฐ์ด์ฆ ํด๋ก๋ MD'
- 4. ์ฃผ๊ธฐ์ ์ธ ๊ฑด๊ฐ๊ฒ์ง, 'ํด๋ก๋ MD ์ธํ๋ก๋ฒ'์ 6๊ฐ์ง ๊ธฐ์ค
- 5. ์ธ๊ณต์ง๋ฅ๊ณผ์ ํ์ ์ ํ ๋จ๊ณ ์ ๊ทธ๋ ์ด๋ํ๋ ๋ฐฉ๋ฒ
1. ๊ฐ๋ฐํ ์๋ก ๋์ด๋๋ ๊ท์น, ๋์ด๋๋ ๊ณ ๋ฏผ
์ปดํจํฐ ์์ ์์ ์ฝ๋๋ฅผ ์์ฑํ๋ค ๋ณด๋ฉด ์ด๋ ์๊ฐ ๋จธ๋ฆฟ์์ด ๋ณต์กํด์ง ๋๊ฐ ์์ฃผ ์ฐพ์์ต๋๋ค.
ํนํ ์ธ๊ณต์ง๋ฅ ๋๊ตฌ์ ํจ๊ป ํ๋ก์ ํธ๋ฅผ ์งํํ ๋๋ ์ฐ๋ฆฌ๊ฐ ์ง์ผ์ผ ํ ๊ท์น๋ค์ด ๋์์์ด ๋์ด๋๊ธฐ ๋ง๋ จ์ ๋๋ค.
์ฒ์์๋ ์์ฃผ ๊ฐ๋จํ ์ฝ์์ผ๋ก ์์ํ์ง๋ง ์๊ฐ์ด ํ๋ฅผ์๋ก ์ฑ๊ฒจ์ผ ํ ์กฐ๊ฑด๋ค์ด ์ฐ๋๋ฏธ์ฒ๋ผ ์์ฌ ๋ง์์ ๋ฌด๊ฒ๊ฒ ๋ง๋ค๊ณค ํฉ๋๋ค.
ํน์ ์ฌ๋ฌ๋ถ๋ ์ธ๊ณต์ง๋ฅ์๊ฒ ๋งค๋ฒ ๋๊ฐ์ ์ง์๋ฅผ ๋ฐ๋ณตํ๋๋ผ ํผ๋ก๊ฐ์ ๋๋ผ์ ์ ์ด ์์ผ์ ๊ฐ์?
์ด๋ฌํ ๋ฒ๊ฑฐ๋ก์์ ํด๊ฒฐํ๊ธฐ ์ํด ๋ฑ์ฅํ ๋๊ตฌ๊ฐ ๋ฐ๋ก ํด๋ก๋ MD ๋งค๋์ง๋จผํธ ๊ณต์ ํ๋ฌ๊ทธ์ธ์ ๋๋ค.
2. CLAUDE.md ํ์ผ์ด ๋ฌด๊ฑฐ์์ง๋ ์ด์ ์ ๋ฌธ์ ์
์ฐ๋ฆฌ๊ฐ ๊ฐ๋ฐ ํ๋ก์ ํธ๋ฅผ ์งํํ ๋ ํด๋ก๋ ์ฝ๋๊ฐ ๊ผญ ์์์ผ ํ ํต์ฌ ๊ท์น๋ค์ ๊ธฐ๋กํด๋๋ ํ์ผ์ด ์์ต๋๋ค.
๋ฐ๋ก CLAUDE.md๋ผ๋ ์ด๋ฆ์ ์ค์ ํ์ผ์ธ๋ฐ ์ด ํ์ผ์ ํ๋กฌํํธ๋ฅผ ์์ฒญํ ๋๋ง๋ค ์๋์ผ๋ก ํจ๊ป ์ ์ก๋๋ ํน์ง์ ๊ฐ์ง๊ณ ์์ต๋๋ค.
๋ฌธ์ ๊ฐ ๋๋ ์ง์ ์ ํ๋ก์ ํธ์ ๊ท๋ชจ๊ฐ ์ปค์ง๊ณ ๊ธฐ๋ฅ์ด ์ถ๊ฐ๋ ์๋ก ์ด ํ์ผ ์์ ๋ด๊ธฐ๋ ๋ด์ฉ์ด ๊ฑท์ก์ ์ ์์ด ๋น๋ํด์ง๋ค๋ ์ฌ์ค์ ๋๋ค.
๊ท์น์ด ๋๋ฌด ๋ง์์ง๋ฉด ์ธ๊ณต์ง๋ฅ์ด ์ค์ํ ๋งฅ๋ฝ์ ๋์น๊ฑฐ๋ ์๋ฑํ ๋ต๋ณ์ ๋ด๋๋ ์์ธ์ด ๋๊ธฐ๋ ํฉ๋๋ค.
๊ทธ๋ ๊ธฐ ๋๋ฌธ์ ์ด ๊ณต๊ฐ์ ์ธ์ ๋ ๊นจ๋ํ๊ณ ๋ช ํํ๊ฒ ์ ์งํด์ฃผ๋ ๊ด๋ฆฌ ์์ ์ด ํ์๊ฐ ๋์์ต๋๋ค.
3. ์์ ์ ๋์ ์๋ฒฝํ๊ฒ ๋งบ์ด์ฃผ๋ '๋ฆฌ๋ฐ์ด์ฆ ํด๋ก๋ MD'
์๋ก์ด ๊ธฐ๋ฅ์ ์ฑ๊ณต์ ์ผ๋ก ๊ตฌํํ๊ณ ๋๋ฉด ์ฐ๋ฆฌ๋ ๋ณดํต ๊น์ ์๋์ ํ์จ์ ๋ด์ฌ๋ฉฐ ๋ชจ๋ํฐ๋ฅผ ๋ฐ๋ผ๋ด ๋๋ค.
์ด ํ๋ฌ๊ทธ์ธ์ ํฌํจ๋ ์ฒซ ๋ฒ์งธ ๋๊ตฌ์ธ ๋ฆฌ๋ฐ์ด์ฆ ํด๋ก๋ MD(Revise CLAUDE.md)๋ ๋ฐ๋ก ๊ทธ ๋ํ๊ฐ ๋ง๋ฌด๋ฆฌ๋๋ ์์ ์ ์คํํ๋ ๋ช ๋ น์ด์ ๋๋ค.
ํ๋์ ์์ ์ธ์ ์ด ์์ ํ ๋๋๊ธฐ ์ ์ ์ด ๋ช ๋ น์ ๋ด๋ฆฌ๋ฉด ์ธ๊ณต์ง๋ฅ์ด ๋ฐฉ๊ธ ๋๋ ๋ํ ๋ด์ญ ์ ์ฒด๋ฅผ ๊ผผ๊ผผํ๊ฒ ๋ถ์ํ๊ธฐ ์์ํฉ๋๋ค.
์ฐ๋ฆฌ๊ฐ ์น์ดํ๊ฒ ํ ๋ก ํ๋ฉฐ ์๋ก ์๊ฒ ๋ ๋ช ๋ น์ด์ ํต์ฌ์ ์ธ ์์ ํจํด ๊ทธ๋ฆฌ๊ณ ์กฐ์ฌํด์ผ ํ ํจ์ ๋ค์ ์๋ฆฌํ๊ฒ ์ถ์ถํด๋ ๋๋ค.
๋ง์น ์ค์ํ ๋น์ฆ๋์ค ํ์๊ฐ ๋๋ ์งํ์ ์ผ๋ชฉ์์ฐํ๊ฒ ์์ฑํ๋ ํ์๋ก์ฒ๋ผ ๋ค์ ๊ฐ๋ฐ์ ์ํ ํต์ฌ ์์ฝ๋ณธ์ ์ ์ํด์ฃผ๋ ์ญํ ์ ์ํํฉ๋๋ค.
4. ์ฃผ๊ธฐ์ ์ธ ๊ฑด๊ฐ๊ฒ์ง, 'ํด๋ก๋ MD ์ธํ๋ก๋ฒ'์ 6๊ฐ์ง ๊ธฐ์ค
์ฌ๋์ด ์ ๊ธฐ์ ์ผ๋ก ๊ฑด๊ฐ๊ฒ์ง์ ๋ฐ๋ฏ์ด ์ฐ๋ฆฌ๊ฐ ๊ด๋ฆฌํ๋ ํ๋ก์ ํธ ํ์ผ๋ ์ฃผ๊ธฐ์ ์ธ ์ ๊ฒ์ด ํ์ํฉ๋๋ค.
๋ ๋ฒ์งธ๋ก ์ ๊ณต๋๋ ํต์ฌ ๋๊ตฌ์ธ ํด๋ก๋ MD ์ธํ๋ก๋ฒ(CLAUDE.md Improver)๋ ํ์ผ์ ์ ์ฒด์ ์ธ ์ํ๋ฅผ ๊ฒ์ฌํ ๋ ํ์ฉ๋ฉ๋๋ค.
์ด ๋ช ๋ น์ด๋ฅผ ํธ์ถํ๋ฉด ์์คํ ์ด ํ๋ก์ ํธ ๋ด๋ถ์ ์กด์ฌํ๋ ๋ชจ๋ CLAUDE.md ํ์ผ์ ์์งํ์ฌ ๋ฏธ๋ฆฌ ์ ํด์ง 6๊ฐ์ง ์๊ฒฉํ ๊ธฐ์ค์ผ๋ก ํ๊ฐ๋ฅผ ๋ด๋ฆฝ๋๋ค.
ํ์ฌ ์ํ๊ฐ ์ผ๋ง๋ ๊ฑด๊ฐํ์ง ๋ฑ๊ธ์ ๋งค๊ฒจ ๋ณด์ฌ์ค ๋ฟ๋ง ์๋๋ผ ๋ ์ด์ ์๋ํ์ง ์๋ ๋ก์ ๋ช ๋ น์ด๋ ๋๋ฝ๋ ํ๊ฒฝ ์ค์ ๊น์ง ์ง์ด๋ ๋๋ค.
๋์น๊ธฐ ์ฌ์ด ์์กด์ฑ ๋ฌธ์ ์ ์ฌ์ํ ์ด์๋ค๊น์ง ๋ฏธ๋ฆฌ ํ์ ํด์ฃผ๊ธฐ ๋๋ฌธ์ ๊ฐ๋ฐ์๋ ์ค๋กฏ์ด ์ฐฝ์๊ณผ ๋ก์ง์๋ง ์ง์คํ ์ ์๋ ํ๊ฒฝ์ด ๋ง๋ค์ด์ง๋๋ค.
5. ์ธ๊ณต์ง๋ฅ๊ณผ์ ํ์ ์ ํ ๋จ๊ณ ์ ๊ทธ๋ ์ด๋ํ๋ ๋ฐฉ๋ฒ
์ข์ ๋๊ตฌ๋ฅผ ๊ณ์ ๋๋ ๊ฒ๋งํผ ๋ ๋ ํ ์ผ์ ์์ง๋ง ๊ทธ๊ฒ์ ์ด๋ป๊ฒ ํ์ฉํ๋๋์ ๋ฐ๋ผ ๊ฒฐ๊ณผ๋ ํฌ๊ฒ ๋ฌ๋ผ์ง๋๋ค.
๊ฐ๋ฐ ๋์ค ๋ฐ์ํ ์๋ง์ ์ํ์ฐฉ์ค์ ์์คํ ๊ธฐ๋ก๋ค์ ๋งค๋ฒ ์๋์ผ๋ก ์ ๋ฆฌํ๋ ์ผ์ ์๊ฐ๋ณด๋ค ๋ง์ ์๋์ง๊ฐ ์๋ชจ๋๋ ์์ ์ ๋๋ค.
ํด๋ก๋ MD ๋งค๋์ง๋จผํธ ํ๋ฌ๊ทธ์ธ์ ์ํฌํ๋ก์ฐ์ ์์ฐ์ค๋ฝ๊ฒ ๋ น์ฌ๋ด๋ฉด ๋ณต์กํ ๊ท์น๋ค์ด ์์์ ์ ๋๋๋ ๋ง๋ฒ์ ๊ฒฝํํ๊ฒ ๋ฉ๋๋ค.
๋ถํ์ํ ํ ์คํธ ์ฐ๊บผ๊ธฐ๋ ๊ณผ๊ฐํ๊ฒ ๋์ด๋ด๊ณ ํต์ฌ ๊ฐ์ด๋๋ผ์ธ๋ง ๋จ๊ฒจ๋์ด ์ธ๊ณต์ง๋ฅ์ด ์ธ์ ๋ ์ต์์ ์ฑ๋ฅ์ ๋ฐํํ๋๋ก ์ด๋์ด์ค ์ ์์ต๋๋ค.
๋จ์ํ ์ฝ๋ ์์ฑ์ ๋์ด ์ธ๊ณต์ง๋ฅ๊ณผ์ ์ง์ ํ ํ์ ํํธ๋์ญ์ ๊ตฌ์ถํ๋ ์ค๋งํธํ ์ฒซ๊ฑธ์์ ์ง๊ธ ์์ํด๋ณด๋ ๊ฒ์ ์ด๋จ๊น์?
"๋จ์ํจ์ ์ ์งํ๋ ๊ฒ์ ๋ณต์กํจ์ ๋ค์ค๋ฆฌ๋ ๊ฐ์ฅ ๊ฐ๋ ฅํ ํ์ด๋ค."
์ค๋๋ ๋ชจ๋ํฐ ์์์ ๋ ํ๋ฆฌ๋ฉฐ ๊ฐ์น๋ฅผ ๋ง๋ค์ด๊ฐ๋ ๋ชจ๋ ๊ฐ๋ฐ์๋ถ๋ค์ ์ฌ์ ์ ์ง์ฌ์ผ๋ก ์์ํฉ๋๋ค.
์์์ ์์ํ ์ค๋ช ๊ณผ ์ค์ต ํ๋ฉด์ด ๊ถ๊ธํ์๋ค๋ฉด ์๋ ๋ฒํผ์ ํตํด ํ์ธํด๋ณด์ธ์.
์ ํ๋ธ ์๋ณธ ์์ ์ ์ฐฝ์์ ์ด๊ธฐ์ถ์ฒ: ์ง์ฝ๋ฉ๋ ์ ํฌ๋ธ์์
์ด ๊ธ์ ์๋ณธ ์์ ๋ด์ฉ์ ์ฐธ๊ณ ํ์ฌ ์์ฑ๋์์ผ๋ฉฐ, ๋ชจ๋ ์ ์๊ถ์ ์์์์๊ฒ ์์ต๋๋ค.
๋ณธ ์ฝํ ์ธ ๋ ๊ฐ์ธ ๋ฐ ๋น์์ ์ ์ฉ๋๋ก๋ง ์ฌ์ฉ๋จ์ ๋ช ํํ ํ๊ณ , ๋ฌด๋จ ๋ณต์ ๋ฐ ์์ ์ ์ด์ฉ์ ๊ธ์งํฉ๋๋ค.
CLAUDE.md ํ์ผ ํ์ง์ ๊ฐ์ฌํ๊ณ ์ธ์ ์์ ์ป์ ์ธ์ฌ์ดํธ๋ฅผ ์บก์ฒํ๋ ๋๊ตฌ๋ฅผ ์ ๊ณตํด์,
ํญ์ ์ฝ๋๋ฒ ์ด์ค์์ ํจ์จ์ ์ผ๋ก ์์ ํ๋ ๋ฐ ํ์ํ ๋งฅ๋ฝ์ ๊ฐ์ถ๋๋ก ํด์ค๋๋ค.
ํต์ฌ ๊ธฐ๋ฅ ๋ ๊ฐ์ง: CLAUDE.md ํ์ง ๊ฐ์ฌ — ์ ์ฅ์ ์ ์ฒด์ CLAUDE.md ํ์ผ์ ์ค์บํ๊ณ , ๋ช ๋ น์ด/์ํฌํ๋ก์ฐ, ์ํคํ ์ฒ, ํน์ด์ฌํญ(gotcha), ๊ฐ๊ฒฐํจ ๊ฐ์ ํ์ง ๊ธฐ์ค์ผ๋ก ํ๊ฐํด์ ์ ์์ ๋ฑ๊ธ์ด ๋ด๊ธด ์์ธ ๋ณด๊ณ ์๋ฅผ ์์ฑํฉ๋๋ค.
"audit my CLAUDE.md files" ๊ฐ์ ๋ฌธ๊ตฌ๋ก ํธ๋ฆฌ๊ฑฐํ ์ ์์ด์. GitHub
์ธ์ ํ์ต ๋ด์ฉ ๋ฐ์ — /revise-claude-md ๋ช ๋ น์ด๋ ์ธ์ ์ด ๋๋ ๋ ๋ฐ๊ฒฌํ ์ธ์ฌ์ดํธ๋ฅผ ์บก์ฒํ๋ ๊ฑธ ๋์์ค๋๋ค.
๋ณ๊ฒฝ ์ฌํญ์ diff ํํ๋ก ๋ณด์ฌ์ฃผ๊ณ ์น์ธํด์ผ๋ง ์ ์ฉ๋ฉ๋๋ค.
์ค์น ๋ฐฉ๋ฒ
๊ณต์ ๋ง์ผํ๋ ์ด์ค(claude-plugins-official)์์ ๋ฐ๋ก ์ค์นํ ์ ์์ด์:
/plugin install claude-md-management@claude-plugins-official
์ฐธ๊ณ ํ ๋งํ ํ
์ธ์ ๋์ค # ํค๋ฅผ ๋๋ฅด๋ฉด ๊ทธ ์๊ฐ์ ํ์ต ๋ด์ฉ์ CLAUDE.md์ ๋ฐ๋ก ๋ฐ์ํ๋๋ก ์์ฒญํ ์ ์์ด์.
ํ๊ณผ ๊ณต์ ํ์ง ์์ ๊ฐ์ธ ์ค์ ์ .claude.local.md์ (๊ทธ๋ฆฌ๊ณ .gitignore์ ์ถ๊ฐ), ์ ์ญ ๊ธฐ๋ณธ ์ค์ ์ ~/.claude/CLAUDE.md์ ๋๋ ๊ฑธ ๊ถ์ฅํฉ๋๋ค.
Claude Code๋ ์์ ๋๋ ํ ๋ฆฌ์ CLAUDE.md ํ์ผ๋ค์ ์๋์ผ๋ก ์ฐพ๊ธฐ ๋๋ฌธ์ ๋ชจ๋ ธ๋ ํฌ ๊ตฌ์ฑ์์๋ ์๋์ผ๋ก ์๋ํฉ๋๋ค.
- ๊ณต์ ๋งํฌ ๋ง๋ค๊ธฐ
- X
- ์ด๋ฉ์ผ
- ๊ธฐํ ์ฑ
