๋ณธ๋ฌธ์œผ๋กœ ๊ฑด๋„ˆ๋›ฐ๊ธฐ

๐Ÿš€ ์•ˆํ‹ฐ๊ทธ๋ž˜๋น„ํ‹ฐ 2.0 ร— ํด๋กœ๋“œ์ฝ”๋“œ(Claude Code) ์ดˆ๊ณ ์† ์—ฐ๋™ ๊ฐ€์ด๋“œ (Windows ๊ธฐ์ค€)

์ด ๊ฐ€์ด๋“œ๋Š” ์ˆ˜๋งŽ์€ ์‹œํ–‰์ฐฉ์˜ค์™€ ์œˆ๋„์šฐ ๋ณด์•ˆ ์—๋Ÿฌ๋ฅผ ๊ฑด๋„ˆ๋›ฐ๊ณ , ์•ˆํ‹ฐ๊ทธ๋ž˜๋น„ํ‹ฐ 2.0 ํ”„๋กœ๊ทธ๋žจ ๋‚ด๋ถ€์—์„œ ํด๋กœ๋“œ์ฝ”๋“œ๋ฅผ ๊ฐ€์žฅ ์•ˆ์ „ํ•˜๊ณ  ๋น ๋ฅด๊ฒŒ ๊ตฌ๋™ํ•˜๊ธฐ ์œ„ํ•œ 'ํ”„๋ฆฌํŒจ์Šค ๋…ธ์„ '์ž…๋‹ˆ๋‹ค. ์•„๋ž˜ ์ˆœ์„œ๋Œ€๋กœ๋งŒ ๊ทธ๋Œ€๋กœ ๋”ฐ๋ผ ํ•˜์„ธ์š”!

1๋‹จ๊ณ„: ๋กœ์ปฌ ์ปดํ“จํ„ฐ ์„ธํŒ… (PowerShell 1๋ฒˆ ์ฐฝ)

๋จผ์ € ๋‚ด ์ปดํ“จํ„ฐ์—์„œ ์•ˆํ‹ฐ๊ทธ๋ž˜๋น„ํ‹ฐ์™€ ํด๋กœ๋“œ์ฝ”๋“œ๋ฅผ ์ด์–ด์ค„ ๋ฐฑ๊ทธ๋ผ์šด๋“œ ์ค‘๊ณ„ ์„œ๋ฒ„๋ฅผ ์ผœ๋Š” ๋‹จ๊ณ„์ž…๋‹ˆ๋‹ค.

โ‘  ํŒŒ์›Œ์‰˜ ์‹คํ–‰ ๋ฐ ๊ถŒํ•œ ํ—ˆ์šฉ

์œˆ๋„์šฐ ๊ฒ€์ƒ‰์ฐฝ์— PowerShell์„ ๊ฒ€์ƒ‰ํ•œ ๋’ค, ๋ฐ˜๋“œ์‹œ '๊ด€๋ฆฌ์ž ๊ถŒํ•œ์œผ๋กœ ์‹คํ–‰'์„ ๋ˆŒ๋Ÿฌ ์ผญ๋‹ˆ๋‹ค. ์ฐฝ์ด ์—ด๋ฆฌ๋ฉด ์•„๋ž˜ ๋ช…๋ น์–ด๋ฅผ ๋ณต์‚ฌํ•ด ๋„ฃ๊ณ  ์—”ํ„ฐ๋ฅผ ์นœ ๋’ค, ์งˆ๋ฌธ์ด ๋‚˜์˜ค๋ฉด Y๋ฅผ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.

PowerShell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process

โ‘ก ํ”„๋ก์‹œ ํŒจํ‚ค์ง€ ์„ค์น˜

์ด์–ด์„œ ์•ˆํ‹ฐ๊ทธ๋ž˜๋น„ํ‹ฐ์™€ ํด๋กœ๋“œ๋ฅผ ๋ฌถ์–ด์ค„ ํ”„๋ก์‹œ ํ”„๋กœ๊ทธ๋žจ์„ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค. (โ€ป PC์— Node.js๊ฐ€ ์„ค์น˜๋˜์–ด ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.)

Bash

npm install -g antigravity-claude-proxy

