Claude Code
๋ฐ์ด๋ธ
10์ 25์ผ ์ถ๊ฐ ยท AI๊ฐ ๊ณ ์น ์ฝ๋๋ฅผ ๋ฏฟ๊ธฐ ์ ์ โ๊ฒฐ์ ยท๋ฌธ์ housepeoplekorea@gmail.com
ํฐ๋ฏธ๋ ํ ์ค๋ก ๊ฐ๋ฐํ ํ ๋ช ์ ๊ณ ์ฉํ๋ ๋ฒ
์จ๋ณด๊ณ ๋์์ผ ์์๋ค. ์ฐจ์์ด ๋ค๋ฅด๋ค๋ ๊ฑธ."
โ ๊นํํ, Claude Code ์ฌ์ฉ 6๊ฐ์ ํ
์ ์ฒด ์ปค๋ฆฌํ๋ผ
โณ ์ธ์์ โ ๊ณํ๋๋ก ๋์ง ์์ต๋๋ค.
์๊ฐ์ ๋ฉ์ถ์ง ์์ต๋๋ค.
AI๋ ๋งค์ผ ์งํํฉ๋๋ค.
์ด ๋ณํ์ ์๋์ โ
AI๋ฅผ ๊ฐ์ฅ ์ ํ์ฉํ๋ 0.1%๊ฐ ๋์ธ์.
๊ทธ ๊ฐ์น๋ โ 10๋ฐฐ ยท 100๋ฐฐ ยท ๊ทธ ์ด์์ ๋๋ค.
์ง๊ธ ์์ํ์ธ์.
199,000์ ๋จ ํ ๋ฒ ยท 5๊ถ ํตํฉ (1ยท2ยท3ยท4ยท5๊ถ) + ํ์ ์
๋ฐ์ดํธ + VIP ๋์ค์ฝ๋
๋จ๊ถ 5๊ถ์ ๋ฐ๋ก ์ฌ๋ ๊ฒ๋ณด๋ค ์ ๋ ด ยท ํ์ ์
๋ฐ์ดํธ ํฌํจ
โพ ํ ๋ฒ ๊ฒฐ์ ๋ก ํ์ ์ ๋ฐ์ดํธ ยท ์ ๊ถ ๋ฌด๋ฃ ์ ๊ณต ยท ๐ ์ผ๋ฐ PDF ์ ์์ฑ ๊ณผ ๋น๊ต๋ถ๊ฐ
"Introduction to Agent Skills" Certificate of Completion
โ hwahyun Kim (๊นํํ, ๋ฆฌ๋ฏธํธ๋ฆฌ์ค๋งจ) ยท 2026-05-14 ๋ฐ๊ธ
Claude ๊ฐ๋ฐ์ฌ ์ง์ ์ธ์ฆ โ ์ด๋ก ์ด ์๋, Anthropic ๊ณต์ ์ปค๋ฆฌํ๋ผ ์๋ฃํ ์ ์
"ํด๋ก๋ ์ฝ๋์ AI ์์ด์ ํธ๋ก โ AI ๋ค์ดํฐ๋ธ ๊ธฐ์ ์ด ๋๊ธฐ ์ํ ํ๋ ์."
โ ๋ ธ์ฑํ ยท IT ๋ํ (๊ตฌ๊ธ ์ํฐ๊ทธ๋๋นํฐ ๋ฐ์ด๋ธ์ฝ๋ฉ ์ ์)
"CLAUDE.md๋ก AI์๊ฒ ํ์ฌ ํ๋ฒ์ ์ฌ๋ ๋ฐฉ์ โ ์ด๊ฑธ ๋ชจ๋ฅด๊ณ AI๋ฅผ ๊ฐ๋ฅด์ณค๋ค๋ฉด ์ ๋ฐ๋ง ๊ฐ๋ฅด์น ๊ฒ๋๋ค."
โ ๋ฐ๊ธฐ์ ๋ํ (AI ๊ต์ก๊ธฐ์ ์ฐํ SANTA)
"1์ธ ์ฐฝ์ ๊ฐ๊ฐ G-Stack ๋ฐฉ๋ฒ๋ก ํ๋๋ก B2B ํ๋ซํผ์ 96์๊ฐ ๋ง์ ์์ฑ โ ๋ฐ์ด๋ธ์ฝ๋ฉ์ ์ ํ์ด ์๋๋ผ ์๋ก์ด ๊ฐ๋ฐ ํจ๋ฌ๋ค์์ ๋๋ค."
โ ๊น๋์ ๊ต์ (๋ถ์ฐ๋ํ๊ต ์ฐํํ๋ ฅ๋จ)
"์ฌ๋ด ์๋ํ ์์คํ ์ ์ธ์ฃผ ์์ด ๋ง๋ค๊ณ โ ๊ฐ๋ฐ๋น 1,200๋ง์์ ์๊ผ์ต๋๋ค."
โ ๊ฐ๋ฌด์ฑ ๋ํ (์์ฐ์ด์ํฐ SIWU ENT)
"3์ผ ๋ง์ ๋๋ฉํ์ด์ง๋ฅผ ๋ฐฐํฌํ์ต๋๋ค. ๋ง์ผํ ํ์ฅ 10๋ ํ๋ฉด์ ๊ฐ๋ฐ์ํํ ๋ง ๋ชป ํ๋ ๊ฒ, ์ด์ ์ ๊ฐ ์ง์ ๋ง๋ค์์ต๋๋ค."
โ ๋ฐO์ค (๋ง์ผํ ํ์ฅ, 38์ธ)
์ด 165๊ฑด ์ง์ ํ๊ธฐ ๋์ ยท ์ถ์ฒ 92%
์ถ์ฒ 92% ยท ๋์ ๋ฐฉ๋ฌธ 18,054๋ช ์ค์ธก
Claude Code๊ฐ ๋ญ๋ฐ?
ChatGPT๋ ๋ญ๊ฐ ๋ฌ๋ผ
์ ์ผ ๋ง์ด ๋ฐ๋ ์ง๋ฌธ์ด๋ค. ์ด ๊ฐ์์ ๋จ๋ฒ์ ์ ๋ฆฌํ๋ค. ๋น์ ํ๋๋ฉด ์ถฉ๋ถํ๋ค.
โก "์์ด์ ํธ"์ ์๋ฏธ๋ฅผ ๋น๊ฐ๋ฐ์์๊ฒ๋ ์ฝ๊ฒ ์ค๋ช ํ ์ ์๋ค
โข Claude Code๋ก ํ ์ ์๋ ๊ฒ๊ณผ ํ ์ ์๋ ๊ฒ์ ๊ตฌ๋ถํ๋ค
๋น์ ํ๋๋ก ์ ๋ถ ์ค๋ช ํ๋ค
ChatGPT์๊ฒ ์ฝ๋๋ฅผ ๋ฌผ์ด๋ณด๋ ๊ฑด ์๋ฆฌ ๋ ์ํผ ๊ฒ์์ด๋ค. ๋ ์ํผ๋ฅผ ์๋ ค์ฃผ๋ฉด ๋ด๊ฐ ์ง์ ์ฌ๋ฃ ์ฌ๊ณ , ์๋ฆฌํ๊ณ , ์ค๊ฑฐ์ง๊น์ง ํด์ผ ํ๋ค.
Claude Code๋ ๋ค๋ฅด๋ค. ์ด๊ฑด ์ ฐํ๋ฅผ ๊ณ ์ฉํ ๊ฒ์ด๋ค. "์ค๋ ์ ๋ ํ์คํ ๋ง๋ค์ด์ค"๋ผ๊ณ ํ๋ฉด ์ ฐํ๊ฐ ๋์ฅ๊ณ ์ด์ด๋ณด๊ณ , ์ฌ๋ฃ ํ์ ํ๊ณ , ์๋ฆฌํ๊ณ , ์๊น์ง ์ฐจ๋ ค์ค๋ค. ๋ด๊ฐ ํ ์ผ์ "๋ง์๋ค, ์กฐ๊ธ ์ง๋ค"๋ผ๊ณ ํผ๋๋ฐฑํ๋ ๊ฒ๋ฟ์ด๋ค.
ChatGPT: "์ด๋ค ํ์ผ์ธ์ง ๋ถ์ฌ๋ฃ์ด ์ฃผ์ธ์."
Claude Code: (์ค์ ๋ก ํด๋ ๋ค์ง๊ณ 30์ด ๋ค) "app.py 127๋ฒ์งธ ์ค์์ None ํ์ ์ค๋ฅ ๋ ๊ฒ ๊ฐ์์. ๊ณ ์น ๊น์?"
๊ทธ๋ฅ ๊ณ ์ณค๋ค. ์ง์ง๋ก.
ํต์ฌ ์ฐจ์ด โ 4๊ฐ์ง
| ๊ตฌ๋ถ | ChatGPT / Claude.ai ์น | Claude Code CLI |
|---|---|---|
| ํ์ผ ์ ๊ทผ | ๋ถ์ฌ๋ฃ๊ธฐ๋ง ๊ฐ๋ฅ | ์ง์ ์ฝ๊ณ ์ฐ๊ณ ์คํ |
| ๊ธฐ์ต | ๋ํ ๋๋๋ฉด ๋ฆฌ์ | CLAUDE.md๋ก ํ๋ก์ ํธ ์ง์นจ ์ ๊ณต |
| ํ๋ | ๋ต๋ณ ์์ฑ | ๊ณํ โ ์คํ โ ๊ฒ์ฆ |
| ํ์ฅ | ์์ | MCP๋ก DBยทGitHub ์ง์ ์ ์ด |
๊ฒฐ์ ์ ์ธ ์ฐจ์ด๋ ํ์ผ ์์คํ ์ง์ ์ ๊ทผ์ด๋ค. Claude Code๋ ๋น์ ์ปดํจํฐ์ ํด๋๋ฅผ ์ง์ ์ด๊ณ , ํ์ผ์ ์ฝ๊ณ , ์์ ํ๊ณ , ํฐ๋ฏธ๋ ๋ช ๋ น์ด๋ฅผ ์คํํ๋ค. AI๊ฐ ๊ฐ๋ฐ์์ฒ๋ผ ์ผํ๋ ๊ฒ ์๋๋ผ, AI๊ฐ ์ค์ ๋ก ๊ฐ๋ฐ์์ฒ๋ผ ์ผํ๋ค.
์์ด์ ํธ๊ฐ ๋ญ๊ฐ์
์์ฆ "AI ์์ด์ ํธ"๋ผ๋ ๋ง์ด ๋ง์ด ๋์จ๋ค. ์ฝ๊ฒ ๋งํ๋ฉด ์ด๋ ๋ค.
์์ด์ ํธ: ๋ชฉํ โ ๊ณํ โ ๋๊ตฌ ์ฌ์ฉ โ ๊ฒฐ๊ณผ ํ์ธ โ ์์ โ ์๋ฃ
์์ด์ ํธ๋ ๊ฒฐ๊ณผ๊ฐ ๋์ฌ ๋๊น์ง ์ค์ค๋ก ๋ฃจํ๋ฅผ ๋๋ค. ํ ๋ฒ ์ง์ํ๋ฉด ์์์ ํ๋ค.
Claude Code๋ ์ฝ๋ฉ ์์ด์ ํธ๋ค. "์ด API์ ์ ๋ ํ ์คํธ ์ถ๊ฐํด์ค"๋ผ๊ณ ํ๋ฉด, ์ฝ๋ ์ฝ๊ณ , ํ ์คํธ ์์ฑํ๊ณ , ์คํํด์ ํต๊ณผํ๋์ง ํ์ธํ๊ณ , ์คํจํ๋ฉด ๊ณ ์น๋ ๊ณผ์ ์ ์์์ ๋ฐ๋ณตํ๋ค.
ํ ์ ์๋ ๊ฒ vs ๋ชป ํ๋ ๊ฒ
๊ธฐ์กด ์ฝ๋ ๊ตฌ์กฐ ํ์ / ์๋ฌ ์์ธ ๋ถ์ / SQL ์ฟผ๋ฆฌ ์ต์ ํ
git commit ๋ฉ์์ง ์์ฑ / PR ์ค๋ช ์ด์ ์์ฑ
GUI ์ฑ ์ง์ ์กฐ์ (Playwright MCP ์์ด) / ๋ฌดํ์ ์์จ ์คํ (ํ์ธ ์์ฒญํจ)
์ค์น & ์ฒซ ๋ํ
10๋ถ ์์ฑ ๊ฐ์ด๋
๋ณต์กํ๊ฒ ์๊ฐํ์ง ๋ง๋ผ. Node.js ์ค์นํ๊ณ ๋ช ๋ น์ด ํ๋ ์น๋ฉด ๋์ด๋ค.
โก ์ค์ ํ๋ก์ ํธ ํด๋์์ ์ฒซ ๋ฒ์งธ ๋ํ๋ฅผ ์์ฑํ๋ค
โข ๊ธฐ๋ณธ ๋ช ๋ น์ด 5๊ฐ๋ฅผ ์ธ์ด๋ค
์ฌ์ ์ค๋น (5๋ถ)
์ค์น (1๋ถ)
# ํ์ฌ ๊ถ์ฅ ์ค์น๋ ์ด์์ฒด์ ๋ณ ๊ณต์ ์๋ด๋ฅผ ํ์ธํ์ธ์. # https://code.claude.com/docs/en/setup # Windows PowerShell: irm https://claude.ai/install.ps1 | iex # macOS/Linux: curl -fsSL https://claude.ai/install.sh | bash claude --version
๋ก๊ทธ์ธ (2๋ถ)
claude
์ฒ์ ์คํํ๋ฉด ๋ธ๋ผ์ฐ์ ๊ฐ ์ด๋ฆฐ๋ค. Anthropic ๊ณ์ ์ผ๋ก ๋ก๊ทธ์ธํ๊ณ "ํ์ฉ" ๋ฒํผ ๋๋ฅด๋ฉด ๋. ํ ํฐ์ด ๋ด ์ปดํจํฐ์ ์ ์ฅ๋๋ค.
์ฒซ ๋ํ (2๋ถ)
cd ๋ด-ํ๋ก์ ํธ-ํด๋ claude
์ด๊ฒ ์ ๋ถ๋ค. Claude Code๊ฐ ํ์ฌ ํด๋๋ฅผ ์๋์ผ๋ก ์ฝ๊ณ ๋ํ ๋ชจ๋๋ก ์ง์ ํ๋ค.
์ด ํด๋ ๊ตฌ์กฐ๋ฅผ ํ์ ํ๊ณ ์ด๋ค ํ๋ก์ ํธ์ธ์ง ์ค๋ช ํด์ค.
Claude๊ฐ ์ค์ ๋ก ํ์ผ๋ค์ ์ด์ด๋ณด๊ณ ์ค๋ช ํ๋ค. ๋ง๋ฒ์ฒ๋ผ ๋๊ปด์ง๋ ์ฒซ ์๊ฐ์ด๋ค.
๊ผญ ์ธ์ธ ๋ช ๋ น์ด 5๊ฐ
| ๋ช ๋ น์ด | ์ญํ |
|---|---|
| /clear | ๋ํ ์ปจํ ์คํธ ์ด๊ธฐํ (์ ์์ ์์ ์ ) |
| /help | ์ฌ์ฉ ๊ฐ๋ฅํ ๋ช ๋ น์ด ์ ์ฒด ๋ชฉ๋ก |
| /context | ํ์ฌ ์ปจํ ์คํธ ์๋์ฐ ์ฌ์ฉ๋ ํ์ธ |
| Ctrl+C | Claude ์๋ต ์ฆ์ ์ค๋จ |
| Shift+Enter | ์ค๋ฐ๊ฟ (Enter๋ ์ ์ก) |
ํฉ๊ธ ์ํฌํ๋ก์ฐ
Explore โ Plan โ Code โ Commit
Claude Code๋ฅผ ์ฐ๋ ์ฌ๋ฐ๋ฅธ ์์. ํ์ยท๊ณํยท๊ตฌํยท๊ฒ์ฆ์ ๊ตฌ๋ถํ๋ฉด ๋ฌด์์ ๊ณ ์ณค๋์ง ํ์ธํ๊ธฐ ์ฝ๋ค.
โก "ํ์ โ ๊ณํ ํ์ธ โ ๊ตฌํ โ ๊ฒ์ฆ"์ ์ด์ ๋ฅผ ์ค๋ช ํ๋ค
โข Plan ๋ชจ๋๋ฅผ ์ธ์ ์ฐ๋์ง ์๋ค
"Claude Codeํํ ๋ฐ๋ก ์ฝ๋ฉ ์ํค๋ฉด ์ ์ด์ํ ๊ฒ ๋์ค๋๊ณ ? ์ ฐํํํ ๋ญ ์ํ๋์ง๋ ๋ง ์ ํ๊ณ '์๋ฆฌํด'๋ผ๊ณ ํ๋ ๊ฑฐ๋ ๊ฐ๋ค."
์ ์์๊ฐ ์ค์ํ๊ฐ
์ฒ์ Claude Code๋ฅผ ์ธ ๋ ์ ์ง๋ฅด๋ ์ค์ 1์: "๋ฒ๊ทธ ๊ณ ์ณ์ค"๋ผ๊ณ ๋ฐ๋ก ์ํจ๋ค. ๊ทธ๋ฌ๋ฉด Claude๊ฐ ์ฝ๋๋ฅผ ๋ฏ์ด๋ณด์ง๋ ์๊ณ ์ถ์ธก์ผ๋ก ๊ณ ์น๋ค. ํ๋ฆฐ๋ค. ๋ค์ ๊ณ ์น๋ค. ๋ ๋ง๊ฐ์ง๋ค.
๊ทธ ํ๋ก ์ ๋๋ก ๋ฐ๋ก ์์ ์ ์ํจ๋ค. ๋ฐ๋์ ํ์ ๋จผ์ .
4๋จ๊ณ ํฉ๊ธ ์ํฌํ๋ก์ฐ
์ค์ ํ๋กฌํํธ โ ๋ณต๋ถํด์ ์จ๋ผ
Step 1: ํ์ ํ๋กฌํํธ
[ํ์ผ๋ช ๋๋ ๊ธฐ๋ฅ๋ช ]์ด ์ด๋ป๊ฒ ๋์ํ๋์ง ํ์ ํด์ค. ๊ด๋ จ ํ์ผ๋ค ์ฝ์ด๋ณด๊ณ ํ์ฌ ๊ตฌ์กฐ ์ค๋ช ํด์ค. ์ง๊ธ์ ์ฝ๋ ๊ฑด๋๋ฆฌ์ง ๋ง, ๋ถ์๋ง.
Step 2: ๊ณํ ํ์ธ ํ๋กฌํํธ
[์ํ๋ ๋ณ๊ฒฝ์ฌํญ] ๊ตฌํํ๋ ค๋ฉด ์ด๋ป๊ฒ ํ ๊ฑฐ์ผ? ์ด๋ค ํ์ผ์ ์ด๋ป๊ฒ ๋ฐ๊ฟ ๊ฑด์ง ๊ณํ ๋จผ์ ์๋ ค์ค. ์ฝ๋ ์์ ์ ๋ด๊ฐ OK ํ๋ฉด ์์ํด.
Step 3: ๊ตฌํ ํ๋กฌํํธ
OK, ์งํํด. [ํ์ผ๋ช ]๋ถํฐ ์์ํด. ๊ฐ ํ์ผ ์์ ํ์ ์ ๋์๊ฐ๋์ง ํ์ธํ๋ฉด์ ํด์ค.
/plan ๋ชจ๋ โ ๋ ์์ ํ๊ฒ
๋ณต์กํ ์์ ์๋ /plan ๋ชจ๋๋ฅผ ์ด๋ค. ์ด ๋ชจ๋์์ Claude๋ ํ์ผ์ ์์ ํ ์ ์๋ค. ๊ณํ๋ง ์ธ์ธ ์ ์๋ค.
/plan # ์ด์ Claude๋ ์ฝ๊ธฐ๋ง ๊ฐ๋ฅ, ์์ ๋ถ๊ฐ # "์ข์, ์์ํด" ํ๋ฉด ์ผ๋ฐ ๋ชจ๋๋ก ์ ํ
Claude Code๋ก ๋ง๋ ์ง์ง ๊ฒ์ โ ์ง๊ธ ๋ฐ๋ก ํ๋ ์ด
์ธ๊ตญ์ธ์๊ฒ ํ๊ตญ์ด๋ฅผ ๊ฐ๋ฅด์น๋ ์น๊ฒ์ K-Town. ์ค์น ์์ด ๋ธ๋ผ์ฐ์ ์์ ๋ฐ๋ก ๋์๊ฐ๋๋ค. ์ด ์ฑ ์ ๋๊ตฌ๋ก ์ด๋ฐ ๊ฒ๋ ๋ง๋ญ๋๋ค.
โถ K-Town ๊ฒ์ ํด๋ณด๊ธฐ์ด ์ฑ ์ด Claude Code๋ก ์ง์ ์ ๋ฐ์ดํธ๋ ๊ณผ์ ์ ํต์งธ๋ก ๊ณต๊ฐํ์ต๋๋ค
๋ฉํฐ AI ๋์ ์์ ยท git ๋ณต์์ผ๋ก ๋ฒ๊ทธ ์ก๊ธฐ ยท ๋ผ์ด๋ธ ์ฌ์ดํธ๋ฅผ ์ ๊นจ๊ณ ์์ ํ๋ ๊ฒ์ฆ ๋ฃจํ โ ์ฑ ๋งจ ๋ค ๊ตฌ๋งค์ ์ ์ฉ ์ฑํฐ์ ์ค์ ์ปค๋ฐยทํ๋ฉด๊ณผ ํจ๊ป ๋ด์์ต๋๋ค.
โถ ์ค์ ๋ฐ๋ชจ ์์: AI์ฌ๋ฅ๊พผ ์ ํ๋ธ
์ฌ์ค 1~5๊ถ ์ ๊ถ์ด ์ด๋ฒ 6์์ ์ ๋ฐ์ดํธ๋์ด์. ์ง๊ธ ๊ฐ์ฅ ์ธ ์ ์๋ AI ์ธํ ์ ์ ๊ถ์ ํจ๊ป ๋ณผ ๋ ์์ฑ๋ฉ๋๋ค.
โจ๏ธ Claude Code ์ด๊ด์ ํ๋ง๋: "์ฝ๋ฉํ์ง ๋ง๋ผ"
์ฝ๋ฉ์ด ์๋๋ผ '์ํค๋' ์๋. 4๊ถ์ด ๊ทธ ์ค์ ์ ๋๋ค.
๐ ์ฌ๊ธฐ๋ถํฐ๋ โ ์ ๊ธ ํ ๋น๋ฐ๋ฒํธ๋ก ์ด๋ฆฝ๋๋ค
5๊ถ ํํจํค์ง 199,000์ โ ํ์ ๊ฐ์ฅ ๊ฐ์น์๋ 1ํ ๊ฒฐ์ .
๊ฒฐ์ ํ์ธ ํ ๋
ธ์
DB ๋ฑ๋ก โ ์์
์ผ ๊ธฐ์ค 2์ผ ์์ ๋น๋ฐ๋ฒํธ ์ด๋ฉ์ผยท๋ฌธ์ ๋ฐ์ก (๊ณตํด์ผ ์ ์ธ).
๐ AI ๋ฐ์ด๋ธ ํ๋ซํผ ์๋ด โ ์ ์์ฑ ์ ์ ๊ธ ํ์ด์ง ๋งํฌ์ ๋น๋ฐ๋ฒํธ๋ก ์ ์ํ์ฌ ๋ณด๋ ์น ํํ์ ๋๋ค. ๋ณ๋ PDF ํ์ผยท์์ง์ ์ ๊ณต๋์ง ์์ต๋๋ค.
"ํด๋ก๋ ์ฝ๋์ AI ์์ด์ ํธ๋ก โ AI ๋ค์ดํฐ๋ธ ๊ธฐ์
์ด ๋๊ธฐ ์ํ ํ๋
์."
โ ๋
ธ์ฑํ ยท IT ๋ํ (๊ตฌ๊ธ ์ํฐ๊ทธ๋๋นํฐ ๋ฐ์ด๋ธ์ฝ๋ฉ ์ ์)
1~4๊ถ ์ถ์ฒ์ฌ: ๋ฐ๊ธฐ์ ยท ๊น๋์ ยท ๊ฐ๋ฌด์ฑ
์ด๋ฆยท์ด๋ฉ์ผยท์ ํยท์ํยท๊ธ์ก 5 ํญ๋ชฉ ์ ์ก
์ด๋ฏธ ๊ฒฐ์ ํ์ ๋ถ โ ๋ฐ์ผ์ ๋น๋ฐ๋ฒํธ ์ ๋ ฅ
โ ํ๋ถ ๊ฐ๋ฅ: 1๋ ์์ 5๊ถ ๋ชจ๋ ์ด์ฌํ ์คํํ๋๋ฐ 10๋ง์(99K)์ ๊ฐ์น๋ฅผ ๋ชป ๋๋ผ์ จ๋ค๋ฉด โ 100% ์ ์ก ํ๋ถ
โ ํ๋ถ ๋ถ๊ฐ: ๋น๋ฐ๋ฒํธ๋ก ์ ๊ธ ํด์ (์ด๋)ํ ํ ๋๋ ๋จ์ ๋ณ์ฌ์ ๊ฒฝ์ฐ, ใ์ ์์๊ฑฐ๋ ๋ฑ์์์ ์๋น์๋ณดํธ์ ๊ดํ ๋ฒ๋ฅ ใ ์ 17์กฐ ์ 2ํญ ์ 5ํธ ๋ฐ ๊ฐ์ ๋ฒ ์ํ๋ น ์ 21์กฐ์ ๋ฐ๋ผ ์ฒญ์ฝ์ฒ ํ(ํ๋ถ)๊ฐ ์ ํ๋ฉ๋๋ค. ๊ตฌ๋งค ์ ๋ฌด๋ฃ ๋ฏธ๋ฆฌ๋ณด๊ธฐ๋ก ์ถฉ๋ถํ ํ์ธํ์ธ์.
โพ ํ ๋ฒ ๊ฒฐ์ ยท ํ์ ์ ๋ฐ์ดํธ
2026.10.25 ยท 4๊ถ ์ค์ ๋ณด๊ฐ
AI๊ฐ ๊ณ ์น ์ฝ๋๋ฅผ ๋ฏฟ๊ธฐ ์ ์
Claude Code ์ค์ ยท ์ง์นจยท๊ฒ์ฆ ์ฝ๋ยท์์ ๋ณ๊ฒฝยทํ๊ท ํ์ธ
์ด ์ฅ์ ์ฝ๊ณ ๋จ๊ธฐ๋ ๊ฒ
์คํ ๊ฐ๋ฅํ ์ฝ๊ธฐ ์ ์ฉ ์์ ๋ก 0ํ์ ์ ๋ณด ๋๋ฝ, ์ค๋ณต ์์ฝ์ ๊ตฌ๋ถํ๊ณ ๊ฒ์ฌํฉ๋๋ค.
์ถ๊ฐ ๋ณธ๋ฌธ๊ณผ ์ค์ต์ ๊ธฐ์กด ๊ตฌ๋งค์ ์ ๊ธ ํด์ ํ ์ฝ์ ์ ์์ต๋๋ค. ์ด๋ฏธ ๊ตฌ๋งคํ์ จ๋ค๋ฉด ์ฑ ์ ๋น๋ฐ๋ฒํธ ์ ๋ ฅ์ฐฝ์ ์ด์ฉํด์ฃผ์ธ์.
1. ํ๋ก์ ํธ ์ง์นจ๊ณผ ์คํ์ ๋ง๋ ์ฅ์น๋ ๋ค๋ฅด๋ค
CLAUDE.md๋ ํ๋ก์ ํธ์ ๋ชฉ์ ๊ณผ ์์
๋ฐฉ์์ ์๋ ค์ฃผ๋ ๋ฌธ๋งฅ์
๋๋ค. โํ์ง ๋งโ๋ผ๊ณ ์ ์๋ค๊ณ ๋ชจ๋ ์คํ์ด ๊ธฐ์ ์ ์ผ๋ก ์ฐจ๋จ๋๋ ๊ฒ์ ์๋๋๋ค. ์ค๋ช
์ ์ง์นจ ํ์ผ์, ๊ฒ์ฌ๋ ์ฝ๋์ ๋๊ตฌ ์คํ ๊ฒฝ๊ณ์ ๋ก๋๋ค. ์ค์ํ ์ฐ๊ธฐ๋ ์๋ฒ์ ๊ถํ๊ณผ ์น์ธ ๊ฒ์ฆ์ ํต๊ณผํด์ผ ํฉ๋๋ค.
์๋ ๋ฌธ์๋ ์ค์ต ํ๋ก์ ํธ์ ๋ง์ถฐ ๋ฐ๊ฟ ์ธ ์์์ ๋๋ค. ๊ธฐ์กด ์ ์ฅ์์ ์ง์นจ์ด ์๋ค๋ฉด ์ ํ์ผ๋ก ๋ฎ์ด์ฐ์ง ๋ง๊ณ ๊ฒน์น๋ ๋ด์ฉ๊ณผ ์ถฉ๋๋ถํฐ ํ์ธํ์ธ์.
# ํ๋ก์ ํธ: ๊ฐ์ ์คํ๋์ค ์์ฝ ๊ฒํ ์ค์ต
๋ชฉ์ : ์ฝ๊ธฐ ์ ์ฉ ๊ฐ์ ๋ฐ์ดํฐ๋ก ์ด์ฉ ๊ฐ๋ฅ ์ฌ๋ถ๋ฅผ ๊ฒํ ํ๋ค.
์์
์์:
1. ๊ธฐ์กด ์ง์นจยท๊ด๋ จ ์ฝ๋ยท๊ฒ์ฌ ์ฝ๋๋ฅผ ์ฝ๋๋ค.
2. ์๋ฃ ๊ธฐ์ค๊ณผ ๋ฐ๊ฟ ํ์ผ์ ์งง๊ฒ ์ ์ํ๋ค.
3. ์์ ๋ณ๊ฒฝ์ผ๋ก ๊ตฌํํ๋ค.
4. ์ค์ ๊ฒ์ฌ ๋ช
๋ น๊ณผ ๊ฒฐ๊ณผ๋ฅผ ๋ณด๊ณ ํ๋ค.
๊ณตํต ๊ฐ๋
:
- ๊ณ ๊ฐ๊ณผ ์์์ ๊ณ ์ ID๋ก ์๋ณํ๋ค.
- ์์ฌ ํ์ ๋๋ฝ๊ณผ 0ํ๋ฅผ ๊ตฌ๋ถํ๋ค.
- ์์ด์ ํธ์ ์ ์์ ์คํ ์น์ธ์ด ์๋๋ค.
์ ์งํ ๊ฒฝ๊ณ:
- ์ค์ ๊ณ ๊ฐ ๋ฐ์ดํฐ, ์ธ์ฆ์ ๋ณด, ๊ฒฐ์ ยท์์ฝ ์๋ฒ๋ฅผ ์ฐ๊ฒฐํ์ง ์๋๋ค.
- ์ถ๋ ฅ์ ์์ฝ ์๋ฃ๋ผ๊ณ ์ฐ์ง ์๋๋ค. ์ค์ ์ํํ ์ผ๋ง ๋ณด๊ณ ํ๋ค.
- ๊ธฐ์กด ํ์ผ์ ํต์งธ๋ก ๋ค์ ๋ง๋ค๊ฑฐ๋ ๊ด๊ณ์๋ ๊ธฐ๋ฅ์ ๋ฐ๊พธ์ง ์๋๋ค.
๊ฒ์ฌ: python -m unittest -v test_ontology_lab.py
์๋ฃ ๋ณด๊ณ : ๋ฐ๋ ๊ฒ / ์คํํ ๊ฒ์ฌ / ๋จ์ ์ ํ / ๋๋๋ฆด ๋ฒ์ .2. ๋ง๋ก ์ ํ ์์น์ ๊ฒ์ฌ ์ฝ๋๋ก ๋ฐ๊พธ๊ธฐ
์ฝ๊ธฐ ์ ์ฉ ๊ฒํ ์ฝ๋๋ ๋ชจ๋ธ์ ๋ง์์จ์ ๋ณ๊ฐ๋ก ์กฐ๊ฑด์ ํ์ธํฉ๋๋ค. โ์์ฌ ํ์๊ฐ ์์ผ๋ฉด ๋ฌผ์ด๋ณด๋ผโ๋ ๋ฌธ์ฅ์ needs_information์ด๋ผ๋ ๊ฒฐ๊ณผ๋ก, โ0ํ๋ฉด ๋ง์๋ผโ๋ ๋ฌธ์ฅ์ blocked๋ผ๋ ๊ฒฐ๊ณผ๋ก ํ์ธํ ์ ์์ด์ผ ํฉ๋๋ค.
| ์์น | ํ์ธํ ๊ฒ์ฌ |
|---|---|
| ์ ๋ณด๋ฅผ ์ง์ด๋ด์ง ์์ | ์์ฌ ํ์ ํ๋๋ฅผ ์ญ์ ํ๋ฉด needs_information |
| ๊ฐ์ ์์ ์ค๋ณต ์ฌ์ฉ ๊ธ์ง | ๊ธฐ์กด ์์ฝ์ 14:30์ ์์ํ๋ฉด blocked |
| ์กฐํ ๋๋ฝ์ ๋น ์๊ฐ์ผ๋ก ์คํดํ์ง ์์ | ์์ ์ฑ ํ์๊ฐ false๋ฉด needs_information |
| ์ค๋ณต ์คํ ๋ฐฉ์ง | ์ฒ๋ฆฌ๋ ์์ฒญ ํค๋ duplicate์ ๊ธฐ์กด ๊ฒฐ๊ณผ ID ๋ฐํ |
| ๋ชจ๋ธ์ ์๊ธฐ ์์ ์ ์น์ธํ ์ ์์ | approved=true๋ฅผ ๋ฃ์ด๋ executed=false |
| ์ข ๋ฃ์ ๋ค์ ์์์ ๊ตฌ๋ถ | ์ด ์์ ์์ 15:00 ์ข ๋ฃยท15:00 ์์์ ์ถฉ๋ํ์ง ์์ |
์ค์๋น์ค์ ์ฒญ์ยท์ค๋น ์๊ฐ์ด ์์ผ๋ฉด ๊ทธ ๊ฐ๊ฒฉ๋ ๊ท์น์ผ๋ก ๋ฃ์ด์ผ ํฉ๋๋ค. ์์ ์ ์๊ฐ ์ ์ฑ ์ ์์ ์ ์ ์ข ์ ์ฑ ์ด๋ผ๊ณ ๊ทธ๋๋ก ๊ฐ์ ธ์ค๋ฉด ์ ๋ฉ๋๋ค. ๊ฒ์ฌ ์ฝ๋๋ โ์ด ์ ๋ฌด์์ ๋ง๋คโ๋ ํฉ์๋ฅผ ํํํฉ๋๋ค.
3. ์คํํ๋ ์์์ ์์ ๊ฒฐ๊ณผ
์๋ด๋ฌธ์ ๋ณด๊ณ ontology_lab.py, sample_data.json, test_ontology_lab.py๋ฅผ ๊ฐ์ ํด๋์ ์ ์ฅํฉ๋๋ค.
python ontology_lab.py
python -m unittest -v test_ontology_lab.py
# ์ฒซ ๋ช
๋ น: ready_for_review / executed: false
# ๋ ๋ฒ์งธ ๋ช
๋ น: ๊ฐ๋ณ ๊ฒ์ฌ ๊ฒฐ๊ณผ์ OK๊ฐ ๋์ค๋์ง ์ง์ ํ์ธ
# python ๋ช
๋ น์ด ์๋ค๋ฉด python3 ์ฌ์ฉ
# ๋ฐ๊ฟ๋ณด๊ธฐ:
# remaining_sessions ํ๋๋ฅผ ์ญ์ โ ํ์ธ ํ์
# remaining_sessions๋ฅผ 0์ผ๋ก ๋ณ๊ฒฝ โ ์ฐจ๋จ
# ๊ธฐ์กด ์์ฝ์ start๋ฅผ 14:30์ผ๋ก ๋ณ๊ฒฝ โ ์๊ฐ ์ถฉ๋ ์ฐจ๋จ4. AI์๊ฒ ์์ ์์ฒญ์ ํ ๋๋ ์ฆ์์ ์๊ฒ ์ค๋ค
์ฆ์: ์์ฌ ํ์๊ฐ ์๋ ๊ณ ๊ฐ์๊ฒ ์ด์ฉ ๊ฐ๋ฅ์ผ๋ก ๋์ต๋๋ค.
์ฌํ ์
๋ ฅ: sample_data.json์์ remaining_sessions๋ง ์ญ์ ํฉ๋๋ค.
๊ธฐ๋ ๊ฒฐ๊ณผ: needs_information. ์์ฌ 0ํ์ ๋ค๋ฅธ ๊ฒฐ๊ณผ์ฌ์ผ ํฉ๋๋ค.
๋ฒ์: ๊ด๋ จ ํ์ ๊ณผ ํ๊ท ๊ฒ์ฌ๋ง ์์ ํฉ๋๋ค.
๋ณด๊ณ : ์์ธ, ๋ฐ๋ ํ์ผ, ์ค์ ์คํํ ๊ฒ์ฌ ๋ช
๋ นยท์ถ๋ ฅ, ๋จ์ ์ ํ.
๊ธ์ง: ์ค์ ๊ณ ๊ฐ ๋ฐ์ดํฐ๋ ์ธ๋ถ ์๋น์ค ์ฐ๊ฒฐ๋ก ๋ฌธ์ ๋ฅผ ์ฌํํ์ง ์์ต๋๋ค.์ค๋ฅ ํ๋ฉด๋ง ์ฃผ๊ธฐ๋ณด๋ค ์ ๋ ฅยท๊ธฐ๋ ๊ฒฐ๊ณผยท์ค์ ๊ฒฐ๊ณผ๋ฅผ ๊ฐ์ด ์ฃผ๋ฉด ํ์ธํ๊ธฐ ์ฝ์ต๋๋ค. ๊ฐ์ ์คํจ๋ฅผ ๊ณ ์น ๋ค์๋ ์ ์ ์ ๋ ฅ๋ ๊ณ์ ํต๊ณผํ๋์ง ํ์ธํฉ๋๋ค. ์ด๊ฒ์ด ํ๊ท ํ์ธ์ ๋๋ค.
5. ๋ฐฐํฌ ์ ๋ง์ง๋ง์ผ๋ก ํ์ธํ ๊ฒ
- ์ฐจ์ด ๋ณด๊ธฐ: ์์ ํ ํ์ผ๊ณผ ์ค์ ์ฐจ์ด๊ฐ ์์ฒญ ๋ฒ์ ์์ธ์ง ํ์ธํฉ๋๋ค.
- ์คํ ๊ฒฝ๊ณ: ํ๋ฉด์ด ์๋๋ผ ์๋ฒ๊ฐ ๊ณ ๊ฐยท๋งค์ฅยทํ๋ ๊ถํ์ ํ์ธํ๋์ง ๋ด ๋๋ค.
- ๋์์ฑ: ๋ ์์ฒญ์ด ๋์์ ์ค๋ฉด ๋ง์ง๋ง ์ถฉ๋์ ์ด๋์์ ๋ง์์ง ์ ํฉ๋๋ค. ์ด ์ฝ๊ธฐ ์ ์ฉ ์์ ์๋ ์ค์ ์์ฝ ํธ๋์ญ์ ์ด ์์ต๋๋ค.
- ๋ณต๊ตฌ: ์คํจ ์ ๋๋๋ฆด ๋ฒ์ ์ ๊ธฐ๋กํฉ๋๋ค. ์ด์ ๋ฐ์ดํฐ ๋๋๋ฆฌ๊ธฐ๋ ์ฝ๋ ๋๋๋ฆฌ๊ธฐ์ ๋ณ๊ฐ์ ๋๋ค.
- ๋ณด๊ณ : ๋ก์ปฌ ๊ฒ์ฌ ์ฑ๊ณต, ๋ฐฐํฌ ์ฑ๊ณต, ์ฌ์ฉ์ ํ๋ฆ ์ฑ๊ณต์ ๊ฐ๊ฐ ํ์ธํฉ๋๋ค. ํ๋๊ฐ ๋ค๋ฅธ ํ๋์ ์ฆ๊ฑฐ๊ฐ ๋์ง๋ ์์ต๋๋ค.
์ง์นจ์ ์ ์ ์ฝ์๊ณผ, ์คํ ๊ฒฝ๊ณ์์ ํ์ธํ ๊ท์น
์์์ ์ ๋ฌด ๊ท์น์ ๊ฒ์ฌ ์ฝ๋๋ก ๋ฐ๊ฟจ์ต๋๋ค. ์ด๋ฒ์๋ ๊ทธ ๊ท์น์ด ์ด๋์์ ์๋ํ๋์ง ๊ตฌ๋ถํฉ๋๋ค. CLAUDE.md์ โ์น์ธ ์์ด ํ์ผ์ ๋ฐ๊พธ์ง ๋ง ๊ฒโ์ด๋ผ๊ณ ์ฐ๋ฉด ๋ชจ๋ธ์ด ์ฐธ๊ณ ํ ์ง์นจ์ด ๋ฉ๋๋ค. ๊ทธ๋ฌ๋ ๊ทธ ๋ฌธ์ฅ ์์ฒด๊ฐ ํ์ผ ์์คํ ์ ์ฐ๊ธฐ ๊ถํ์ ์์ ์ง๋ ์์ต๋๋ค. ์๋ ๊ธฐ์ต๋ ์ง๋ ๊ตํ์ ์ฌ์ฌ์ฉํ๋ ์๋จ์ด์ง ์น์ธ ์ฅ์น๊ฐ ์๋๋๋ค.
| ์ธต | ๋จ๊ธฐ๋ ๊ฒ | ํ์ธํ ์ง๋ฌธ |
|---|---|---|
| ํ๋ก์ ํธ ์ง์นจ | ์์ ๋ฒ์ยท๊ฒ์ฌ ๋ช ๋ นยท์๋ฃ ๋ณด๊ณ ๊ธฐ์ค | ์ ์ธ์ ์ด ์ฝ๊ณ ์ดํดํ๋๊ฐ? |
| ์๋ ๊ธฐ์ต | ์ฌ์ฌ์ฉํ ๊ตํยท์ ํธ | ์ค๋๋๊ฑฐ๋ ํ๋ฆฐ ๊ธฐ๋ก์ ๊ณ ์ณค๋๊ฐ? |
| ๊ถํยทPreToolUse ๋ฑ | ์คํ ์ ํ์ฉยท์ฐจ๋จ ํ๋จ | ๊ธ์ง๋ ์ ๋ ฅ์ด ์ค์ ๋ก ์ฐจ๋จ๋๋๊ฐ? |
| PostToolUse ๊ฒ์ฌ | ์ด๋ฏธ ํ ๋ณ๊ฒฝ์ ๊ฒฐ๊ณผ ํ์ธ | ์คํจ๊ฐ ๋ณด์กดยท๋ณด๊ณ ๋๋๊ฐ? |
10๋ถ ์ค์ต: โํญ์ ์ํด๋ผโ ๊ฐ์ ์ถ์ ๊ท์น ๋์ ์์ ์ ์ฅ์์ ์ง์นจ์ ๋ค์ฏ ์ค๋ก ์ ์ผ์ธ์. โ ์ด๋ฒ ๋ณ๊ฒฝ ๋ฒ์ โก๋จผ์ ์ฌํํ ์ฆ์ โข์คํํ ๊ฒ์ฌ โฃ๋ฏธ์คํ ๊ฒ์ฌ์ ๋ณด๊ณ ๋ฐฉ์ โค์ปค๋ฐยท๋ฐฐํฌ ์น์ธ ๊ฒฝ๊ณ๋ฅผ ํฌํจํฉ๋๋ค. ๊ทธ๋ฐ ๋ค์ ๋ชจ๋ธ์๊ฒ ๊ฐ ์ค์ ์ด๋ป๊ฒ ๊ฒ์ฆํ ์ง ์ค๋ช ํ๊ฒ ํ๊ณ , ์ค๋ช ๊ณผ ์ค์ ๊ฒฐ๊ณผ๋ฅผ ๋ฐ๋ก ๊ธฐ๋กํฉ๋๋ค.
์๋ ๋ค์ฏ ์ค์ 3๊ถ๊ณผ ํจ๊ป ์ฐ๋ reader_lab.py์ ๊ฐ์ ์์ฅ ํ์ ์ ๋์์ผ๋ก ํฉ๋๋ค. ๋ค์ ์์ฌ ํ์ ์์ ๊ณผ์ ์๋ ๊ฒ์ฌ ๋์์ด ๋ค๋ฆ
๋๋ค. ๊ทผ๊ฑฐ ๋๋ฝ์ needs_evidence์ ์์ฌ ํ์ ๋ฏธํ์ธ์ needs_information์ ์๋ก ๋ฐ๊ฟ ์ฐ์ง ๋ง์ธ์.
์ด๋ฒ ์์ ์ ๊ฐ์ ์์ฅ์ ๊ทผ๊ฑฐยท์น์ธ ํ์ ๋ง ๋ค๋ฃฌ๋ค. ํ์ฌ ํ์ผ์์ ๊ทผ๊ฑฐ๊ฐ ์์ผ๋ฉด needs_evidence, ์น์ธ์ด ์์ผ๋ฉด awaiting_approval์ธ์ง ๋จผ์ ํ์ธํ๋ค. python examples/claude-code-checks/run_checks.py ๋ฅผ ์คํํ๋ค. ์คํํ์ง ๋ชปํ ๊ฒ์ฌ๋ ๋ฏธ์คํ์ผ๋ก ์ฐ๊ณ ์์ธ์ ๋จ๊ธด๋ค. diff๋ฅผ ๊ฒํ ํ ๋ค์๋ง ๋ค์ ๋จ๊ณ๋ก ๋๊ธฐ๋ฉฐ ์ปค๋ฐยท๋ฐฐํฌ๋ ๋ณ๋ ์น์ธํ๋ค.
์ด ์ง์นจ์ผ๋ก ๋ณด์ฅ๋๋ ๊ฒ๊ณผ ์ ๋๋ ๊ฒ
์ข์ ๋ต์ ๋ณ๊ฒฝ ๋ฒ์์ ๊ฒ์ฌ ๊ฒฐ๊ณผ๋ฅผ ์ถ์ ํ ์ ์๊ฒ ํด์ค๋๋ค. ํ์ง๋ง โํ์ผ์ ์ ์์ผ๋ ์ธ๋ถ ๋ฐ์ก์ด ๋ถ๊ฐ๋ฅํ๋คโ๊ณ ๊ฒฐ๋ก ๋ด๋ฆฌ๋ฉด ์ค๋ต์ ๋๋ค. ์ค์ ๊ฒฝ๊ณ๋ ์ฌ์ฉ ๊ฐ๋ฅํ ๋๊ตฌยท์ด์์ฒด์ ๊ถํยท์๋น์ค ์ธก ์ธ๊ฐยท์น์ธ ์ ์ฐจ๋ก๋ ํ์ธํด์ผ ํฉ๋๋ค. ์ง์นจ ํ์ผ์๋ API ํค๋ ๊ณ ๊ฐ ์๋ฌธ์ ๋ฃ์ง ์์ต๋๋ค.
ํ ์คํธ๊ฐ ์คํจํ๋๋ฐ ๋ง์ง๋ง ์ค์ ์ฑ๊ณต์ด๋ผ๋ฉด
๊ฒ์ฌ๋ฅผ ์๋์ผ๋ก ์คํํ๋ ๊ฒ๋ณด๋ค ์ค์ํ ๊ฒ์ ์คํจ๋ฅผ ์์ง ์๋ ๊ฒ์ ๋๋ค. ์ ธ ํ์ดํ๋ผ์ธ์ ๋ง์ง๋ง ๋ช ๋ น์ด ์ฑ๊ณตํ๋ฉด ์์ชฝ ํ ์คํธ ์คํจ๊ฐ ์จ๊ฒจ์ง ์ ์์ต๋๋ค. ์ด ์ฑ ์ Hooks ์์ ๋ ์ด์ tail๋ก ์ถ๋ ฅ์ ์๋ผ์ ๋๊ธฐ๋ ๋์ Python ์คํ๊ธฐ๊ฐ ์์ ๊ฒ์ฌ ํ๋ก์ธ์ค์ ์ข ๋ฃ์ฝ๋๋ฅผ ๊ทธ๋๋ก ๋ฐํํฉ๋๋ค. ์ถ๋ ฅ๋ ๊ทธ๋๋ก ๋ณด์ฌ์ฃผ๋ฏ๋ก ์ค๋ฅ์ ์๋ค ๋งฅ๋ฝ์ ํ์ธํ ์ ์์ต๋๋ค.
python examples/claude-code-checks/run_checks.py python examples/claude-code-checks/run_checks.py --demo-failure
๋ ๋ฒ์งธ ๋ช
๋ น์ ์คํจ ์ ๋ฌ์ ํ์ธํ๋ ์๋์ fixture์
๋๋ค. ์คํ ์งํ PowerShell์ $LASTEXITCODE, Bash๋ echo $?๋ฅผ ํ์ธํ์ธ์. ์ ์ ๊ฒ์ฌ๋ 0, ์๋์ ์คํจ๋ 1์ด์ด์ผ ํฉ๋๋ค. ์คํจ๋ฅผ ์จ๊ธฐ์ง ์๋ ์คํ๊ธฐ๋ฅผ ๋ง๋ค์๋ค๊ณ ํด์ Claude Code๊ฐ ๋ชจ๋ ์ด๋ฒคํธ๋ฅผ ๊ฐ์ ๋ฐฉ์์ผ๋ก ์ฐจ๋จํ๋ ๊ฒ์ ์๋๋๋ค.
์ด๋ฒคํธ ๊ฒฝ๊ณ: PreToolUse๋ ์คํ ์ ๋๊ตฌ ํธ์ถ์ ๋ง์ ์ ์์ต๋๋ค. PostToolUse๋ ๋๊ตฌ๊ฐ ์ด๋ฏธ ์คํ๋ ๋ค์์ด๋ฏ๋ก ์ข ๋ฃ์ฝ๋๋ก ๊ณผ๊ฑฐ์ ๋ณ๊ฒฝ์ ์ทจ์ํ ์ ์์ต๋๋ค. PostToolUse์์ ๊ฒ์ฌ ์คํจ๋ฅผ ๋ณด์๋ค๋ฉด ๋ค์ ์์ ยท๊ฒํ ๋ก ์ฐ๊ฒฐํ๊ณ , ์๋ณต์ด ํ์ํ๋ฉด diff๋ฅผ ํ์ธํ ํ ๋ณ๋๋ก ์ํํฉ๋๋ค. Stop ๋ฑ ๋ค๋ฅธ ์ด๋ฒคํธ์ ์ข ๋ฃ์ฝ๋ ์๋ฏธ๋ ๊ฐ๋ค๊ณ ๊ฐ์ ํ์ง ๋ง์ธ์.
์คํ๋ผ์ธ ์ฐจ๋จ ์ค์ต: ์ ๊ณต๋ hook_guard.py๋ Read๋ง ํ์ฉํ๋ ๊ต์ก์ฉ ํ์ฉ๋ชฉ๋ก์ ๋๋ค. ๊ฒ์ฌ ์ฝ๋๋ Read ์ ๋ ฅโ0, Write ์ ๋ ฅโ2, ์๋ชป๋ JSONโ2๋ฅผ ์ง์ ํ์ธํฉ๋๋ค. ์ ๋ฌ๋ ํ์ผ ๊ฒฝ๋ก๋ ๋ช ๋ น์ ์ค์ ์คํํ์ง ์์ผ๋ฏ๋ก ์ญ์ ยท๋ฐ์ก์ด ๋ฐ์ํ์ง ์์ต๋๋ค. ์ด ํ์ผ์ Claude Code์ ์๋ ์ค์น๋์ง ์์ผ๋ฉฐ, ์ ์ฒด ๋ณด์ ํด๋ฒ๋ ์๋๋๋ค.
๋น ํด๋์ ์์ถ์ ํ๊ณ , examples ํด๋๊ฐ ๋ณด์ด๋ ์์น์์ ์ ๋ช
๋ น์ ์คํํ์ธ์. ์ด ๋ฌถ์์ Claude Code ์ค์ ์ ์๋ ๋ณ๊ฒฝํ์ง ์์ต๋๋ค.
๊ต์ก์ฉ guard ยท ์คํ ๋ฐฉ๋ฒ๊ณผ ํ๊ณ
๊ฒ์ฌ ํ ๋จ๊ธธ ๋ณด๊ณ ์
๋ณ๊ฒฝ ์ ์ฆ์: ์์ ํ ํ์ผ๊ณผ ๋ฒ์: ์คํํ ๋ช ๋ น / ์ข ๋ฃ์ฝ๋: ํ์ฉ fixture / ์ฐจ๋จ fixture ๊ฒฐ๊ณผ: ๋ฏธ์คํ ๊ฒ์ฌ์ ์ด์ : ์ค์ ์ธ๋ถ ๋์: ์์ ๋ค์ ๊ฒํ ์ / ๋ณต๊ตฌ ๋ฐฉ๋ฒ:
ํฉ๊ฒฉ์ ์ด๋ก์ ๋ฉ์์ง๋ฅผ ์บก์ฒํ๋ ๊ฒ์ด ์๋๋ผ ์ ์0ยท์๋์ ์คํจ1ยท์ฐจ๋จ2๋ฅผ ๊ตฌ๋ณํ๊ณ , ์ค์ ๋ก ์คํํ์ง ์์ ํตํฉ ๊ฒ์ฌ๋ ๋ฏธ์คํ์ด๋ผ๊ณ ์ฐ๋ ๊ฒ์ ๋๋ค. ๋ค์ ์ฝ๋ ์์ ์ค์ต์์๋ ํ ์คํธ๋ฅผ ์ฝํ๊ฒ ๋ฐ๊ฟ ํต๊ณผ์ํค์ง ๋ง๊ณ ์ ๋ฌด ๊ท์น์ ๋ณด์กดํ์ธ์.
2026-10-31 ๊ณต์ ๋ฌธ์ ํ์ธ: ์ง์นจ๊ณผ ์๋ ๊ธฐ์ต ยท Hooks ์ ๋ ฅยท์ถ๋ ฅ๊ณผ ์ด๋ฒคํธ๋ณ ์ข ๋ฃ์ฝ๋. ์ฌ๊ธฐ์๋ Claude Code ํตํฉ ๋์์ ์ฌํํ๋ค๊ณ ์ฃผ์ฅํ์ง ์์ต๋๋ค. ๋ก์ปฌ Python fixture๋ง ์คํํ๋ฉฐ ์ค์ ์ ์ฉ์ ์ค์น ๋ฒ์ ยท์ด์์ฒด์ ยท๊ถํ ์ค์ ์ ๋ง์ถฐ ๋ณ๋ ํ์ธํฉ๋๋ค.
๋ด ์ ๋ฌด ํ๋๋ก ์์ฑํ๋ ์ธ์ ๋ฌถ์
4๊ถ ์ ์ฉ ๊ณผ์ : ์ ๋ฌด ์์ฑ ํคํธ์ 3๋จ๊ณ์ ๋ณ๊ฒฝ ์ ์ฆ๊ฑฐยท์์ ๋ฒ์ยท๋ณ๊ฒฝ ํ ํ์ธยท๋ฏธ์คํ ๊ฒ์ฌ๋ฅผ ๋จ๊ธฐ์ธ์. ๋ฌธ์ ์์ ์ ์๋ ๋์กฐ ์ฆ๊ฑฐ๋ฅผ ์ฌ์ฉํ๊ณ ๋ช ๋ นยท์ข ๋ฃ์ฝ๋๋ ๋น์๋ก๋๋ค. ์ฝ๋ ์์ ์ ์ค์ ์คํํ ๋ช ๋ น๊ณผ ๊ฒฐ๊ณผ๋ฅผ ๊ธฐ๋กํด ๋ค์ ๋ด๋น์๊ฐ ๊ฒํ ํ ์ ์๊ฒ ํฉ๋๋ค.
์ํฌ๋ถยท์์ฑ ์์ยท์์ยท์คํ๋ผ์ธ ์์ฑ ๋๊ตฌ ๋ฐ๊ธฐ ยท ZIP ยท ์น์์ ์์ ์ด๊ธฐ
์ง๊ธ ์ฝ๋ ๊ถ์ ์ฐ์ถ๋ฌผ๋ง ์ด์์ผ๋ก ์ ์ฅํด๋ ๋ฉ๋๋ค. ๋ค์ฏ ๊ถ ์ ์ฒด ์ธ์ ๊ณผ์ ๋ ์ ํ ์ฌํ ๊ฒฝ๋ก์ ๋๋ค. ํ๊ตญ์ดยท์์ด ์๋ด ์ํฌ๋ถ๊ณผ ๋น ์์์ด ํฌํจ๋ฉ๋๋ค. ์์ด ์๋ด๋ 5๊ถ ์ ์ฒด ๋ฒ์ญ๋ณธ์ ๋ปํ์ง ์์ต๋๋ค. ์์ฑ ๋๊ตฌ๋ ์ ๋ ฅ ์๋ฃ๋ฅผ ๋ฌธ์๋ก ์ ๋ฆฌํ๋ฉฐ, ready_for_review๋ ๋ฌธ์ ๊ฒํ ์ค๋น์ ๋๋ค. ์ค์ ์ฑ ์ฐ๋ยท์น์ธยท์ธ๋ถ ์คํ์ ๋ณ๋์ ๋๋ค.
๊ฒ์ฌ๋ฅผ ํต๊ณผ์ํค๋ ์์ ๊ณผ, ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ๋ ์์
2026.10.31 ยท ์์ธกํ๊ณ , ์คํํ๊ณ , ๊ฒฐ๊ณผ๋ฅผ ์ค๋ช ํ๋ ์ค์ต
AI์๊ฒ โํ ์คํธ๋ฅผ ๋ชจ๋ ํต๊ณผ์์ผ๋ผโ๋ผ๊ณ ๋ง ๋งํ๋ฉด ์๋ชป๋ ๋์์ ๊ณ ์น๋ ๋์ ๊ฒ์ฌ๋ฅผ ๋์จํ๊ฒ ๋ง๋ค ์๋ ์์ต๋๋ค. ๋จผ์ ์ ์งํด์ผ ํ ์ ๋ฌด ๊ท์น์ ์ ์ด๋์ธ์. ์ด๋ฒ ์ค์ต์ ๊ท์น์ ์์ฌ ํ์๋ฅผ ๋ชจ๋ฅด๋ฉด ํ์ธ ํ์, ํ์ธ๋ 0ํ๋ฉด ์ฐจ๋จ, ์ ์ ์กฐ๊ฑด์ด๋ฉด ๊ฒํ ์ค๋น์ ๋๋ค. ์ค์ ์์ฝ์ ์คํํ์ง ์์ต๋๋ค.
Claude Code์ ํ์ฌ ํ๋ก์ ํธ์ ์ง์นจ์ ์ฝ๊ฒ ํ๊ณ , ์ด ํ์ ์ ๋ด๋นํ๋ ํ์ผ๊ณผ ๊ฒ์ฌ ํ์ผ์ ์ฐพ๊ฒ ํ์ธ์. ๋ค์์ผ๋ก ๋๋ฝ ๊ฐ์ 0์ผ๋ก ์ทจ๊ธํ๋ ๋ฌธ์ ๊ฐ ์ค์ ๋ก ์๋์ง ํ์ธํฉ๋๋ค. ๋ฌธ์ ๊ฐ ์๋ค๋ฉด ์ ์ ๋์์ ๊นจ๋จ๋ ค ๊ณ ์น ํ์๋ ์์ต๋๋ค. ์ฐ์ต์ฉ ๋ณต์ฌ๋ณธ์์๋ง ์๋ชป๋ ์กฐ๊ฑด์ ๋ฃ๊ณ ์คํจ๋ฅผ ์ฌํํฉ๋๋ค.
์์ ์์ฒญ์ ๋ค์์ฒ๋ผ ๊ตฌ์ฒด์ ์ผ๋ก ์ ์ต๋๋ค. โ์ ๋ฌด ๊ท์น๊ณผ ๊ธฐ๋ ๊ฒฐ๊ณผ๋ ์ ์งํ์ธ์. ๋จผ์ ์คํจํ๋ ์ ๋ ฅ๊ณผ ์ถ๋ ฅ์ ๋ณด์ฌ์ฃผ๊ณ , ์์ธ์ด ๋๋ ์กฐ๊ฑด์ ์ต์ํ์ผ๋ก ์์ ํ์ธ์. ๊ฒ์ฌ ํ์ผ์ ๋ฐ๊ฟ์ผ ํ๋ค๋ฉด ์ด์ ๋ฅผ ์ค๋ช ํ์ธ์.โ ๊ฒ์ฌ ๋ณ๊ฒฝ์ด ๋ฌด์กฐ๊ฑด ๋์ ๊ฒ์ ์๋๋๋ค. ์ค์ํ ๊ฒ์ ์ ํ์ ์๊ตฌ์ฌํญ์ ๋ชฐ๋ ๋ฐ๊พธ์ง ์๋ ๊ฒ์ ๋๋ค.
๊ฒฐ๊ณผ ๋ณด๊ณ ์์๋ ๋ฐ๋ ์ฝ๋๋ณด๋ค ์ฆ๊ฑฐ๋ฅผ ๋จผ์ ๋ด ๋๋ค. ์ด๋ค ๋ช ๋ น์ ์คํํ๋์ง, ๋๋ฝยท0ยท์ ์ ์ ๋ ฅ์ด ๊ฐ๊ฐ ๋ฌด์์ ๋ฐํํ๋์ง, ์คํํ์ง ๋ชปํ ๊ฒ์ฌ๋ ๋ฌด์์ธ์ง ํ์ธํ์ธ์. ์ด์ด ๋ณ๊ฒฝ ๋ด์ญ์ ์ด์ด ๊ด๋ จ ์๋ ํ์ผ์ด๋ ์ค์ ์ด ํจ๊ป ๋ฐ๋์ง ์์๋์ง ์ดํด๋ด ๋๋ค.
Claude Code์ ์์ ์๋ฃ ๋ฉ์์ง๋ ๊ฒ์์ ์์์ ๋๋ค. ๊ฒฐ๊ณผ๊ฐ ๋ง์๋ ์ด์ ๋ฐฐํฌ๋ ๋ณ๋ ๋จ๊ณ์ด๊ณ , ์ฝ๋ ๋๋๋ฆฌ๊ธฐ๋ก ์ธ๋ถ์์ ์ด๋ฏธ ๋ฐ์ํ ๋ณ๊ฒฝ๊น์ง ์ทจ์ํ ์ ์๋ ๊ฒ์ ์๋๋๋ค. ์ด๋ฒ ๊ณผ์ ๋ ์ฐ์ต์ฉ ์ฝ๋์ ์์ ๊ณผ ๊ฒ์ฆ์์ ๋๋ ๋๋ค. ๋จ๊ธธ ์ฐ์ถ๋ฌผ์ ๋ณ๊ฒฝ ์ ์ฌํ ๊ฒฐ๊ณผ, ์์ ๋ด์ญ, ๋ณ๊ฒฝ ํ ๊ฒ์ฌ ๊ฒฐ๊ณผ, ๋จ์ ํ๊ณ ๋ค ๊ฐ์ง์ ๋๋ค.
ํ์ฌ ํ์ผ๊ณผ ํ๋ก์ ํธ ์ง์นจ์ ๋จผ์ ์ฝ์ด์ค. ์๊ตฌ์ฌํญ์ ์ ์งํ ์ฑ ๋ฌธ์ ๋ฅผ ์ฌํํ๊ณ ์ต์ ์์ ํด์ค. ๋ณด๊ณ ์๋ ์๋๋ฅผ ํฌํจํด์ค. 1. ์ฌํ ์ ๋ ฅ๊ณผ ์์ ์ ๊ฒฐ๊ณผ 2. ์์ ํ ํ์ผ๊ณผ ์ด์ 3. ์ค์ ์คํํ ๊ฒ์ฌ์ ๊ฒฐ๊ณผ 4. ์คํํ์ง ๋ชปํ ๊ฒ์ฌ์ ๋จ์ ์ํ ๊ด๋ จ ์๋ ๊ธฐ๋ฅ๊ณผ ์ด์ ์ค์ ์ ๋ณ๊ฒฝํ์ง ๋ง.
API ํธ์ถ ์์ ์ Agent SDK์ ๋ฒ์
์ด ์ ์ import anthropic์ client.messages.create() ์์ ๋ Claude API๋ฅผ ํธ์ถํ๋ Client SDK ์์ ์
๋๋ค. ํธ์ถ์ ์์๋๋ก ์ฐ๊ฒฐํ๊ฑฐ๋ ๋ณ๋ ฌ๋ก ์คํํ๋ ๋ฐฉ๋ฒ์ ๋ณด์ฌ์ค๋๋ค. Claude Agent SDK๋ Claude Code์ ๋๊ตฌยท์์ด์ ํธ ๋ฃจํยท์ปจํ
์คํธ ๊ด๋ฆฌ ๋ฑ์ ์ ํ๋ฆฌ์ผ์ด์
์์ ์ฌ์ฉํ๋ ๋ณ๋ SDK์ด๋ฏ๋ก ์ด๋ฆ๊ณผ ์ค์น ๋ฐฉ๋ฒ์ ๊ตฌ๋ถํด์ผ ํฉ๋๋ค.
๊ณต์ ๋ฌธ์๋ CLI, Client SDK, Agent SDK๋ฅผ ๊ตฌ๋ถํ๋ค. Claude Agent SDK ๊ฐ์
์คํ ์ ํ์ธํ๋ ํ์ฌ ๋ชจ๋ธ๊ณผ ๋น์ฉ
2026-10-31 ๊ณต์ Claude API ๊ฐ์ ๊ธฐ์ค. ์๋ ๊ฐ์ ์ ๋ ฅ/์ถ๋ ฅ 100๋ง ํ ํฐ๋น USD์ด๋ฉฐ ๊ตฌ๋ ์๊ธ์ด ์๋๋๋ค. Haiku๋ ์์ ๊ฐ๊ฒฉ์ด๊ณ ์ต์ ยทํ๋ซํผ์ ๋ฐ๋ผ ๋ฌ๋ผ์ง ์ ์์ต๋๋ค.
| ๋ชจ๋ธ ID | ์ ๋ ฅ / ์ถ๋ ฅ | ๋น๊ตํ ์ฉ๋ |
|---|---|---|
claude-haiku-5-5 | ๋ถํฐ $0.10 / $0.50 | ๋ถ๋ฅยท์ถ์ถยท๋ผ์ฐํ |
claude-sonnet-5-5 | $2 / $10 | ์๋ยทํ์ง ๊ท ํ |
claude-opus-5-5 | $4 / $20 | ๋ณต์กํ ์ฝ๋ฉยท์ง์ ์ ๋ฌด |
claude-fable-5-1 | $10 / $50 | ์ฅ๊ธฐยท๊ณ ๋๋ ์์ |
์ ํ์ ๊ฐ์ ์ํ์ ์ ๋ต๋ฅ ยท๊ฒ์ ์๊ฐยท๋น์ฉ์ผ๋ก ๊ฒฐ์ ํฉ๋๋ค. ๋ชจ๋ธ ์ด๋ฆ๋ง ๋ฐ๊พผ ์ฝ๋๊ฐ ํธํ๋๋ค๊ณ ๊ฐ์ ํ์ง ๋ง์ธ์. ๊ณผ๊ฑฐ ์ฌ๋ก์ ๋น์ ๋ชจ๋ธ๋ช ์ ๊ธฐ๋ก์ผ๋ก ๋ณด์กดํฉ๋๋ค.
๊ณต์ ๋ชจ๋ธยท๊ฐ๊ฒฉยท๊ธฐ๋ฅ ํ์ธ ยท Claude Code ์ค์น ์๋ด