Roo Code 代理 IP 配置与模型 API 排障
Roo Code 代理 IP 怎么配置？本文说明 VS Code 扩展进程、模型 Provider 与环境变量的关系，并给出出口验证、扩展重载及常见连接错误排查方法。
Roo Code 运行在 VS Code 扩展环境中，但真正发起模型请求的可能是不同 Provider SDK。系统代理、VS Code 网络设置和终端环境变量不一定由这些请求库以相同方式读取。配置前应先确定模型提供商和运行入口，再验证扩展进程实际使用的出口。
接入全球代理服务前先确认当前环境属于支持的海外网络环境；不在支持范围内时，应先确认服务适用条件。
Roo Code、VS Code 和 Provider 分别负责什么
记录 Roo Code 版本、模型提供商、Base URL、运行环境和错误码。先确认扩展进程是否读取代理环境变量，再核对 Token、模型名称、权限和请求超时；出口 IP 正常但模型调用失败时，不要直接把认证或配额问题归因于代理。判断顺序可对照 AI 工具访问异常排查中心。
| 网络层 | 负责内容 | 能否证明 Roo Code 已走代理 | 验证动作 |
|---|---|---|---|
| 系统或 VS Code | 应用基础网络与编辑器设置 | 不能单独证明 | 查询应用侧出口并记录设置 |
| Roo Code 扩展进程 | 扩展继承的环境变量 | 需要重载后验证 | 重新加载窗口并发送最小请求 |
| 模型 Provider SDK | 实际模型 API 请求 | 需要按 Provider 单独确认 | 核对 Base URL、API Key 和响应状态 |
系统代理、扩展环境变量和 Provider SDK
第一层是系统或 VS Code 的网络设置，第二层是 Roo Code 扩展进程继承的环境变量，第三层是模型 Provider 自身的 Base URL、API Key 和 SDK。Roo Code 当前文档没有为所有 Provider 统一承诺独立 Proxy URL，因此若当前 Provider 读取进程环境，可在启动 VS Code 前设置 HTTP_PROXY、HTTPS_PROXY；SOCKS5 是否通过 ALL_PROXY 生效，应按当前 SDK 验证。
可复制的脱敏示例：
```powershell
$env:HTTP_PROXY = "http://USER:PASSWORD@HOST:PORT"
$env:HTTPS_PROXY = $env:HTTP_PROXY
code .
```
配置后执行“重新加载窗口”或重启 VS Code，再用一个最小模型请求测试。若只在终端中验证出口 IP，无法证明 Roo Code 扩展也使用了同一网络路径。代理认证格式以 代理设置 为准。
401、403、407、429 与超时排查
先用一个最小请求确认出口 IP、地区和响应状态，再按下表判断：
| 状态或现象 | 责任层 | 下一步 |
|---|---|---|
| 401/403 | API Key、模型权限或 Provider 规则 | 核对认证头、模型名和权限 |
| 407 | 代理认证 | 核对主机、端口、账号和密码 |
| 429 | Provider 配额或请求频率 | 检查配额并降低频率 |
| TLS、连接重置、超时 | DNS、TLS 信任链、协议或扩展进程 | 比较 Roo Code 与命令行的网络路径 |
407 应按 407 代理认证错误排查 检查代理账号、密码、主机和端口。
TLS、连接重置或超时应按 TLS 与连接超时排查 检查 DNS、代理协议、客户端超时和网络路径。连续失败时停止重复请求并保存复现信息。
如何在 Roo Code 内验证模型请求
设置变量后先保存工作并完全退出 VS Code，再从同一终端启动；如需隔离验证，可使用独立 user-data-dir。模型响应与出口证据分开记录，不能用终端中的 IP 检测替代扩展实际请求。
先记录 Roo Code、VS Code 和 Provider 版本，再测试相同 Base URL 在命令行与 Roo Code 中的结果。命令行成功而扩展失败，优先检查环境变量是否被扩展进程继承、窗口是否重载、TLS 信任链是否一致；状态码归因统一按上表处理。
需要比较同为 VS Code 扩展的网络继承方式时，可查看 Cline 代理 IP 配置指南。
如果重点是配置文件是否加载，可参考 Continue 代理 IP 配置指南。
如果需要区分账号登录、内置模型和外部 API 三条链路，可继续查看 Windsurf 代理 IP 配置指南。这些工具的入口不同，不应直接复制设置。
Roo Code 的扩展行为可先查看官方文档和代理设置帮助。不同 Provider 对代理环境变量的支持方式可能不同；如果当前 Provider 文档没有明确说明，请先用最小请求验证，不要默认配置已经生效。排查时记录 Roo Code、VS Code 和 Provider 版本、配置入口、响应状态和失败时间。
只有命令行、系统代理和模型权限都已分别排除，问题仍集中在扩展进程的网络出口时，才有必要评估代理 IP 的接入方式。
短时模型接口测试可进一步评估 动态住宅代理 IP；若问题来自 Provider 权限或配额，更换代理 IP 不会生效。
FAQ
如何确认 Roo Code 已经走代理？
先按主机、端口、账号和密码配置代理环境变量，再确认 Roo Code 读取了该变量；用一个最小模型请求检查出口 IP 和响应状态。
Roo Code 出现 401、403、407 或 429 时先查什么？
遇到状态码时，先按“401、403、407、429 与超时排查”中的对应项定位，再核对扩展实际请求的时间和脱敏日志。
代理 IP 能解决 Roo Code 的模型调用限制吗？
不能保证。代理 IP 只影响网络出口，不能替代账号权限、模型配额或目标服务的调用规则。