Claude Mail Bridge

克劳德邮件桥

一个远程控制工具，即使您不在终端上，也能让您与Claude Code保持联系。

运作原理

┌─────────────────┐         Email         ┌─────────────────┐
│                 │ ◄───────────────────► │                 │
│   Claude Code   │                       │   Your Email    │
│   (tmux)        │                       │   (phone/PC)    │
│                 │                       │                 │
└─────────────────┘                       └─────────────────┘
        │
        ├── Daemon listens for email replies
        ├── Hooks detect session state changes
        └── MCP provides presence & email capabilities

Claude Code的电子邮件远程控制——批准权限、塑造AI行为和协调团队，所有这些都不需要接触终端。

主要特点

1.基于电子邮件的远程控制

随时随地通过电子邮件与终端中运行的Claude Code进行通信。包括会话上下文（项目、分支、工作目录、开始时间），并支持高达15MB的文件附件。

2.远程权限审批

远程批准Claude Code的权限请求而不进行阻止。该系统会自动捕获权限提示，将多个请求批处理在一起，并将其与终端上下文一起通过电子邮件发送，以便做出明智的决定。

3.完成AI行为调整

一个三层系统（MCP+技能+钩子），塑造了克劳德的行为方式：

• MCP工具 提供能力（在场、电子邮件、团队管理）
• 技能 定义行为规则（何时使用电子邮件、隐私协议）
• 钩子 触发自动响应（权限捕获、会话事件）

4.团队协作

通过让Claude Code与团队成员协调来提高团队沟通效率。让Claude总结项目进度、通知团队或委派任务——所有这些都有明确的隐私控制。

为什么选择CMB？

CMB专为实时解决方案可能不理想的特定场景而设计：

CMB可以在任何可以访问电子邮件的地方工作——在飞机上、地铁里，或者只是没有稳定的互联网连接。

安装

1.安装软件包

pip install claude-mail-bridge

从GitHub手动安装

如果您更喜欢从源代码安装：

# Clone the repository
git clone https://github.com/CodingJay-1/claude-mail-bridge.git
cd claude-mail-bridge

# Build the package
pip install build
python -m build

# Install the built wheel
pip install dist/claude_mail_bridge-*.whl

2.设置环境变量

SMTP密码是通过安全环境变量配置的：

# Add to ~/.bashrc or ~/.zshrc
export CMB_SMTP_PASSWORD='your_smtp_password'

获取SMTP密码: - QQ邮箱：设置→ 账户→ POP3/SMTP服务→ 生成授权码 - Gmail：帐户→ 安全→ 2-步骤验证→ 应用密码

3.运行安装向导

claude-mail-bridge setup

按照提示输入：

• 系统电子邮件：用于发送/接收消息的电子邮件（例如。， your_bot@qq.com)
• 电子邮件提供商：QQ邮箱/Gmail/自定义
• SMTP密码：已通过环境变量设置
• 收件人电子邮件：您的个人电子邮件，用于接收克劳德的消息
• 您的别名：显示名称（可选）
• 机器名称：此机器的标识符（显示在电子邮件主题中）

配置将保存到 ~/.claude-mail-bridge/config.json

4.安装Claude代码插件

claude-mail-bridge install-claude-plugin

这将安装：

• 钩子：会话启动/停止，权限请求挂钩
• MCP服务器：在场管理、电子邮件沟通、团队管理
• 技能：克劳德的行为准则

5.启动守护进程

claude-mail-bridge start

用法

基本命令

# Start daemon
claude-mail-bridge start

# Stop daemon
claude-mail-bridge stop

# Show status
claude-mail-bridge status

# Set presence status
claude-mail-bridge presence set online   # At terminal
claude-mail-bridge presence set away     # Away from terminal

# Get current presence
claude-mail-bridge presence get

# Test email functionality
claude-mail-bridge test-email

# Uninstall plugin
claude-mail-bridge uninstall

如何触发远程控制

Claude Code会自动加载已安装的MCP服务和技能。自然地表达自己：

告诉克劳德你要走了 （触发状态切换为离开）：

"I'm leaving" / "我要走了"
"I'm going" / "我先走了"

告诉克劳德你回来了 （触发状态切换到在线）：

"I'm back" / "我回来了"
"I'm at the terminal" / "我在电脑前了"

直接请求电子邮件通信:

"Email me the results"
"Contact me via email" / "邮件联系"

当您的状态为 away，克劳德将自动：

• 通过电子邮件报告进度
• 通过电子邮件询问重要决定
• 等待您的电子邮件回复以继续执行

在场状态行为

团队成员管理

# Add team member
claude-mail-bridge teammates add teammate@example.com --alias "John"

# List team members
claude-mail-bridge teammates list

# Remove team member
claude-mail-bridge teammates remove teammate@example.com

让克劳德的电子邮件团队成员:

"Email John and tell him..."
"Notify the team..."
"Summarize progress and send to Sarah..."

MCP工具参考

Claude Code可以使用以下MCP工具：

存在系统

电子邮件系统

团队体系

技能参考

Claude Code会根据上下文自动调用这些技能：

工作流示例

1. 告诉克劳德你要走了:

   You: "I'm leaving, monitor the test results and email me if there are issues"

1. 克劳德检测到离开状态，通过电子邮件自动报告

1. 您通过电子邮件回复:

   Continue

或

   Skip this test

1. 克劳德收到你的回复，继续执行任务

配置文件

配置保存在 ~/.claude-mail-bridge/config.json:

{
  "cmb_email": {
    "smtp_host": "smtp.qq.com",
    "smtp_port": 465,
    "imap_host": "imap.qq.com",
    "imap_port": 993,
    "user": "your_bot@qq.com"
  },
  "receiver_email": "your_personal@gmail.com",
  "receiver_alias": "Your Name",
  "machine_name": "workstation",
  "teammates_mail_list": [
    {"email": "teammate@example.com", "alias": "John"}
  ]
}

备注：SMTP密码是通过配置的 CMB_SMTP_PASSWORD 环境变量，未存储在配置文件中。

日志

日志文件位置： ~/.claude-mail-bridge/logs/daemon.log

测试平台

电子邮件提供商

操作系统

欢迎投稿！如果您在其他平台上测试过CMB，请分享您的经验。

故障排除

没有收到电子邮件？

1. 检查守护进程是否正在运行： claude-mail-bridge status
2. 检查日志： tail -f ~/.claude-mail-bridge/logs/daemon.log
3. 测试电子邮件功能： claude-mail-bridge test-email

克劳德没有触发遥控器？

确保插件已安装：

claude-mail-bridge install-claude-plugin

检查MCP服务是否已注册：

claude mcp list

你应该看看 presence_system, email_system, team_system.

发展

# Clone repository
git clone https://github.com/your-repo/claude-mail-bridge.git
cd claude-mail-bridge

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

许可证

MIT许可证