โ‘ข ์•ˆํ‹ฐ๊ทธ๋ž˜๋น„ํ‹ฐ ๊ณ„์ • ์—ฐ๋™

์•„๋ž˜ ๋ช…๋ น์–ด๋ฅผ ์ž…๋ ฅํ•˜๋ฉด ์›น ๋ธŒ๋ผ์šฐ์ € ์ฐฝ์ด ํ•˜๋‚˜ ๋œน๋‹ˆ๋‹ค. ์•ˆํ‹ฐ๊ทธ๋ž˜๋น„ํ‹ฐ ๋กœ๊ทธ์ธ์„ ์™„๋ฃŒํ•œ ํ›„ ๋ธŒ๋ผ์šฐ์ € ์ฐฝ์„ ๋‹ซ์•„์ฃผ์„ธ์š”.

PowerShell

antigravity-claude-proxy accounts add

โ‘ฃ ๋ฐฑ๊ทธ๋ผ์šด๋“œ ํ”„๋ก์‹œ ์„œ๋ฒ„ ์‹œ์ž‘

์ด์ œ ์ค‘๊ณ„ ์„œ๋ฒ„๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

PowerShell

antigravity-claude-proxy start

โš ๏ธ ์ ˆ๋Œ€ ์ฃผ์˜: ์ด ๋ช…๋ น์–ด๋ฅผ ์น˜๋ฉด ์„œ๋ฒ„๊ฐ€ ๊ฐ€๋™๋˜๊ธฐ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค. ์ด ํŒŒ์›Œ์‰˜ ์ฐฝ์€ ์ ˆ๋Œ€๋กœ ๋‹ซ์ง€ ๋งˆ์‹œ๊ณ , ์ตœ์†Œํ™”(_) ๋ฒ„ํŠผ์„ ๋ˆŒ๋Ÿฌ ์•„๋ž˜๋กœ ๋‚ด๋ ค๋‘์„ธ์š”! ์ปดํ“จํ„ฐ๊ฐ€ ์ผœ์ ธ ์žˆ๋Š” ๋™์•ˆ ๊ณ„์† ์‚ด์•„์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

2๋‹จ๊ณ„: ํด๋กœ๋“œ์ฝ”๋“œ ์ธ์ฆ ํ™˜๊ฒฝ ๊ตฌ์ถ• (PowerShell 2๋ฒˆ ์ฐฝ)

์•ˆํ‹ฐ๊ทธ๋ž˜๋น„ํ‹ฐ ํ”„๋ก์‹œ ์‹ ํ˜ธ๋ฅผ ํด๋กœ๋“œ์ฝ”๋“œ๊ฐ€ ์•Œ์•„์ฑŒ ์ˆ˜ ์žˆ๋„๋ก ํ™˜๊ฒฝ๋ณ€์ˆ˜๋ฅผ ์‹ฌ์–ด์ฃผ๋Š” ๋‹จ๊ณ„์ž…๋‹ˆ๋‹ค.

โ‘  ์ƒˆ๋กœ์šด ํŒŒ์›Œ์‰˜ ์ฐฝ ์—ด๊ธฐ

1๋‹จ๊ณ„์—์„œ ์ตœ์†Œํ™”ํ•ด ๋‘” ์ฐฝ์€ ๊ทธ๋Œ€๋กœ ๋‘๊ณ , ์ƒˆ๋กœ์šด ํŒŒ์›Œ์‰˜ ์ฐฝ์„ ํ•˜๋‚˜ ๋” ์—ฝ๋‹ˆ๋‹ค. ์ƒˆ ์ฐฝ์ด ์—ด๋ฆฌ๋ฉด ๊ถŒํ•œ ํ—ˆ์šฉ ๋ช…๋ น์–ด๋ฅผ ๋‹ค์‹œ ํ•œ๋ฒˆ ์ž…๋ ฅํ•ด ์ค๋‹ˆ๋‹ค.

PowerShell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process

โ‘ก ํ”„๋กœํ•„ ํŒŒ์ผ ์ƒ์„ฑ

ํŒŒ์›Œ์‰˜์˜ ์ž๋™ ์‹คํ–‰ ์„ค์ • ํŒŒ์ผ์„ ๊ฐ•์ œ๋กœ ์ƒˆ๋กœ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค.

