minssam.
Published on

Claude Code 4์›” ์—…๋ฐ์ดํŠธ: /powerupยทMCP ๊ฐœ์„ ์œผ๋กœ AI ์ฝ”๋”ฉ์˜ ํŒ์ด ๋ฐ”๋€๋‹ค

"Claude Code ์“ฐ๊ณ  ์‹ถ์€๋ฐ, ์–ด๋””์„œ๋ถ€ํ„ฐ ์‹œ์ž‘ํ•ด์•ผ ํ• ์ง€ ๋ชจ๋ฅด๊ฒ ์–ด์š”."

์ด๋Ÿฐ ์ด์•ผ๊ธฐ๋ฅผ ์ •๋ง ๋งŽ์ด ๋“ค์—ˆ์Šต๋‹ˆ๋‹ค. ๊ธฐ๋Šฅ์€ ๋งŽ์€๋ฐ, ์ฒ˜์Œ ์ ‘ํ•˜๋Š” ์‚ฌ๋žŒ์—๊ฒŒ๋Š” ๋ง‰๋ง‰ํ•˜๊ฒŒ ๋А๊ปด์ง€๋Š” ๊ฒŒ ์‚ฌ์‹ค์ž…๋‹ˆ๋‹ค. ๊ทธ๋Ÿฐ๋ฐ 2026๋…„ 4์›” ์—…๋ฐ์ดํŠธ ์ดํ›„ ์ด ์ง„์ž…์žฅ๋ฒฝ์ด ํ™• ๋‚ฎ์•„์กŒ์Šต๋‹ˆ๋‹ค.

์ด๋ฒˆ ์—…๋ฐ์ดํŠธ์˜ ํ•˜์ด๋ผ์ดํŠธ๋Š” ๋‹จ์ˆœํ•œ ๋ฒ„๊ทธ ํ”ฝ์Šค๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค. /powerup ์ธํ„ฐ๋ž™ํ‹ฐ๋ธŒ ํŠœํ† ๋ฆฌ์–ผ, MCP ์—ฐ๊ฒฐ ์†๋„ ๊ฐœ์„ , ํ›…(Hook) ์‹œ์Šคํ…œ ํ™•์žฅ๊นŒ์ง€ โ€” ์›Œํฌํ”Œ๋กœ์šฐ ์ž์ฒด๋ฅผ ๋ฐ”๊พธ๋Š” ๋ณ€ํ™”๋“ค์ด ํ•จ๊ป˜ ์™”์Šต๋‹ˆ๋‹ค. ์—๋“€ํ…Œํฌ CEO์ด์ž Claude Code๋ฅผ ๋งค์ผ ์“ฐ๋Š” ์‚ฌ์šฉ์ž ์ž…์žฅ์—์„œ ํ•ต์‹ฌ๋งŒ ๋ฝ‘์•„ ์ •๋ฆฌํ•ฉ๋‹ˆ๋‹ค.


๋ชฉ์ฐจ

  1. /powerup: ๋ฐฐ์šฐ๋ฉด์„œ ์“ฐ๋Š” AI ์ฝ”๋”ฉ ํŠœํ„ฐ
  2. MCP ์—ฐ๊ฒฐ ๊ฐœ์„ : ๊ธฐ๋‹ค๋ฆผ์ด ์‚ฌ๋ผ์ง„๋‹ค
  3. ํ›… ์‹œ์Šคํ…œ ํ™•์žฅ: ์ž๋™ํ™”์˜ ์ •๋ฐ€๋„๊ฐ€ ์˜ฌ๋ผ๊ฐ„๋‹ค
  4. Named Subagents: AI ํŒ€ํ”Œ๋ ˆ์ด๊ฐ€ ๊ฐ€๋Šฅํ•ด์ง„๋‹ค
  5. ์‹ค์ „ ํ™œ์šฉ ํŒ: ์ง€๊ธˆ ๋‹น์žฅ ์จ๋ณผ ์ˆ˜ ์žˆ๋Š” ๊ฒƒ๋“ค

