WhatsApp Channel for Claude Code

社区

通过 WhatsApp 直接驱动你的 Claude Code 会话

分类: 团队协作第 2 / 55
Stars: ★ 109 热门
传输方式: stdio（本地进程）
运行环境: Bun
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 6 天前
工具数: 10

64FMRS · C

这是一个由社区开发、经 Anthropic 审核并发布到官方插件市场的 WhatsApp channel 插件（仓库自述为第一个被 Anthropic 审核发布的社区 WhatsApp channel 插件），以关联设备方式连接个人 WhatsApp 账号，无需 API key、Docker 或 WhatsApp Business API。它在 Claude Code 中体验最完整：入站消息可作为 channel 通知唤醒会话；在其他 MCP 客户端中退化为轮询模式。适合愿意在终端完成配置、重视本地隐私的个人开发者；不适合需要官方托管、多实例或合规级企业通道的用户。使用时需注意一个账号只能有一个关联会话，以及审批命令刻意保留在终端以保证安全。

最强项 · 文档质量 16/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

12/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: 静态证据仅来自 README：描述了 stdio MCP 服务器、Bun 进程、工具清单（reply/react/edit_message/download_attachment/status/unreplied/catch_up/list_groups）以及大量故障排查项（440 断连、连接单例、通道通知被丢弃、客户端 bug #37933）。这些说明对失败模式有自我认知，且错误路径可诊断（diag.log、WHATSAPP_DIAG_DEBUG）；但仓库清单未被缓存，未提供任何提交的测试或 CI 工作流证据，无法核实工具行为与声明的匹配，也无法验证启动与 MCP 初始化握手。按静态校准上限 12，取 10：快乐路径可信、边界与错误处理描述较细但缺少可复现证据。
安全与权限 12/20: 安全设计有明显自觉：审批必须提供具体配对码（防止“批准待处理项”式提示注入）、access.ts 明确不作为 MCP 工具暴露、运行时状态（认证、允许列表、群配置、收件箱）存放于 ~/.whatsapp-channel 而非仓库、声称无需 API key 且无第三方中转服务器、Apache-2.0 与 SECURITY.md 披露渠道。扣分点：权限链依赖单一账号的 WhatsApp 关联设备，Claude 以用户本人号码发出消息，存在身份混淆与误发风险；README 明确要求 --dangerously-load-development-channels 这类危险标志；权限中继用 emoji 反应批准工具调用，属于对高风险操作的弱确认；无源码可核实凭据存储加密、日志是否含隐私内容、外发网络边界是否仅限 WhatsApp。未触及红线（无恶意、无凭据窃取、无隐蔽外传），故给 12 而非 0-4。
维护活跃度 12/20: 维护迹象：Apache-2.0 许可证明确、版权署名、CONTRIBUTING.md 与 SECURITY.md（私有披露）齐备、官方插件市场发布徽章与截图、87 stars、0 开放 issue、活跃的文档与故障排查更新。但缺少可核实的发布记录、版本号策略、依赖更新流程；open issues 为 0 无法判断响应能力；未缓存清单与源码，无法确认提交频率。证据不足以支撑高分，取 12。
文档质量 16/20: 文档质量是本项最强项：分层的安装步骤（插件市场安装 + 配对码流程）、其他 MCP 客户端（Codex/Gemini/Cursor）的完整配置示例、绝对路径与超时参数说明、访问控制的终端替代命令、语音转录的一次性安装、针对具体症状的故障排查表（含日志文件与调试环境变量）、单连接限制的明确披露、指向 USAGE.md 的扩展文档。扣分：部分关键行为（通道通知、只允许一个客户端、setup 需终端）以“已知限制”形式散落在正文而非集中列表；未披露成本与隐私数据流细节；USAGE.md 内容未被提供，无法核实其与 README 是否一致。取 16。
安装易用性 14/20: 安装路径相对清晰：三条命令即可安装插件，配对为二维码/配号码码流程，无需 Meta 开发者账号或 API key；同时为 Codex CLI、Gemini CLI、Cursor 提供了 stdio 配置片段及超时建议（startup_timeout_sec 30、tool_timeout_sec 120）。平台兼容性有明确边界：必须使用 Bun，语音转录仅限 Apple Silicon（mlx-whisper）。摩擦点较多：必须使用 --dangerously-load-development-channels 危险标志且 --channels 尚不支持；非 Claude Code 客户端需手动绝对路径且无推送，只能轮询；setup 只能从终端完成。按静态校准上限 15，取 14。

静态评测 · 未实际运行收录于 2026-09-10

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

希望用个人 WhatsApp 号码与 Claude 交互的个人用户
愿意在终端完成配置、能接受 Claude Code 开发标志的开发者
需要在手机端远程审批工具调用的自动化场景

不适合谁

需要官方 WhatsApp Business API 或 Meta 开发者账号的合规场景
需要官方托管、多租户或云端多实例部署的团队
无法保证同一时间只运行一个客户端实例的环境
不愿自行搭建 mlx-whisper 却期望语音转写的用户

所需权限

读取与发送 WhatsApp 消息（以你个人号码身份）
访问本机运行时状态目录 ~/.whatsapp-channel/（认证、允许列表、群组配置、收件箱）
读写仓库内的本地文件与运行脚本（如 bun scripts/access.ts、scripts/watchdog.sh）
可选的本地语音转写（ffmpeg 与 mlx-whisper 环境）

风险与副作用

