Wechat Claude Code

wechat-claude-code

通过微信远程控制 Claude Code。扫码登录后，直接在微信里给 Claude 发任务、审批操作、中断执行、接收完成通知。

功能

基础功能
- 微信对话：直接在微信里给 Claude 发消息，Claude 在本地执行后把结果发回微信
- 图片 / 文件传输：发图片给 Claude 让它分析，Claude 生成的文件也能回传微信
- 语音消息：自动提取转写文字后转发给 Claude

权限审批

开启后，Claude 每次执行 Bash 命令、写文件、编辑文件前，会先发微信问你是否允许：

回复 y 放行，回复 n 拒绝。默认关闭，需手动开启。

审批白名单

为常见操作设置自动允许/拒绝规则，无需每次手动确认：

任务完成通知
Claude 完成任务后自动推送微信通知，无需盯着终端等。

流式进度推送
任务执行超过 30 秒，每隔 30 秒推送一次心跳消息，告知当前已用时。

中断控制
在微信发 /stop，立即中断 Claude 正在执行的任务。

多项目管理

管理多个代码仓库，随时切换：

任务历史

查看最近 20 条任务记录，支持重发：

定时任务

定时或周期性执行任务：

用量统计

用户访问控制

控制哪些微信账号可以操控 Claude（默认所有人均可）：

文件请求

从服务器获取文件内容：

环境要求

- Claude Code v2.1.80+
- Node.js >= 22
- 微信（iOS / Android / macOS / Windows）

安装

无需编译，dist/ 已包含在仓库中。

使用步骤

第一步：注册 MCP + 扫码登录

终端会显示二维码，用微信扫码登录。登录成功后账号信息保存在 ~/.claude/channels/wechat/。

第二步：Patch Claude Code

Claude Code 默认关闭 Channels 功能，需要打补丁启用：

恢复原始版本：

第三步：启动

启动后在微信给登录的账号发消息，即可开始使用。

微信命令

其他任何消息都会直接发给 Claude 执行。

可选：开启权限审批

第一步：安装 hooks

这会在 ~/.claude/settings.json 里注册 PreToolUse 和 Stop 两个 hook。

第二步：开启审批模式

开启后，Claude 执行 Bash / Write / Edit / MultiEdit 前都会发微信等待审批。

关闭审批模式（恢复无拦截）：
审批超时（2分钟）后自动放行，不会卡死。

移除 hooks：

所有 CLI 命令

工作原理

消息流

权限审批流程

任务完成通知

Stop hook 在 Claude 完成响应后触发，读取 ~/.claude/channels/wechat/last-user.json 中保存的用户上下文，调用 iLink API 发送通知。

中断控制

/stop 命令触发后，MCP Server 执行 process.kill(process.ppid, 'SIGINT')，向父进程 Claude Code 发送中断信号。

定时任务

MCP Server 内置调度循环，每分钟检查 ~/.claude/channels/wechat/jobs.json，到期任务通过 channel notification 转发给 Claude 执行。

注意事项

- 单账号限制（iLink Bot API 限制）
- 用户需先发一条消息，Claude 才能回复（context_token 按消息签发）
- Session 会过期，过期后重新扫码：node dist/cli.js login
- patch 仅对 npm 全局安装的 Claude Code（cli.js）有效，原生二进制版本自动识别并跳转

License

Apache 2.0