1. /powerup: ๋ฐฐ์šฐ๋ฉด์„œ ์“ฐ๋Š” AI ์ฝ”๋”ฉ ํŠœํ„ฐ

Claude Code์˜ ๊ธฐ๋Šฅ์„ ์ตํžˆ๋Š” ๊ฐ€์žฅ ๋น ๋ฅธ ๋ฐฉ๋ฒ•์ด ์ƒ๊ฒผ์Šต๋‹ˆ๋‹ค.

/powerup ๋ช…๋ น์–ด๋ฅผ ์ž…๋ ฅํ•˜๋ฉด ์• ๋‹ˆ๋ฉ”์ด์…˜ ๋ฐ๋ชจ์™€ ํ•จ๊ป˜ Claude Code์˜ ํ•ต์‹ฌ ๊ธฐ๋Šฅ์„ ์ธํ„ฐ๋ž™ํ‹ฐ๋ธŒํ•˜๊ฒŒ ๋ฐฐ์šธ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋‹จ์ˆœํžˆ ๋ฌธ์„œ๋ฅผ ์ฝ๋Š” ๊ฒŒ ์•„๋‹ˆ๋ผ, ์‹ค์ œ๋กœ ๊ธฐ๋Šฅ์„ ์‹คํ–‰ํ•ด๋ณด๋ฉด์„œ ์ตํžˆ๋Š” ๋ฐฉ์‹์ž…๋‹ˆ๋‹ค.

๊ต์œก์ž์˜ ๋ˆˆ์œผ๋กœ ๋ณด๋ฉด, ์ด๊ฑด ๋‹จ์ˆœํ•œ ํŠœํ† ๋ฆฌ์–ผ์ด ์•„๋‹™๋‹ˆ๋‹ค. 'ํ–‰ํ•จ์œผ๋กœ ๋ฐฐ์šด๋‹ค(Learning by Doing)'๋Š” ๊ต์œก ์›๋ฆฌ๋ฅผ AI ๋„๊ตฌ์— ์ ์šฉํ•œ ์„ค๊ณ„์ž…๋‹ˆ๋‹ค. ๊ฐœ๋…์„ ๋จผ์ € ์„ค๋ช…ํ•˜๊ณ , ๋ฐ”๋กœ ์‹œ์—ฐํ•˜๊ณ , ์ง์ ‘ ํ•ด๋ณด๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค.

์–ด๋–ค ๋‚ด์šฉ์„ ๋‹ค๋ฃจ๋‚˜์š”?

ํ˜„์žฌ /powerup์ด ๋‹ค๋ฃจ๋Š” ์ฃผ์š” ์˜์—ญ:

  • ๊ธฐ๋ณธ ๋ช…๋ น์–ด: ํŒŒ์ผ ์ˆ˜์ •, ์ฝ”๋“œ ์‹คํ–‰, ๊ฒ€์ƒ‰์˜ ๊ธฐ์ดˆ
  • ์—์ด์ „ํŠธ ๋ชจ๋“œ: ๋ฉ€ํ‹ฐ์Šคํ… ์ž‘์—… ์„ค์ • ๋ฐฉ๋ฒ•
  • ํ›…(Hook) ํ™œ์šฉ: ์ž๋™ํ™” ํŠธ๋ฆฌ๊ฑฐ ์„ค์ •
  • MCP ์„œ๋ฒ„ ์—ฐ๊ฒฐ: ์™ธ๋ถ€ ๋„๊ตฌ ํ†ตํ•ฉ ๋ฐฉ๋ฒ•

์ดˆ๋ณด์ž์™€ ๊ณ ์ˆ˜ ๋ชจ๋‘์—๊ฒŒ ์œ ์šฉํ•œ ์ด์œ 

์ฒ˜์Œ ์“ฐ๋Š” ์‚ฌ๋žŒ์€ ๊ธฐ๋Šฅ ์ „์ฒด๋ฅผ ์ฒด๊ณ„์ ์œผ๋กœ ํŒŒ์•…ํ•  ์ˆ˜ ์žˆ๊ณ , ์ด๋ฏธ ์“ฐ๊ณ  ์žˆ๋Š” ์‚ฌ๋žŒ๋„ ๋ชฐ๋ž๋˜ ๊ธฐ๋Šฅ์„ ๋ฐœ๊ฒฌํ•˜๋Š” ๊ธฐํšŒ๊ฐ€ ๋ฉ๋‹ˆ๋‹ค.


