weixin

---

✨ 功能亮点

功能	说明
🔐 扫码登录	使用微信官方 iLink API，扫一下二维码即完成授权，无需抓包或第三方框架
⚡ 零中间层	MCP Server 直连微信 iLink 后端，消息延迟极低
🛡️ 访问控制	内置 Pairing（配对码）/ Allowlist 双模式，防止陌生人滥用
📨 长轮询	后台持续轮询，消息实时送达 Claude Code
🔄 自动分段	超 2000 字的回复自动拆分发送，微信不截断
📜 消息历史	内存维护最近 50 条对话记录，支持 fetch_messages 回溯
🎯 MCP Channel 协议	原生对接 Claude Code --channels 标志，与 Discord 插件同等地位

---

架构原理

┌──────────────┐     微信私信      ┌─────────────────────────┐
│   微信用户    │ ──────────────▶  │  WeChat iLink API        │
│  (手机端)    │                  │  ilinkai.weixin.qq.com   │
└──────────────┘                  └────────────┬────────────┘
                                               │ 长轮询 (ilink/bot/getupdates)
                                               ▼
                                  ┌─────────────────────────┐
                                  │   server.ts (Bun)        │
                                  │   MCP Channel Server     │
                                  │                         │
                                  │  • 访问控制              │
                                  │  • context_token 缓存   │
                                  │  • 消息历史              │
                                  └────────────┬────────────┘
                                               │ notifications/claude/channel
                                               ▼
                                  ┌─────────────────────────┐
                                  │     Claude Code          │
                                  │   (claude --channels)    │
                                  └─────────────────────────┘

数据流：

1. 微信用户发送私信 → iLink 后端持有
2. server.ts 长轮询 ilink/bot/getupdates，拿到新消息
3. 检查发送者是否在 allowlist → 通过则发 notifications/claude/channel 给 Claude
4. Claude 调用 reply 工具 → server.ts POST ilink/bot/sendmessage → 微信用户收到回复

---

快速开始

前提条件

• Bun ≥ 1.0
• Claude Code v2.1.80+ 已安装
• 一个微信账号（用于扫码授权）

方式一：从 GitHub 安装（推荐）

claude plugin marketplace add weicyruc/claude-weixin-channel
claude plugin install weixin@weicyruc-plugins

方式二：从本地克隆安装

git clone https://github.com/weicyruc/claude-weixin-channel.git
cd claude-weixin-channel
./install.sh

安装脚本会自动完成：

• 安装 npm 依赖（bun install）
• 通过 claude plugin CLI 注册插件，使 /weixin:configure 等技能生效

2. 重启 Claude Code

必须完整退出并重启才能加载插件和技能。

3. 扫码登录微信

启动 Claude Code，运行登录技能：

/weixin:configure

终端会出现 ASCII 二维码，用微信扫码并在手机上确认授权。登录凭证自动保存到 ~/.claude/channels/weixin/account.json。

4. 启动频道

注意：非官方插件需要加 --dangerously-load-development-channels 标志，这是 Claude Code channels 研究预览期的要求。必须在启动时带上这个标志，否则微信消息不会转发给 Claude。

claude --dangerously-load-development-channels plugin:weixin@weicyruc-plugins

5. 配对第一个用户

默认策略为 pairing（配对）模式：

1. 微信好友向你的账号发送任意消息
2. 对方收到配对码，例如：配对请求 — 请在 Claude Code 中运行：\n/weixin:access pair a1b2c3
3. 在步骤 4 启动的 Claude Code 会话中运行：

/weixin:access pair a1b2c3

4. 对方的后续消息将直接转发给 Claude ✅

---

配置参考

目录结构

~/.claude/channels/weixin/
├── account.json       # 登录凭证（bot_token, base_url, account_id）
└── access.json        # 访问控制（allowFrom, policy, pending）

account.json

登录成功后自动写入，无需手动编辑：

{
  "bot_token": "eyJ...",
  "base_url": "https://ilinkai.weixin.qq.com",
  "account_id": "[email protected]"
}

access.json

{
  "policy": "pairing",
  "allowFrom": ["[email protected]"],
  "pending": {}
}

字段	说明
policy	pairing：未知用户收到配对码；allowlist：未知用户静默丢弃
allowFrom	已授权的微信用户 ID 列表
pending	等待确认的配对码（5 分钟过期）

---

MCP 工具参考

Claude Code 启动后可调用以下工具：