WeChat Claude Code Bridge

Chat with Claude Code in WeChat, just like texting a friend

Scan a QR code to bind your WeChat, and a new "friend" appears in your contacts. Send it a message — it gets forwarded to Claude Code running on your computer, and the reply streams back to WeChat in real time. Supports text, images, voice, and files.

---

Highlights

Scan and go	No account signup, no server deployment. Scan a QR code and you're done in a minute. All data stays on your machine.
Clean messages	Only key info gets pushed — progress, results, key decisions. Tool calls and intermediate noise are filtered out automatically.
"Typing..." indicator	WeChat shows a typing indicator while Claude is working, so you always know it's on it.
Consistent experience	Mobile and desktop Claude Code behave identically — same orchestration, same output. Not two disconnected AIs.
Two-way files	Send images, Word docs, PDFs for Claude to analyze. Files Claude generates get pushed directly to WeChat — no need to go back to your computer.
Timeout reassurance	Task taking longer than 5 minutes? You'll get an automatic message letting you know it's still working.

---

Install

Option 1: skills CLI (recommended)

npx skills add Wechat-ggGitHub/wechat-claude-code

The first time you trigger the skill, it will automatically clone the source and install dependencies.

Option 2: Manual clone

git clone https://github.com/Wechat-ggGitHub/wechat-claude-code.git ~/.claude/skills/wechat-claude-code
cd ~/.claude/skills/wechat-claude-code && npm install

Quick Start

1. Bind WeChat

cd ~/.claude/skills/wechat-claude-code
npm run setup

A QR code will pop up — scan it with WeChat.

2. Start the service

npm run daemon -- start

On macOS, this registers a launchd agent for auto-start on boot and auto-restart on crash.

3. Start chatting

Open WeChat and send a message to your new "friend".

Manage the service

npm run daemon -- status   # Check if running
npm run daemon -- stop     # Stop the service
npm run daemon -- restart  # Restart (after code updates)
npm run daemon -- logs     # View recent logs

---

WeChat Commands

Send these directly in the WeChat chat:

Command	Description
/help	Show available commands
/clear	Clear current session, start fresh
/stop	Stop current task
/model <name>	Switch Claude model
/prompt <text>	Set a system prompt (e.g. "reply in Chinese")
/cwd <path>	Switch working directory
/skills	List installed Skills
/status	View current session state
/history [n]	View recent chat history
/compact	Compact context, start a new CLI session
/reset	Full reset including working directory
/undo [n]	Remove last N messages from history
/<skill> [args]	Trigger any installed Skill

---

How It Works

WeChat (phone) ←→ ilink Bot API ←→ Node.js daemon ←→ Claude Code CLI (local)

The daemon long-polls WeChat for new messages, forwards them to the local claude CLI, and streams replies back to WeChat. Everything runs on your own machine.

---

Roadmap

• Message queue optimization — Consecutive messages can produce mixed-up replies. Working on a better queuing strategy. Ideas welcome.
• Prevent sleep — Use macOS caffeinate to keep the system awake, so closing the lid doesn't interrupt the service.
• Resume desktop session — Chat on your computer for a while, then continue the same session from WeChat on the go. Same workspace, same context.

---

Prerequisites

• Node.js >= 18
• macOS or Linux
• A personal WeChat account
• Claude Code CLI installed and authenticated

Note: Claude Code supports third-party API providers (OpenRouter, AWS Bedrock, etc.) — set ANTHROPIC_BASE_URL and ANTHROPIC_API_KEY accordingly.

Data Directory

All data is stored in ~/.wechat-claude-code/:

~/.wechat-claude-code/
├── accounts/       # WeChat account credentials
├── config.json     # Global config
├── sessions/       # Session data
└── logs/           # Rotating logs (daily, 30-day retention)

License

MIT