2. MCP ์—ฐ๊ฒฐ ๊ฐœ์„ : ๊ธฐ๋‹ค๋ฆผ์ด ์‚ฌ๋ผ์ง„๋‹ค

MCP(Model Context Protocol) ์„œ๋ฒ„ ์—ฐ๊ฒฐ์ด ๋А๋ฆฌ๋ฉด ์ „์ฒด ์›Œํฌํ”Œ๋กœ์šฐ๊ฐ€ ๋ง‰ํ˜”์Šต๋‹ˆ๋‹ค. ์ด์ œ ๋‹ฌ๋ผ์ง‘๋‹ˆ๋‹ค.

์ด๋ฒˆ ์—…๋ฐ์ดํŠธ์—์„œ ๋‘ ๊ฐ€์ง€ ์ค‘์š”ํ•œ MCP ๊ด€๋ จ ๊ฐœ์„ ์ด ์ด๋ฃจ์–ด์กŒ์Šต๋‹ˆ๋‹ค.

๊ฐœ์„  ์‚ฌํ•ญ๊ธฐ์กด๋ณ€๊ฒฝ ํ›„
MCP_CONNECTION_NONBLOCKING=true-p ๋ชจ๋“œ์—์„œ MCP ์—ฐ๊ฒฐ ๋Œ€๊ธฐ์—ฐ๊ฒฐ ๋Œ€๊ธฐ ์—†์ด ์ฆ‰์‹œ ์‹œ์ž‘
์„œ๋ฒ„ ์—ฐ๊ฒฐ ์ œํ•œ๊ฐ€์žฅ ๋А๋ฆฐ ์„œ๋ฒ„์— ๋ฌถ์—ฌ ๋Œ€๊ธฐ์ตœ๋Œ€ 5์ดˆ ํƒ€์ž„์•„์›ƒ ํ›„ ์ง„ํ–‰

์‰ฝ๊ฒŒ ๋งํ•˜๋ฉด, 10๊ฐœ์˜ MCP ์„œ๋ฒ„ ์ค‘ ํ•˜๋‚˜๊ฐ€ ๋А๋ ค๋„ ์ „์ฒด๊ฐ€ ๊ธฐ๋‹ค๋ฆฌ๋Š” ์ƒํ™ฉ์ด ์‚ฌ๋ผ์ง‘๋‹ˆ๋‹ค. 5์ดˆ๊ฐ€ ์ง€๋‚˜๋ฉด ๋А๋ฆฐ ์„œ๋ฒ„๋Š” ๊ฑด๋„ˆ๋›ฐ๊ณ  ๋‚˜๋จธ์ง€ ์ž‘์—…์„ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.

ํŠนํžˆ ์ž๋™ํ™” ์Šคํฌ๋ฆฝํŠธ(-p ํ—ค๋“œ๋ฆฌ์Šค ๋ชจ๋“œ)๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒฝ์šฐ, MCP_CONNECTION_NONBLOCKING=true ํ™˜๊ฒฝ๋ณ€์ˆ˜ ํ•˜๋‚˜๋กœ ์‘๋‹ต ์†๋„๋ฅผ ํฌ๊ฒŒ ๋Œ์–ด์˜ฌ๋ฆด ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

"๋ณ‘๋ชฉ ํ•˜๋‚˜๊ฐ€ ์ „์ฒด ํŒŒ์ดํ”„๋ผ์ธ์„ ๋ง‰๋Š” ๊ฒƒ์ด ๊ฐ€์žฅ ํฐ ๋น„ํšจ์œจ์ž…๋‹ˆ๋‹ค. ์ด๋ฒˆ ์—…๋ฐ์ดํŠธ๋Š” ๊ทธ ๋ณ‘๋ชฉ์„ ์ œ๊ฑฐํ–ˆ์Šต๋‹ˆ๋‹ค."


