Amp는 Sourcegraph에서 개발한 강력한 AI 코딩 에이전트로, 터미널에서 실행하거나 IDE 확장으로 사용할 수 있습니다. 자연어를 사용하여 소프트웨어 엔지니어링 작업을 도와줍니다.
코딩 플랜 과 결합하면 Amp의 기능이 더욱 향상됩니다 — Claude Opus 4.5 및 Gemini 3 Pro와 같은 강력한 모델을 저렴한 비용으로 이용할 수 있습니다.시스템 요구 사항 설치 전에 다음을 확인하세요:
macOS / Linux / WSL : curl (일반적으로 사전 설치됨)Windows 네이티브 : Node.js 버전 18 이상안정적인 인터넷 연결
1단계: Amp CLI 설치 macOS / Linux / WSL
Windows 네이티브
npm (모든 OS)
권장되는 설치 방법입니다. 자동 업데이트와 Bun을 통한 빠른 실행을 지원합니다. curl -fsSL https://ampcode.com/install.sh | bash
권한 오류가 발생하면 sudo로 실행해 보세요: curl -fsSL https://ampcode.com/install.sh | sudo bash
Windows는 설치 스크립트를 지원하지 않습니다. npm을 사용하세요: npm install - g @anthropic - ai / amp
Node.js 설치가 필요합니다. 권한 오류가 발생하면 PowerShell 또는 Command Prompt를 관리자 권한으로 열어주세요.모든 운영 체제를 위한 대체 방법: npm install -g @anthropic-ai/amp
설치 확인 설치 후 Amp가 작동하는지 확인하세요:
2단계: 코딩 플랜 설정 Amp 설치 후, 코딩 플랜을 사용하도록 설정합니다. 다음 방법 중 하나를 선택하세요:
macOS / Linux / WSL
Windows
Amp CLI는 두 개의 구성 파일을 사용합니다:
설정 파일 : ~/.config/amp/settings.json - 일반 설정시크릿 파일 : ~/.local/share/amp/secrets.json - 민감한 자격 증명(API 키) 디렉토리가 없으면 생성하세요: mkdir -p ~/.config/amp ~/.local/share/amp
~/.config/amp/settings.json 편집:{ "amp.url" : "https://api.vibecodecheap.com" }
~/.local/share/amp/secrets.json 편집:{ "apiKey@https://api.vibecodecheap.com" : "your_api_key" }
Amp CLI는 %APPDATA%\amp\에 두 개의 구성 파일을 사용합니다:
설정 파일 : %APPDATA%\amp\settings.json시크릿 파일 : %APPDATA%\amp\secrets.json 디렉토리가 없으면 생성하세요 (PowerShell): New-Item - ItemType Directory - Force - Path " $ env: APPDATA \amp"
%APPDATA%\amp\settings.json 편집:{ "amp.url" : "https://api.vibecodecheap.com" }
%APPDATA%\amp\secrets.json 편집:{ "apiKey@https://api.vibecodecheap.com" : "your_api_key" }
AppData 폴더를 열려면 Win + R을 누르고, %APPDATA%\amp을 입력한 후 Enter를 누르세요.
your_api_key를 VibeCodeCheap API 키로 교체하세요.
macOS & Linux
Windows Cmd
Windows PowerShell
임시 (현재 세션): export AMP_URL = https :// api . vibecodecheap . com export AMP_API_KEY = your_api_key
영구적: 쉘 설정 파일에 추가하세요:# Bash (~/.bashrc) echo 'export AMP_URL=https://api.vibecodecheap.com' >> ~/.bashrc echo 'export AMP_API_KEY=your_api_key' >> ~/.bashrc source ~/.bashrc # Zsh (~/.zshrc) echo 'export AMP_URL=https://api.vibecodecheap.com' >> ~/.zshrc echo 'export AMP_API_KEY=your_api_key' >> ~/.zshrc source ~/.zshrc # Fish (~/.config/fish/config.fish) echo 'set -gx AMP_URL https://api.vibecodecheap.com' >> ~/.config/fish/config.fish echo 'set -gx AMP_API_KEY your_api_key' >> ~/.config/fish/config.fish source ~/.config/fish/config.fish
임시 (현재 세션): set AMP_URL = https ://api.vibecodecheap.com set AMP_API_KEY = your_api_key
영구적: setx AMP_URL "https://api.vibecodecheap.com" setx AMP_API_KEY "your_api_key"
setx 사용 후, 변경 사항을 적용하려면 Command Prompt를 다시 열어야 합니다.
임시 (현재 세션): $ env: AMP_URL = "https://api.vibecodecheap.com" $ env: AMP_API_KEY = "your_api_key"
영구적: [ Environment ]::SetEnvironmentVariable( "AMP_URL" , "https://api.vibecodecheap.com" , "User" ) [ Environment ]::SetEnvironmentVariable( "AMP_API_KEY" , "your_api_key" , "User" )
영구적으로 설정한 후, 변경 사항을 적용하려면 PowerShell을 다시 열어야 합니다.
이 설정으로 amp login 명령은 더 이상 필요하지 않습니다.
3단계: Amp CLI 사용 이제 Amp를 사용할 준비가 되었습니다. 모든 요청은 코딩 플랜을 통해 라우팅됩니다.
# 대화형으로 실행 amp # 또는 프롬프트와 함께 실행 amp "Python으로 hello world 프로그램을 작성해 주세요"
4단계: (선택 사항) Amp IDE 확장 설정 프록시는 VS Code, Cursor, Windsurf 등의 Amp IDE 확장에서도 작동합니다.
IDE를 열고 마켓플레이스에서 Amp 확장을 설치합니다
Amp 확장 설정을 엽니다
Amp URL 을 로 설정합니다Amp API Key 를 VibeCodeCheap API 키로 설정합니다IDE에서 Amp 사용을 시작합니다
CLI와 IDE 모두 프록시를 동시에 사용할 수 있습니다.
문제 해결
오류 'command not found: amp'
macOS/Linux : ~/.local/bin 또는 설치 경로가 PATH에 추가되었는지 확인하세요Windows : 터미널을 다시 시작하거나 npm 글로벌 bin 경로를 확인하세요 # npm 글로벌 경로 확인 npm config get prefix
macOS/Linux : sudo로 실행하거나 --prefix와 함께 npm 사용을 시도하세요Windows : PowerShell/Cmd를 관리자 권한으로 여세요
인터넷 연결을 확인하세요
VPN 또는 회사 프록시를 사용 중이라면 비활성화하거나 npm/curl에 대한 프록시를 구성하세요
방화벽이 api.vibecodecheap.com을 차단하지 않는지 확인하세요
API 키가 올바르게 복사되었는지 확인하세요 (추가 공백 없이)
코딩 플랜 대시보드에서 API 키가 여전히 유효한지 확인하세요
시크릿 파일에서 올바른 형식을 확인하세요
수동으로 생성하세요: # macOS/Linux mkdir -p ~/.config/amp ~/.local/share/amp # Windows PowerShell New-Item -ItemType Directory -Force -Path " $env :APPDATA\amp"
완료! 이제 코딩 플랜과 함께 Amp를 사용하여 AI 기반 개발을 할 수 있습니다.
