Claude Code Mac桌面端+远程控制：CLI用户指南

Claude Code Mac桌面应用和claude remote-control子命令从相反的方向解决同一个问题。桌面应用为您提供一个带有三个标签页（Chat、Cowork、Code）的窗口，以及可以围绕代码布置的工作区。远程控制则恰恰相反：本地机器上完全没有窗口，只有一个进程将本地会话提供给手机上的Claude应用或任意浏览器中的claude.ai/code。¹

如果您是从终端中的claude一路走来，这两种界面起初都会显得有些陌生。既然TUI已经够用了，我为什么还要GUI？我的Mac就在面前，为什么还要从手机上操控它？这两个问题的答案是相同的：本地环境是您无法迁移的部分。 文件系统、MCP服务器（Yurei、Cloudflare、GitHub）、Xcode、代码签名身份、您的Yurei套接字、您的~/.claude/projects/历史记录。所有这些都存在于本机上。桌面应用和远程控制是从其他位置访问该环境的两种方式：另一个窗口、另一台设备、沙发、会议室。

这篇文章是我希望自己当初切换时拥有的参考资料。它涵盖三种模式（本地CLI、云端、本地+远程控制）、各自的设置方法、各处可用的斜杠命令、推送通知机制，以及桌面应用与终端中claude的具体差异。如实呈现局限性。绝无废话。

简要总结

• 三种模式从claude.ai/code看起来相似，但运行方式截然不同：本地CLI、云端会话（终端中的claude --remote、桌面端的Remote环境，或在claude.ai/code启动新会话）、本地+远程控制。只有第一种和第三种能访问您的文件系统、MCP服务器和Xcode。¹²
• Mac桌面应用的Code标签页是图形化的Claude Code会话：与CLI同一引擎、同一份~/.claude.json配置、同一份CLAUDE.md、同样的MCP服务器。但它有自己的窗格布局、侧边对话和会话侧边栏。²
• claude remote-control（服务器模式）让进程在本地持续运行，并允许从任意设备连接。claude --remote-control是启用了远程控制的交互式会话。/remote-control则是从现有会话内部以斜杠命令形式启用同一功能。¹
• iOS应用推送通知通过/config→”Push when Claude decides”启用（v2.1.110+）。Claude会在长任务完成或需要您输入时推送。¹³
• 对于原生macOS或iOS构建，本地CLI或本地+远程控制是唯一真正可行的环境。云端会话无法运行Xcode、无法签名、无法看到本地的Yurei套接字。²

三种关键模式

相同的claude.ai/code URL、相同的iOS应用图标，背后却是三种完全不同的运行时环境。

1. 本地CLI

这就是终端中的claude。进程运行在您的Mac上。会话存储在磁盘上的~/.claude/projects/<project-path>/<session-id>.jsonl，而不是您的Anthropic账户中。⁴ 您的iPhone无法看到它。没有任何远程界面。

您能获得：

• 完整文件系统访问：~/Projects、~/.claude/，任何用户拥有读写权限的位置
• 所有MCP服务器：Yurei（/tmp/yurei.sock）、Cloudflare、GitHub、Supabase、Playwright等
• Xcode、模拟器（xcrun simctl）、代码签名身份、App Store Connect
• 本地安装的插件、技能和钩子
• 语音模式（/voice）
• 所有CLI标志（--worktree、--rc、--print、--output-format等）

您无法获得：从其他设备查看或操控会话的任何方式。

对于Mac应用构建（Return、Get Bananas、Water，以及App Intents和MCP server文章中的应用），本地CLI完美胜任。本地+远程控制（下文第3节介绍）也同样如此：两者都将Claude进程保留在Mac上，因此都能访问Xcode、模拟器和签名。云端会话才是无法运行Apple工具链的那个。

2. 云端会话

这是从终端运行claude --remote "task"、在桌面应用启动会话时选择Remote，或在网页端访问claude.ai/code并在那里启动新会话的情形。Claude Code进程运行在Anthropic的托管云基础设施上，而非您的本机。²（较旧的文档和shell习惯有时会用& task作为同等结果的简写；请将显式的--remote标志视为规范形式。）