PowerShell

New-Item -Type File -Path $PROFILE -Force

โ‘ข ๋ฉ”๋ชจ์žฅ์œผ๋กœ ์„ค์ • ํŒŒ์ผ ์—ด๊ธฐ

์•„๋ž˜ ๋ช…๋ น์–ด๋ฅผ ์ž…๋ ฅํ•˜๋ฉด, ๋ฐฉ๊ธˆ ๋งŒ๋“  ๊ป๋ฐ๊ธฐ๋ฟ์ธ ๋นˆ ๋ฉ”๋ชจ์žฅ ์ฐฝ์ด ํ™”๋ฉด์— ํˆญ ํ•˜๊ณ  ์ƒˆ๋กœ ์ผœ์ง‘๋‹ˆ๋‹ค.

PowerShell

notepad $PROFILE

โ‘ฃ ํ™˜๊ฒฝ๋ณ€์ˆ˜ ์ฝ”๋“œ ์ž…๋ ฅ ํ›„ ์ €์žฅ

์ƒˆ๋กœ ์—ด๋ฆฐ ๋นˆ ๋ฉ”๋ชจ์žฅ ์ฐฝ์— ์•„๋ž˜ ์ฝ”๋“œ๋ฅผ ๊ทธ๋Œ€๋กœ ๋ณต์‚ฌํ•ด์„œ ๋ถ™์—ฌ๋„ฃ์Šต๋‹ˆ๋‹ค. ๊ทธ ํ›„ ์ €์žฅ(Ctrl + S)์„ ๋ˆ„๋ฅด๊ณ  ๋ฉ”๋ชจ์žฅ ์ฐฝ์„ ์™„์ „ํžˆ ๋‹ซ์•„์ค๋‹ˆ๋‹ค.

PowerShell

$env:ANTHROPIC_BASE_URL="http://localhost:9999/v1"
$env:ANTHROPIC_AUTH_TOKEN="your_antigravity_token"

โ‘ค ์ตœ์ดˆ 1ํšŒ ์ธ์ฆ ํ™•์ธ

๋ฉ”๋ชจ์žฅ์„ ๋‹ซ์€ ๋’ค, ํŒŒ์›Œ์‰˜ ์ฐฝ์— ๋Œ์•„์™€ ์•„๋ž˜ ๋ช…๋ น์–ด๋ฅผ ํ•œ ์ค„์”ฉ ์ฐจ๋ก€๋Œ€๋กœ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค.

PowerShell

. $PROFILE
claude

์‹คํ–‰ ๋„์ค‘ ํ™”๋ฉด์— Custom API key detected... ๋ผ๋Š” ์งˆ๋ฌธ์ด ๋‚˜ํƒ€๋‚˜๋ฉด ํ‚ค๋ณด๋“œ๋กœ 1์„ ์ž…๋ ฅํ•˜๊ณ  ์—”ํ„ฐ(Yes)๋ฅผ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค. ์ •์ƒ์ ์œผ๋กœ ๋กœ๊ทธ์ธ์ด ํ’€๋ฆฌ๋Š” ๊ฒƒ์„ ํ™•์ธํ–ˆ๋‹ค๋ฉด ์ด 2๋ฒˆ ํŒŒ์›Œ์‰˜ ์ฐฝ์€ ๊บผ์ฃผ์…”๋„ ๋ฉ๋‹ˆ๋‹ค.

3๋‹จ๊ณ„: ์•ˆํ‹ฐ๊ทธ๋ž˜๋น„ํ‹ฐ ์•ฑ์—์„œ ๋งˆ๋ฌด๋ฆฌ ๊ตฌ๋™

์ด์ œ ๋ณต์žกํ•œ ๊ฒ€์€ ์ฐฝ์€ ๋๋‚ฌ์Šต๋‹ˆ๋‹ค. ์•ˆํ‹ฐ๊ทธ๋ž˜๋น„ํ‹ฐ ํ”„๋กœ๊ทธ๋žจ ์•ˆ์œผ๋กœ ๋น„์„œ๋ฅผ ์™„์ „ํžˆ ํก์ˆ˜์‹œํ‚ค๋Š” ๋‹จ๊ณ„์ž…๋‹ˆ๋‹ค.

