wechat-claude-code

Bridge WeChat messages and images to a local Claude Code instance.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/kuacoco/wechat-claude-code --skill wechat-claude-code-kuacoco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wechat-claude-code
Source: https://github.com/kuacoco/wechat-claude-code/tree/main
Command: npx skills add https://github.com/kuacoco/wechat-claude-code --skill wechat-claude-code-kuacoco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the friction of using Claude Code on your computer by letting you talk to it directly from your phone in WeChat, including image input and tool-permission approvals.

Core Features & Use Cases

  • WeChat-to-Claude Code bridge: forwards your WeChat messages (and images) to a locally running Claude Code instance.
  • Image recognition: send photos from WeChat and have Claude analyze them.
  • Interactive permission approvals: when Claude requests tool execution, you approve or deny via WeChat with y/n (with timeout handling).
  • Slash-command control from WeChat: manage session behavior and Claude settings using commands like /help, /clear, /model, /permission, /prompt, /status, /skills, /history, and more.
  • Session persistence and interrupt support: preserves conversation context across messages and aborts an in-progress query when a new message arrives.

Quick Start

In Claude Code, trigger this skill by sending a message like “wechat bridge”, then follow the guided status and run setup/start as instructed in WeChat or via the daemon commands.

Frequently Asked Questions about wechat-claude-code

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I chat with Claude Code from WeChat on my phone?

You can chat with Claude Code from WeChat by running a local Claude Code instance and using a WeChat bridge to forward your text and image messages directly to the model.

Can I approve Claude Code tool permissions remotely from WeChat?

Yes, when Claude Code requests tool execution, you can approve or deny permissions interactively from WeChat by replying with y or n, complete with timeout handling.

Does the WeChat Claude Code bridge support sending images for analysis?

Yes, the WeChat bridge supports image recognition by forwarding photos sent from your WeChat to the local Claude Code instance for immediate visual analysis.

How do I manage Claude Code session settings using WeChat slash commands?

You can manage session behavior in WeChat using slash commands such as /help, /clear, /model, /prompt, /status, and /history to control your Claude Code instance remotely.

What are the limitations of running Claude Code through WeChat?

A limitation is that sending a new WeChat message will abort any in-progress query, though the system does preserve conversation context through session persistence across messages.

Do I need a local Claude Code instance to use the WeChat bridge?

Yes, you must have a locally running Claude Code instance because the WeChat bridge forwards mobile messages to it, requiring a stateful daemon polling WeChat messages and a SKILL.md entry.