您能获得：

• 跨机器和设备的持久性：可从iPhone、iPad、浏览器查看
• 在您关闭应用或关机后仍继续运行
• Anthropic托管环境，无需本地设置
• 多仓库支持：云端会话可将多个GitHub仓库克隆到同一工作区²

您无法获得：

• 无法访问~/Projects的文件系统
• 无法访问本地MCP服务器（Yurei套接字、本地Cloudflare缓存脚本、.mcp.json中的自定义MCP均不可达）
• 无Xcode、无模拟器、无签名
• 看不到您的~/.claude/配置或技能（仅能访问已克隆仓库的.claude/）
• 无法@mention文件（@自动补全从本地项目读取；云端会话没有本地项目）²

适用场景：不依赖Apple工具链的自包含编码任务。开PR审查、跑测试套件、重构文件、写Python脚本。任何只需要git+标准Linux+Python/Node即可完成的工作。

3. 本地+远程控制

这是第三种选择，也是大多数CLI用户忽略的一种。启用方式有三种：claude remote-control（服务器模式）、claude --remote-control（或--rc，启用远程控制的交互式会话），或从现有会话内部使用/remote-control。Claude Code进程仍以完整本地访问权限在Mac上运行，同时也向Anthropic API注册，因此您可以从iPhone、iPad或浏览器操控它。¹

您能获得：本地CLI拥有的一切，外加一部可用于发起提示的手机。对话在所有连接的设备之间保持同步。您可以从Mac终端发送一条消息，在iPhone上看到它，在iPhone上输入后续消息，再从终端看到它返回。本地进程仍在执行工作；您的手机只是一扇窗口。

您要放弃的是：一小组特定的斜杠命令。文档明确指出/mcp、/plugin和/resume仅限本地（它们都会打开需要终端的交互式选择器）。文档也明确列出了产生文本输出、可从移动端和Web使用的命令：/compact、/clear、/context、/usage、/exit、/extra-usage、/recap、/reload-plugins。¹

这就是原生macOS或iOS应用构建的答案。您拥有Xcode，拥有MCP，拥有Yurei套接字，同时还拥有手机可见性。

设置Mac桌面应用

桌面应用和CLI不是相互替代的关系。它们是同一引擎的两种客户端。您可以在同一台机器、甚至同一个项目上同时运行两者。每个客户端跟踪自己的会话历史，但它们共享CLAUDE.md、~/.claude.json、MCP服务器、钩子和技能。²

从claude.com/download下载。安装。使用您的claude.ai账户登录。应用包含三个标签页：²

• Chat用于常规Claude对话
• Cowork用于Dispatch（长时间运行的任务，可选择从手机发送消息）
• Code用于带图形界面的Claude Code

我们关心的是Code标签页。点击侧边栏中的+ New session。在提示区域配置四项内容：²

1. Environment：Local（本Mac）、Remote（Anthropic云端）或SSH（您管理的远程机器）
2. Project folder：Claude工作的目录
3. Model：Sonnet 4.6、Opus 4.6、Opus 4.7或其他
4. Permission mode：Ask、Auto-accept edits、Plan、Auto或Bypass permissions

输入提示词，按Enter。从这里开始感觉就像聊天应用：消息层叠堆放，工具调用以可折叠卡片渲染，文件变更时会出现差异统计指示器（+12 -1）。点击该指示器可打开差异查看器，逐文件审查并进行行级评论。²

对于本地会话，提示框中的@键可从项目自动补全文件路径：与CLI的@提及功能相同。对于远程会话，@被禁用，因为云端进程无法看到您的本地文件。²

启动前的前置条件

任何远程控制会话都有四个前置条件：¹

• Claude Code v2.1.51或更高版本（用claude --version检查）。
• 订阅：Pro、Max、Team或Enterprise。不支持API密钥。在Team和Enterprise上，管理员必须先在claude.ai/admin-settings/claude-code中启用Remote Control开关。
• 认证：如果尚未登录，运行claude并使用/login（claude.ai选项）。来自claude setup-token或CLAUDE_CODE_OAUTH_TOKEN环境变量的纯推理令牌将无法工作。
• 工作区信任：在项目目录中至少运行一次claude并接受工作区信任对话框。

