๊ธฐํ˜ธ๋กœ ํ”„๋กœ์ ํŠธ ์ปจํ…์ŠคํŠธ ์‹ค์‹œ๊ฐ„ ์ถ”๊ฐ€ํ•˜๋Š” ๋ฒ•

์ด๋ฏธ์ง€
ํด๋กœ๋“œ ์ฝ”๋“œ์—์„œ ๊ธฐํ˜ธ๋กœ ํ”„๋กœ์ ํŠธ ์ปจํ…์ŠคํŠธ๋ฅผ ์‹ค์‹œ๊ฐ„ ์ถ”๊ฐ€ํ•˜๋Š” ๋ฐฉ๋ฒ• (2026๋…„ ๊ธฐ์ค€) ํด๋กœ๋“œ ์ฝ”๋“œ ์“ฐ๋‹ค ๋ณด๋ฉด ์ด๋Ÿฐ ๋‹ต๋‹ตํ•œ ์ˆœ๊ฐ„์ด ๊ผญ ์˜ต๋‹ˆ๋‹ค. “๋‚ด๊ฐ€ ์ง€๊ธˆ ์–ด๋–ค ํ”„๋กœ์ ํŠธ์ธ์ง€ ์•Œ๊ณ  ๋งํ•˜๋Š” ๊ฑฐ ๋งž์ง€?” ๋ถ„๋ช… ๊ฐ™์€ ์งˆ๋ฌธ์ธ๋ฐ ์–ด์ œ์™€ ์˜ค๋Š˜ ๋‹ต์ด ๋‹ฌ๋ผ์ง€๊ณ , ๋งฅ๋ฝ์„ ๋‹ค์‹œ ์„ค๋ช…ํ•˜๋А๋ผ ์‹œ๊ฐ„๋งŒ ๊ฐ‘๋‹ˆ๋‹ค. ์ด ๋ฌธ์ œ๋ฅผ ํ•œ ๋ฒˆ์— ํ•ด๊ฒฐํ•ด์ฃผ๋Š” ํ•ต์‹ฌ์ด ๊ธฐํ˜ธ๋ฅผ ์ด์šฉํ•œ ํ”„๋กœ์ ํŠธ ์ปจํ…์ŠคํŠธ ์‹ค์‹œ๊ฐ„ ์ถ”๊ฐ€ ์ž…๋‹ˆ๋‹ค. ์ด๋ฒˆ ๊ธ€์—์„œ๋Š” ํด๋กœ๋“œ ์ฝ”๋“œ์—์„œ ๊ธฐํ˜ธ๋ฅผ ํ™œ์šฉํ•ด ํ”„๋กœ์ ํŠธ ๋งฅ๋ฝ์„ ์ฆ‰์‹œ ์ฃผ์ž…ํ•˜๋Š” ๋ฐฉ๋ฒ• ์„ ์‰ฝ๊ณ  ์žฌ๋ฏธ์žˆ๊ฒŒ ์ •๋ฆฌํ•ด ๋“œ๋ฆฌ๊ฒ ์Šต๋‹ˆ๋‹ค. ๐Ÿ“Œ ๋ชฉ์ฐจ ํ”„๋กœ์ ํŠธ ์ปจํ…์ŠคํŠธ๊ฐ€ ์™œ ์ค‘์š”ํ•œ๊ฐ€ ์ปจํ…์ŠคํŠธ๋ฅผ ์ถ”๊ฐ€ํ•˜๋Š” ํ•ต์‹ฌ ๊ธฐํ˜ธ ์ •๋ฆฌ @ ๊ธฐํ˜ธ๋กœ ์ปจํ…์ŠคํŠธ๋ฅผ ์ฆ‰์‹œ ๋ถˆ๋Ÿฌ์˜ค๋Š” ๋ฒ• ์‹ค์‹œ๊ฐ„ ์ปจํ…์ŠคํŠธ ์ถ”๊ฐ€ ์‹ค์ „ ์˜ˆ์‹œ ์ปจํ…์ŠคํŠธ๋ฅผ ์•ˆ์ •์ ์œผ๋กœ ์œ ์ง€ํ•˜๋Š” ์š”๋ น ํ”„๋กœ์ ํŠธ ์ปจํ…์ŠคํŠธ๊ฐ€ ์™œ ์ค‘์š”ํ•œ๊ฐ€ AI๋Š” ๋˜‘๋˜‘ํ•˜์ง€๋งŒ ์•„๋ฌด ๋งฅ๋ฝ ์—†์ด ์ผํ•˜์ง€๋Š” ๋ชปํ•ฉ๋‹ˆ๋‹ค. ๊ฐ™์€ “๋ฆฌํŒฉํ„ฐ๋ง”์ด๋ผ๋Š” ๋ง๋„ ํ”„๋กœ์ ํŠธ๋งˆ๋‹ค ์˜๋ฏธ๊ฐ€ ๋‹ค๋ฆ…๋‹ˆ๋‹ค. ๊ทœ๋ชจ, ์‚ฌ์šฉ ๊ธฐ์ˆ , ํŒ€ ๊ทœ์น™์„ ๋ชจ๋ฅด๋ฉด ๋‹ต๋ณ€์€ ์ž์—ฐ์Šค๋Ÿฝ๊ฒŒ ์ถ”์ƒ์ ์œผ๋กœ ๋ณ€ํ•ฉ๋‹ˆ๋‹ค. ๊ธฐํ˜ธ๋กœ ์ปจํ…์ŠคํŠธ๋ฅผ ์ถ”๊ฐ€ํ•˜๋ฉด ํ˜„์žฌ ํ”„๋กœ์ ํŠธ ๊ธฐ์ค€ ์œผ๋กœ ๋ชจ๋“  ์„ค๋ช…์ด ์žฌ์ •๋ ฌ๋ฉ๋‹ˆ๋‹ค. ์ด ์ฐจ์ด๋Š” ์ž‘์—…์ด ๊ธธ์–ด์งˆ์ˆ˜๋ก ํ›จ์”ฌ ํฌ๊ฒŒ ๋А๊ปด์ง‘๋‹ˆ๋‹ค. ์ปจํ…์ŠคํŠธ๋ฅผ ์ถ”๊ฐ€ํ•˜๋Š” ํ•ต์‹ฌ ๊ธฐํ˜ธ ์ •๋ฆฌ ํด๋กœ๋“œ ์ฝ”๋“œ์—์„œ ์ปจํ…์ŠคํŠธ๋ฅผ ๋‹ค๋ฃจ๋Š” ํ•ต์‹ฌ ๊ธฐํ˜ธ๋Š” ๋‹จ์ˆœํ•ฉ๋‹ˆ๋‹ค. ๊ฐ€์žฅ ๋Œ€ํ‘œ์ ์ธ ๊ฒƒ์ด @ ๊ธฐํ˜ธ ์ž…๋‹ˆ๋‹ค. @๋Š” “์ด ํŒŒ์ผ ๋˜๋Š” ์ด ์ •๋ณด๋ฅผ ๊ธฐ์ค€์œผ๋กœ ์ƒ๊ฐํ•ด๋ผ”๋ผ๋Š” ๋ช…ํ™•ํ•œ ์‹ ํ˜ธ์ž…๋‹ˆ๋‹ค. ํŒŒ์ผ๋ฟ ์•„๋‹ˆ๋ผ ์„ค๋ช… ๋ฌธ์žฅ, ์—ญํ•  ์ง€์ •๊ณผ ํ•จ๊ป˜ ์“ฐ๋ฉด ์ปจํ…์ŠคํŠธ ํšจ๊ณผ๊ฐ€ ๋ฐฐ๋กœ ์ปค์ง‘๋‹ˆ๋‹ค. ๊ธฐํ˜ธ๋Š” AI์—๊ฒŒ ์ฃผ๋Š” ํ‘œ์ง€ํŒ์ด๋ผ๊ณ  ์ƒ๊ฐํ•˜์‹œ๋ฉด ๋ฉ๋‹ˆ๋‹ค. @ ๊ธฐํ˜ธ๋กœ ์ปจํ…์ŠคํŠธ๋ฅผ ์ฆ‰์‹œ ๋ถˆ๋Ÿฌ์˜ค๋Š” ๋ฒ• ๊ฐ€์žฅ ๊ธฐ๋ณธ์ ์ธ ๋ฐฉ์‹์€ ํŒŒ์ผ์„ ์ง์ ‘ ์ง€์ •ํ•˜๋Š” ๊ฒƒ์ž…๋‹ˆ๋‹ค. ์˜ˆ๋ฅผ ๋“ค๋ฉด ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค. @src/Layout.tsx ์ด ํ”„๋กœ์ ํŠธ์˜ ์ „์ฒด ๊ตฌ์กฐ ๊ธฐ์ค€...

