
直到我发现了JessyTsui开发的Claude Code Remote项目,这个"邮件任务管理器"彻底解决了我的痛点。通过收发邮件远程控制本地Claude Code,可以在任务完成时接收通知,并通过简单回复邮件发送新命令,真正意义上的重新定义远程开发新体验!
核心原理
Claude Code Remote的工作原理:通过邮件收发进行Claude Code任务管理。你可以在办公室启动Claude Code执行任务,然后回家等通知。当任务完成时,你的邮箱会立即收到通知邮件。

更令人惊喜的是,它支持连续对话。只需直接回复邮件,写下新的指令如"继续重构下一个模块"或"把结果生成图表",这些命令就会在公司电脑上自动执行。

人在家中坐,码从邮件来,这种工作方式不需要任何网络穿透技术,只要有邮箱的地方,就有你的远程开发基地。
安全性保障
安全性是远程控制的核心关切。Claude Code Remote通过多重机制确保安全:
-
发件人白名单验证:只有你授权的邮箱地址才能发送指令
-
Token验证机制:每个会话拥有唯一Token,防止误操作
-
会话过期保护:Token具有24小时有效期,自动失效
-
命令过滤系统:自动过滤潜在危险命令
这意味着不是任何人的邮件都能控制你的Claude Code,系统会严格验证发件人身份。
部署流程
步骤1:下载和安装
git clone https://github.com/JessyTsui/Claude-Code-Remote.git
cd Claude-Code-Remote
npm install
步骤2:启动邮件监听服务
cd /Users/jessytsui/dev/TaskPing
npm run relay:pty
这会启动邮件监听服务,监听 noreply@example.com
收到的回复邮件。
步骤3:启动Claude Code并集成TaskPing
# 启动Claude Code
claude
# 在Claude Code中使用TaskPing发送邮件通知
# 例如:当任务完成时会自动发送邮件
步骤4:配置Claude Code钩子
# 查看当前钩子配置
cat ~/.config/claude-code/settings/hooks.json
# 如果没有配置,需要设置TaskPing钩子
# 复制TaskPing的钩子配置文件
环境配置详解
.env 配置文件
# 发件配置(飞书邮箱)
SMTP_HOST=smtp.feishu.cn
SMTP_USER=noreply@example.com
SMTP_PASS=kKgS3tNReRTL3RQC
# 收件配置(飞书邮箱)
IMAP_HOST=imap.feishu.cn
IMAP_USER=noreply@example.com
IMAP_PASS=kKgS3tNReRTL3RQC
# 用户通知邮箱
EMAIL_TO=user@example.com
# 安全白名单(允许发送命令的邮箱)
ALLOWED_SENDERS=user@example.com
邮件回复测试
方法1:手动测试
# 在TaskPing目录中运行
node test-smtp-token.js
这会发送测试邮件到 user@example.com
,邮件主题包含Token格式:[TaskPing #XXXXXXXX] Claude Code 任务完成 - TaskPing-Token-Test
方法2:实际集成测试
-
在Claude Code中执行任务
-
任务完成后,TaskPing自动发送邮件通知
-
邮件发送到配置的邮箱地址
邮件客户端支持
用户可以从任意邮箱回复到 noreply@example.com
:
✅ Gmail 网页版/客户端 ✅ 手机Gmail APP ✅ Apple Mail ✅ Outlook ✅ QQ邮箱 ✅ 163邮箱 ✅ 任何支持SMTP的邮箱
这种全平台兼容性确保了无论你使用什么设备或邮件服务,都能无缝控制Claude Code。
实战应用场景
场景1:长时间构建任务
想象这样的工作流:
-
在Claude Code中启动项目构建
-
离开电脑,在手机收到构建完成邮件
-
手机直接回复:"继续部署到生产环境"
-
回到电脑时部署已完成
场景2:代码审查与优化
-
Claude Code完成代码生成
-
收到邮件通知查看结果
-
回复:"请添加单元测试和文档"
-
Claude自动生成测试和文档
场景3:数据分析任务
在我的实际使用中,最常见的场景是运行耗时的数据分析任务。启动分析后,我可以去开会或处理其他工作。当分析完成时,手机会收到通知,我可以立即查看结果并决定下一步操作——无论是生成可视化图表、导出报告,还是进行深度分析。
扩展可能性
基于邮件的远程控制原理,还可以参照制作Telegram Bot实现实时执行过程监控。这为开发者提供了更多自定义远程控制方案的可能性。
总结
Claude Code Remote项目让我重新思考了远程开发的可能性。通过将邮件这个最普遍的通信工具与AI编程助手结合,它创造了一种既简单又强大的远程控制方案。
不需要复杂的网络配置,不需要专门的客户端,只需要一个邮箱——这种极简的设计理念正是其最大的优势。对于像我这样经常需要处理长时间任务的开发者来说,它不仅提高了工作效率,更重要的是给了我们更大的工作灵活性。