终端命令明明跑了，Xcode 窗口却不见了？
最快解法：Windows 版 Claude Code Desktop 可以通过 SSH 连接远程 Mac；Claude Code、项目文件和开发命令会在远程 Mac 上运行。SSH 只提供终端与文件访问，不会把 Mac 桌面传到 Windows。
只有 Windows 电脑、要让 Claude Code 处理 macOS 项目的学生，可以照着这篇教程验收 SSH 工作流。
正在做 Swift 或 iOS 课程、需要用 Mac 工具的初学者，可以重点看项目路径和构建检查。
如果作业必须点击 Xcode 窗口或查看模拟器画面，应另行准备图形桌面连接方式。
最后更新于 2026 年 10 月 13 日，已核对 Claude Code Desktop 官方 SSH 设置、客户端平台及远程主机要求。若后续桌面版更新了连接流程，先以官方文档为准。
[ SECTION_01 ] Claude Code Desktop 连接远程 Mac：先选对工作方式
能否连接？可以。 Claude Desktop 提供 Windows 客户端，Claude Code 功能是否可用还取决于账户方案；桌面应用的 Code 会话可选择 SSH 环境。远程主机须运行 macOS 或 Linux，首次连接时 Desktop 会在远端自动安装 Claude Code。开始前可查看桌面版 SSH 会话的官方说明和Claude Desktop 的系统要求与功能可用性。
先把两种连接想成不同的门：
- SSH 是终端门：让 Claude Code 访问远端文件、运行命令，适合改代码、执行测试或构建。
- 图形桌面是屏幕门：显示远端 macOS 桌面，适合查看窗口、点选 Xcode 菜单或观察模拟器。
- 组合使用：代码任务走 SSH；课程要求屏幕操作时，再通过获准的图形桌面方式连接。
因此，“Claude Code 能在远程 Mac 上运行”不等于“Windows 上能看到远程 Mac 屏幕”。即使终端构建成功，也不能仅凭 SSH 判断 Xcode 界面验收或模拟器演示已经完成。
[ SECTION_02 ] 连接前的准备：账号、主机与课程项目
先确认远端 Mac 的主机地址、SSH 端口、获准使用的账号，以及课程代码放在哪个目录。主机地址可以理解为远程电脑的门牌号；SSH 账号则是门禁名单上的身份。没有有效账号，知道地址也进不去。
Mac 端需要允许远程登录，并将连接者纳入获准用户范围。Apple 的远程登录设置说明指出，Remote Login 用于 SSH 或 SFTP 访问；开启远程登录也会影响安全性，所以不要擅自更改学校或管理员管理的设备策略。托管主机应使用服务方提供的 SSH 连接信息，不要假设自己能修改系统设置。
在 Windows 上，先确认桌面版已经安装并登录。官方页面列出的 Windows 桌面系统要求是 Windows 10 或更高版本；Claude Code 功能与账户方案相关。可对照Windows 桌面安装说明。如果之后需要从 PowerShell 单独测试 SSH，再查看微软的Windows OpenSSH 客户端安装与连接说明。
连接信息不齐时，不要靠猜来试：
- 地址应由主机管理员或服务方提供；不要把示例地址当成真实主机。
- 确认端口是否为默认值。Desktop 的 SSH 端口留空时默认使用 22，但已有 SSH 配置也可能指定其他端口。
- 确认远端项目目录确实存在，并且账号有读写权限。
- 若设备、网络或账号由学校管理，先确认政策允许远程登录；不要绕过限制。
[ SECTION_03 ] 添加 SSH 主机：把连接字段填准确
在 Claude Code Desktop 的 Code 页面开始新会话前，打开环境下拉菜单，选择 SSH，再添加 SSH 连接。连接表单的字段应与管理员提供的信息一致；已经配置过 ~/.ssh/config 的主机，可以使用配置中的主机别名，而不必重复抄写所有连接参数。
| 字段 | 填什么 | 新手怎么理解 |
|---|---|---|
| Name | 自己能认出的连接名称 | 通讯录里的备注，不是主机地址 |
| SSH Host | 用户名@主机地址，或已有 SSH 配置中的主机别名 |
要去的门牌号和登录身份 |
| SSH Port | 服务方提供的端口；留空时按官方默认规则处理 | 进入主机的门 |
| SSH Key | 私钥文件路径；已有 SSH 配置或代理时可按设置留空 | 本机保存的门禁钥匙 |
| Worktree folder | 远端用于新会话工作树的目录；可依需要留空 | Claude 为会话放置独立工作副本的位置 |
这些字段与首次远端安装行为见官方 SSH 连接设置。表单可能随桌面版更新而变化；如果界面与文档不一致，应以当前版本界面和官方说明核对，不要把过期教程中的字段硬套进去。
私钥就像只应由持有人保管的门禁钥匙。不要把私钥、密码或账号凭证发给同学，也不要粘贴进 Claude 提示词、课程提交内容或公开仓库。若组织或学校提供统一 SSH 配置，应按其说明使用；认证失败时先核对主机、账号、密钥路径和访问权限，不要尝试绕过管理策略。
[ SECTION_04 ] 连上之后：确认项目和命令确实在远端
连接成功后，从 Desktop 的 SSH 环境里选择远程 Mac 上的课程项目目录。项目目录就是本次作业的“工作桌”：选错目录，Claude 可能查看了不相关的文件，甚至在错误位置修改内容。
第一次不要马上让 Claude 大改项目。先用只读请求确认路径和文件，例如：
请只查看当前目录，不要修改文件。说明当前路径、列出主要项目文件，并指出课程要求的入口文件在哪里。
再让它检查工具位置，或运行课程允许的无破坏性查看命令，例如 pwd、ls、git status。重点确认输出对应远程 Mac 的项目目录，而不是 Windows 本机。Claude Code Desktop 的窗口运行在本地，并不表示项目文件和终端命令也在本地执行；官方文档说明 SSH 会话中的 Claude Code 运行在远端，并访问远端文件与工具。
一个常被忽略的成本是目录和权限边界：项目放错路径会造成“连上了却找不到代码”；账号只有读取权限时，改文件或构建可能失败；学校网络策略也可能阻止 SSH。出现这些情况时，应先向主机或课程管理员确认，不要扩大权限或擅自复制敏感课程文件到个人设备。
[ SECTION_05 ] 第一次课程练习：先看差异，再做构建验收
选一个范围很小、能通过作业要求核对的改动，例如修正文档说明或补一个简单函数。先让 Claude 解释计划，再逐项确认它要改哪些文件。初学者不要一开始就允许它重写整个项目，也不要把未经检查的生成代码直接当作完成作业。
改动生成后，在 Desktop 的差异视图里逐文件检查：新增内容是否符合题意，是否误删已有实现，是否改动了课程未要求的配置。需要进一步核验时，可在远端终端运行 git status 和 git diff --check；后者用于检查差异中的空白错误和冲突标记，具体行为可查阅Git 差异检查文档。提交前再由学生本人确认代码逻辑、命令输出和课程提交规则。
如果课程要求命令行构建，可在 SSH 会话中执行，但应先确认远端安装了相应工具。Apple 的Xcode 命令行工具参考列出了随 Xcode 提供的工具，例如 xcodebuild；命令行构建结果不等于完成了图形界面验收。遇到需要查看模拟器画面、调整 Xcode 设置或点击界面控件的作业，应安排独立的图形桌面访问。Apple 的屏幕共享使用说明讲的是 Mac 间的屏幕共享；Windows 用户能否访问某个远端桌面，仍须确认实际主机和服务支持的客户端方式。
[ SECTION_06 ] 验收清单与连接方式对照
完成首次连接后，按下面的可勾选清单逐项验收。任何一项未通过，都先停在当前步骤核对信息，不要让 Claude 对不确定的目录继续写入。
- [ ] Claude Code Desktop 已安装、登录，且 Code 功能对当前账户可用。
- [ ] SSH 主机、端口、账号和认证方式来自可信管理员或服务方。
- [ ] 远端主机满足官方文档要求，账号获准连接。
- [ ] Desktop 环境明确选中 SSH，而不是本机或其他会话。
- [ ] 当前路径和课程项目文件确认来自远端 Mac。
- [ ] 用只读查看或小范围练习验证过命令位置。
- [ ] 已逐文件检查 Claude 产生的差异，再决定是否构建或提交。
- [ ] 如果作业要求操作 Xcode 窗口或查看模拟器，已另行确认图形桌面方案。
| 课程任务 | SSH 是否够用 | 验收重点 |
|---|---|---|
| 阅读项目、解释代码、修改文本或源文件 | 通常够用 | 确认选中远端目录，逐项审查差异 |
| 运行远端已有的命令行工具或构建命令 | 视工具与权限而定 | 核对远端工具已安装，并检查输出和退出结果 |
| 点击 Xcode 窗口、调整界面设置 | 不够 | 另确认可用的图形桌面连接方式 |
| 查看或演示模拟器画面 | SSH 本身不提供画面 | 另确认图形访问、模拟器状态及课程验收要求 |
对只需处理文件、运行终端任务的学生，SSH 路线通常更直接：不必把桌面画面持续传输到本机，也能在远程 Mac 上使用项目工具。若课程要求可视化操作，缺少图形连接时，SSH 再顺畅也无法替代这部分验收；反过来，只靠桌面远控做命令行工作，也可能让文件位置和操作记录更难确认。
若手边没有可用 Mac，但课程已经明确需要 macOS 环境，可以先查看 NOVAKVM 的远程 Mac 连接入口，再按作业要求判断是否适合。相比临时借用设备，临时方案可能受使用时段限制；相比仅用 SSH，纯终端无法展示 Xcode 界面；而购买实体 Mac 则需要承担长期设备成本。需要图形桌面或特定配置时，先核对实际可用的连接方式与环境，再决定是否租用；如果作业完全能在现有 Windows 环境完成，或必须使用手边的物理接口，就没有必要为了 SSH 工作流额外租 Mac。可先通过 NOVAKVM 的 Mac 配置选项核对适用环境，再决定是否进入租用流程。