Kaggle CLI 代理怎么设置：数据集下载、API 认证与连接测试
设置 Kaggle CLI 代理时，先保护凭据，再确认 CLI 读取的代理入口，用最小 API 请求验证连接、认证和数据集权限。
Kaggle CLI 的凭据、代理连接和数据集权限是三层问题。先保护凭据，再验证 CLI 进程是否使用代理，最后用小请求区分网络和权限。
如何准备 Kaggle 凭据并配置 CLI 代理
按当前 Kaggle CLI 官方文档准备凭据文件或环境变量，并限制文件权限。不要把 token 写进 notebook 输出、Shell 历史、日志或截图；泄露时撤销旧 token 并检查共享环境副本。代理变量应在运行 CLI 的同一终端设置，具体入口按当前版本核验。
命令行代理参数可参考Linux 和 cURL 怎么使用 HTTP/SOCKS5 代理，不要把 token 写入命令历史。
如何逐步验证 API 和文件下载
先做出口检测，再发轻量 API 请求或元数据请求，最后下载小文件，成功后才进行目标大文件下载。记录 CLI 版本、命令、状态码、出口和耗时；小请求成功不能保证大文件传输一定成功。
需要核对 API 请求入口时，可查看代理 IP API 怎么用。
只有连接或出口证据指向代理时才调整代理；不要无限重试大文件。
下面的错误表用于区分 CLI 凭据、数据集权限、代理认证和文件传输。
| 错误/现象 | 检查层 | 验证动作 | 处理方式 |
|---|---|---|---|
| 401 | Kaggle 凭据 | 检查凭据文件或环境变量 | 更新凭据 |
| 403 | 账号/数据集权限 | 检查目标数据集 | 核对访问权限 |
| 407 | 代理认证 | 检查账号、密码和格式 | 修正代理配置 |
| 429 | 请求频率 | 查看服务端提示 | 等待并降速 |
| DNS/TLS | 连接层 | 测解析和证书链 | 修复网络 |
| 下载超时 | 文件传输 | 记录大小和耗时 | 先用小文件复测 |
小请求通过且权限明确后，再执行目标数据集下载。
401、403、407、429 和超时怎么处理
先确认 CLI 版本和凭据来源，再在运行 CLI 的同一终端设置代理。依次做出口检测、轻量 API/元数据请求、小文件下载和目标大文件下载；每一步记录状态码、数据集权限、出口和耗时。变量存在不等于 CLI 已使用代理，必须用请求结果确认。
如果错误码含义仍不明确，可参考代理 API 错误码和程序报错怎么查。
凭据泄露后应该怎么处理
401 查凭据，403 查账号或数据集权限，407 查代理认证，429 按提示等待并降速，DNS/TLS 查连接和证书。大文件超时要记录文件大小、传输耗时和重试次数，不无限重试。token 泄露后撤销旧凭据，并检查 notebook 输出、日志和 Shell 历史。
先列出文件，再执行下载
先验证 CLI 能读取代理和认证，再下载小文件；具体配置入口按当前 Kaggle CLI 版本文档核验：
```bash
HTTPS_PROXY="http://user:password@proxy.example:8080" kaggle datasets files owner/dataset
```
记录 HTTP 状态或 CLI 错误类别；列出文件成功只证明连接、认证和数据集可见，不能代表大文件下载一定不会超时。
FAQ
小请求成功是否保证大文件成功？
不能，文件大小、持续连接、权限变化和限流仍可能影响下载。
401、403 和 407 分别应该查什么？
401 查 Kaggle 凭据是否有效且被 CLI 读取；403 查账号或数据集权限；407 查代理账号和认证格式。
代理变量存在是否代表 Kaggle CLI 已使用代理？
不代表。应通过出口检测或轻量 API 请求确认 CLI 进程发出的请求实际经过预期出口。
凭据泄露后应立即做什么？
撤销旧 token 并生成新凭据，再检查 notebook 输出、日志和 Shell 历史中是否留有副本。