Ubuntu ์„œ๋ฒ„ ํด๋กœ๋“œ ์ฝ”๋“œ ๊ธ€๋กœ๋ฒŒ ์„ค์น˜ ์‹ค์ „ ๊ฐ€์ด๋“œ (2026 ์ตœ์‹ )

๐Ÿ”ท Ubuntu ์„œ๋ฒ„ ํด๋กœ๋“œ ์ฝ”๋“œ ๊ธ€๋กœ๋ฒŒ ์„ค์น˜ ์‹ค์ „ ๊ฐ€์ด๋“œ (2026 ์ตœ์‹ )

Ubuntu ์„œ๋ฒ„์—์„œ Claude Code๋ฅผ ์ „์—ญ(Global)์œผ๋กœ ์„ค์น˜ํ•˜๊ณ 

์‹ค์ œ ์„œ๋ฒ„ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์—์„œ ๋ฐ”๋กœ ํ™œ์šฉํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์ •๋ฆฌํ–ˆ์Šต๋‹ˆ๋‹ค.

์ดˆ๋ณด์ž๋„ SSH ์ ‘์†๋งŒ ํ•  ์ˆ˜ ์žˆ๋‹ค๋ฉด ๋๊นŒ์ง€ ๋”ฐ๋ผ์˜ฌ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.


