🤖 Claude Code × WeChat
将 Claude AI 接入微信私信 — 官方 iLink API · 零中间层 · 开箱即用
English · 快速开始 · 架构原理 · 配置参考 · 踩坑指南
让你的微信私信直接对话 Claude Code，扫码登录，5 分钟上线。
✨ 功能亮点
| 功能 | 说明 |
|---|
| 🔐 扫码登录 | 使用微信官方 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) │
└─────────────────────────┘
数据流：
- 微信用户发送私信 → iLink 后端持有
server.ts 长轮询 ilink/bot/getupdates，拿到新消息- 检查发送者是否在 allowlist → 通过则发
notifications/claude/channel 给 Claude
- Claude 调用
reply 工具 → server.ts POST ilink/bot/sendmessage → 微信用户收到回复
快速开始
前提条件
方式一：从 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（配对）模式：
- 微信好友向你的账号发送任意消息
- 对方收到配对码，例如：
配对请求 — 请在 Claude Code 中运行：\n/weixin:access pair a1b2c3
- 在步骤 4 启动的 Claude Code 会话中运行：
/weixin:access pair a1b2c3
- 对方的后续消息将直接转发给 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": "xxxxxxxx@im.bot"
}
access.json
{
"policy": "pairing",
"allowFrom": ["user123@im.wechat"],
"pending": {}
}
| 字段 | 说明 |
|---|
policy | pairing：未知用户收到配对码；allowlist：未知用户静默丢弃 |
allowFrom | 已授权的微信用户 ID 列表 |
pending | 等待确认的配对码（5 分钟过期） |
MCP 工具参考
Claude Code 启动后可调用以下工具：