连接前准备
你需要一台已开启 RDP 服务的 Windows 电脑、获准远程登录的账号，以及 Mac 到这台电脑的可用网络。安装客户端不等于在 Windows 上开启服务；服务端和网络需要分别准备。服务器没有公网入口时，可通过局域网或 VPN 访问。
在下载页面按 Mac 芯片选择安装包：Apple silicon 需要 macOS 13 或更高版本，Intel 需要 macOS 12 或更高版本。是否已开放下载，以该页面为准。下载对应 DMG，打开后把 rdp-cli 拖入“应用程序”，再执行以下命令启用 CLI：
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
终端仍找不到 rdp-cli 时，重新打开终端，或直接使用上方应用内可执行文件的完整路径。DMG 中也提供独立可执行文件。
建立一个会话
把示例地址和 USER 替换为你获授权的服务器及账号。在 macOS 终端（zsh）粘贴以下命令块，按提示输入密码并回车。输入时不显示密码；命令会把密码传给 rdp-cli 并自动结束输入。
read -r -s "rdp_password?密码: "
printf '\n'
printf '%s' "$rdp_password" | rdp-cli connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
使用域账号时增加 --domain DOMAIN。已有保存凭据可改用 --credential-ref CREDENTIAL，不要混用多个密码来源。证书选项见 rdp-cli connect --help；当前 RDP 默认策略是 ignore，请按环境配置证书验证。
阅读返回的 JSON，检查状态并保存 data.session。不要从教程复制旧会话 ID。已连接时画面仍可能停留在登录或“欢迎”，先观察再决定下一步操作。
获取真实远端画面
把 SESSION 换成刚刚返回的会话值：
rdp-cli screenshot --session SESSION --out first-screen.png
打开 first-screen.png 查看桌面。截图响应还包含 data.observation，后续依据这张图执行输入时要使用它。观察令牌不是永久密码，也不是会话 ID；重连、控制权变化及屏幕布局变化可能让它失效。
想看时再打开窗口
远端连接不需要本机窗口。想跟踪 Agent 的工作时，打开已有会话即可：
rdp-cli watch --session SESSION --viewer window
窗口初始只读，可通过工具栏暂停或接管。关闭只读窗口不会断开会话；关闭持有控制权的窗口会使输入暂停。
连接失败时检查什么
依次检查服务器地址、网络、RDP 服务及账号权限，阅读结构化错误，不要反复提交密码。旧服务器可能需要明确选择兼容配置，但不应把这个设置扩展到无关会话。已有会话可先用 rdp-cli status --session SESSION 查询状态，再决定是否重试。