启动远程控制会话的四种方式

当前文档列出了四种调用界面（三种来自CLI，外加一个VS Code命令）。Mac桌面应用不是远程控制的宿主；远程控制由claude（CLI）或VS Code扩展承载。¹

服务器模式：claude remote-control

cd ~/Projects/blakecrosley.com
claude remote-control

终端变成服务器。没有交互式提示。它会显示会话URL，并（按下空格键时）显示二维码。从其他设备打开该URL或扫描二维码即可连接。会话活跃期间，终端显示连接状态和工具活动。

实用标志：¹

• --name "My Project"：在claude.ai/code可见的自定义会话标题
• --remote-control-session-name-prefix <prefix>：覆盖自动名称（默认是您机器的主机名，生成类似myhost-graceful-unicorn的名称）
• --spawn same-dir（默认）：所有会话共享当前工作目录
• --spawn worktree：每个会话获得独立的git worktree（需要git仓库）；运行时按w可在same-dir和worktree之间切换
• --spawn session：单会话模式，拒绝其他连接；仅在启动时设置
• --capacity N：最大并发会话数（默认32，不能与--spawn=session同时使用）
• --sandbox / --no-sandbox：切换文件系统和网络隔离（默认关闭）

当您想启动会话后离开时，服务器模式是正确选择。终端现在是守护进程，而不是工作区。

交互式：claude --remote-control

claude --remote-control
# 或更简短
claude --rc

与普通交互式会话相同，但启用了远程控制。您可以在本地输入消息，同时也可以从claude.ai/code或iOS应用输入。对话保持同步。可选：claude --rc "Project Name"。

当您想继续在终端工作但又希望手机可见时使用此方式。这是最常见的情形。

斜杠命令：/remote-control

已经在会话中并希望对当前对话启用远程控制？输入/remote-control（或/rc）。当前对话历史会延续过来，会话URL+二维码会出现。可传递名称：/remote-control My Project。

--verbose、--sandbox和--no-sandbox标志不能与斜杠命令形式一起使用：仅适用于claude remote-control（服务器模式）。

VS Code扩展

在Claude Code VS Code扩展中，在提示框中输入/remote-control（或/rc），或用/打开命令菜单并选择它。需要Claude Code v2.1.79或更高版本。¹ 提示框上方会出现显示连接状态的横幅。点击Open in browser直接跳转到会话，或在claude.ai/code的会话列表中找到它。点击横幅上的关闭图标或再次运行/remote-control即可断开连接。

VS Code命令不接受名称参数，也不显示二维码。会话标题来自对话历史或第一条提示。

始终启用：/config→”Enable Remote Control for all sessions”

如果您希望每个交互式claude会话默认注册一个远程会话，运行/config并将Enable Remote Control for all sessions切换为true。¹ 每个交互式进程获得一个远程会话。多个实例→多个会话。如需从单个进程启动多个并发会话，服务器模式仍是正确工具。

推送通知机制

当有趣的事情发生时推送到您的手机。设置分四步：¹³

1. 安装iOS或Android的Claude应用。在Claude Code中，如果您还没有，/mobile会显示下载二维码。
2. 使用您在终端中Claude Code使用的同一Claude账户登录。
3. 接受操作系统的通知权限提示。
4. 在终端中运行/config并启用Push when Claude decides（v2.1.110+）。

之后，Claude会决定何时推送。两种情况会触发：长时间运行的任务完成，或Claude需要您的输入才能继续。您也可以在提示中明确请求：notify me when the tests finish。没有逐事件的配置：要么开启要么关闭。

如果您打开了设置但没有看到通知，最常见的修复方法是：打开手机上的Claude应用，让它刷新推送令牌。在此之前，/config屏幕会显示No mobile registered。iOS专注模式和Android电池优化也可能延迟或抑制推送；请检查iOS的设置→通知→Claude，或在Android上将Claude应用从电池优化中豁免。¹

