微信里跟 Claude Code 聊天开源桥接工具扫码一分钟搞定微信扫码绑定本地 Claude Code 自动接入微信——文字、图片、语音、文件双向收发像跟朋友聊天一样用 AI 编程。目录1. 项目简介——它是什么2. 六大核心亮点3. 工作原理——四层桥接架构4. 快速上手——3 步从零到聊起来5. 微信端命令——13 个命令全掌握6. 实际使用场景7. 适用场景与优缺点8. 总结1. 项目简介——它是什么wechat-claude-code是一个开源的 Claude Code Skill一句话概括把本地运行的 Claude Code 接入微信让你在微信里直接跟 Claude Code 聊天。它不是另一个 AI聊天机器人——而是桥接你电脑上已有的 Claude Code CLI。扫码绑定后你的微信联系人列表里会多出一个好友给它发消息消息自动转发给本地 Claude Code 处理回复实时推送回微信。支持文字、图片、语音、文件的双向收发——发一张图片让它分析发一个 PDF 让它总结它生成的文件也会直接推送给你。所有数据跑在你自己电脑上隐私有保障。 项目地址https://github.com/Wechat-ggGitHub/wechat-claude-code Skills.shhttps://skills.sh/Wechat-ggGitHub/wechat-claude-code LicenseMIT2. 六大核心亮点亮点说明扫码即用不用注册账号不用部署服务器。微信扫码绑定一分钟搞定。数据全在本地隐私有保障。消息不刷屏只推送核心信息——进度、结果、关键决策。工具调用、中间过程等噪音自动过滤阅读体验清爽。「对方正在输入中…」Claude 处理任务时微信顶部会显示输入状态指示器随时感知它在干活。电脑手机体验一致手机端和电脑端 Claude Code 行为完全相同——同样的编排逻辑、同样的输出效果不是两个割裂的 AI。文件双向收发发图片、Word、PDF 给 Claude 分析Claude 生成的文件直接推送到微信不用回到电脑前查看。超时安抚任务超过 5 分钟没响应自动发一条消息告诉你还在干不会让你对着空白聊天框干等。3. 工作原理——四层桥接架构整个系统的数据流非常清晰微信手机 ←→ ilink Bot API ←→ Node.js 守护进程 ←→ Claude Code CLI本地每一层的职责层角色说明微信手机端用户界面你发消息/文件的地方也是收到回复的地方ilink Bot API消息通道微信与本地服务之间的通信桥梁提供消息收发 APINode.js 守护进程消息路由长轮询监听微信消息转发给 Claude CLI流式推送回复回微信Claude Code CLIAI 引擎Anthropic 官方 CLI在你本地执行推理、工具调用、代码生成关键设计细节长轮询机制守护进程持续轮询 ilink Bot API一旦有新消息立即处理流式推送Claude Code 的回复不是等全部生成完再发而是实时流式推送——你在微信里能看到回复逐字出现消息过滤工具调用细节、中间推理过程等被自动过滤只推送最终结果和关键进度信息输入状态守护进程会通知微信显示「对方正在输入中…」体验就像跟真人聊天所有数据都在你的电脑上——守护进程、Claude CLI、会话数据、配置文件全跑在本地不经过任何第三方云端。4. 快速上手——3 步从零到聊起来前置条件✅ Node.js 18✅ macOS 或 Linux✅ 个人微信账号✅ 已安装 Claude Code CLI 并完成认证 Claude Code 支持第三方 APIOpenRouter、AWS Bedrock 等设置ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY即可。Step 1安装方式一skills CLI推荐npx skillsaddWechat-ggGitHub/wechat-claude-code首次触发时自动克隆源码并安装依赖。方式二手动克隆gitclone https://github.com/Wechat-ggGitHub/wechat-claude-code.git ~/.claude/skills/wechat-claude-codecd~/.claude/skills/wechat-claude-codenpminstallStep 2扫码绑定cd~/.claude/skills/wechat-claude-codenpmrun setup弹出二维码用微信扫码。扫码完成后你的微信联系人里就多了一个好友。Step 3启动服务npmrun daemon -- startmacOS 用户特权自动注册 launchd实现开机自启 崩溃自动重启——合上盖子再打开服务还在跑。现在打开微信给你的新好友发条消息试试管理服务npmrun daemon -- status# 查看运行状态npmrun daemon -- stop# 停止服务npmrun daemon -- restart# 重启更新代码后使用npmrun daemon -- logs# 查看日志数据目录所有数据存储在~/.wechat-claude-code/~/.wechat-claude-code/ ├── accounts/ # 微信账号凭证 ├── config.json # 全局配置 ├── sessions/ # 会话数据 └── logs/ # 运行日志每日轮转保留 30 天5. 微信端命令——13 个命令全掌握直接在微信聊天框里发命令就像发普通消息一样命令说明实用场景/help显示帮助忘了命令时查一下/clear清除当前会话开始新对话话题切换时使用/stop停止当前任务Claude 跑偏了停掉重来/model 名称切换 Claude 模型想用 Opus一条命令切换/prompt 内容设置系统提示词/prompt 用中文回答/cwd 路径切换工作目录/cwd ~/my-project指向项目目录/skills查看已安装的 Skill查看可用能力/status查看当前会话状态看当前模型、目录等/history [数量]查看最近对话记录/history 5看最近 5 条/compact压缩上下文开始新 CLI 会话上下文太长时压缩/reset完全重置包括工作目录等一键清空重来/undo [数量]撤销最近几条对话/undo 2撤销最近 2 条/skill [参数]触发任意已安装的 Skill直接调用任何 Skill 最实用的三个命令/prompt设中文回复、/cwd切换目录、/stop停掉跑偏的任务6. 实际使用场景 场景一出门在外远程编程你在咖啡店突然想起一个 bug 需要修。打开微信你帮我检查 ~/my-app/src/auth.ts 里的登录逻辑有没有问题 Claude[分析代码] 发现第 42 行的 token 验证缺少过期检查已添加... 你修好了发给我 Claude[修改代码] ✅ 已修复并推送文件给你全程不需要打开电脑微信里就完成了代码修复。 场景二图片/PDF 即时分析你[发送一张产品截图] Claude这是某电商平台的商品页面主要信息如下...价格 ¥299... 你[发送一份 PDF 合同] Claude合同摘要甲方 XX 公司乙方 YY 公司合同期限 2026-01 至 2026-12... 场景三跨设备无缝切换早上在电脑上用 Claude Code 开发了一上午下午出门开会。路上想继续打开微信直接发消息——同一个 Claude Code 实例、同一个工作空间、同一个上下文。7. 适用场景与优缺点✅ 最适合谁人群场景‍ 开发者出门时远程指挥 Claude 修 bug、写代码 产品经理发需求文档给 Claude 分析微信里直接看结论 设计师发设计稿给 Claude 描述、提建议 写作者发 PDF/Word 给 Claude 总结微信里看摘要 任何 Claude Code 用户想随时随地用 AI不想一直坐在电脑前⚖️ 优缺点对比优点缺点 扫码即用一分钟搞定 仅支持 macOS/Linux无 Windows 数据全在本地隐私安全 需要电脑一直开着运行守护进程 消息过滤不刷屏 连续多条消息回复可能串队列优化进行中 输入状态指示体验自然 依赖 ilink Bot API 第三方通道 文件双向收发 macOS 合盖会中断caffeinate 方案开发中 launchd 自启 崩溃重启 电脑手机会话续聊功能尚未发布 13 个微信端命令 需要先安装 Claude Code CLI 支持第三方 API 提供商 长轮询而非 WebSocket实时性稍弱8. 总结wechat-claude-code 解决的是一个很朴素但很刚需的问题Claude Code 很强但你总不能一直坐在电脑前。它用最简洁的架构——微信 → ilink → Node.js 守护进程 → Claude CLI——实现了微信里用 AI 编程的体验。扫码一分钟绑定数据全在本地消息不刷屏还有对方正在输入中…这种贴心的小细节。13 个微信端命令让你在手机上也能切换模型、设提示词、换工作目录、停掉任务控制力不输电脑端。当然也有遗憾——Windows 不支持、合盖会中断、消息队列还在优化。但作为一个 MIT 开源项目它的核心体验已经非常扎实了。如果你是 Claude Code 用户又经常不在电脑前这个工具就是为你做的。推荐指数⭐⭐⭐⭐ (4/5)扫码即用、数据本地、体验自然——微信接入 Claude Code 的最佳方案。期待 Windows 支持和会话续聊功能上线后升到 5 星。原文链接https://github.com/Wechat-ggGitHub/wechat-claude-codeLicenseMIT标签#微信 #ClaudeCode #AI编程 #桥接工具 #开源项目 #本地部署分类原创文章