出去吃饭、下班回家，但公司电脑上的数据分析任务还在跑，你担心它出错或者跑完没人管？现在有了一个全新的解决方案：通过邮件远程控制本地的 Claude Code，让邮件成为你和 AI 之间的信使。你可以在办公室启动任务，然后潇洒离开，回家后通过手机邮件接收结果，甚至直接回复邮件下达新指令——代码自动在远方机器上执行，全程无需魔法、无需网络穿透。
本文带你一步步搭建这个邮件遥控系统，从原理到实战，有手就行。
什么是远程 Claude Code 遥控器？
这是由开发者 JessyTsui 开源的一款工具，它通过监听和发送邮件，让你能够远程控制本地运行的 Claude Code。核心功能包括：
- 任务完成后自动发送邮件通知到你的手机
- 支持直接回复邮件，将新指令传递给 Claude Code 自动执行
- 基于发件人白名单机制，确保只有你授权的邮箱才能控制
- 不需要公网 IP、内网穿透等复杂网络配置
工作流程：一封邮件引发的代码自动执行
整个工作流非常直观：
- 在公司电脑的命令行中启动 Claude Code，开始执行任务（如数据分析、代码重构）。
- 任务完成（或等待子任务）时，系统自动触发脚本，向你的邮箱发送一封通知邮件。
- 你打开手机邮箱，看到结果摘要，思考后直接回复邮件，例如：“干得不错，现在请把代码打包成 Docker 镜像。”
- 远在公司的 Claude 接收到你的回复指令，立即开始执行新任务。
- 整个过程循环往复，你只需要一个邮箱，就能拥有远程开发基地。
安全机制：不是谁都能控制你的 Claude
系统基于 发件人白名单 进行验证。你需要在配置中指定允许发送指令的邮箱地址，只有这些邮箱发来的邮件才会被 Cluade Code 执行。其他任何发件人的邮件都会被忽略，确保你的代码环境安全可控。
三步配置指南
以下配置在公司的电脑上完成，一次配置，长期使用。
第一步：下载与安装
打开终端，执行以下命令克隆项目并安装依赖：
git clone https://github.com/JessyTsui/Claude-Code-Remote.git cd Claude-Code-Remote npm install
提示： 确保你的电脑已安装 Node.js（版本 16+）和 Git。如果 npm install 速度慢，可以换用国内镜像源（如淘宝镜像）后重试。
第二步：配置邮箱信息
在项目根目录下创建一个 .env 文件，填入你的邮箱账号信息。关键配置项包括：
- 邮箱账号：用于发送通知和接收指令的邮箱地址
- 邮箱密码：注意：如果使用 Gmail，必须使用“应用密码（App Passwords）”，而不是你的登录密码
- 接收通知邮箱：你想收到通知的邮箱（可以是同一个）
- 允许发件人白名单：只有这些邮箱地址发来的指令才会被执行，建议填写你常用的手机邮箱
小提示： 如何获取 Gmail 应用密码？进入 Google 账号 -> 安全 -> 两步验证 -> 应用密码，生成一个专用密码用于此工具。其他邮箱（如 QQ、163）通常使用授权码或 SMTP 密码，请参考各自说明。
第三步：配置 Claude Code 钩子
这一步是关键，让 Claude Code 在任务完成或等待子任务时自动触发邮件通知。
编辑 Claude Code 的配置文件 ~/.claude/settings.json，添加以下 hooks 配置：
{
"hooks": {
"Stop": "cd /path/to/Claude-Code-Remote && npm run notify",
"SubAgentStop": "cd /path/to/Claude-Code-Remote && npm run notify"
}
}
请将 /path/to/Claude-Code-Remote 替换为你实际克隆项目的路径。当 Claude Code 任务停止（Stop）或等待子任务（SubAgentStop）时，会自动执行通知脚本，向你的邮箱发送邮件。
注意： 如果你不清楚 Claude Code 的配置文件位置，通常是在 ~/.claude/settings.json，如果不存在，可以手动创建。确保 JSON 格式正确。
启动与使用
配置完成后，需要同时运行两个部分：
- 邮件监控服务：在终端中执行
npm run relay:pty，它会持续监听邮箱，接收你发来的指令并进行转发。 - Claude Code 主程序：建议在另一个终端（如
tmux会话）中启动claude命令，开始你的任务。
整体启动命令如下：
# 启动邮件监控服务（在第一个终端） npm run relay:pty # 在另一个终端（例如 tmux）中启动 Claude Code claude
提示： 使用 tmux 或 screen 可以让你关闭终端连接后，Claude Code 和邮件监控服务仍然在后台运行，非常适合长时间任务。
任务完成后，你的手机邮箱会收到通知。回复邮件即可下达新指令，Claude Code 会自动接收并执行。
进阶玩法：TG Bot 实时监控
如果你觉得邮件通知不够实时，还可以参照项目中的邮件内容格式，自己搭建一个 Telegram Bot。TG Bot 支持流式输出，你可以实时看到 Claude Code 的执行过程，就像在聊天界面中直接对话编程一样。具体实现方式可参考项目文档或社区教程。
提示： 邮件通知适合非实时场景，TG Bot 适合需要实时观察每一步输出的场景。两者可以同时使用，互为补充。
常见问题与解答
Q1：为什么使用 Gmail 时必须用“应用密码”，不能用普通密码？
Gmail 为了安全，对第三方应用（如本工具）的登录做了限制。普通密码只能用于网页登录，而应用密码是专门为这类程序生成的“一次性授权密码”，具有更高的安全性。同理，其他邮箱（如 QQ、163）也建议使用授权码而非真实密码。
Q2：如何确保只有我能控制 Claude Code？
系统通过白名单机制验证发件人。请在 .env 文件中正确设置 ALLOWED_SENDERS 字段，填写你允许的邮箱地址（多个可以用逗号分隔）。只有这些邮箱发来的邮件才会被处理，其他邮件会被忽略。同时，建议不要将邮箱密码泄露给他人。
Q3：邮件通知收不到，怎么办？
- 检查
.env中的邮箱账号和密码是否正确（Gmail 应用密码注意不要有空格）。 - 确认邮箱的 SMTP 服务是否已开启（例如 Gmail 需要在设置中允许“不够安全的应用”或使用应用密码）。
- 检查防火墙或网络是否拦截了 SMTP 端口（默认 587 或 465）。
- 在项目目录下运行
npm run test-mail（如果存在该命令）测试邮件发送功能。
Q4：Claude Code 任务执行完了，但没收到邮件？
请检查 hooks 配置是否正确。确保 ~/.claude/settings.json 中的路径是绝对路径，并且项目目录下存在 npm run notify 脚本（本项目已内置）。另外，Claude Code 的 Stop 事件只在任务正常结束时触发，如果任务被强制中断（如 Ctrl+C），可能不会触发邮件。
Q5：能否在手机上直接查看任务结果？
邮件通知中会包含 Claude Code 输出的摘要信息（具体内容取决于你在钩子脚本中如何配置）。如果需要查看完整日志，建议将日志输出到文件，并在邮件中附上文件路径。或者使用 TG Bot 实时查看完整输出。
总结
通过邮件远程控制 Claude Code，让你摆脱了必须守在电脑前的束缚。无论是几小时的数据分析、代码重构，还是多轮迭代任务，你都能在手机上轻松完成管理和指令下达。本工具开源且配置简单，安全机制也考虑周全，适合所有希望提升开发效率的 Claude Code 用户。如果你还想把 Claude Code 的 20 美元订阅用出 200 美元的效果，不妨试试这套远程控制方案，再结合 Claude Code Sub Agents 的灵活运用，让你的 AI 开发助手真正变成一个 7×24 小时在线的远程团队。
现在就动手配置吧，让你公司的电脑成为你的私人云开发中心！