cc-wecom

WeCom (企业微信) 远程控制 Claude Code：把 PreToolUse 授权卡片推到 IM，点按钮放行；远程下发 /wrc 指令驱动 Claude 干活。

能做什么

• IM 侧授权转发 — Claude 触发的 Bash / Edit 等敏感工具，会以按钮卡片推到企业微信，点 ✅/❌ 直接放行或拒绝；卡片就地刷新成决策结果。
• 远程 /wrc — 在 IM 里给机器人发指令，daemon 通过 WebSocket 转给本机 Claude 执行，结果回推。
• 结构化消息 — 基于 @wecom/aibot-node-sdk 的按钮 / markdown 卡片，非纯文本。
• MCP 主动推送 — Claude 通过 wecom__send_markdown 工具主动汇报。

上手 (3 步)

前置：Node ≥ 20、已装 claude 或 claude-internal、企业微信「智能机器人」的 botId + secret。

npm install -g cc-wecom
wrc init

wrc init 会交互式问 4 个值并落盘到 ~/.cc-wecom/：

| 字段 | 落点 | | --- | --- | | botId / secret | ~/.cc-wecom/secrets.json | | Claude agent (claude / claude-internal / 自定义路径) | ~/.cc-wecom/config.jsonc | | 启用 PreToolUse hook | ~/.cc-wecom/config.jsonc |

随后自动：编译 dist → wrc sync 注入 hook/MCP → 装 daemon (launchd/systemd --user) → 等 WS 鉴权。

绑定默认会话：CLI 提示后，在企业微信里给机器人发：

将本对话设置为默认会话

10 分钟 claim 窗口内的这条精确匹配消息会被吃掉，把发送方 principal 写进 defaultChat + allowFrom。这是唯一绕过 allowFrom 的入口，消费完立刻关闭。

演示：CLI 自动跑一条三步指令 (echo → sleep → MCP 推送)，IM 应收到两张授权卡片和一条 markdown 总结。

常用命令

wrc status              # daemon + WS 健康
wrc logs -f             # 实时日志
wrc send <chat> <text>  # 主动推消息
wrc reload              # 重启 daemon
wrc unsync              # 卸载 hook/MCP (保留 daemon)
wrc uninstall           # 完整卸载 (先于 npm uninstall -g)

⚠️ 卸载顺序：先 wrc uninstall 再 npm uninstall -g cc-wecom，否则 launchd/systemd 会反复拉起已删除的二进制。~/.cc-wecom/ 下的配置/secrets 不会被清，二次安装可复用。

详细文档

• docs/ONBOARDING.md — 上手细节、排错、多机部署
• docs/DESIGN-INIT.md — init 流程的设计取舍

License

MIT