HD Warp 使用指南
快速完成配置，开启无感切换体验。按照以下步骤操作，几分钟即可上手。
开始配置 →操作步骤
0
环境准备
安装必要的系统依赖
▼
在开始使用 HD Warp 之前，请确保已安装以下依赖组件。如果您已经安装，可跳过此步骤。
应用打开显示"已损坏"？
macOS 的安全机制可能会阻止运行未签名的应用。请在终端执行以下命令解除限制：
macOS 的安全机制可能会阻止运行未签名的应用。请在终端执行以下命令解除限制：
sudo xattr -rd com.apple.quarantine /Applications/HD\ Warp.app
1. 安装 Homebrew（如已安装可跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. 安装 Python 3.13+
brew install python@3.13
3. 安装 mitmproxy（二选一）
推荐使用 brew 安装，更稳定可靠
brew install mitmproxy
或使用 pip 安装：
pip3 install mitmproxy
1
生成与安装证书
配置 HTTPS 拦截所需的 CA 证书
▼
进入「网关中心」页面，点击「生成证书」按钮。生成完成后，点击「立即安装」。
系统会打开「钥匙串访问」，请按以下步骤操作：
- 在钥匙串中搜索
mitmproxy - 双击证书打开详情
- 展开「信任」选项
- 将「使用此证书时」改为「始终信任」
- 关闭窗口并输入密码确认
重要：证书必须设为「始终信任」，否则网关无法拦截 HTTPS 请求！
2
导入账号
添加 Warp 账号到账号池
▼
进入「账号池」页面，点击「添加账号」按钮。
支持批量导入 API Key，每行一个，格式为：
wk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
如何获取 API Key？
在 Warp 中进入 Settings → Account → Create API Key
在 Warp 中进入 Settings → Account → Create API Key
3
激活网关
输入激活码解锁全部功能
▼
4
启动网关
开始享受无感切换体验
▼
点击「启动网关」按钮，系统将自动完成以下操作：
- 启动代理（默认端口 9528）
- 自动配置系统代理
- 验证账号池状态
- 启动账号轮换服务
网关运行时会自动管理额度，当账号额度耗尽时自动切换到下一个可用账号。
常见问题
应用下载后显示「已损坏」无法打开？
▼
这是 macOS 的安全机制导致的。请打开终端，执行以下命令解除限制：
sudo xattr -rd com.apple.quarantine /Applications/HD\ Warp.app
网关提示无网络连接？
▼
请开启您的科学上网工具的 TUN 模式（也叫增强模式/全局模式）后重试。TUN 模式可确保系统代理生效。
启动网关后 Warp 无法使用 AI 功能？
▼
请检查证书是否已正确安装并设为「始终信任」。可以在「钥匙串访问」中搜索
mitmproxy 查看证书状态。如果显示不受信任，请重新设置。
遇到 403 Forbidden 错误怎么办？
▼
403 错误通常是账号临时受限。请继续尝试发送请求，系统会自动检测并标记问题账号，同时切换到其他可用账号。多次尝试后即可恢复正常使用。
初次启动时 AI 请求失败？
▼
首次启动时系统需要验证所有账号状态。请等待左下角「就绪账号」数量稳定后再使用。账号验证过程中可能出现临时错误，这是正常现象。
显示 502 Bad Gateway 错误？
▼
通常是上游代理连接不稳定导致。请尝试重启网关或检查网络环境。系统会自动重试 502 错误，如果持续出现请检查科学上网工具是否正常运行。
额度显示不正确？
▼
额度会在使用过程中自动同步更新。您也可以在「账号池」页面点击「刷新额度」按钮手动更新所有账号的额度信息。
如何获取更多帮助？
▼