๐Ÿ“š ๋ชฉ์ฐจ


1️⃣ Ubuntu ์„œ๋ฒ„์— ํด๋กœ๋“œ ์ฝ”๋“œ๊ฐ€ ํ•„์š”ํ•œ ์ด์œ 

์„œ๋ฒ„ ๊ฐœ๋ฐœ์„ ํ•˜๋‹ค ๋ณด๋ฉด ๋กœ์ปฌ IDE ์—†์ด

SSH ํ™˜๊ฒฝ์—์„œ ๋ฐ”๋กœ ์ฝ”๋“œ ๋ถ„์„๊ณผ ์ˆ˜์ •์ด ํ•„์š”ํ•  ๋•Œ๊ฐ€ ๋งŽ์Šต๋‹ˆ๋‹ค.

์ด๋•Œ Claude Code๋ฅผ ๊ธ€๋กœ๋ฒŒ๋กœ ์„ค์น˜ํ•˜๋ฉด ์ž‘์—… ํšจ์œจ์ด ๊ธ‰๊ฒฉํžˆ ์˜ฌ๋ผ๊ฐ‘๋‹ˆ๋‹ค.

✔ ์–ด๋А ๋””๋ ‰ํ„ฐ๋ฆฌ์—์„œ๋„ ์ฆ‰์‹œ ์‹คํ–‰ ๊ฐ€๋Šฅ

✔ ์ž๋™ํ™” ์Šคํฌ๋ฆฝํŠธ, CI/CD์™€ ์—ฐ๋™ ์‰ฌ์›€

✔ ์„œ๋ฒ„ ๊ฐœ๋ฐœ ์ŠคํŠธ๋ ˆ์Šค ๊ธ‰๊ฐ


2️⃣ ์„ค์น˜ ์ „ ํ•„์ˆ˜ ์ค€๋น„ ์‚ฌํ•ญ

์•„๋ž˜ ์กฐ๊ฑด์ด ํ•˜๋‚˜๋ผ๋„ ๋น ์ง€๋ฉด ์„ค์น˜ ์ค‘ ๋ง‰ํž ํ™•๋ฅ ์ด ๋†’์Šต๋‹ˆ๋‹ค.

ํŠนํžˆ Node.js ๋ฒ„์ „์€ ๊ฐ€์žฅ ์ค‘์š”ํ•ฉ๋‹ˆ๋‹ค.

Ubuntu 20.04 ์ด์ƒ ๊ถŒ์žฅ

Node.js 18 ์ด์ƒ ํ•„์ˆ˜

sudo ๋˜๋Š” root ๊ถŒํ•œ ํ•„์š”


3️⃣ Node.js 18+ ์„ค์น˜ ๋ฐฉ๋ฒ•

Ubuntu ์„œ๋ฒ„์—์„œ๋Š” NodeSource ์„ค์น˜ ๋ฐฉ์‹์ด ๊ฐ€์žฅ ์•ˆ์ •์ ์ž…๋‹ˆ๋‹ค.

์•„๋ž˜ ๋ช…๋ น์–ด๋ฅผ ๊ทธ๋Œ€๋กœ ๋ณต์‚ฌํ•ด ์‹คํ–‰ํ•˜์„ธ์š”.

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

์„ค์น˜ ํ›„ ๋ฐ˜๋“œ์‹œ ๋ฒ„์ „์„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

node -v
npm -v
Node.js ๊ณต์‹ ํ™ˆํŽ˜์ด์ง€ ๋ฐ”๋กœ๊ฐ€๊ธฐ

