微信 Claude Code 助手
把微信变成本地 Claude Code 的远程任务入口。
你在手机上发一句话，本机上的 Claude Code 就开始干活。任务过程会回到微信，结果也会回到微信。你不需要一直守着终端，也不需要专门开一个网页面板。
这不是一个“只能演示”的桥接原型，而是一条已经跑通的本地使用路径：
- 微信发任务
- 本地后台 worker 执行
- Claude Code 处理代码或分析任务
- 结果自动回发微信
English Summary
wechat-claude-assistant turns WeChat into a worker-first remote task entry for local Claude Code.
You send a message from WeChat. A local worker picks it up, runs Claude Code on your machine, and sends the result back to chat.
It supports:
- text
- image
- image + text
- image links
- webpage URLs
- webpage URLs + text
- uploaded documents (
pdf, docx, xlsx, pptx, md, txt, ...)
- documents + text
- voice
- voice + text
The default path is worker, not channels, because the goal is daily usability rather than session-only protocol demos.
一眼看懂它怎么工作
flowchart LR
A["WeChat / ClawBot"] --> B["WeChat Bridge Core"]
B --> C["worker 模式"]
C --> D["Local Claude Code"]
D --> C
C --> A
B -. 高级模式 .-> E["channels 模式"]
E -. 桥接到 .-> F["当前 Claude Code 会话"]
新手 3 分钟上手
如果你是第一次接触这个项目，直接走这条路径，不要先折腾 channels。
你需要先准备好
Claude CodeNode.js 18+- 一个能正常使用 ClawBot 的微信号
第一步：拉代码并安装
git clone https://github.com/itzone-x/wechat-claude-assistant.git
cd wechat-claude-assistant
npm install
npm run build
第二步：跑安装向导
node dist/cli.js install
向导会带你完成：
- 环境检查
- 微信扫码登录
- 工作目录设置
- 执行策略设置
- 自动启动偏好保存
注意：这一步只会完成配置和微信登录，不会自动开始监听微信消息。
如果你在向导里选择了“开启自动启动”，安装结束后会尝试直接安装并启动本机服务。
如果服务成功拉起，安装结束时会直接打印一段精简状态摘要，告诉你当前 worker 是否已经在运行。
第三步：启动 worker
前台运行：
node dist/cli.js start
如果你希望它后台常驻：
node dist/cli.js start --daemon
只有看到终端输出 worker 模式已启动，微信里的消息才会收到回复。
如果你改用自动启动服务：
node dist/cli.js service install
node dist/cli.js service status
node dist/cli.js status
请先确认 service status 显示“已加载: 是”，并且 status 显示“worker 运行中: 是”，再去微信里发消息。
第一次验证
在微信里给 ClawBot 发：
/echo 你好
如果收到回复，说明链路已经通了。
开始真实使用
直接在微信里发自然语言任务，例如：
请检查当前项目的 README，告诉我主路径是不是 worker 模式，并简短总结。
也可以直接发：
- 文字
- 图片
- 图片 + 文字
- 图片链接
- 网页链接
- 网页链接 + 文字
- 文件附件
- 文件附件 + 文字
- 语音
- 语音 + 文字
常用命令
本地：
node dist/cli.js status
node dist/cli.js stop
node dist/cli.js service install
node dist/cli.js doctor
微信里：
/echo 你好/status/reset/help
这是什么
这个项目基于微信官方 ClawBot iLink API，把微信接到本地 Claude Code 上。
它现在有两种模式：
worker：主路径，也是推荐模式。适合真正拿来日常使用。channels：高级模式。适合已经在 Claude Code 终端里工作的高级用户，或者想研究 Claude Channels 的人。
简单说：
- 如果你想“在微信里给本地 Claude Code 派活”，用
worker
- 如果你想“把微信消息直接桥接进当前 Claude Code 会话”，才考虑
channels
这个产品解决了什么问题
Claude Code 很强，但它天然是“坐在电脑前”的工具。
现实里的问题是：
- 路上想到一个任务，得等回到电脑再开工
- 临时想让它先改点代码、跑点分析，手机上没入口
- 就算做了桥接，很多方案也停留在协议验证，离“稳定可用”还差很远
这个项目想解决的就是这件事：
让微信变成你本地 AI 开发代理的控制入口。
你可以在地铁上、开会间隙、吃饭路上，直接通过微信给本地 Claude Code 派任务。等你回到电脑前，代码可能已经改好了，结果也已经回到了微信。
为什么主路径是 worker，而不是 channels
我们一开始也研究过 Channels 路线。
它很先进，也很优雅，但有一个现实问题：它更适合“当前会话内桥接”，不太适合做普通用户的默认产品路径。它依赖当前 Claude Code 会话在线，也更容易受到认证方式和本地配置影响。
所以这个项目最后做出的决定很明确：
channels 保留，但只作为高级模式worker-first 才是主产品路径
这个取舍背后的逻辑很简单。真正有价值的不是“微信能和 Claude 聊天”，而是“微信可以给本地 Claude Code 派活，而且这件事能稳定运行”。
快速开始
npm install
npm run build
node dist/cli.js install
安装向导会完成：
- 环境检查
- 模式选择
- 微信扫码登录
- 工作目录与执行策略设置
- 自动启动偏好保存
完成后，推荐直接运行：
node dist/cli.js start
如果你希望它在后台常驻：
node dist/cli.js start --daemon
如果你希望它跟随 macOS 登录自动启动：
node dist/cli.js service install
安装完后，先验证它真的已经起来：
node dist/cli.js service status
node dist/cli.js status
只有当 service status 显示“已加载: 是”，并且 status 显示“worker 运行中: 是”，才说明微信消息已经有人在监听。
微信上怎么用
连通后，直接给 ClawBot 发消息即可。
常用命令：
/echo 你好：连通性测试/status：查看当前任务状态/reset：重置当前微信会话对应的 Claude 会话/help：查看命令说明
普通任务直接发自然语言，例如：
请检查当前项目的 README，告诉我主路径是不是 worker 模式，并简短总结。
现在也支持多模态输入：
- 直接发图片，让 Claude 只看图回答
- 发图片再补一句话，让 Claude 结合图片和文字一起理解
- 直接发图片链接，只要链接最终返回的是图片，也会先下载到本地再交给 Claude
- 直接发网页链接或公众号文章链接，bridge 会先抓取网页正文，再把可读文本交给 Claude
- 发网页链接再补一句话，让 Claude 结合网页内容和你的问题一起理解
- 直接上传文件附件，例如
pdf、docx、xlsx、pptx、md、txt
- 上传文件后再补一句话，让 Claude 结合附件内容和你的问题一起理解
- 直接发语音，优先使用微信自动转写内容理解；如果语音媒体可下载，也会把语音文件一并交给 worker
- 发语音再补一句话，让 Claude 结合转写文本、语音附件和文字一起理解
例如：
请看这张报错截图，告诉我最可能的根因。
请结合这张页面截图和我上面的描述，帮我判断 UI 为什么错位。
请看这篇文章：https://example.com/article ，帮我提炼 3 个重点。
我刚上传了一份 PDF，请结合文件内容告诉我核心结论。
worker 默认更安静：
- 正常情况下直接回最终结果
- 只有任务超过 5 秒还没完成，才补一条
处理中，发送 /status 可查看进展。
- 如果任务失败，会回
任务执行失败：...
- bridge 会对入站消息做短窗口去重，尽量避免语音、文字和多模态消息被重复回复
常用命令