补充背景：另有一个push-notification工具（同样在v2.1.110+），它让Claude自身在会话期间决定发送通知，而不仅仅是任务结束时。它与同一远程控制界面配对，无需额外设置。³

远程可用的斜杠命令

这是大多数CLI用户最关心的部分。当您在手机上而不是终端上输入时，哪些命令可用？

任意已连接客户端（终端、浏览器、iOS应用）均可使用：¹

• /compact、/clear：上下文管理
• /context、/usage、/extra-usage：使用情况和上下文检查（v2.1.113+为/extra-usage增加了远程控制支持）
• /exit、/recap、/reload-plugins
• 所有非选择器的文本输入（常规提示、产生文本输出的普通斜杠命令）

仅限本地（仅终端）：¹

• /mcp：打开交互式选择器
• /plugin：打开交互式选择器
• /resume：需要渲染带选择UI的会话列表

规律是：任何在终端中需要带键盘选择的列表式UI的命令都仅限本地。任何文本进/文本出的命令都可以从移动端或Web使用。

部分命令的远程控制支持与版本相关。 /extra-usage仅在v2.1.113及更高版本中可从远程控制客户端工作：早期版本会静默失败。⁵ 如果某个命令在手机上的行为与Mac上不同，值得检查claude --version。

权限模式略有不同

桌面应用有五种权限模式；CLI在这五种之外还多了dontAsk：²

dontAsk仅CLI可用。其余都映射到发送按钮旁的UI控件。CLI标志--dangerously-skip-permissions对应Bypass permissions，您必须在设置→Claude Code→”Allow bypass permissions mode”中选择启用。²

Auto模式在Team/Enterprise/API上需要Claude Sonnet 4.6、Opus 4.6或Opus 4.7；在Max上需要Opus 4.7。Pro计划或第三方提供商不可用。²

Cowork标签页与Dispatch（相邻但并不相同）

桌面应用的Cowork标签页是一项不同的功能，使用习惯有所重叠。Dispatch是”从手机向Claude发送任务，由它决定自行处理还是在Mac上启动Code会话”。²

配对仅需一次：安装Claude移动应用，通过Cowork标签页将其与Mac关联。之后，您可以向Dispatch发送任务（”修复登录bug，开个PR”）由它路由工作。Bug修复、依赖更新、测试运行和PR创建通常会作为带Dispatch徽章的Code会话出现在侧边栏中。研究、文档编辑和电子表格工作则留在Cowork中。

Dispatch生成的Code会话的应用批准权限会在30分钟后过期（与之相对，常规Code会话的权限会在整个会话期间保持有效），因此长时间运行的Dispatched任务可能会再次提示您批准已批准过的应用权限。²

Dispatch需要Pro或Max。Team或Enterprise不可用。

这不是远程控制。Dispatch是”向Claude发送任务自主运行”；远程控制是”操控已经运行的会话”。它们在文档中被记录为独立界面：远程控制由CLI或VS Code承载，Dispatch生成桌面Code会话：而文档目前没有描述将两者结合。根据您是想委派（Dispatch）还是操控（远程控制）来选择。

从CLI继承的内容

桌面应用读取与CLI相同的配置文件：²

• 项目中的CLAUDE.md和CLAUDE.local.md
• ~/.claude.json（全局）和.mcp.json（按项目）用于MCP服务器
• 在~/.claude/settings.json或.claude/settings.json中定义的钩子和技能
• settings.json中的权限规则
• 所有可用模型

CLI标志→桌面端等价物：²

值得提醒一个配置陷阱：Claude Desktop聊天应用（claude_desktop_config.json处的纯聊天客户端）和Claude Code Desktop（我们正在讨论的开发客户端）是不同的产品。为聊天应用配置的MCP服务器不会出现在Code标签页中。Code读取~/.claude.json和.mcp.json，而不是claude_desktop_config.json。²

CLI→桌面端：何时迁移

桌面应用在CLI不擅长的三件事上表现出色：²