โ‘  ์•ˆํ‹ฐ๊ทธ๋ž˜๋น„ํ‹ฐ์—์„œ ๋‚ด ์ž‘์—… ํด๋” ์—ด๊ธฐ

  1. ์•ˆํ‹ฐ๊ทธ๋ž˜๋น„ํ‹ฐ 2.0 ํ”„๋กœ๊ทธ๋žจ์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

  2. ์™ผ์ชฝ ์‚ฌ์ด๋“œ๋ฐ”์—์„œ ๋ณธ์ธ์ด ์ฝ”๋”ฉ ์ž‘์—…์„ ์ง„ํ–‰ํ•  ํ”„๋กœ์ ํŠธ ํด๋”๋ฅผ ํ™œ์„ฑํ™”ํ•ฉ๋‹ˆ๋‹ค.

  3. ์™ผ์ชฝ ์ƒ๋‹จ์˜ + New Conversation์„ ๋ˆŒ๋Ÿฌ ์™„์ „ํžˆ ์ƒˆ๋กœ์šด ๋Œ€ํ™”๋ฐฉ์„ ํ•˜๋‚˜ ์—ฝ๋‹ˆ๋‹ค.

โ‘ก ์น˜ํŠธํ‚ค ๋ช…๋ น์–ด ๋˜์ง€๊ธฐ

์ƒˆ๋กœ ์—ด๋ฆฐ ๋Œ€ํ™”๋ฐฉ์˜ ๋ฉ”์ธ ์ž…๋ ฅ์ฐฝ์— ์•„๋ž˜ ๋ช…๋ น์–ด๋ฅผ ํ† ์”จ ํ•˜๋‚˜ ํ‹€๋ฆฌ์ง€ ์•Š๊ณ  ๊ทธ๋Œ€๋กœ ๋ณต์‚ฌํ•ด์„œ ์ „์†ก(์—”ํ„ฐ)ํ•ฉ๋‹ˆ๋‹ค.

Plaintext

/run npx.cmd -y @anthropic-ai/claude-code mcp serve

๐Ÿ’ก ์—๋Ÿฌ ์˜ˆ๋ฐฉ ๊ฟ€ํŒ: ์œˆ๋„์šฐ ๋ณด์•ˆ ์ด์Šˆ(PSSecurityException)์™€ ๊ธ€์ž ๊นจ์ง ๋ฒ„๊ทธ๋ฅผ ์›์ฒœ ์ฐจ๋‹จํ•˜๊ธฐ ์œ„ํ•ด, ์ผ๋ฐ˜ npx ๋Œ€์‹  ์ฒ˜์Œ๋ถ€ํ„ฐ npx.cmd ํ˜•์‹์„ ์‚ฌ์šฉํ•˜๊ณ  ๋’ค์— **mcp serve**๋ฅผ ๋‹ค์ด๋ ‰ํŠธ๋กœ ๋ถ™์—ฌ์ฃผ๋Š” ๊ฒƒ์ด ํ•ต์‹ฌ ๋น„์ฑ…์ž…๋‹ˆ๋‹ค!

โ‘ข ๊ถŒํ•œ ์Šน์ธ (ํŒ์—… ํด๋ฆญ)

๋ช…๋ น์–ด๋ฅผ ์ „์†กํ•˜๋ฉด ์•ˆํ‹ฐ๊ทธ๋ž˜๋น„ํ‹ฐ ํ™”๋ฉด ํ•˜๋‹จ์— ์•ˆ์ „์„ ์œ„ํ•œ ๊ถŒํ•œ ์š”์ฒญ ํŒ์—…์ด ๋œน๋‹ˆ๋‹ค.

  1. ๋ชฉ๋ก ์ค‘์—์„œ 3 Yes, and always allow 'npx.cmd' ํ•ญ๋ชฉ์„ ๋งˆ์šฐ์Šค๋กœ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค.

  2. ์šฐ์ธก ํ•˜๋‹จ์˜ ํŒŒ๋ž€์ƒ‰ [Submit] ๋ฒ„ํŠผ์„ ๋ˆ„๋ฆ…๋‹ˆ๋‹ค.

  3. ์ž ์‹œ ํ›„ ๋‚ด๋ถ€ ๊ฒ€์ฆ ์ ˆ์ฐจ๋กœ ์ธํ•ด --help ๊ด€๋ จ ํŒ์—…์ด ํ•œ ๋ฒˆ ๋” ๋‚˜์˜ค๋ฉด ๋˜‘๊ฐ™์ด 3๋ฒˆ(ํ•ญ์ƒ ํ—ˆ์šฉ)์„ ๋ˆ„๋ฅด๊ณ  ์ œ์ถœํ•ฉ๋‹ˆ๋‹ค.

