微信里多了个会写代码的「好友」：Claude Code 桥接上手记

昨晚十一点，躺床上刷手机，突然想起白天那个线上小 bug 还没动。爬起来开电脑？算了，被窝之外都是远方。当时脑子里就冒出一个念头：要是有个办法，直接在微信里给 Claude Code 发句话，让它帮我把那个配置改了，回头发我手机上，我连被窝都不用出……

然后我发现，还真有人把这事做出来了。

Wechat-ggGitHub/wechat-claude-code，一个 Claude Code 的 Skill，MIT 协议。它不长在云端，而是跑在你自己电脑上。链路长这样：

微信（手机）  ←→  ilink Bot API  ←→  Node.js 守护进程  ←→  本机 Claude Code CLI

说人话就是：扫码绑一下，你的微信里会多出一个「好友」。给它发消息，消息转发到你电脑上正在跑的 Claude Code，回复发回来。全程数据都在本地，不落第三方服务器。

它最戳我的几个点

不是那种「能跑 demo 但日用就废」的项目。真正让我想装上的，是这几个细节：

扫码即用，不部署服务器。 不用注册账号，不用开一台云主机常驻。微信扫码绑定，一分钟完事。对一个只想「手机上能戳一下 Claude」的人来说，这点太关键——很多同类方案死就死在「你得先有个公网服务器」这一步。

消息不刷屏。 这是我最在意的一点。Claude Code 跑任务时，工具调用、中间步骤、一堆 Read/Edit 的噪音能把聊天框淹了。它做了过滤：只把进度、结果、关键决策推到微信，工具调用的过程自动吃掉了。你在手机上看到的是干净的「它在干啥 + 干完了」，不是一屏幕的机器自言自语。

「对方正在输入中…」 这个细节很鬼。Claude 在处理时，微信顶部会显示输入状态。你知道它不是卡了，是真在干活，不会对着空白聊天框怀疑人生。

文件双向收发。 你发图片、Word、PDF 给它分析；它生成的文件（比如改好的配置、导出的报告）也会直接推回微信，不用再爬回电脑前看。坐地铁上让人家帮你读份 PDF，它把要点甩回聊天框，这体验是顺的。

超时安抚。 任务超过 5 分钟没响应？它会自动发一条「还在干，别急」。这种「怕你等得慌所以主动报备」的小动作，用起来比想象中暖。

怎么装

两种方式，我都试了，推荐第一种：

# 方式一：skills CLI（推荐）
npx skills add Wechat-ggGitHub/wechat-claude-code

首次在对话里触发时会自动克隆源码并装依赖。或者手动来：

git clone https://github.com/Wechat-ggGitHub/wechat-claude-code.git ~/.claude/skills/wechat-claude-code
cd ~/.claude/skills/wechat-claude-code && npm install

绑定的时候扫个码：

cd ~/.claude/skills/wechat-claude-code
npm run setup      # 弹出二维码，微信扫
npm run daemon -- start   # 启动守护进程

macOS 下它会自动注册 launchd，开机自启、崩了自重启——这点对「长期挂着」的场景很省心。管理服务也齐活：status / stop / restart / logs。

然后打开微信，给你新出现的那个「好友」发条消息，就成了。

微信里能用的命令

它把 Claude Code 那套斜杠命令基本搬过来了，直接在微信聊天里发就行：

/help        帮助
/clear       清当前会话，开新对话
/stop        停当前任务
/model <名>  切 Claude 模型
/prompt <内容>  设系统提示词（比如「用中文回答」）
/cwd <路径>  切工作目录
/skills      看已装 Skill
/status      看当前会话状态
/history [n] 看最近对话
/compact     压上下文，开新 CLI 会话
/reset       完全重置（含工作目录）
/undo [n]    撤销最近 n 条
/<skill> [参数]  触发任意已装 Skill

等于说，你在微信里敲的，就是你电脑上 Claude Code 能听懂的那套语言。手机端和电脑端不是两个割裂的 AI，是同一个会话的两个入口。

几个我特意确认过的点

数据存哪。 全在 ~/.wechat-claude-code/：accounts/（微信凭证）、config.json、sessions/、logs/（每日轮转，留 30 天）。都在本机，这点对隐私敏感的人很友好。

能不能用第三方 API。 能。Claude Code 本身支持 OpenRouter、AWS Bedrock 这些，设 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 即可。也就是说不用死磕官方订阅也能跑起来。

它是怎么转起来的。 守护进程用长轮询盯着微信消息，转发给本机 claude CLI，回复再流式推回微信。本质上就是个「消息搬运 + 流式桥接」的本地代理，不魔改 Claude Code 本体。

两点老实话

不是吹完就完。我踩坑前先看了它的边界，得跟你交个底：

暂时只支持 macOS / Linux。 前置条件里写明了：Node.js ≥ 18、macOS 或 Linux、个人微信账号、已装好并认证过 Claude Code CLI。重点来了——没有 Windows 原生支持。Windows 党要么 WSL，要么先观望。这点和无限 OCR 那批「开箱即跑」的项目不同，装之前先确认你的环境。

消息队列还不够稳。 作者自己在「后续计划」里也认了：连续发多条指令时，回复容易串。他正在研究更好的队列策略。所以别拿它当高并发客服系统，当「我一个人、偶尔戳一下」的随身入口，目前刚刚好。

另外它 roadmap 上还有俩我挺期待的：用 caffeinate 阻止系统休眠（合盖也能回消息）、以及「从电脑端当前会话直接续聊」——出门接着手机聊，工作区和上下文不断。这俩落地了，才算真正把「随身 Claude」闭环。

值不值得装

如果你日常就泡在 Claude Code 里，又总有不方便开电脑、却又想让它干点活的场景（通勤、躺床、开会摸鱼），这个 Skill 的性价比很高：扫码即用的门槛低到离谱，消息过滤又让它日常可用，不是玩具。

前提是你得在 macOS/Linux 上、有个个人微信、Claude Code 已经认证过。满足这几条，花五分钟装上，你微信里就多了一个「会写代码、随叫随到、还知道主动报备」的好友。

至于我那十一点想改的线上 bug——第二天早上，我还是爬起来开电脑用键盘改的。但至少那天晚上，我知道这件事，已经可以不用爬起来了。