wechat-claude-code

English | 中文

A Claude Code Skill that bridges personal WeChat to your local Claude Code. Chat with Claude from your phone via WeChat — text, images, permission approvals, slash commands, all supported.

Features

• Text conversation with Claude Code through WeChat
• Image recognition — send photos for Claude to analyze
• Permission approval — reply y/n in WeChat to approve Claude's tool use
• Slash commands — /help, /clear, /model, /status, /skills
• Launch any installed Claude Code skill from WeChat
• macOS launchd daemon — auto-start on boot, auto-restart on crash
• Session persistence — resume conversations across messages

Prerequisites

• Node.js >= 18
• macOS (daemon managed via launchd)
• Personal WeChat account (QR code binding required)
• Claude Code with @anthropic-ai/claude-agent-sdk installed

Installation

Clone into your Claude Code skills directory:

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

postinstall automatically compiles TypeScript via tsc.

Quick Start

1. Setup (first time only)

Scan QR code to bind your WeChat account:

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

A QR code image will open — scan it with WeChat. Then configure your working directory.

2. Start the daemon

npm run daemon -- start

This registers a launchd agent for auto-start and auto-restart.

3. Chat in WeChat

Send any message in WeChat to start chatting with Claude Code.

4. Manage the service

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

WeChat Commands

Command	Description
/help	Show available commands
/clear	Clear current session (start fresh)
/model <name>	Switch Claude model
/status	View current session state
/skills	List installed Claude Code skills
/<skill> [args]	Trigger any installed skill

Permission Approval

When Claude requests to execute a tool, you'll receive a permission request in WeChat:

• Reply y or yes to allow
• Reply n or no to deny
• No response within 60 seconds = auto-deny

How It Works

WeChat (phone) ←→ ilink bot API ←→ Node.js daemon ←→ Claude Code SDK (local)

• The daemon long-polls WeChat's ilink bot API for new messages
• Messages are forwarded to Claude Code via @anthropic-ai/claude-agent-sdk
• Responses are sent back to WeChat
• A macOS launchd agent keeps the daemon running

Data

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

~/.wechat-claude-code/
├── accounts/       # WeChat account credentials (one JSON per account)
├── config.env      # Global config (working directory, model, permission mode)
├── sessions/       # Session data (one JSON per account)
├── get_updates_buf # Message polling sync buffer
└── logs/           # Rotating logs (daily, 30-day retention)

Development

npm run dev    # Watch mode — auto-compile on TypeScript changes
npm run build  # Compile TypeScript

License

MIT