3. ํ›… ์‹œ์Šคํ…œ ํ™•์žฅ: ์ž๋™ํ™”์˜ ์ •๋ฐ€๋„๊ฐ€ ์˜ฌ๋ผ๊ฐ„๋‹ค

ํ›…(Hook)์€ Claude Code๊ฐ€ ํŠน์ • ์ด๋ฒคํŠธ์— ๋ฐ˜์‘ํ•ด ์™ธ๋ถ€ ๋ช…๋ น์„ ์‹คํ–‰ํ•˜๋Š” ์ž๋™ํ™” ๊ธฐ๋Šฅ์ž…๋‹ˆ๋‹ค.

์ด๋ฒˆ ์—…๋ฐ์ดํŠธ์—์„œ ํ›… ์‹œ์Šคํ…œ์— ๋‘ ๊ฐ€์ง€๊ฐ€ ์ถ”๊ฐ€๋์Šต๋‹ˆ๋‹ค.

PreToolUse์— 'defer' ์˜ต์…˜ ์ถ”๊ฐ€

๊ธฐ์กด์—๋Š” PreToolUse ํ›…์—์„œ ํ—ˆ์šฉ(allow) ๋˜๋Š” ๊ฑฐ๋ถ€(deny)๋งŒ ๊ฐ€๋Šฅํ–ˆ์Šต๋‹ˆ๋‹ค. ์ด์ œ 'defer(์ง€์—ฐ)' ์˜ต์…˜์ด ์ถ”๊ฐ€๋ฉ๋‹ˆ๋‹ค.

ํ—ค๋“œ๋ฆฌ์Šค ์„ธ์…˜(-p ๋ชจ๋“œ)์—์„œ ํŠน์ • ๋„๊ตฌ ํ˜ธ์ถœ ์‹œ์ ์— ์ž‘์—…์„ ๋ฉˆ์ถ”๊ณ , --resume ํ”Œ๋ž˜๊ทธ๋กœ ๋‹ค์‹œ ์‹œ์ž‘ํ•  ๋•Œ ํ›…์ด ์žฌํ‰๊ฐ€๋ฉ๋‹ˆ๋‹ค. ์‚ฌ๋žŒ์˜ ํŒ๋‹จ์ด ํ•„์š”ํ•œ ์ง€์ ์—์„œ AI๊ฐ€ ์ž ์‹œ ๋Œ€๊ธฐํ•˜๊ณ  ์Šน์ธ์„ ๋ฐ›๋Š” ๋ฐฉ์‹์ž…๋‹ˆ๋‹ค.

PermissionDenied ํ›… ์ถ”๊ฐ€

์ž๋™ ๋ชจ๋“œ(auto mode)์—์„œ AI๊ฐ€ ํŠน์ • ์ž‘์—…์„ ๊ฑฐ๋ถ€๋‹นํ–ˆ์„ ๋•Œ ๋ฐœ์ƒํ•˜๋Š” ์ƒˆ๋กœ์šด ํ›… ์ด๋ฒคํŠธ์ž…๋‹ˆ๋‹ค. ๊ฑฐ๋ถ€ ์ด๋ฒคํŠธ๋ฅผ ๋กœ๊น…ํ•˜๊ฑฐ๋‚˜, ๋Œ€์•ˆ ๊ฒฝ๋กœ๋ฅผ ํŠธ๋ฆฌ๊ฑฐํ•˜๋Š” ๋ฐ ํ™œ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ด ๋‘ ๊ฐ€์ง€๋ฅผ ํ•ฉ์น˜๋ฉด: AI๊ฐ€ ์ž‘์—…ํ•˜๋‹ค ๋ง‰ํžˆ๋ฉด ์‚ฌ๋žŒ์—๊ฒŒ ์•Œ๋ฆฌ๊ณ , ์‚ฌ๋žŒ์ด ํ™•์ธ ํ›„ ์žฌ๊ฐœํ•˜๋Š” ์ •๋ฐ€ํ•œ ์ž๋™ํ™” ํŒŒ์ดํ”„๋ผ์ธ์„ ๊ตฌ์„ฑํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.