โ‘ฃ ์—ฐ๋™ ์™„๋ฃŒ ๋ฐ ์ผ ์‹œํ‚ค๊ธฐ

ํ•˜๋‹จ์— ์ดˆ๋ก์ƒ‰ ๊ธ€์”จ๋กœ RUNNING ์ƒํƒœ๊ฐ€ ํ‘œ๊ธฐ๋˜๋ฉด ๋ชจ๋“  ์—ฐ๋™์ด ํผํŽ™ํŠธํ•˜๊ฒŒ ๋๋‚ฌ์Šต๋‹ˆ๋‹ค!

์ด์ œ ๋Œ€ํ™”์ฐฝ์— ํ‰์†Œ์ฒ˜๋Ÿผ ํ•œ๊ธ€๋กœ "์ด ํด๋”์— ์ œ์•ˆ์„œ ์ž๋™ํ™” ํŒŒ์ด์ฌ ํ”„๋กœ์ ํŠธ ๋ผˆ๋Œ€ ํŒŒ์ผ๋“ค์„ ์ƒ์„ฑํ•ด ์ค˜"๋ผ๊ณ  ๋ช…๋ น์„ ๋‚ด๋ฆฌ๋ฉด, ํด๋กœ๋“œ์ฝ”๋“œ๊ฐ€ ๋‚ด ์ปดํ“จํ„ฐ ํด๋”๋ฅผ ์กฐ์ž‘ํ•ด ์ง„์งœ ํŒŒ์ผ๋“ค์„ ์•Œ์•„์„œ ์ฒ™์ฒ™ ๋งŒ๋“ค์–ด๋‚ด๊ธฐ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.

1

ํ•จ๊ป˜ ์ด์•ผ๊ธฐํ•ด์š” 1

๋กœ๊ทธ์ธํ•˜๊ณ  ๋Œ“๊ธ€์„ ๋‚จ๊ฒจ ์ฃผ์„ธ์š”

Develiper ํ”„๋กœํ•„ ์ด๋ฏธ์ง€
Develiper2026.05.23

1ํ์— ์‚ฌ๋ก€๊ธ€์„ 2๊ฐœ๋‚˜ ใ…Žใ…Ž

๊ฐ์‚ฌํ•ฉ๋‹ˆ๋‹ค.

์ €๋„ ๋‚˜์ค‘์— ์‹œ๊ฐ„๋  ๋•Œ ๋”ฐ๋ผํ•ด์„œ ์„ค์น˜ํ•˜๊ณ  ์‚ฌ์šฉํ•ด๋ณด๊ฒ ์Šต๋‹ˆ๋‹ค.

๐Ÿ‘ ๐Ÿฅฐ ๐ŸŒธ

ํ•„์š”ํ•œ AI ์ •๋ณด๋งŒ
๋ฉ”์ผํ•จ์— ์™์™ ๋„ฃ์–ด๋“œ๋ ค์š”.

์ง€๊ธˆ ํ•ซํ•œ AI ์†Œ์‹๋ถ€ํ„ฐ ์ง์ ‘ ํ•ด ๋ณธ ์‚ฌ๋ก€๊นŒ์ง€, ์›”์š”์ผ๋งˆ๋‹ค ๋ฌด๋ฃŒ๋กœ ๋ฐ›์•„๋ณด์„ธ์š”

์ด๋Ÿฐ ์‚ฌ๋ก€๋„ ์žˆ์–ด์š”

์‚ฌ๋ก€ ์ „์ฒด ๋ณด๊ธฐ