1. 并行会话并排显示：每个Code标签页会话在<project-root>/.claude/worktrees/下获得独立的Git worktree。用Ctrl+Tab/Ctrl+Shift+Tab循环切换。在一个会话中运行重构，在另一个会话中运行测试套件，可视化地审查它们，而不是通过ANSI转义码。
2. 可视化差异审查：点击+12 -1指示器。在行上评论。用Cmd+Enter将评论提交回Claude。比在终端阅读内联差异强得多。
3. 嵌入式预览窗格：Claude可以启动开发服务器，在嵌入式浏览器中打开运行中的应用，截图、点击操作并验证自己的更改。每个项目默认开启自动验证（在.claude/launch.json中切换或通过Preview下拉菜单切换）。²

CLI在以下方面仍然胜出：脚本化（--print、--output-format）、自动化（cron任务、CI）、tmux/screen工作流，以及任何需要dontAsk权限模式的场景。

如需将CLI会话迁移到桌面端而不丢失上下文，在终端中运行/desktop。它会保存会话、在桌面应用中打开它，并退出CLI。²

局限性与陷阱

来自文档的真实情况：¹

• 每个交互式进程一个远程会话。 在服务器模式之外，每次claude调用支持一个远程会话。需要多个？请使用claude remote-control（服务器模式）。
• 本地进程必须保持运行。 远程控制由claude CLI进程或VS Code扩展承载。关闭终端、退出VS Code或终止claude进程，远程会话即终止。没有从终端分离的模式。¹
• 网络中断>10分钟会终止会话。Mac可以处于唤醒状态但10分钟内无法访问网络；进程退出，您必须重新启动。
• Ultraplan会断开远程控制。 两者都占用claude.ai/code界面，每次只能连接一个。
• Auto模式需要较新的模型。 Max上需Opus 4.7；Team/Enterprise/API上需Sonnet 4.6、Opus 4.6或Opus 4.7。Pro不可用。
• API密钥和纯推理令牌不起作用。 远程控制需要全作用域的claude.ai OAuth登录。如果ANTHROPIC_API_KEY已设置，请取消设置。如果您通过claude setup-token或CLAUDE_CODE_OAUTH_TOKEN认证，请运行claude auth login刷新。
• Team和Enterprise管理员必须启用它。 默认关闭。开关位于claude.ai/admin-settings/claude-code→Remote Control。某些数据保留配置会使开关不可用。

最常见的”为什么这个不工作”故障：用户使用纯推理令牌登录。错误”Remote Control requires a full-scope login token”对应这种情况。修复方法：claude auth login并选择claude.ai选项。¹

其他值得了解的故障排查情形

官方文档涵盖了几种会消耗初学者大量时间的故障模式。提炼如下：¹

• “Remote Control requires a claude.ai subscription”：您未通过claude.ai认证。如果ANTHROPIC_API_KEY已设置，请先取消设置，然后claude auth login。
• “Unable to determine your organization for Remote Control eligibility”：缓存的账户信息已过期。运行claude auth login刷新。
• “Remote Control is not yet enabled for your account”：检查环境中是否有CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC、DISABLE_TELEMETRY、CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX或CLAUDE_CODE_USE_FOUNDRY。远程控制需要claude.ai认证；第三方提供商无法工作。取消设置，然后/logout再/login。
• “Remote Control is disabled by your organization’s policy”：根据文档有三种原因：(a) 您使用API密钥或Console账户（请使用claude.ai OAuth），(b) Team/Enterprise管理员未启用开关，(c) 由于与远程控制不兼容的数据保留配置，管理员开关变灰（请联系Anthropic支持）。
• “Remote credentials fetch failed”：用--verbose重新运行以查看底层错误：claude remote-control --verbose。通常是未登录、防火墙阻止了到Anthropic API的443端口出站HTTPS，或更早的会话创建失败（查找Session creation failed: see debug log）。
• 工作区信任对话框：如果远程控制启动失败但没有明显错误，请在项目目录中至少运行一次claude并接受工作区信任对话框。这一步是远程控制注册会话之前的必需操作。

