claude-code-weixin
WeChat channel plugin for Claude Code — chat with Claude Code directly from WeChat.
Works just like the built-in Telegram channel: WeChat messages flow into your Claude Code session, and Claude replies back through WeChat.
Architecture
WeChat User ←→ iLink Bot API ←→ [this plugin (MCP server)] ←→ Claude Code
(long-poll) stdio transport (your session)
This is a Claude Code channel plugin — an MCP server with the claude/channel capability. Claude Code spawns it as a subprocess and communicates via stdio. Inbound WeChat messages arrive as MCP notifications, and Claude uses MCP tools (reply) to respond.
Features
- Text messaging (send and receive)
- Image recognition (download, decrypt, and pass to Claude for vision)
- File download (PDF, documents — Claude can read and summarize)
- Video download
- Voice messages (server-side speech-to-text when available, or raw audio download)
- Outbound file/image/video sending via CDN upload
- Multi-bot support (multiple WeChat accounts in one session)
- QR code login (scan with WeChat to authorize)
- Pairing-based access control
Setup
Quick install (via npm)
npx claude-channel-weixin install
npx claude-channel-weixin login
claude --dangerously-load-development-channels plugin:weixin@claude-channel-weixin
Or install manually (via GitHub)
claude plugin marketplace add https://github.com/yingwang/claude-code-weixin.git
claude plugin install weixin@claude-channel-weixin
npx claude-channel-weixin login
claude --dangerously-load-development-channels plugin:weixin@claude-channel-weixin
What each step does
- Install — registers the marketplace and installs the plugin into Claude Code
- Login — shows a QR code in terminal; scan with WeChat to authorize; bot token auto-saved
- Start — launches Claude Code with the WeChat channel enabled
- Pair — send a message from WeChat, then approve the pairing code with
/weixin:access pair <code>
After pairing, messages flow through automatically.
Slash Commands
| Command | Description |
|---|
/weixin:configure | Show current config status |
/weixin:configure clear | Remove bot token |
/weixin:access pair <code> | Approve a pairing request |
/weixin:access allow <id> | Add user to allowlist |
/weixin:access remove <id> | Remove user from allowlist |
/weixin:access policy <mode> | Set DM policy (pairing/allowlist/disabled) |
/weixin:access list | Show allowed users |
Configuration
Stored at ~/.claude/channels/weixin/:
| File | Purpose |
|---|
.env | WEIXIN_BOT_TOKEN=... (chmod 600) |
config.json | Channel settings (DM policy, API URL, etc.) |
allowlist.json | Approved sender IDs |
sync-buf.dat | Long-poll cursor (prevents duplicate messages) |
Multi-bot support
To connect multiple WeChat accounts, add additional tokens to .env:
WEIXIN_BOT_TOKEN=first-token
WEIXIN_BOT_TOKEN_2=second-token
Each token gets its own long-poll monitor. All messages feed into the same Claude Code session.
Security
- Bot token: Gives full access to send/receive messages as your WeChat bot. Never share it or commit it to git.
- Sender allowlist: Only paired/approved WeChat users can push messages to your Claude session
- Pairing flow: Unknown users get a 6-char code → you approve in terminal → they're added
- Token storage: Bot token stored with 600 permissions, never logged
Development
npm install
npm run build
npm run dev # watch mode
After code changes: npm run build, then kill the plugin process and /reload-plugins in Claude Code.
kill $(pgrep -f 'weixin.*server.js')
# then run /reload-plugins in Claude Code
License
Apache-2.0
yingwang