准备工作

运行第一个任务前，需要先完成几项准备。完成后，你就可以进入 runwhere 快速开始 跑通 CLI 主链。

1. 创建控制台账号

打开 RunWhere 控制台，创建账号并进入你的组织。团队成员后续可以在同一组织下共享资源、任务和用量视图。

2. 接入云资源

在控制台打开 Cloud Accounts，按页面提示完成接入。

接入流程通常是：

1. 选择云厂商和区域。
2. 按页面提示创建角色、信任关系或访问授权。
3. 回到 RunWhere 完成验证。
4. 等待账号状态变为 healthy。

接入前建议确认：

• GPU/vCPU 配额不是 0。
• 目标区域有可用网络。
• 云账号未欠费，按量计费可用。
• 安全组允许任务运行所需的控制面通信。

Free 档开箱即用，不需要提前开通订阅；需要更多并发配额时再在控制台的账务管理中升级套餐。

如果新账号 GPU 配额为 0，需要先在云厂商控制台申请提额，再回到 RunWhere 重新触发健康检查。

3. 生成 API Token

在控制台生成 API Token。这个 token 用于 runwhere login，代表你的身份和组织权限。

请不要把 token 写进：

• Git 仓库
• 任务 YAML
• Issue 或 PR
• 聊天记录
• 公共日志

4. 安装 runwhere

pip install runwhere

开发环境可以在源码目录安装：

cd runwhere-runw
pip install -e ".[dev]"

确认命令可用：

runwhere --help

5. 登录

runwhere login --endpoint https://api.runwhere.ai

命令会提示粘贴 API Token。非交互环境可以用管道输入：

echo "$RUNWHERE_TOKEN" | runwhere login --endpoint https://api.runwhere.ai

登录信息会写入本机：

~/.runwhere/config.toml

确认当前身份：

runwhere whoami

6. 下一步

准备完成后，继续阅读：

• runwhere 快速开始：跑通最短路径。
• 任务 YAML：编写任务文件。
• 运行任务：同步、提交、看日志和清理任务。