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(所有操作系统)
推荐方法。支持自动更新和通过 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 或命令提示符。 适用于所有操作系统的替代方法: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": "您的_api_密钥"
}
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": "您的_api_密钥"
}
要打开 AppData 文件夹,按 Win + R,输入 %APPDATA%\amp 然后按 Enter。
将 您的_api_密钥 替换为您的 VibeCodeCheap API Key。
macOS 和 Linux
Windows Cmd
Windows PowerShell
临时(当前会话):export AMP_URL=https://api.vibecodecheap.com
export AMP_API_KEY=您的_api_密钥
永久: 添加到您的 shell 配置文件:# 对于 Bash (~/.bashrc)
echo 'export AMP_URL=https://api.vibecodecheap.com' >> ~/.bashrc
echo 'export AMP_API_KEY=您的_api_密钥' >> ~/.bashrc
source ~/.bashrc
# 对于 Zsh (~/.zshrc)
echo 'export AMP_URL=https://api.vibecodecheap.com' >> ~/.zshrc
echo 'export AMP_API_KEY=您的_api_密钥' >> ~/.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 您的_api_密钥' >> ~/.config/fish/config.fish
source ~/.config/fish/config.fish
临时(当前会话):set AMP_URL=https://api.vibecodecheap.com
set AMP_API_KEY=您的_api_密钥
永久:setx AMP_URL "https://api.vibecodecheap.com"
setx AMP_API_KEY "您的_api_密钥"
使用 setx 后,需要重新打开命令提示符才能使更改生效。
临时(当前会话):$env:AMP_URL = "https://api.vibecodecheap.com"
$env:AMP_API_KEY = "您的_api_密钥"
永久:[Environment]::SetEnvironmentVariable("AMP_URL", "https://api.vibecodecheap.com", "User")
[Environment]::SetEnvironmentVariable("AMP_API_KEY", "您的_api_密钥", "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 Key
- 开始在 IDE 中使用 Amp
故障排除
错误 '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 驱动的开发了。