跳转到内容
Rayrun
登录注册

首次使用 Rayrun

这一页用最短的路径把 Rayrun 跑起来：注册 → 安装 CLI → 登录 → 创建第一个沙箱 → 在沙箱里执行命令。五步，命令都可以直接复制。

不装 CLI 也能用：控制台的「沙箱」页有等价的图形入口，REST API 能做同样的事 （文末有 curl 版）。

1. 注册账号

Section titled “1. 注册账号”

打开 https://dashboard.rayrunos.com，点右上角「注册」。每个账号自带一个组织， 注册即赠送初始余额（余额与流水在控制台的账单页）。

2. 安装 CLI 并登录

Section titled “2. 安装 CLI 并登录”

下载页有四个平台的发布包。Linux x86_64：

终端窗口
curl -O https://rayrunos.com/dl/rayrun-linux-amd64.tar.gz
sudo tar -xzf rayrun-linux-amd64.tar.gz -C /usr/local/bin rayrun


rayrun version   # 确认装好了

macOS 的包未签名、未公证，首次运行会被 Gatekeeper 拦下；Windows 包未实测 —— 下载页上有同样的标注。

登录（密码在终端提示输入，不回显）：

终端窗口
rayrun login you@example.com

下载包默认连接托管环境 https://api.rayrunos.com/v1；自托管用 --api-url 覆盖。 如果提示连不上 127.0.0.1:8080，说明是旧版 CLI —— 重新下载下载页的安装包， 或临时加 --api-url https://api.rayrunos.com/v1。

CLI 会自动创建一枚命令行专用 Token 并保存到本地（0600），之后所有命令直接可用。 这枚 Token 在控制台「设置 → 我的 API Token」里只读；要删除请在命令行执行 rayrun logout。

CI / 脚本也可以不用登录，直接设 RAYRUN_API_URL + RAYRUN_TOKEN（Token 在控制台 「设置 → 我的 API Token」创建，明文只显示一次）。

3. 创建第一个沙箱

Section titled “3. 创建第一个沙箱”
终端窗口
rayrun run --name demo

创建是同步的（含启动握手，几秒到十几秒），成功后输出形如：

已创建沙箱 <沙箱 ID>（agent=claude-code@1 status=Running ip=10.x.x.x）

默认规格 2 vCPU / 2 GiB 内存 / 32 GiB 工作区，镜像 claude-code@1； --cpus / --memory / --workspace / --agent 可以改。

4. 在沙箱里执行命令

Section titled “4. 在沙箱里执行命令”
终端窗口
rayrun exec demo -- sh -c 'echo hello from $(hostname)'

输出 hello from <沙箱主机名>。退出码就是命令的退出码，可以直接塞进脚本。 命令原样传递、不经 shell 包装，需要 shell 特性时像上面这样自己写 sh -c '…'。

需要交互式终端（伪终端）时：

终端窗口
rayrun exec -it demo

-it 只接沙箱名 —— 终端里跑的是镜像声明的交互程序（claude-code@1 即 Claude Code 本身），不接受另指定命令。

5. 用完清理

Section titled “5. 用完清理”
终端窗口
rayrun sandbox list          # 列出全部沙箱：ID、状态、规格
rayrun sandbox rm <沙箱 ID>  # 销毁

沙箱按运行时长计费；销毁不可逆，工作区数据一并删除。

下一步

Section titled “下一步”

同一件事也可以用 REST API 做（需要另建一枚网页 Token —— rayrun login 保存的 Token 不在终端回显）：

终端窗口
curl -sS https://api.rayrunos.com/v1/sandboxes \
  -H "Authorization: Bearer $RAYRUN_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"name":"demo","agent":"claude-code@1","cpu_cores":2,"memory_mb":2048}'