要把手机连接到 Claude Code，先在 iPhone 或 Android 手机上安装 Claude Code Notifier App，在电脑上安装免费的 ccn 命令行工具，然后进行配对。运行 ccn pair 并扫描显示的二维码；或者在 App 中打开“电脑 > 添加电脑”，再用 App 显示的 6 位配对码运行 ccn pair。Mac、Windows 和 Linux 上操作完全相同，大约一分钟搞定。
01配对后能做什么
手机配对后，Claude Code 需要你时就能找到你：
- 一轮对话结束时立即收到“Claude 已完成”的 push 通知。
- 权限请求可以选择允许一次、本次会话内允许或拒绝。
- 提问可以直接选择选项来回答。
- Claude 完成后可以马上发送后续指令。
配对之前，ccn 已经会在这些时刻于电脑上显示桌面通知，配对只是把手机也加进来。
Claude Code Notifier 是由 TouchTap Ltd 开发的独立工具，并非 Anthropic 出品，也与其无关联。它基于 Claude Code 的 hook 工作，因此能覆盖任意 terminal 中的每个 claude 会话，包括 VS Code、Cursor 和 JetBrains IDE 内置的 terminal。
02开始之前
你需要：
- 电脑上已安装并能正常使用 Claude Code。
- 手机上安装 Claude Code Notifier App，可从 App Store 或 Google Play 下载。如果还没装 App 就先扫了二维码，手机会自动引导你去应用商店。
- 两台设备都能联网。
App 下载免费，使用需订阅或一次性买断，年度方案提供免费试用。详见价格。
03两种配对方式
有两种方式，结果完全一样，选方便的那种即可。
二维码链接和 6 位配对码的有效期都是 24 小时。
04方式一：扫描二维码
在 Mac 或 Linux 上
- 打开 terminal，安装
ccn：
curl -fsSL https://claudecodenotifier.com/install.sh | sh或者用 Homebrew：
brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn- 运行
ccn（或ccn pair）。它会按需安装 hook，并显示一个二维码和一个链接。 - 用手机相机对准二维码，打开链接。如果已经装了 app，它会直接打开并完成配对；如果还没装，手机会先跳转到 App Store 或 Google Play，装好 app 后配对会继续进行。
- terminal 中会提示手机已配对成功。
在 Windows 上
- 打开 PowerShell，安装
ccn（Windows 支持目前为 beta 版）：
irm https://claudecodenotifier.com/install.ps1 | iex- 运行
ccn pair，PowerShell 会显示一个二维码和一个链接。 - 和上面一样，用手机相机扫描即可。
- PowerShell 中会提示手机已配对成功。
通过 Node.js 或插件安装（适用于任意系统）
如果装了 Node.js，下面这条命令可以一次完成安装并开始配对：
npx @touchtap/ccn也可以在 Claude Code 里以插件形式安装，然后运行它的 setup 命令：
/plugin install ccn --marketplace touch-tap/ccn
/ccn:setup05方式二：输入 6 位配对码
这种方式从手机端发起，适合看不清电脑屏幕，或者 Claude Code 跑在需要通过 SSH 连接的服务器上的情况。
- 打开 Claude Code Notifier app，进入 Computers > Add a computer。
- app 会显示一个 6 位配对码，以及适用于你操作系统的完整命令。
- 在电脑上运行这条命令。如果已经装了
ccn，只需：
ccn pair 482913把 482913 换成你自己的配对码。
一条命令完成安装和配对
每条安装命令都可以带上配对码，所以新电脑只需要一条命令。
在 Mac 或 Linux 上：
curl -fsSL https://claudecodenotifier.com/install.sh | sh -s 482913在 Windows 的 PowerShell 中：
irm https://claudecodenotifier.com/install.ps1 | iex; ccn pair 482913如果用的是 Claude Code 插件，把配对码传给 setup 命令：/ccn:setup 482913。
06验证是否生效
用这两条命令确认一切就绪：
ccn doctor # checks hooks, credentials, server connection and presence detection
ccn test # sends a test notification to your phone然后实际试一下：启动 claude，给它一个小任务，然后离开键盘。任务完成时，手机就会收到 push。
注意，ccn 能感知你是否在电脑前。如果你在最近 30 秒内有输入，权限 prompt 和提问会照常显示在 terminal 里，手机最多只收到一条提醒。离开电脑，就能看到手机接管。
07配对多台设备
- 多台电脑，一部手机。在每台电脑上重复上述步骤即可。公司的 Mac、家里的 Linux 主机和 Windows 笔记本都可以推送到同一部手机。同时运行多个 Claude Code 会话介绍了如何区分它们。
- 多部手机，一台电脑。把每部手机都和这台电脑配对即可。
- 查看或移除手机。
ccn devices会列出已配对的手机，ccn devices revoke <name>可以移除其中一部。
08脚本和远程机器
ccn pair --no-wait 会打印二维码后立即返回，适合脚本和自动化部署。在通过 SSH 连接的服务器上，6 位配对码通常最简单，因为你可以在运行 Claude Code 的同一个 SSH 会话里直接输入。其余配置请参阅通过 SSH 接收远程服务器上 Claude Code 的通知。
09配对失败时
- 配对码被拒绝。配对码有效期为 24 小时。在 app 里重新生成一个，或者改用二维码方式。
- 二维码扫不出来。把 terminal 窗口调大一些，或者直接在手机上打开打印出来的链接。
- 安装后找不到
ccn。新开一个 terminal，让PATH生效。 - 已配对，但收不到 push。先运行
ccn doctor，再运行ccn test，并检查手机设置里是否允许该应用发送通知。
完整清单见 Claude Code 通知不工作？排查清单。
10暂时还不想配对？
没关系。安装 ccn 后桌面通知就能用。在配对手机之前，ccn 会偶尔提示你运行 ccn pair。如果不想再看到提示：
ccn config set pair_nudges off11常见问题
配对需要账号吗？
不需要。Claude Code Notifier 没有账号体系，配对时无需注册就能把电脑和手机关联起来。通知经由加密中继转发，并在 48 小时内删除。详见隐私政策。
配对码有效期多久？
应用里的 6 位数字码和 ccn pair 生成的二维码链接都是 24 小时有效，过期后重新生成即可。
没有屏幕的电脑能配对吗？
可以。用 6 位数字码的方式：在应用中打开“电脑 > 添加电脑”，然后在那台机器上（比如通过 SSH）带上该码运行 ccn pair。
配对会改动我的 Claude Code 设置吗？
安装 ccn 时会在 ~/.claude/settings.json 中添加七个 hook 条目，其他内容一概不动，并在同目录下保留一份一次性备份。配对本身只是关联手机。ccn uninstall 会移除这些 hook、配对和本地状态。
怎么解除手机配对？
运行 ccn devices 查看已配对的手机，再运行 ccn devices revoke <name>。ccn forget 还会把这台电脑从服务器上删除。