์—ฐ๊ฒฐ ์ค‘โ€ฆ
์—ฐ๊ฒฐ ์ค‘โ€ฆ
์ „์ฒด ๋ณด๊ธฐ
์บ‡์ฆˆ์˜ ํฌ๋ฆฝํ†  ๋…ธํŠธ๐Ÿ“โ˜•๏ธ
Telegram ยท @Katzenote

๐Ÿ‘€์—์ด์ „ํ‹ฑ ์ฝ”๋”ฉ ๊ฟ€ํŒ - claude.md๋ฅผ ์• ์šฉํ•˜๊ธฐ

๊ฒŒ์‹œ
2026.02.10 16:13
์กฐํšŒ
922
ํฌ์›Œ๋“œ
29
์ด๋ฏธ์ง€
1์žฅ

์‚ฌ์ง„์€ ์ œ๊ฐ€ ์ „์—ญ์œผ๋กœ ์‚ฌ์šฉํ•˜๋Š” claude.md์˜ ํ•ต์‹ฌ ๋‚ด์šฉ์ด๊ณ  claude.md๋Š” ์„ธ์…˜ ์‹คํ–‰์ „์— ๊ธฐ๋ณธ์ ์œผ๋กœ ์ฐธ๊ณ ํ•˜๋Š” ์‚ฌํ•ญ๋“ค์ž…๋‹ˆ๋‹ค.

์ฃผ๋กœ, ์ฝ”๋”ฉ ์ง€์นจ์„œ๋‚˜ ํŒŒ์ผ๊ตฌ์กฐ๋ฅผ ์„ค๋ช…ํ•˜๋Š” ์šฉ๋„

์˜ˆ์‹œ๋“ค ๋‚จ๋“ค ํ…œํ”Œ๋ฆฟ ๋ณต์‚ฌํ•ด์„œ ์“ฐ๋Š” ๋ฐฉ๋ฒ•๋ณด๋‹ค๋Š”, ๊ทธ๊ฑฐ๋ณด๋‹ค ํ›จ์”ฌ ์ข‹์€ ๋ฐฉ๋ฒ•์ด ์žˆ์Šต๋‹ˆ๋‹ค. (๊ทธ๋ž˜๋„ ์ € 4๊ฐ€์ง€๋Š” ์ถ”๊ฐ€ํ•˜๊ธธ ์ถ”์ฒœ)

์ž์‹ ์ด ์‚ฌ์šฉํ•˜๋Š” Claudeํ•œํ…Œ
๋‚ด ํŒŒ์ผ ๋””๋ ‰ํ† ๋ฆฌ์™€ git ํžˆ์Šคํ† ๋ฆฌ ๋ชจ๋‘ ๋ถ„์„ํ•ด์„œ claude md ์˜์–ด๋กœ ์ƒ์„ธํ•˜๊ฒŒ ์ž‘์„ฑํ•ด์ค˜

-> ์ดํ›„ claude md Refactoringํ•˜๊ณ  ์ถ”๊ฐ€ํ•˜๊ฑฐ๋‚˜ ์ง€์›Œ๋„ ๋˜๋Š”๋ถ€๋ถ„ ์žˆ๋‚˜?

์ž…๋ ฅํ›„ ์กฐ์ •ํ•ด๋‚˜๊ฐ€๋ฉด ๋ฉ๋‹ˆ๋‹ค

๐Ÿ˜Ž ์ „์—ญ vs ํ”„๋กœ์ ํŠธ๋ณ„ ์ฐจ์ด
CLAUDE.md๋Š” ๋‘ ๋ ˆ๋ฒจ๋กœ ๋‚˜๋‰ฉ๋‹ˆ๋‹ค

์ „์—ญ CLAUDE.md (~/.claude/CLAUDE.md)

  • ๋‚ด ๋ชจ๋“  ํ”„๋กœ์ ํŠธ์— ๊ณตํ†ต์œผ๋กœ ์ ์šฉ
  • ๋‚˜๋งŒ์˜ ์ฝ”๋”ฉ ์Šคํƒ€์ผ, ์„ ํ˜ธํ•˜๋Š” ๊ทœ์น™ ๋“ฑ
  • ์˜ˆ: "ํ•œ๊ตญ์–ด๋กœ ์ฃผ์„ ๋‹ฌ์ง€ ๋งˆ", "logging์€ structlog ์จ", "ํƒ€์ž… ํžŒํŠธ ํ•„์ˆ˜"

ํ”„๋กœ์ ํŠธ๋ณ„ CLAUDE.md (ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ์˜ CLAUDE.md)
ํ•ด๋‹น ํ”„๋กœ์ ํŠธ์—๋งŒ ์ ์šฉ
๊ธฐ์ˆ  ์Šคํƒ, ๋นŒ๋“œ ๋ช…๋ น์–ด, ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ ๋“ฑ
git์— ์ปค๋ฐ‹ํ•˜๋ฉด ํŒ€์›์ด๋ž‘ ๊ณต์œ ๋„ ๋จ
์ถ”๊ฐ€๋กœ CLAUDE.local.md๋Š” git์— ์•ˆ ์˜ฌ๋ผ๊ฐ€๋Š” ๋‚˜๋งŒ์˜ ๋กœ์ปฌ ์„ค์ •์šฉ์ž…๋‹ˆ๋‹ค.

๐Ÿ˜Ž ์˜์–ด๋กœ ์“ฐ๋Š” ์ด์œ ?
CLAUDE.md๋Š” ์˜์–ด๋กœ ์“ฐ๋Š” ๊ฑธ ์ถ”์ฒœํ•ฉ๋‹ˆ๋‹ค.

Claude๊ฐ€ ์˜์–ด ๊ธฐ๋ฐ˜ ๋ชจ๋ธ์ด๋ผ ์˜์–ด ์ง€์‹œ๋ฅผ ๋” ์ •ํ™•ํ•˜๊ฒŒ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.
ํ† ํฐ๋„ ํ•œ๊ตญ์–ด๋ณด๋‹ค ์ ๊ฒŒ ๋จน์Œ.

๋Œ€ํ™”๋Š” ํ•œ๊ตญ์–ด๋กœ ํ•ด๋„ ๋˜๋Š”๋ฐ, md ์ž‘์„ฑ๊ณผ ์ฝ๊ธฐ๋Š” ์˜์–ด๊ฐ€ ํšจ์œจ์ ์ž…๋‹ˆ๋‹ค.

์กฐํšŒ922ํฌ์›Œ๋“œ29ํ…”๋ ˆ๊ทธ๋žจ์—์„œ ๋ณด๊ธฐ