Chat with Claude Code in WeChat, just like texting a friend
扫码绑定微信后，你的微信里会多出一个好友。给它发消息，消息会自动转发给你电脑上运行的 Claude Code，回复也会实时推送到微信。支持文字、图片、语音、文件的收发。
| 扫码即用 | 不用注册账号，不用部署服务器。微信扫码绑定，一分钟搞定。数据全在本地，隐私有保障。 |
| 消息不刷屏 | 只推送核心信息——进度、结果、关键决策。工具调用、中间过程等噪音自动过滤，阅读体验清爽。 |
| "对方正在输入中..." | Claude 在处理任务时，微信顶部会显示输入状态，随时感知它在干活。 |
| 电脑手机体验一致 | 手机端和电脑端 Claude Code 行为完全相同——同样的编排逻辑、同样的输出效果。不是两个割裂的 AI。 |
| 文件双向收发 | 发图片、Word、PDF 给 Claude 分析；Claude 生成的文件也会直接推送到微信，不用回到电脑前查看。 |
| 超时安抚 | 任务超过 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 installcd ~/.claude/skills/wechat-claude-code
npm run setup弹出二维码，用微信扫码。
npm run daemon -- startmacOS 下自动注册 launchd，开机自启、崩溃自动重启。
打开微信，给你新出现的那个"好友"发条消息试试。
npm run daemon -- status # 查看运行状态
npm run daemon -- stop # 停止服务
npm run daemon -- restart # 重启服务（更新代码后使用）
npm run daemon -- logs # 查看日志直接在微信聊天中发送即可：
| 命令 | 说明 |
|---|---|
/help |
显示帮助 |
/clear |
清除当前会话，开始新对话 |
/stop |
停止当前任务 |
/model <名称> |
切换 Claude 模型 |
/prompt <内容> |
设置系统提示词（如"用中文回答"） |
/cwd <路径> |
切换工作目录 |
/skills |
查看已安装的 Skill |
/status |
查看当前会话状态 |
/history [数量] |
查看最近对话记录 |
/compact |
压缩上下文，开始新 CLI 会话 |
/reset |
完全重置（包括工作目录等设置） |
/undo [数量] |
撤销最近几条对话 |
/<skill> [参数] |
触发任意已安装的 Skill |
微信（手机） ←→ ilink Bot API ←→ Node.js 守护进程 ←→ Claude Code CLI（本地）
守护进程通过长轮询监听微信消息，转发给本地 claude CLI 处理，回复实时流式推送回微信。全程跑在你自己电脑上。
- 消息队列优化 — 连续发多条指令时，回复容易串。正在研究更好的队列策略，也欢迎讨论。
- 电脑休眠不中断 — 利用 macOS 的
caffeinate命令阻止系统睡眠，合上盖子也能响应微信消息。 - 接续电脑会话 — 在电脑上聊了很久，出门想接着聊。计划支持从当前电脑端的 Claude Code 会话直接续聊，工作空间和上下文保持一致。
- Node.js >= 18
- macOS 或 Linux
- 个人微信账号
- 已安装 Claude Code CLI 并完成认证
提示： Claude Code 支持第三方 API 提供商（OpenRouter、AWS Bedrock 等），设置
ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY即可。
所有数据存储在 ~/.wechat-claude-code/：
~/.wechat-claude-code/
├── accounts/ # 微信账号凭证
├── config.json # 全局配置
├── sessions/ # 会话数据
└── logs/ # 运行日志（每日轮转，保留 30 天）