CLI用户的决策树

面对一个真实任务，根据工作需要选择模式：

工作是否需要Apple工具链（Xcode、模拟器、签名）？
├── 是 → 本地CLI或本地+远程控制
│         （云端无法访问工具链）
│
└── 否 → 是否需要您的本地MCP服务器（Yurei、Cloudflare等）？
         ├── 是 → 本地CLI或本地+远程控制
         │
         └── 否 → 您是否需要从手机监控或操控？
                  ├── 是 → 本地+远程控制，或云端会话
                  │         （如果任务持续数小时，云端更好）
                  │
                  └── 否 → 本地CLI即可

Mac/iOS应用开发：我大多数应用所做的工作：每次都落在最上面的分支。云端会话无法xcodebuild，无法与模拟器通信，无法签名。对于Get Bananas的MCP扩展、我Yurei驱动的census脚本，或Apple Ecosystem cluster工作，Apple工具链依赖是无法回避的。本地+远程控制是唯一同时提供该工具链和手机可见界面的途径。

常见问题

我能在同一项目上同时运行CLI和桌面应用吗？

可以。它们共享配置（CLAUDE.md、~/.claude.json、MCP服务器、钩子、技能），但保持独立的会话历史。² 您可以在iTerm中运行claude会话，并在桌面应用中开启Code标签页会话，两者都指向同一个~/Projects/blakecrosley.com，都向git写入。如果不使用worktree，请小心并行写入。

我的Mac进入睡眠后，远程控制会话会怎样？

机器恢复在线后会话会自动重新连接。如果您的Mac处于唤醒状态但超过约10分钟无法访问网络，会话会超时，您必须用claude remote-control启动新会话。¹

远程控制能与& task（后台）语法一起使用吗？

& task和远程控制是不同的界面。& task将工作发送到云端会话。远程控制将您从其他设备连接到本地会话。两者都可以出现在claude.ai/code的会话列表中，但云端那个运行在Anthropic基础设施上，而远程控制那个运行在您的机器上。¹

我能将远程控制与第三方提供商（Bedrock、Vertex、Foundry）一起使用吗？

不能。远程控制需要claude.ai认证。如果您设置了CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX或CLAUDE_CODE_USE_FOUNDRY，资格检查会因”Remote Control is not yet enabled for your account”而失败。请取消设置并重新运行。¹

--remote-control和claude remote-control有什么区别？

claude --remote-control（或--rc）在您的终端中启动一个普通的交互式会话，启用了远程控制。您可以在本地输入，同时也可以从其他设备输入。claude remote-control（无标志，子命令）是服务器模式：终端变成服务器，没有本地提示，只有连接状态。两者默认创建一个远程会话；服务器模式可以通过--capacity或--spawn提供多个。¹

桌面应用是否有像CLI那样的技能、插件和钩子？

有。它们就是同一套技能、插件和钩子。桌面应用读取~/.claude/settings.json和项目级.claude/settings.json，与CLI相同。点击提示框旁的+按钮浏览已安装的插件和技能。插件在远程（云端）会话中不可用，但在本地桌面会话中可正常使用。²

为什么/mcp无法从我的手机使用？

/mcp打开一个交互式选择器，需要终端专属的UI进行选择。它仅限本地。/plugin和/resume同样如此。¹ 任何产生文本输出的命令（/compact、/clear、/context、/usage、/extra-usage、/exit、/recap、/reload-plugins）都可从移动端和Web使用。

是否有免费层级，还是这一切都需要订阅？

远程控制在Pro、Max、Team和Enterprise计划上可用。不支持API密钥。在Team和Enterprise上，管理员必须先在claude.ai管理员设置中启用Remote Control开关，用户才能看到该功能。¹ 桌面应用本身可免费下载，但需要claude.ai登录才能使用。

最简洁的版本：本地CLI是基底。桌面应用是同一基底的图形客户端。/remote-control是让该基底可从手机访问的桥梁。 根据工作需要和您所在的位置进行选择。

参考资料