🤖 Claude Code × WeChat

将 Claude AI 接入微信私信 — 官方 iLink API · 零中间层 · 开箱即用

让你的微信私信直接对话 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 → 微信用户收到回复

快速开始

前提条件

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（配对）模式：

微信好友向你的账号发送任意消息
对方收到配对码，例如：配对请求 — 请在 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": "[email protected]"
}

access.json

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

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

MCP 工具参考

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

weixin

Popularity

What's Inside

README