weixin-claude-code
微信 Channel 插件 for Claude Code —— 通过微信与 Claude Code 双向通信。
功能
- 在微信中给 Claude Code 发消息，Claude 直接在终端中处理并回复到微信
- 支持文本、图片、语音、视频、文件等全媒体类型
- 微信扫码登录，零配置即用
- Claude 回复自动转为纯文本（微信不支持 Markdown）
- 权限转发：Claude Code 的工具调用审批（如 Bash、Write、Edit）会转发到微信，直接回复 yes/no 即可远程授权，无需守在终端前
前置要求
- Claude Code v2.1.80+
- Bun 运行时
- claude.ai 账号登录（不支持 API Key 认证）
安装
# 1. 添加插件源
/plugin marketplace add Dcatfly/claude-plugins
# 2. 安装插件
/plugin install weixin-claude-code@dcatfly-plugins使用
启动
claude --dangerously-load-development-channels plugin:weixin-claude-code@dcatfly-plugins自定义 Channel 目前处于研究预览阶段，需要使用 --dangerously-load-development-channels 标志启动。首次登录
启动后 Claude 会提示你调用 login 工具，扫描二维码完成微信连接：
- Claude 调用 login 工具，展示二维码（如被折叠按
ctrl+o展开） - 用微信扫描二维码
- 在微信中确认登录
- 连接成功，开始收发消息
收发消息
连接成功后，你在微信中发送的消息会实时推送到 Claude Code 会话中。Claude 处理后通过 reply 工具将回复发回微信。
发送文本：直接在微信中输入文字
发送媒体：支持发送图片、语音、视频、文件，Claude 会下载并处理
接收回复：Claude 的回复会自动转为纯文本发送到微信
可用工具
| 工具 | 说明 |
|---|---|
login | 发起微信扫码登录 |
reply | 回复微信消息（支持文本和媒体） |
status | 查询当前连接状态 |
logout | 登出微信并清除凭证 |
登出
在 Claude Code 中调用 logout 工具即可断开微信连接并清除本地凭证。
工作原理
微信用户 微信服务器 iLink Bot API [本插件 MCP Server] Claude Code插件作为 MCP Channel 服务器运行。微信通信由 weixin-bot-plugin 库处理（iLink Bot API long-poll 收消息、CDN 媒体加解密、SILK 语音转码等），本插件将收到的消息以 Channel notification 推送到 Claude Code 会话中。Claude 通过 reply 工具将回复发回微信。
局限性
- 仅接受登录者自己的消息 —— 其他人发的消息和群消息会被过滤，这是安全设计
- 不支持 Claude Code 原生命令 —— 微信消息是作为对话内容处理的，无法触发
/clear、/compact等 CLI 命令 - Session 过期需手动重新登录 —— 微信 session 过期后需要重新调用
login扫码 - Channel 功能处于研究预览阶段 —— 需要
--dangerously-load-development-channels标志 - 需要 claude.ai 登录 —— 不支持 Console 或 API Key 认证
- 非 Channel 模式下插件仍然会启动 —— MCP 协议目前无法让插件检测自身是否运行在 channel 模式（claude-code#36964）。若以普通 MCP 模式加载，插件仍会消费微信消息但 notification 会被静默丢弃，导致后续 channel 模式会话丢失这些消息。建议仅在需要时启用此插件
数据存储
凭证和同步数据存储在 ~/.claude/channels/wechat/ 目录下：
~/.claude/channels/wechat/
├── accounts.json # 账号列表
├── accounts/.json # 登录凭证（仅所有者可读）
└── sync/.sync.json # 消息同步断点登出时所有数据会被自动清除。
收发的媒体文件（图片、语音、视频、文件）缓存在系统临时目录下：
$TMPDIR/weixin-claude-code/media/
├── inbound/ # 接收的媒体
└── outbound/ # 发送的媒体许可证
MIT