4. Named Subagents: AI ํŒ€ํ”Œ๋ ˆ์ด๊ฐ€ ๊ฐ€๋Šฅํ•ด์ง„๋‹ค

๋ณต์žกํ•œ ํ”„๋กœ์ ํŠธ๋ฅผ ํ˜ผ์ž ์ฒ˜๋ฆฌํ•˜๋Š” AI์—์„œ, ์—ญํ• ์„ ๋‚˜๋ˆ  ํ˜‘๋ ฅํ•˜๋Š” AI ํŒ€์œผ๋กœ.

์ด๋ฒˆ ์—…๋ฐ์ดํŠธ์—์„œ @ ๋ฉ˜์…˜ typeahead(์ž๋™์™„์„ฑ)์— Named Subagents๊ฐ€ ์ถ”๊ฐ€๋์Šต๋‹ˆ๋‹ค. ๋ช…๋ช…๋œ ์„œ๋ธŒ์—์ด์ „ํŠธ๋ฅผ @์ด๋ฆ„ ํ˜•ํƒœ๋กœ ํ˜ธ์ถœํ•  ์ˆ˜ ์žˆ๊ฒŒ ๋ฉ๋‹ˆ๋‹ค.

์‹ค์ œ ํ™œ์šฉ ์‹œ๋‚˜๋ฆฌ์˜ค:

  • ํ”„๋ก ํŠธ์—”๋“œ ์ž‘์—…์€ @frontend-agent๊ฐ€, ๋ฐฑ์—”๋“œ API๋Š” @backend-agent๊ฐ€ ๋ถ„๋‹ด
  • ๋ฌธ์„œ ์ž‘์„ฑ์€ @writer-agent, ์ฝ”๋“œ ๋ฆฌ๋ทฐ๋Š” @reviewer-agent๊ฐ€ ๋‹ด๋‹น
  • ๊ฐ ์—์ด์ „ํŠธ๋Š” ์„œ๋กœ์˜ ๊ฒฐ๊ณผ๋ฅผ ์ฐธ๊ณ ํ•ด ์ „์ฒด ํ”„๋กœ์ ํŠธ๋ฅผ ์™„์„ฑ

๋งˆ์น˜ ์‹ค์ œ ํŒ€์ฒ˜๋Ÿผ AI๊ฐ€ ์—ญํ• ์„ ๋‚˜๋ˆ  ์ผํ•ฉ๋‹ˆ๋‹ค. ๋Œ€๊ทœ๋ชจ ์ฝ”๋“œ๋ฒ ์ด์Šค๋‚˜ ๋ณต์žกํ•œ ๋ฉ€ํ‹ฐ์Šคํ… ํ”„๋กœ์ ํŠธ์—์„œ ์ง„๊ฐ€๋ฅผ ๋ฐœํœ˜ํ•  ๊ธฐ๋Šฅ์ž…๋‹ˆ๋‹ค.


5. ์‹ค์ „ ํ™œ์šฉ ํŒ: ์ง€๊ธˆ ๋‹น์žฅ ์จ๋ณผ ์ˆ˜ ์žˆ๋Š” ๊ฒƒ๋“ค

์ด๋ฒˆ ์—…๋ฐ์ดํŠธ๋กœ ๋‹น์žฅ ํšจ๊ณผ๋ฅผ ๋ณผ ์ˆ˜ ์žˆ๋Š” ์‚ฌ์šฉ๋ฒ• ์„ธ ๊ฐ€์ง€์ž…๋‹ˆ๋‹ค.

  • ์ฒ˜์Œ ์‹œ์ž‘์ด๋ผ๋ฉด: /powerup์œผ๋กœ 30๋ถ„ ํˆฌ์žํ•ด ์ „์ฒด ๊ธฐ๋Šฅ ํŒŒ์•…ํ•˜๊ธฐ
  • ์ž๋™ํ™” ํŒŒ์ดํ”„๋ผ์ธ ๊ตฌ์ถ• ์ค‘์ด๋ผ๋ฉด: MCP_CONNECTION_NONBLOCKING=true ํ™˜๊ฒฝ๋ณ€์ˆ˜ ์ถ”๊ฐ€๋กœ ์‘๋‹ต์†๋„ ๊ฐœ์„ 
  • ํŒ€ ํ”„๋กœ์ ํŠธ๋ฅผ AI๋กœ ๊ด€๋ฆฌ ์ค‘์ด๋ผ๋ฉด: Named Subagents๋กœ ์—ญํ•  ๋ถ„๋ฆฌํ•ด ๋ณต์žก๋„ ๋‚ฎ์ถ”๊ธฐ