Claude 发送的消息会以你自己的号码出现，收件人无法区分
同一个 WhatsApp 账号只允许一个关联设备会话，同时运行两个服务器会互相踢下线
访问控制命令刻意不暴露为 MCP 工具（仅终端执行），若误开放给消息侧可能被提示注入利用
入站消息的唤醒依赖 Claude Code 的 channel 扩展，其他客户端不会收到推送
已知的 Claude Code 客户端缺陷（#37933）可能导致消息不到达，属于客户端侧问题
使用 --dangerously-load-development-channels 标志启动存在风险，需自行确认来源可信

安装接入

准备工作

运行环境：Bun

其他可选配置项（1 个）

WHATSAPP_DIAG_DEBUG 可选设为 1 可输出 Baileys 的完整调试日志，用于排查消息收发问题；非必需。

方式一（Claude Code 插件）：依次执行 claude plugin marketplace add Rich627/whatsapp-claude-plugin、claude plugin install whatsapp-channel@whatsapp-claude-plugin，再以 claude --dangerously-load-development-channels plugin:whatsapp-channel@whatsapp-claude-plugin 启动（该标志会把插件注册为 channel，未加时工具仍可加载，但新消息不会唤醒会话）。会话内执行 /whatsapp-channel:configure <phone>（国家码+号码，不带 +），首次启动会打印配对码；手机端进入 WhatsApp → 设置 → 已关联的设备 → 关联设备 → 改用电话号码关联 → 输入配对码。方式二（其他 MCP 客户端）：用绝对路径注册 stdio 服务器，例如 Codex CLI 的 ~/.codex/config.toml、Gemini CLI 的 ~/.gemini/settings.json 或 Cursor 的 mcp.json，命令为 bun run --cwd /absolute/path/to/whatsapp-channel start，并将超时调大（如 startup_timeout_sec 30、tool_timeout_sec 120）。

.mcp.json

{
  "mcpServers": {
    "whatsapp": {
      "type": "stdio",
      "command": "bun",
      "args": ["run", "--cwd", "/absolute/path/to/whatsapp-channel", "start"]
    }
  }
}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "whatsapp": {
      "type": "stdio",
      "command": "bun",
      "args": [
        "run",
        "--cwd",
        "/absolute/path/to/whatsapp-channel",
        "start"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add whatsapp -- bun run --cwd /absolute/path/to/whatsapp-channel start

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动后运行 status 工具，应返回设备链接和连接信息；首次配对时终端会显示配对码，在手机 WhatsApp 的已链接设备中输入即可。

常见排障

配对码没有显示：先执行 /whatsapp-channel:configure <phone> 再重新启动
出现 440 断开错误：同一认证状态只允许一个连接，用 pkill -f "whatsapp.*server" 清理残留进程
新消息不唤醒会话：多半是启动时漏了 --dangerously-load-development-channels plugin:whatsapp-channel@whatsapp-claude-plugin，检查 MCP 调试日志中的 Channel notifications skipped
消息不到达：可能与 Claude Code 客户端缺陷 #37933 有关，服务端正常
回复能发出但收不到：先发一条私聊再发群消息；查看 ~/.whatsapp-channel/diag.log 中的 inbound upsert 行，并设 WHATSAPP_DIAG_DEBUG=1 获取 Baileys 完整调试输出
认证过期：执行 /whatsapp-channel:configure reset-auth 后重新配对
其他客户端没有推送：改用 wait_for_messages、catch_up 或 unreplied 轮询

试试这样问

连接成功后，可以直接对 AI 助手这样说：

检查一下 WhatsApp 连接状态
有没有没回复的消息？帮我看看
给这个号码回复一条消息
列出我所在的 WhatsApp 群组

工具能力 10

reply 写入

向聊天发送消息，可分块并支持 @ 提及。

react 写入

对消息添加表情回应（也用于权限批准/拒绝）。

edit_message 写入

编辑已发送的消息。

download_attachment 只读

下载收到的媒体附件。

status 只读

查看服务器与连接状态。

unreplied 只读

列出尚未回复的消息数量与内容。

catch_up 只读

重启后重放各聊天的近期双向对话、未回复计数与未完成任务。

list_groups 只读

列出可用的群组。

展开其余 2 个工具

wait_for_messages 只读

轮询等待下一条消息，最长约 40 秒。

whatsapp_unavailable 只读

当连接被另一个进程占用时返回的唯一工具，并指明占用的进程。

使用场景

从 WhatsApp 用自然语言驱动 Claude Code 会话

把语音消息自动转写为文本后交给 Claude 处理

在手机上用表情回应批准或拒绝 Claude 的工具调用

为不同群组配置各自的性格与对话记忆

在群组 config.md 中安排周期性定时任务

用配对码与允许列表严格控制谁能联系到会话

支持客户端

Claude Code

Codex部分支持

Gemini CLI部分支持

Cursor部分支持

依据项目文档列出，未经本站实测。

详细介绍

WhatsApp Channel for Claude Code 是一个以「关联设备」（与 WhatsApp Web 相同协议，基于 Baileys）方式连接 WhatsApp 的 MCP 服务器，将 WhatsApp 作为 Claude Code 的 channel 暴露出来。收到的消息会实时进入会话，Claude 用你自己的号码回复，收件人看到的是一段正常聊天。全部在本机运行，消息在 WhatsApp 与你自己的会话之间直接传递，中间没有第三方服务器。配对后即使手机关机也能继续工作，只需保持 Claude Code 会话开启，重新连接无需再次配对。它是一个普通的 stdio MCP 服务器，任何 MCP 客户端都可以运行；但入站消息推送依赖 Claude Code 的 notifications/claude/channel 扩展，其他客户端只能轮询。