Wechat Claude Code

wechat-claude-code

**English** | [中文](README_zh.md)

A [Claude Code](https://claude.ai/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

• Real-time progress updates — see Claude's tool calls (🔧 Bash, 📖 Read, 🔍 Glob…) as they happen
• Thinking preview — get a 💭 preview of Claude's reasoning before each tool call
• Interrupt support — send a new message mid-query to abort and redirect Claude
• System prompt — set a persistent prompt via /prompt (e.g. "Reply in Chinese")
• 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, /prompt, /status, /skills, and more
• Launch any installed Claude Code skill from WeChat
• Cross-platform — macOS (launchd), Linux (systemd + nohup fallback)
• Session persistence — resume conversations across messages
• Rate-limit safe — automatic exponential backoff on WeChat API throttling

Prerequisites

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

  **Note:** The SDK supports third-party API providers (e.g. OpenRouter, AWS Bedrock, custom OpenAI-compatible endpoints) — set `ANTHROPIC_BASE_URL` and `ANTHROPIC_API_KEY` accordingly.

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