์ถ”๊ฐ€๋กœ, CLAUDE_CODE_NO_FLICKER=1 ํ™˜๊ฒฝ๋ณ€์ˆ˜๋ฅผ ์„ค์ •ํ•˜๋ฉด ๊ธด ์ถœ๋ ฅ์—์„œ๋„ ํ™”๋ฉด ๊นœ๋นก์ž„ ์—†์ด ์•ˆ์ •์ ์ธ ๋ Œ๋”๋ง์„ ๊ฒฝํ—˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ธด ์„ธ์…˜์—์„œ ์ž‘์—…ํ•  ๋•Œ ๋ˆˆ์˜ ํ”ผ๋กœ๊ฐ€ ํ™•์—ฐํžˆ ์ค„์–ด๋“ญ๋‹ˆ๋‹ค.


๋งˆ์น˜๋ฉฐ

Claude Code๋Š” ๋งค ์—…๋ฐ์ดํŠธ๋งˆ๋‹ค ๋‹จ์ˆœํžˆ ๊ธฐ๋Šฅ์„ ์ถ”๊ฐ€ํ•˜๋Š” ๊ฒƒ์ด ์•„๋‹ˆ๋ผ, AI์™€ ์‚ฌ๋žŒ์ด ํ˜‘๋ ฅํ•˜๋Š” ๋ฐฉ์‹ ์ž์ฒด๋ฅผ ์ •์ œํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค. /powerup์œผ๋กœ ์ง„์ž…์žฅ๋ฒฝ์„ ๋‚ฎ์ถ”๊ณ , MCP ๊ฐœ์„ ์œผ๋กœ ์†๋„๋ฅผ ๋†’์ด๊ณ , ํ›… ์‹œ์Šคํ…œ์œผ๋กœ ์ •๋ฐ€๋„๋ฅผ ๋Œ์–ด์˜ฌ๋ฆฐ ์ด๋ฒˆ ์—…๋ฐ์ดํŠธ๊ฐ€ ๊ทธ ์ฆ๊ฑฐ์ž…๋‹ˆ๋‹ค.

AI ์ฝ”๋”ฉ์€ ์ด์ œ ์†Œ์ˆ˜ ์ „๋ฌธ๊ฐ€์˜ ์˜์—ญ์ด ์•„๋‹™๋‹ˆ๋‹ค. ์ง€๊ธˆ์ด ์‹œ์ž‘ํ•˜๊ธฐ ๊ฐ€์žฅ ์ข‹์€ ์‹œ์ ์ž…๋‹ˆ๋‹ค.


๊ด€๋ จ ๊ธ€ ๋” ์ฝ๊ธฐ

Claude Code๋ฅผ ์ฒ˜์Œ ์จ๋ณธ ํ›„ ๊ฐ€์žฅ ๋†€๋ž๋˜ ๊ธฐ๋Šฅ์ด ๋ฌด์—‡์ธ๊ฐ€์š”? ๋Œ“๊ธ€๋กœ ์•Œ๋ ค์ฃผ์„ธ์š”!


Sources:

Claude Code 4์›” ์—…๋ฐ์ดํŠธ: /powerupยทMCP ๊ฐœ์„ ์œผ๋กœ AI ์ฝ”๋”ฉ์˜ ํŒ์ด ๋ฐ”๋€๋‹ค | MINSSAM.COM