让AI Agent替你查微信wechat-cli接入Claude Code的5个实用场景与完整配置【免费下载链接】wechat-cliA CLI tool to query your local WeChat data — chat history, contacts, sessions, favorites, and more. Designed for LLM integration.项目地址: https://gitcode.com/gh_mirrors/wech/wechat-cliwechat-cli是一款查询本地微信数据的命令行工具支持聊天记录、联系人、会话、收藏等 11 个命令将它接入Claude Code后你只需用自然语言提问AI Agent 就能自动调用 wechat-cli 帮你查未读消息、搜索群聊关键词、导出聊天记录——全程数据不出本机。本文给出完整的安装与配置步骤并分享 5 个日常最好用的实用场景。为什么 wechat-cli 天生适合 AI Agent大多数 CLI 工具的输出是给人看的而 wechat-cli 从设计之初就面向 LLM 集成 默认 JSON 输出— 所有命令默认返回结构化 JSON方便大模型直接解析实现见 wechat_cli/output/formatter.py 全程本地— 密钥提取后即时解密 SQLCipher 数据库数据绝不上传 开箱即用— npm 一键安装无需 Python 环境 命令丰富— sessions、history、search、contacts、members、stats、export、favorites、unread、new-messages、init实现均位于 wechat_cli/commands/一键安装Claude Code 自己就会装方式一让 Claude Code 替你安装推荐这是最省事的方式——直接在 Claude Code 里输入一句话帮我配置并安装npm install -g canghe_ai/wechat-cliClaude 会自动执行 npm 安装、验证版本并主动提示你下一步需要初始化。前提是你本机已有 Node.js 环境没有的话也可以让它帮你装。方式二手动安装# npm 安装推荐无需 Python npm install -g canghe_ai/wechat-cli # 或 pip 安装需要 Python 3.10 pip install wechat-clinpm 包会通过 npm/wechat-cli/install.js 自动识别你的平台macOS / Windows / Linux含 arm64 与 x64无需手动下载二进制。完整初始化init 命令一次搞定密钥提取macOS / Linux需要 sudo 权限sudo wechat-cli initinit会自动检测微信数据目录、扫描微信进程内存提取加密密钥并把配置保存到~/.wechat-cli/目录config.jsonall_keys.json路径定义见 wechat_cli/core/config.py。macOS 特别注意两点先开启终端的完全磁盘访问权限系统设置 → 隐私与安全性 → 完全磁盘访问权限添加你的终端应用Terminal / iTerm2 / IDE 内置终端重启终端。未开启会导致密钥提取失败。多账号选择如果本机登录过多个微信号init 会列出多份数据目录让你选择当前登录的账号不确定自己当前登录的是哪个账号打开微信数据目录按修改日期排序最近活跃的文件夹就是遇到task_for_pid failed怎么办这是 macOS 安全策略限制进程内存访问导致的。wechat-cli 会自动对微信重新签名修复保留原有权限只需完全退出微信、重新登录后再次执行sudo wechat-cli init即可。重新签名是安全的不会导致封号。接入 Claude Code在 CLAUDE.md 中配置命令清单安装并 init 完成后在项目根目录的CLAUDE.md中添加以下内容这是核心配置告诉 Claude 有哪些武器可用## WeChat CLI 你可以使用 wechat-cli 查询我的本地微信数据。 常用命令 - wechat-cli sessions --limit 10 — 列出最近会话 - wechat-cli history 名称 --limit 20 --format text — 读取聊天记录 - wechat-cli search 关键词 --chat 聊天名 — 搜索消息 - wechat-cli contacts --query 名称 — 搜索联系人 - wechat-cli unread — 显示未读会话 - wechat-cli new-messages — 获取上次以来的新消息 - wechat-cli members 群名 — 列出群成员 - wechat-cli stats 聊天名 --format text — 聊天统计配置完成后直接在对话里用自然语言提问即可例如帮我看看微信有没有未读消息在项目群里搜索关于截止日期的消息看看这周 AI 群里谁发言最多Claude 会自动翻译成对应的 wechat-cli 命令执行并把 JSON 结果解读成人类友好的回答。5 个实用场景日常怎么用场景 1每日微信速览 — 晨起 30 秒掌握未读wechat-cli unread对 Claude 说看看我今天有哪些微信未读消息它会列出所有未读会话及最新一条消息摘要。更妙的是增量模式new-messages状态自动保存在~/.wechat-cli/last_check.json逻辑见 wechat_cli/commands/new_messages.py配合定时任务可以做到每小时只汇报新消息像一个安静的微信消息助理。场景 2跨历史全文搜索 — 关键词秒定位翻遍聊天记录找一条消息交给search实现见 wechat_cli/commands/search.pywechat-cli search 截止日期 --chat 项目组 wechat-cli search 报告 --type file对 Claude 说在项目组里搜一下关于截止日期的消息限定最近一个月它会带上时间范围和类型过滤参数精准返回结果。支持按 text / image / file / link / voice 等 10 种消息类型过滤。场景 3导出聊天记录 — 会议纪要与项目复盘项目结束了想做复盘一句把项目组 4 月的聊天记录导出成 Markdown即可wechat-cli export 项目组 --start-time 2026-04-01 --format markdown输出可直接作为 AI 分析的原始语料——让 Claude 接着帮你总结这份记录中的待办事项和结论等于自动生成了聊天版会议纪要。场景 4群成员速查 — 新群快速建立人脉地图wechat-cli members AI交流群 wechat-cli contacts --query 李面对一个陌生的大群问 Claude列出 AI交流群 的成员结合contacts --detail还能查到每个联系人的微信号和签名帮你快速定位关键人物。场景 5聊天统计 — 谁是群里的话痨wechat-cli stats AI交流群 --start-time 2026-09-01返回消息总数、类型分布、发言 Top 10、24 小时活跃图。对 Claude 说看看这周 AI 群里谁发言最多、大家一般几点最活跃数据驱动地认识你的社交圈。常见问题速查问题解答数据安全吗✅ 只读不写数据不出本机不发送/修改/删除任何消息会封号吗不会。工具不干扰微信运行无任何自动化操作支持哪些系统macOSApple Silicon 内置二进制、Windows、Linux需 root 读取进程内存换电脑了在新机重新执行wechat-cli init即可密钥按机提取想重置增量状态删除~/.wechat-cli/last_check.json写在最后wechat-cli 的价值不只是能查微信而是把你的本地微信变成了 AI Agent 可用的数据源。配合 Claude Code查消息、找文件、做统计、写总结……这些原本要翻半小时聊天记录的事现在一句话就能完成。完整的命令参考可阅读项目根目录的 README_CN.md 与 README.md密钥扫描逻辑可参考 wechat_cli/keys/ 下的平台实现。【免费下载链接】wechat-cliA CLI tool to query your local WeChat data — chat history, contacts, sessions, favorites, and more. Designed for LLM integration.项目地址: https://gitcode.com/gh_mirrors/wech/wechat-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考