๐ ์ํฐ๊ทธ๋๋นํฐ 2.0 ร ํด๋ก๋์ฝ๋(Claude Code) ์ด๊ณ ์ ์ฐ๋ ๊ฐ์ด๋ (Windows ๊ธฐ์ค)
2026.05.23
์ด ๊ฐ์ด๋๋ ์๋ง์ ์ํ์ฐฉ์ค์ ์๋์ฐ ๋ณด์ ์๋ฌ๋ฅผ ๊ฑด๋๋ฐ๊ณ , ์ํฐ๊ทธ๋๋นํฐ 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๋จ๊ณ: ์ํฐ๊ทธ๋๋นํฐ ์ฑ์์ ๋ง๋ฌด๋ฆฌ ๊ตฌ๋
์ด์ ๋ณต์กํ ๊ฒ์ ์ฐฝ์ ๋๋ฌ์ต๋๋ค. ์ํฐ๊ทธ๋๋นํฐ ํ๋ก๊ทธ๋จ ์์ผ๋ก ๋น์๋ฅผ ์์ ํ ํก์์ํค๋ ๋จ๊ณ์ ๋๋ค.
โ ์ํฐ๊ทธ๋๋นํฐ์์ ๋ด ์์ ํด๋ ์ด๊ธฐ
์ํฐ๊ทธ๋๋นํฐ 2.0 ํ๋ก๊ทธ๋จ์ ์คํํฉ๋๋ค.
์ผ์ชฝ ์ฌ์ด๋๋ฐ์์ ๋ณธ์ธ์ด ์ฝ๋ฉ ์์ ์ ์งํํ ํ๋ก์ ํธ ํด๋๋ฅผ ํ์ฑํํฉ๋๋ค.
์ผ์ชฝ ์๋จ์
+ New Conversation์ ๋๋ฌ ์์ ํ ์๋ก์ด ๋ํ๋ฐฉ์ ํ๋ ์ฝ๋๋ค.
โก ์นํธํค ๋ช ๋ น์ด ๋์ง๊ธฐ
์๋ก ์ด๋ฆฐ ๋ํ๋ฐฉ์ ๋ฉ์ธ ์ ๋ ฅ์ฐฝ์ ์๋ ๋ช ๋ น์ด๋ฅผ ํ ์จ ํ๋ ํ๋ฆฌ์ง ์๊ณ ๊ทธ๋๋ก ๋ณต์ฌํด์ ์ ์ก(์ํฐ)ํฉ๋๋ค.
Plaintext
/run npx.cmd -y @anthropic-ai/claude-code mcp serve
๐ก ์๋ฌ ์๋ฐฉ ๊ฟํ: ์๋์ฐ ๋ณด์ ์ด์(
PSSecurityException)์ ๊ธ์ ๊นจ์ง ๋ฒ๊ทธ๋ฅผ ์์ฒ ์ฐจ๋จํ๊ธฐ ์ํด, ์ผ๋ฐnpx๋์ ์ฒ์๋ถํฐnpx.cmdํ์์ ์ฌ์ฉํ๊ณ ๋ค์ **mcp serve**๋ฅผ ๋ค์ด๋ ํธ๋ก ๋ถ์ฌ์ฃผ๋ ๊ฒ์ด ํต์ฌ ๋น์ฑ ์ ๋๋ค!
โข ๊ถํ ์น์ธ (ํ์ ํด๋ฆญ)
๋ช ๋ น์ด๋ฅผ ์ ์กํ๋ฉด ์ํฐ๊ทธ๋๋นํฐ ํ๋ฉด ํ๋จ์ ์์ ์ ์ํ ๊ถํ ์์ฒญ ํ์ ์ด ๋น๋๋ค.
๋ชฉ๋ก ์ค์์
3 Yes, and always allow 'npx.cmd'ํญ๋ชฉ์ ๋ง์ฐ์ค๋ก ํด๋ฆญํฉ๋๋ค.์ฐ์ธก ํ๋จ์ ํ๋์
[Submit]๋ฒํผ์ ๋๋ฆ ๋๋ค.์ ์ ํ ๋ด๋ถ ๊ฒ์ฆ ์ ์ฐจ๋ก ์ธํด
--help๊ด๋ จ ํ์ ์ด ํ ๋ฒ ๋ ๋์ค๋ฉด ๋๊ฐ์ด 3๋ฒ(ํญ์ ํ์ฉ)์ ๋๋ฅด๊ณ ์ ์ถํฉ๋๋ค.
โฃ ์ฐ๋ ์๋ฃ ๋ฐ ์ผ ์ํค๊ธฐ
ํ๋จ์ ์ด๋ก์ ๊ธ์จ๋ก RUNNING ์ํ๊ฐ ํ๊ธฐ๋๋ฉด ๋ชจ๋ ์ฐ๋์ด ํผํํธํ๊ฒ ๋๋ฌ์ต๋๋ค!
์ด์ ๋ํ์ฐฝ์ ํ์์ฒ๋ผ ํ๊ธ๋ก "์ด ํด๋์ ์ ์์ ์๋ํ ํ์ด์ฌ ํ๋ก์ ํธ ๋ผ๋ ํ์ผ๋ค์ ์์ฑํด ์ค"๋ผ๊ณ ๋ช ๋ น์ ๋ด๋ฆฌ๋ฉด, ํด๋ก๋์ฝ๋๊ฐ ๋ด ์ปดํจํฐ ํด๋๋ฅผ ์กฐ์ํด ์ง์ง ํ์ผ๋ค์ ์์์ ์ฒ์ฒ ๋ง๋ค์ด๋ด๊ธฐ ์์ํฉ๋๋ค.
ํจ๊ป ์ด์ผ๊ธฐํด์ 1
๋ก๊ทธ์ธํ๊ณ ๋๊ธ์ ๋จ๊ฒจ ์ฃผ์ธ์



1ํ์ ์ฌ๋ก๊ธ์ 2๊ฐ๋ ใ ใ
๊ฐ์ฌํฉ๋๋ค.
์ ๋ ๋์ค์ ์๊ฐ๋ ๋ ๋ฐ๋ผํด์ ์ค์นํ๊ณ ์ฌ์ฉํด๋ณด๊ฒ ์ต๋๋ค.
๐ ๐ฅฐ ๐ธ