連接前準備
你需要一臺已開啟 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）貼上以下指令，依提示輸入密碼並按 Return。輸入時不顯示密碼；指令會將密碼傳給 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 查詢狀態，再決定是否重試。