Appearance
把Claude Code塞进微信:躺着写代码的实现方案
一个把微信和你本机Claude CLI连起来的桥。微信消息 → 桥 → Claude Code执行 → 回复回微信。不用API key,走的是你已经付了的Claude Max订阅。
它是什么?
一句话:把微信和本机 Claude CLI 连起来的桥。
流程:
微信消息 → 微信ClawBot协议(iLink长轮询)
→ 桥(在Mac上常驻)
→ subprocess: claude -p "你的话" --resume <session>
→ 回复回微信特点:
- 不用 API key,走 Claude Max 订阅
- 每个微信联系人独立工作目录、独立会话
- 支持
/cd、/new、/history、/resume等命令 - 行为和终端里用 Claude Code 几乎一致
用起来是什么感觉?
| 场景 | 体验 |
|---|---|
| 地铁上 | 手机微信发指令,家里Mac上的Claude Code跑脚本,回复总结 |
| 和家人吃饭 | 微信群里@微信ClawBot,直接给出诊断+修改建议 |
| 躺在床上 | 一句话让Mac上amend commit、push,修复成本降到发一条微信 |
为什么是微信,不是别的?
Claude Code手机/Web版的问题:都在云端跑,不在自己的Mac上跑。
我想做的:让Claude在自己的电脑里、自己的代码里、自己的环境里干活——MCP配置是我的、登录态是我的、.env是我的、Chrome是我的。
微信的优势:
- 已经在微信里了,不用切app、不用记新密码、不用学新交互
- 微信群里@一下就能用
- 最低门槛的入口
关于安全
我的红线:
| 安全措施 | 说明 |
|---|---|
| 沙盒目录 | 默认 ~/cc-wx-sessions/{chat_id}/,不碰 .ssh、.aws、.env |
| /cd主动授权 | 不指它,绝不自己跑到源码目录乱翻 |
| 无对外端口 | 只主动对腾讯长轮询,外面打不进来 |
| 禁用破坏性命令 | 未来加 --disallowedTools,禁掉 rm*、git push --force* |
风险提示:微信账号被盗 = 攻击者拿到Mac上能跑Claude的入口。
只推荐给:把微信账号当生命线、能接受沙盒外目录授权风险的人。
踩了几个坑
坑一:iLink协议字段命名混乱
qrcode字段不是二维码内容,是个 opaque id- 真正登录URL在
qrcode_img_content字段里——名字叫「图片内容」,里面塞的却是URL字符串
教训:腾讯协议文档没写,翻demo源码才发现。
坑二:sendmessage接口静默丢弃
不带 from_user_id: "" 和 client_id: <uuid>,服务端200返回 {} 假装成功——但回复超过1秒就静默丢弃。
教训:协议文档可以骗你,demo源码不会。写桥接第一件事:找跑通了的最小demo,逐字段比对。
如何安装
前置要求
- macOS + Python 3.11+ + uv
- 本机已装 Claude CLI 并登录 Max 订阅
- 一个能注册成 ClawBot 的微信号
安装步骤
bash
git clone https://github.com/andyleimc-source/wx-cc-bridge.git
cd wx-cc-bridge
make sync
make run # 第一次跑,扫码登录第一次启动会在终端打印二维码,用想当bot的微信号扫码——之后这个号就是私人Claude Code入口。
登录态存在 ~/.wx-cc-bridge/token.json,下次直接后台跑。
后台常驻(macOS launchd)
bash
make install-service
make logs为什么要做这个?
原始动机:懒。不想为小修改专门走到桌前坐下、打开IDE、找文件、输入命令。
做完后意识到更大的事:入口在哪里,使用频率就在哪里。
| 对比 | 终端Claude Code | 微信Claude Code |
|---|---|---|
| 使用频率 | 一天十次 | 一天五十次 |
| 原因 | 需专门打开 | 微信本来就开着 |
桥的价值:把「专业工具」变成「日常工具」,把「工作场景的能力」变成「任何场景都能用的能力」。
总结
| 要点 | 说明 |
|---|---|
| 核心 | 微信 → 桥 → Claude CLI → 回复 |
| 不用API Key | 走Claude Max订阅 |
| 安全 | 沙盒目录、主动授权、无对外端口 |
| 价值 | 入口在哪里,使用频率就在哪里 |
开源地址:github.com/andyleimc-source/wx-cc-bridge
关键词:wx-cc-bridge, Claude Code微信, ClawBot, iLink协议, 微信桥接