4️⃣ Claude Code ๊ธ€๋กœ๋ฒŒ ์„ค์น˜

์ด์ œ Claude Code๋ฅผ ์ „์—ญ(Global)์œผ๋กœ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค.

Ubuntu ์„œ๋ฒ„์—์„œ๋Š” sudo ์‚ฌ์šฉ์ด ์•ˆ์ „ํ•ฉ๋‹ˆ๋‹ค.

sudo npm install -g @anthropic-ai/claude-code

์„ค์น˜ ํ›„ ์ •์ƒ ์—ฌ๋ถ€๋ฅผ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.

claude --version

๋ฒ„์ „์ด ์ถœ๋ ฅ๋˜๋ฉด ์„ค์น˜ ์„ฑ๊ณต์ž…๋‹ˆ๋‹ค.

Anthropic ๊ณต์‹ ํ™ˆํŽ˜์ด์ง€

5️⃣ ํ”„๋กœ์ ํŠธ ํด๋” ์‹ค์ „ ์‚ฌ์šฉ ์˜ˆ์‹œ

์„œ๋ฒ„์—์„œ ์‹ค์ œ๋กœ๋Š” ์•„๋ž˜์ฒ˜๋Ÿผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

์–ด๋А ํ”„๋กœ์ ํŠธ ํด๋”๋“  ๋ฐ”๋กœ ์‹คํ–‰ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

cd /var/www/my-project
claude

Claude๋Š” ์ฝ”๋“œ ์„ค๋ช…, ๋ฆฌํŒฉํ† ๋ง, ์˜ค๋ฅ˜ ๋ถ„์„๊นŒ์ง€

์ฆ‰์‹œ ๋„์™€์ฃผ๋Š” ์„œ๋ฒ„ ์ „์šฉ AI ํŒŒํŠธ๋„ˆ๊ฐ€ ๋ฉ๋‹ˆ๋‹ค.

์„œ๋ฒ„ ๊ฐœ๋ฐœ์ด ํ˜ผ์ž ์‹ธ์šฐ๋Š” ๋А๋‚Œ์ด ์‚ฌ๋ผ์ง‘๋‹ˆ๋‹ค


6️⃣ ์ž์ฃผ ๋ฐœ์ƒํ•˜๋Š” ์˜ค๋ฅ˜ ํ•ด๊ฒฐ

❌ command not found: claude

npm bin -g
which claude

PATH ๋ฌธ์ œ์ผ ํ™•๋ฅ ์ด ๋†’์Šต๋‹ˆ๋‹ค.

์žฌ๋กœ๊ทธ์ธ ๋˜๋Š” ~/.bashrc ํ™•์ธ์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.

❌ Node ๋ฒ„์ „ ์˜ค๋ฅ˜

node -v

18 ๋ฏธ๋งŒ์ด๋ฉด ๋ฐ˜๋“œ์‹œ ์—…๊ทธ๋ ˆ์ด๋“œํ•˜์„ธ์š”.


์ด์ œ Ubuntu ์„œ๋ฒ„์—์„œ๋„

AI์™€ ํ•จ๊ป˜ํ•˜๋Š” ๊ฐœ๋ฐœ ํ™˜๊ฒฝ์ด ์™„์„ฑ๋˜์—ˆ์Šต๋‹ˆ๋‹ค.

์ด ์ฝ”๋“œ๋Š” ๊ทธ๋Œ€๋กœ Blogspot์— ์ตœ์ ํ™”๋˜์–ด ์žˆ์œผ๋‹ˆ ์•ˆ์‹ฌํ•˜๊ณ  ์‚ฌ์šฉํ•˜์„ธ์š”.

์ด ๋ธ”๋กœ๊ทธ์˜ ์ธ๊ธฐ ๊ฒŒ์‹œ๋ฌผ

์ฉ์ด ์ €์ ˆ๋กœ ๋ฒŒ๋ฆฌ๋Š” ํด๋กœ๋“œ ์ฝ”๋“œ China ์‹œ์žฅ ํŠธ๋ Œ๋“œ ์Šคํฌ๋ž˜ํ•‘ ์Šคํฌ๋ฆฝํŠธ ํ•˜๋Š” ๋ฐฉ๋ฒ•

terminal-setup ํŒŒ์ผ๋กœ ํด๋กœ๋“œ ์ฝ”๋“œ ์ปจํ…์ŠคํŠธ ๊ด€๋ฆฌ๋ฒ•

@package.json ๋ถ„์„ ํด๋กœ๋“œ ์ฝ”๋“œ ์˜์กด์„ฑ ์ •๋ฆฌ ๋ช…๋ น์–ด