# claude-code-wechat-channel

**Repository Path**: genvex/claude-code-wechat-channel

## Basic Information

- **Project Name**: claude-code-wechat-channel
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-18
- **Last Updated**: 2026-04-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code WeChat Channel

将微信消息桥接到 Claude Code 会话的 Channel 插件。

基于微信官方 ClawBot ilink API（与 `@tencent-weixin/openclaw-weixin` 使用相同协议），让你在微信中直接与 Claude Code 对话。

## 工作原理

```
微信 (iOS) → WeChat ClawBot → ilink API → [本插件] → Claude Code Session
                                                  ↕
Claude Code ← MCP Channel Protocol ← wechat_reply tool
```

## 前置要求

- [Node.js](https://nodejs.org) >= 18（或 [Bun](https://bun.sh) >= 1.0）
- [Claude Code](https://claude.com/claude-code) >= 2.1.80
- claude.ai 账号登录或 API key（`ANTHROPIC_API_KEY`）
- 微信 iOS 最新版（需支持 ClawBot 插件）

## 快速开始

### 1. 微信扫码登录

```bash
npx claude-code-wechat-channel setup
```

终端会显示二维码，用微信扫描并确认。凭据保存到 `~/.claude/channels/wechat/account.json`。

### 2. 生成 MCP 配置

```bash
npx claude-code-wechat-channel install
```

这会在当前目录生成（或更新） `.mcp.json`，指向本插件。

### 3. 启动 Claude Code + WeChat 通道

```bash
claude --dangerously-load-development-channels server:wechat
```

### 4. 在微信中发消息

打开微信，找到 ClawBot 对话，发送消息。消息会出现在 Claude Code 终端中，Claude 的回复会自动发回微信。

## 命令说明

| 命令 | 说明 |
|------|------|
| `npx claude-code-wechat-channel setup` | 微信扫码登录 |
| `npx claude-code-wechat-channel install` | 生成 .mcp.json 配置 |
| `npx claude-code-wechat-channel start` | 启动 MCP Channel 服务器 |
| `npx claude-code-wechat-channel help` | 显示帮助 |

## 技术细节

- **消息接收**: 通过 `ilink/bot/getupdates` 长轮询获取微信消息
- **消息发送**: 通过 `ilink/bot/sendmessage` 发送回复
- **认证**: 使用 `ilink/bot/get_bot_qrcode` QR 码登录获取 Bearer Token
- **协议**: 基于 MCP (Model Context Protocol) 的 Channel 扩展

## 注意事项

- 当前为 research preview 阶段，需要使用 `--dangerously-load-development-channels` 标志
- Claude Code 会话关闭后通道也会断开
- 微信 ClawBot 目前仅支持 iOS 最新版
- 每个 ClawBot 只能连接一个 agent 实例

## License

MIT