runpodctl 是 Runpod 官方 CLI，用于在终端管理 GPU/CPU 工作负载，覆盖 pod、无服务器端点、模板、网络卷、Hub 部署、模型、SSH 与文件传输。
用途与主要能力：管理 pod 生命周期（创建、启动、停止、重启、重置、更新、删除、日志）；管理无服务器端点（列表、获取、创建、更新、删除）；浏览与搜索 Runpod Hub 仓库并据此部署；搜索模板、检查 GPU 类型与数据中心可用性；检索 SSH 连接信息；处理网络卷与文件传输。
安装与用法：可用 curl -sSL https://cli.runpod.net | bash（Linux/macOS，Windows 经 WSL），或 brew install runpod/runpodctl/runpodctl，也可用官方 README 中的手动二进制、Windows 与 conda 方式。命令以二进制实时帮助为准：runpodctl --help、runpodctl <resource> --help。鉴权可用 export RUNPOD_API_KEY=your_key（非交互，适合智能体），或交互式 runpodctl doctor。
使用前须先 runpodctl update 并 runpodctl version 确认版本，全程固定一个较新版本，勿新旧混用。输出为 stdout JSON，错误为 stderr 单个 JSON 加非零退出码，应按 code 分支处理，而非 status 或消息；成功时 stderr 也可能有弃用警告。runpodctl 自身不重试。部分错误码、urls 对象与价格需 v2.8.0+；--wait 等需 v2.9.0+，serverless logs 需 v2.10.0+，故须先确认版本。
限制：文档为快照，实时 --help 与二进制行为优先；模板/命令细节以实际版本为准。资料中的说明在此截断，更多命令与规则暂未提供。