Amp is a powerful AI coding agent developed by Sourcegraph that can run in the terminal or as an IDE extension. It helps you with software engineering tasks using natural language.
When combined with Coding Plan , Amp’s capabilities are further enhanced — access powerful models like Claude Opus 4.5 and Gemini 3 Pro at a fraction of the cost.
System Requirements Before installing, ensure you have:
macOS / Linux / WSL : curl (usually pre-installed)Windows Native : Node.js version 18 or higherStable internet connection
Step 1: Install Amp CLI macOS / Linux / WSL
Windows Native
npm (All OS)
Recommended method. Supports auto-updating and fast launch via Bun. curl -fsSL https://ampcode.com/install.sh | bash
If you encounter permission errors, try running with sudo: curl -fsSL https://ampcode.com/install.sh | sudo bash
Windows does not support the install script. Use npm: npm install - g @anthropic - ai / amp
Requires Node.js to be installed. Open PowerShell or Command Prompt as Administrator if you encounter permission errors. Alternative method for all operating systems: npm install -g @anthropic-ai/amp
Verify Installation After installation, verify Amp is working:
After installing Amp, configure it to use Coding Plan. Choose one of the following methods:
macOS / Linux / WSL
Windows
Amp CLI uses two configuration files:
Settings file : ~/.config/amp/settings.json - General settingsSecrets file : ~/.local/share/amp/secrets.json - Sensitive credentials (API keys) Create directories if they don’t exist: mkdir -p ~/.config/amp ~/.local/share/amp
Edit ~/.config/amp/settings.json: { "amp.url" : "https://api.vibecodecheap.com" }
Edit ~/.local/share/amp/secrets.json: { "apiKey@https://api.vibecodecheap.com" : "your_api_key" }
Amp CLI uses two configuration files in %APPDATA%\amp\:
Settings file : %APPDATA%\amp\settings.jsonSecrets file : %APPDATA%\amp\secrets.json Create the directory if it doesn’t exist (PowerShell): New-Item - ItemType Directory - Force - Path " $ env: APPDATA \amp"
Edit %APPDATA%\amp\settings.json: { "amp.url" : "https://api.vibecodecheap.com" }
Edit %APPDATA%\amp\secrets.json: { "apiKey@https://api.vibecodecheap.com" : "your_api_key" }
To open the AppData folder, press Win + R, type %APPDATA%\amp and press Enter.
Replace your_api_key with your VibeCodeCheap API Key.
macOS & Linux
Windows Cmd
Windows PowerShell
Temporary (current session): export AMP_URL = https :// api . vibecodecheap . com export AMP_API_KEY = your_api_key
Permanent: Add to your shell config file:# For Bash (~/.bashrc) echo 'export AMP_URL=https://api.vibecodecheap.com' >> ~/.bashrc echo 'export AMP_API_KEY=your_api_key' >> ~/.bashrc source ~/.bashrc # For Zsh (~/.zshrc) echo 'export AMP_URL=https://api.vibecodecheap.com' >> ~/.zshrc echo 'export AMP_API_KEY=your_api_key' >> ~/.zshrc source ~/.zshrc # For 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
Temporary (current session): set AMP_URL = https ://api.vibecodecheap.com set AMP_API_KEY = your_api_key
Permanent: setx AMP_URL "https://api.vibecodecheap.com" setx AMP_API_KEY "your_api_key"
After using setx, you need to reopen Command Prompt for changes to take effect.
Temporary (current session): $ env: AMP_URL = "https://api.vibecodecheap.com" $ env: AMP_API_KEY = "your_api_key"
Permanent: [ Environment ]::SetEnvironmentVariable( "AMP_URL" , "https://api.vibecodecheap.com" , "User" ) [ Environment ]::SetEnvironmentVariable( "AMP_API_KEY" , "your_api_key" , "User" )
After setting permanently, you need to reopen PowerShell for changes to take effect.
With this configuration, the amp login command is no longer necessary.
Step 3: Use Amp CLI You are now ready to use Amp. All requests will be routed through Coding Plan.
# Run interactively amp # Or run with a prompt amp "Write a hello world program in Python"
The proxy also works with Amp IDE extensions for VS Code, Cursor, Windsurf, etc.
Open your IDE and install the Amp extension from the marketplace
Open Amp extension settings
Set Amp URL to
Set Amp API Key to your VibeCodeCheap API Key
Start using Amp in your IDE
Both CLI and IDE can use the proxy simultaneously.
Troubleshooting
Error 'command not found: amp'
macOS/Linux : Ensure ~/.local/bin or the install path is added to your PATHWindows : Restart your terminal or check the npm global bin path # Check npm global path npm config get prefix
Permission error during installation
macOS/Linux : Try running with sudo or use npm with --prefixWindows : Open PowerShell/Cmd as Administrator
Connection or timeout error
Check your internet connection
If using VPN or corporate proxy, try disabling it or configure proxy for npm/curl
Ensure firewall isn’t blocking api.vibecodecheap.com
Verify the API key is copied correctly (no extra whitespace)
Ensure the API key is still valid in the Coding Plan dashboard
Check the correct format in the secrets file
Config directory doesn't exist
Create it manually: # macOS/Linux mkdir -p ~/.config/amp ~/.local/share/amp # Windows PowerShell New-Item -ItemType Directory -Force -Path " $env :APPDATA\amp"
Done! You can now use Amp with Coding Plan for AI-powered development.
