1. 手动翻群 40 分钟，到底卡在哪
先说结论：微信群聊总结这件事，真正耗时间的不是"总结"，而是"翻"。我统计过自己一周的操作——打开微信、点进 8 个群、往上滚、跳过表情包和"收到"、把散落在几百条消息里的决策和待办挑出来、复制到备忘录、再整理成能看的格式。这一套下来，单个活跃群 5 分钟起步，8 个群就是 40 分钟，而且每天都要重来一遍。
更麻烦的是信息形态。群聊里的关键内容往往藏在对话流中间：一句"下午 3 点灰度"夹在十几条闲聊里，一个待办是"王哥你那个脚本好了吗"这种口语化提问。人眼扫一遍容易漏，扫两遍又太费时间。市面上的 AI 总结工具我也试过几个，功能看着不错，但有个绕不开的问题——你的聊天记录得先传到对方服务器，AI 才能处理。对普通闲聊无所谓，但团队群里经常有产品细节、客户信息、内部决策，这些东西上传到第三方，存多久、用来干什么，你根本不知道。
所以这篇要解决的就是：用 wx-cli 在本地把群聊记录导出来，用 Claude Skill 编排总结流程，再通过 TaoToken 统一 Key 接入模型通道，整条链路跑在你自己的电脑上。目标很明确——把每天手动翻群的 40 分钟压到 5 分钟以内。适合谁？每天要盯多个工作群、又对数据流向有顾虑的开发者、产品、运营。下面从环境准备到端到端验证，一步步来。
2. TaoToken 前置：统一 Key 与通道准备
在动手写配置之前，先把模型通道这块理清楚。这套方案里，wx-cli 负责"取数据"，Claude Skill 负责"编排流程"，而真正调用模型做总结的那一步，需要一个稳定的 API 通道。TaoToken 在这里的角色就是统一 Key 和统一入口——你不用为每个工具单独配一套密钥，一个 Key 走通对话、编码、Agent 各类场景。
为什么强调"统一"？因为本地总结器往往不止一个调用点：Claude Code 里跑 Skill 要调模型，你可能还想在脚本里加个自动摘要，或者用 Coding Plan 做长期编码任务。如果每个地方都配一套 Key，管理成本高，换 Key 的时候还得逐个改。TaoToken 把这些收敛到一个入口，配置一次，多处复用。
具体要准备的东西：
- 一个 TaoToken 账号，登录后进控制台创建 API Key
- 记下 API 地址：
https://taotoken.net/api（注意这个地址不带任何查询参数，直接作为 base_url 用） - 确认你要用的模型名，比如 Claude 系列、GPT 系列，按控制台里列出的可用模型填
创建 Key 的入口在控制台的 API Keys 页面，生成后只显示一次，复制下来存到本地密码管理器或者环境变量里，别直接写进会提交到 Git 的配置文件。这一步很多人踩坑：Key 写进settings.json然后不小心 push 上去，只能作废重建。
注意：TaoToken 是合规的 API 聚合通道，配置时只填官方给的
https://taotoken.net/api作为 base_url，不要自行拼接或改动路径。
拿到 Key 之后，先别急着配 Claude Code，用一条 curl 确认通道是通的，能省掉后面一半的排障时间。这个验证动作放在第 4 节，先把配置骨架搭好。
3. 可复制配置：settings.json / config.toml / CC Switch
这一节是全文的核心，直接给可复制的骨架。分三块：Claude Code 的settings.json、通用工具的config.toml、以及 CC Switch 的多配置切换示例。
3.1 Claude Code 的 settings.json 骨架
Claude Code 读取配置的位置通常在用户目录下的.claude/settings.json。如果你要用 TaoToken 作为模型通道，核心是配好env段里的 base_url 和 API Key。骨架如下：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "sk-你的TaoToken密钥", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" }, "permissions": { "allow": [ "Read", "Bash(wx:*)", "Bash(cat:*)" ] } }几个关键点解释一下。ANTHROPIC_BASE_URL填 TaoToken 的 API 地址，这样 Claude Code 的请求就走统一通道，而不是默认的官方端点。ANTHROPIC_AUTH_TOKEN填你刚创建的 Key。ANTHROPIC_MODEL按控制台里可用的模型名填，写错模型名会直接报 404 或 model not found。
permissions.allow这块是给 Skill 用的——总结器需要读本地文件（Read）、执行 wx-cli 命令（Bash(wx:*)）、读导出内容（Bash(cat:*)）。把权限收窄到具体命令前缀，比直接放开所有 Bash 安全得多。
如果你不想把 Key 明文写进文件，可以用环境变量引用：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "${TAOTOKEN_API_KEY}", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } }然后在 shell 的~/.zshrc或~/.bashrc里export TAOTOKEN_API_KEY="sk-..."。这样配置文件可以安全地进版本库。
3.2 config.toml 骨架（通用工具用）
有些工具（比如某些 CLI 客户端、脚本框架）习惯用 TOML 配置。给你一份通用骨架，字段名按你实际用的工具调整：
[provider] name = "taotoken" base_url = "https://taotoken.net/api" api_key = "sk-你的TaoToken密钥" model = "claude-sonnet-4-20250514" timeout = 120 [summarizer] input_dir = "~/wechat-summaries" output_dir = "~/wechat-summaries/digest" max_tokens = 2048 language = "zh"timeout建议给到 120 秒，群聊记录长的时候模型处理需要时间，默认 30 秒容易超时。input_dir和output_dir对应后面脚本的导出和摘要目录。
3.3 CC Switch 多配置切换示例
如果你同时用多个通道（比如一个 TaoToken 通道跑总结，另一个跑别的任务），手动改settings.json太麻烦。CC Switch 这类配置切换工具可以帮你管理多套配置。它的配置通常长这样：
{ "profiles": [ { "name": "taotoken-summary", "settings": { "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "sk-你的TaoToken密钥", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } } }, { "name": "taotoken-coding", "settings": { "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "sk-你的TaoToken密钥", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } } } ], "active": "taotoken-summary" }切换的时候改active字段，或者用 CC Switch 的命令行直接切。这样总结任务和编码任务用不同的模型或参数，互不干扰。长期跑编码和 Agent 任务的话，可以考虑用 Coding Plan 那套配置，把额度用在刀刃上。
3.4 wx-cli 与 Skill 的目录约定
配置里涉及的路径，统一约定一下，后面脚本直接复用：
# 导出目录 mkdir -p ~/wechat-summaries/raw # 摘要输出目录 mkdir -p ~/wechat-summaries/digest # Skill 目录 mkdir -p ~/.claude/skills/wechat-summarizerwx-cli 的安装和导出命令沿用你熟悉的方式，导出到~/wechat-summaries/raw/下，按群名和日期命名。Skill 文件放在~/.claude/skills/wechat-summarizer/SKILL.md，注意路径大小写，Claude Code 对目录名敏感。
4. 端到端验证：一次请求跑通全链路
配置写完，必须做一次端到端验证，确认"取数据 → 编排 → 调模型 → 出摘要"整条链路是通的。分四步。
4.1 验证 TaoToken 通道
先用 curl 打一发，确认 Key 和 base_url 没问题：
curl -s https://taotoken.net/api/v1/messages \ -H "x-api-key: sk-你的TaoToken密钥" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 64, "messages": [{"role": "user", "content": "只回复两个字：通了"}] }'返回里能看到content字段带"通了"两个字，说明通道正常。如果返回 401，检查 Key；返回 404，检查模型名；返回超时，检查网络到taotoken.net的连通性。
4.2 验证 wx-cli 导出
确认微信在运行状态，然后导出目标群：
wx export "项目周例会群" --format markdown -o ~/wechat-summaries/raw/项目周例会群-$(date +%Y%m%d).md打开导出的文件，应该能看到类似这样的结构：
[2026-05-15 09:23] 张工：今天的发布计划确认了吗？ [2026-05-15 09:25] 李姐：确认了，下午 3 点灰度，晚上 8 点全量 [2026-05-15 09:26] 王哥：测试环境没问题，回归测试今早已跑完 [2026-05-15 09:30] 张工：好，3 点前大家准备好回滚脚本文件在本地，没有任何上传动作。这一步通了，数据源就有了。
4.3 验证 Skill 被加载
启动 Claude Code：
claude进入交互界面后输入/，看已加载的 Skill 列表里有没有wechat-summarizer。没有的话检查~/.claude/skills/wechat-summarizer/SKILL.md路径和文件名，注意SKILL.md必须大写。
4.4 跑一次完整总结
在 Claude Code 里执行：
/wechat-summary ~/wechat-summaries/raw/项目周例会群-20260515.md或者直接说"帮我总结这个群聊记录，用结构化格式输出"。预期输出：
## 群聊摘要：项目周例会群 2026-05-15 ### 核心决策 - 今日发布计划确认：下午 3 点灰度，晚上 8 点全量 — 由李姐确认 ### 待办事项 - [ ] 准备回滚脚本 — 负责人：所有人，截止：下午 3 点前 ### 未解决问题 - （本段记录中无未解决问题） ### 重要信息 - 测试环境回归测试已完成（张工确认）从导出到出摘要，实测下来 30 秒到 1 分钟。500 条以上的长记录可能到 2 分钟，但比手动翻 40 分钟已经不是一个量级。这一步跑通，整条链路就闭环了。
5. 本篇常见错排查
配置和验证过程中，几个高频报错集中说一下，都是我自己踩过的。
报错一：401 Unauthorized或invalid api key
九成是 Key 的问题。检查三处：Key 有没有复制完整（前后有没有多余空格）、settings.json里有没有被环境变量覆盖、Key 是不是已经作废。TaoToken 控制台里可以重新生成，生成后立刻更新配置。
报错二：404 model not found
模型名写错了。ANTHROPIC_MODEL必须和控制台里列出的可用模型名完全一致，大小写、版本号后缀都不能差。不确定的话，先用 curl 那一步试出正确的模型名，再填进配置。
报错三：wx: command not found或导出报"无法连接到 WeChat 进程"
前者是 wx-cli 没装好，重新npm install -g对应包。后者是微信没运行，或者微信版本太老。wx-cli 依赖读取运行中的微信进程来获取解密密钥，微信必须处于登录状态。macOS 首次运行如果弹"开发者无法验证"，做一次 ad-hoc 签名即可。
报错四：Skill 没被识别，输入/看不到
路径问题。必须是~/.claude/skills/<skill-name>/SKILL.md，目录名和文件名都要对，SKILL.md大写。改完不用重启 Claude Code，重新输入/就能看到。
报错五：总结结果里出现[引用消息]、[文件]这类占位符
这是 wx-cli 对特殊消息格式（引用、文件分享、小程序卡片）的占位处理，不是 bug。对总结影响不大，Skill 里可以加一条约束让模型跳过这些无内容占位符。如果占位符特别多，检查一下是不是导出的群消息里这类格式占比过高。
报错六：请求超时
群聊记录太长，或者timeout设太短。把config.toml里的timeout提到 120 秒，或者分批导出（比如按天切分）再总结。另外确认到taotoken.net的网络是通的，本地防火墙没拦。
6. 把 40 分钟压到 5 分钟：收尾与通道选择
整套方案跑通之后，日常操作就变成：早上打开电脑，wx-cli 已经把各群记录导出到本地，Claude Code 里一条指令出摘要，5 分钟内搞定一天的群信息归总。数据全程在本地流转，模型调用走 TaoToken 统一通道，Key 配一次多处复用。
几个实用建议。第一，把导出脚本加到 crontab，工作日早上自动跑，你到工位时原始记录已经就位。第二，Skill 里的输出格式按你的习惯调，比如加上"@我 的消息单独列一段"，这样不会漏掉直接找你的内容。第三，Key 用环境变量管理，别写死在配置文件里。
通道这块按场景分流：日常总结和对话验证，用模型对话入口快速试；长期跑编码和 Agent 任务，用 Coding Plan 更划算；接入和排障过程中要查 Key 和文档，直接进 API Keys 和接入文档。配置里所有 base_url 统一填https://taotoken.net/api，不要自己改路径。
最后说个我自己的习惯：每周五花 10 分钟把这一周的摘要归档到~/wechat-summaries/digest/，按周建目录。月底回看的时候，哪些决策落地了、哪些待办一直没动，一目了然。这比翻聊天记录靠谱多了。
