1. 项目定位与用途
claude-channel-weixin 是 Claude Code 的官方渠道插件之一，专注于微信平台集成。其核心用途是在终端环境中为 Claude Code 提供微信消息收发能力，用户无需切换应用即可在 AI 编程会话中处理微信沟通。插件作为本地 MCP 服务器运行，通过微信 iLink Bot API 实现双向通信，适用于需要将微信消息融入开发工作流的场景。
项目档案插件 / 扩展
Claude Code 微信通道插件安装使用指南：终端收发微信消息的 MCP 集成
本文介绍 claude-channel-weixin，一个 Claude Code 微信通道插件。了解其如何通过本地 MCP 服务器和微信 iLink Bot API 实现终端微信消息收发，包括安装步骤、QR 码登录配置、账户配对流程及技术实现特点，无需公共 webhook。
AI 总结
Claude Code 微信通道插件，通过本地 MCP 服务器和微信 iLink Bot API，让用户在终端直接收发微信消息，无需公共 webhook。
中文项目介绍
claude-channel-weixin 是专为 Claude Code 设计的微信通道插件，允许用户在终端环境中直接接收和回复微信消息。它通过运行本地 MCP（Model Context Protocol）服务器，利用微信 iLink Bot API 的 HTTP 长轮询机制进行通信，完全不需要部署公共 webhook 服务，简化了集成流程。
该插件解决了在终端 AI 编程助手（Claude Code）中集成微信消息收发的需求，使用户能够将微信消息转发到本地 AI 会话进行处理，并自动回复。技术实现上，依赖 Bun 运行时和 Claude Code v2.1.80+ 版本，通过 QR 码登录微信账号并完成账户配对，消息回复时自动处理微信所需的 context_token，确保回复正确关联到原始消息。
适用场景包括：在终端使用 Claude Code 时需要实时处理微信消息；将微信消息自动化转发到本地 AI 助手进行智能回复或内容处理。用户需先通过插件市场安装，然后配置 QR 码登录和账户配对，最后使用特定命令启动插件并管理消息流。
详细信息与使用说明
2. 解决的问题
该插件解决了在终端 AI 工具中集成微信消息的难题。传统方式需部署公共 webhook 服务以接收微信回调，但此插件采用 HTTP 长轮询机制，所有通信均在本地完成，无需公网地址。同时，它自动处理微信回复必需的 context_token，确保消息上下文正确传递，避免了手动管理会话状态的复杂性。
3. 适用场景
主要适用于两类用户：一是开发者在终端使用 Claude Code 进行编程时，需实时查看和回复微信消息，避免频繁切换窗口；二是希望将微信消息自动化接入本地 AI 工作流，例如自动回复常见问题、将消息内容作为代码上下文或触发脚本执行。要求用户已安装 Claude Code v2.1.80+ 和 Bun 运行时，并拥有可用的微信账号。
4. 安装方式
安装通过 Claude 插件市场完成。首先添加插件市场源：执行命令 `claude plugin marketplace add m1heng/claude-plugins`（一次性操作）。然后安装插件：`claude plugin install weixin@m1heng-plugins`。安装过程依赖 Bun 包管理器自动处理依赖，包括 @modelcontextprotocol/sdk 和 qrcode-terminal 等库。仓库中未明确给出手动安装步骤，建议使用官方插件市场。
5. 使用方式
使用分为三步：配置登录、启动插件、账户配对。首先在 Claude Code 中运行 `/weixin:configure login` 命令，扫描终端显示的 QR 码完成微信登录。然后使用 `claude --dangerously-load-development-channels plugin:weixin@m1heng-plugins` 启动插件（研究预览期必需标志）。最后向微信机器人发送消息获取配对码，在 Claude 中执行 `/weixin:access pair <code>` 完成授权。此后，来自允许发送者的消息将自动转发到 Claude 会话，回复由 Claude 通过同一 API 发送回微信。
6. 补充说明与实现特点
插件实现基于 Model Context Protocol 本地服务器，通过长轮询维持与微信 iLink Bot API 的连接。关键特点包括：无公共 webhook 需求、自动管理 context_token 以支持微信回复机制、通过技能（skills）提供配置和访问控制功能。仓库中未明确给出消息过滤规则、多用户支持或错误处理细节，这些可能属于实现内部逻辑。当前版本为 0.1.0，采用 MIT 许可证。
思维导图
claude-channel-weixin
核心功能
微信消息接收
微信消息回复
终端集成
技术架构
本地 MCP 服务器
HTTP 长轮询
微信 iLink Bot API
无公共 webhook
依赖环境
Claude Code v2.1.80+
Bun 运行时
@modelcontextprotocol/sdk
qrcode-terminal
安装配置
插件市场添加
插件安装
QR 码登录
账户配对
使用流程
启动插件
消息接收
Claude 处理
自动回复
关键模块
server.ts
login-qr.ts
login-poll.ts
skills/configure
skills/access
常见问题
这个插件需要哪些前提条件？
需要 Claude Code v2.1.80 或更高版本，以及 Bun 运行时环境。
如何安装 claude-channel-weixin 插件？
首先添加插件市场：`claude plugin marketplace add m1heng/claude-plugins`，然后安装：`claude plugin install weixin@m1heng-plugins`。
如何配置微信账号登录？
在 Claude Code 中运行 `/weixin:configure login` 命令，扫描终端显示的 QR 码，并在手机上确认登录。
为什么启动插件时需要 --dangerously-load-development-channels 标志？
因为在 Claude Code 的渠道研究预览期间，非官方插件需要使用此标志来加载开发中的通道功能。
消息回复机制如何工作？
微信要求回复时传递 context_token。插件从接收到的消息中自动提取该令牌并包含在通道通知元数据中，Claude 通过回复工具将其传回，从而正确关联回复到原始消息。