1. 微信里直接和 Claude Code 聊天到底解决了什么问题微信里直接和 Claude Code 聊天本质是把手机微信当成 Claude Code 的远程输入框你在微信发一句话本地电脑上的 Claude Code 收到后开始干活结果再回到微信对话框。它适合谁适合每天挂着电脑、但人经常离开工位的人——通勤路上派个任务、开会间隙让它改个脚本、睡前丢一句“把昨天的日志分析一下”第二天打开电脑看结果。传统做法要么依赖公网 IP 和域名做回调要么走一层网关转发配置门槛不低。开源项目 ClawBot社区里也常叫 wechat-claude-code走的是另一条路它读取微信 ClawBot 插件里的协议层用 HTTP 长轮询收消息本地跑一个 Node.js 守护进程把消息通过 Claude Agent SDK 交给 Claude Code再把流式结果发回微信。全程不需要公网 IP、不需要域名一台能联网的电脑就够。但这里有个绕不开的环节Claude Code 要调用模型就得有可用的 API 通道和 Key。如果你本地已经有一份 Key直接填进去也能跑如果你希望多个工具、多个项目共用一套鉴权和额度用 TaoToken 统一 Key 会更省心——Claude Code、脚本、其他 Agent 都指向同一个 Base URL换模型、查用量、管额度都在一个地方。这篇就按“微信 → 本地 Node.js → Claude Code → TaoToken 通道”的完整链路把环境变量、配置文件、验证动作和常见报错一次讲清楚。先说清楚整体数据流后面每一步都围绕它展开微信手机 ←→ ilink bot API ←→ 本地 Node.js 守护进程 ←→ Claude Agent SDK ←→ Claude Code ←→ TaoToken API 通道你要做的其实就三件事装好项目、把鉴权指向 TaoToken、扫码绑定微信后发一条消息验证。听起来简单但真正卡人的往往是环境变量名写错、Base URL 少了/api、模型 ID 对不上这几处。下面按顺序来。2. 前置准备TaoToken 统一 Key 与 Claude Code 环境在动微信之前先把 Claude Code 这一侧跑通否则后面报错你分不清是微信协议的问题还是模型通道的问题。这一步的核心是拿到 TaoToken 的 API Key并让 Claude Code 认识它。先注册并创建 Key。打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 登录后进入控制台在 API Keys 页面新建一个 Key。建议按用途分开建一个给 Claude Code 用一个给脚本或别的工具用这样哪个 Key 出问题、哪个 Key 用量异常一眼能看出来。新建后立刻复制保存页面刷新后就看不到完整串了。拿到 Key 之后Claude Code 侧有两种接法选一种即可。第一种是用环境变量适合临时验证export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENsk-你的TaoToken密钥注意 Base URL 是https://taotoken.net/api不要多加斜杠也不要写成官网首页地址。ANTHROPIC_AUTH_TOKEN这个变量名是 Claude Code 认的写成ANTHROPIC_API_KEY在部分版本里不生效这是很多人第一次接入失败的原因。第二种是写进 Claude Code 的配置文件适合长期使用。配置文件通常放在用户目录下的.claude/settings.json内容如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-5-20250929 } }这里三个字段要配套出现Base URL、Key、Model ID。Model ID 必须是你账号下确实可用的模型标识写错了会直接返回模型不存在。如果你不确定该填哪个去控制台的模型列表里复制别凭记忆手敲。配好之后先单独验证 Claude Code 能不能通再去做微信接入。验证命令claude -p 用一句话说明你现在用的是哪个模型如果返回了正常文本说明 TaoToken 通道和 Claude Code 已经打通。如果报 401多半是 Key 复制时带了空格或换行如果报连接失败检查 Base URL 是不是写成了https://taotoken.net少了/api。这一步过了微信侧才有意义。顺便说一句如果你后面还想在别的工具里复用这套通道比如 Cline、Codex 这类思路是一样的Base URL 填https://taotoken.net/apiKey 填同一个Model ID 按工具要求填。统一 Key 的好处就在这里——不用每个工具单独申请、单独记额度。3. 可复制配置ClawBot 环境变量与 settings 片段这一节是全文最该照着抄的部分。ClawBot 项目本身通过 npm 脚本管理但它的鉴权最终还是要落到 Claude Code 的配置上所以我们要把上一节的 TaoToken 配置和项目自身的环境变量对齐。先把项目拉下来。官方仓库地址是https://github.com/Wechat-ggGitHub/wechat-claude-code安装到 Claude Code 的 skills 目录下git clone https://github.com/Wechat-ggGitHub/wechat-claude-code.git ~/.claude/skills/wechat-claude-code cd ~/.claude/skills/wechat-claude-code npm install装完之后项目目录里通常会有一个.env或.env.example文件用来放运行期参数。把示例复制成正式文件cp .env.example .env然后编辑.env关键字段如下字段名以你拉到的版本为准逻辑一致# TaoToken 统一通道 ANTHROPIC_BASE_URLhttps://taotoken.net/api ANTHROPIC_AUTH_TOKENsk-你的TaoToken密钥 ANTHROPIC_MODELclaude-sonnet-4-5-20250929 # 会话与守护进程 SESSION_STORE./data/sessions.json LOG_LEVELinfo这里要强调一个容易踩的坑ClawBot 进程启动时会读取环境变量但如果你同时在 shell 里 export 了一份、在.env里又写了一份两者不一致时以哪个为准取决于加载顺序。稳妥做法是只保留一处——要么全放.env要么全放 shell 环境变量别混着来。如果你更习惯用 Claude Code 的 settings 统一管理那就把模型通道写在~/.claude/settings.json.env里只留项目自己的参数{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-5-20250929 } }对应.env精简为SESSION_STORE./data/sessions.json LOG_LEVELinfo两种方式都行关键是 Base URL、Key、Model ID 这三件套必须完整且一致。我见过有人 Base URL 填对了、Key 也对就是 Model ID 留了个占位符没改结果微信发消息一直转圈日志里报模型不存在。配置完成后首次使用要扫码绑定微信npm run setup终端会弹出一个二维码用微信扫一下完成绑定。绑定信息一般会落到本地数据文件里后续启动不需要重复扫码。接着启动守护进程npm run daemon -- start管理命令也一并记下排障时用得上npm run daemon -- status # 查看运行状态 npm run daemon -- stop # 停止服务 npm run daemon -- restart # 重启服务 npm run daemon -- logs # 查看最近日志到这一步配置层面就齐了。下一节我们发一条真实消息把整条链路走通。4. 验证请求从微信发一条消息到 Claude Code 返回配置写完不代表通了必须发一条消息做端到端验证。这一步的目标是确认四个环节都正常微信侧消息发出、本地进程收到、Claude Code 处理、结果回到微信。先确认守护进程在跑npm run daemon -- status看到 running 之类的状态后打开微信找到绑定后的对话入口发一条最简单的消息/status斜杠命令是最适合做首次验证的因为它不依赖模型推理直接由本地进程处理并返回当前会话状态。如果这条能收到回复说明微信协议层和本地进程是通的。接着发一条真正走模型的帮我用一句话解释什么是 HTTP 长轮询正常情况下的完整链路是这样的微信发出消息 → ilink bot API 通过长轮询把消息推给本地 Node.js 进程 → 进程调用 Claude Agent SDK 的 query() 方法 → Claude Code 带着 TaoToken 通道请求模型 → 流式结果返回进程 → 进程把结果发回微信。你会在微信里看到回复逐步出现或一次性出现取决于项目的流式处理实现。如果想让验证更彻底可以发一条需要调用工具的消息比如列出我当前目录下的文件这时 Claude Code 会请求执行工具微信侧会收到权限审批提示。按项目说明回复y或yes允许回复n或no拒绝120 秒未回复自动拒绝。这一步能验证权限审批链路是否正常也是很多人第一次看到“微信里居然能审批工具执行”的地方。验证通过后你可以试试更实用的场景在手机微信发一句“把 ~/projects/demo 里的 README 更新一下补上安装步骤”然后关掉手机去忙别的回到电脑前看 Claude Code 是否已经改完。这才是这套方案真正的价值——把碎片时间利用起来。如果验证失败别急着重装先看日志npm run daemon -- logs日志里通常会直接告诉你卡在哪一环是长轮询没收到消息、还是 SDK 调用报错、还是模型通道返回异常。下一节按真实报错逐条排查。5. 常见报错排查401、local proxy failed、reading choices这一节按真实会遇到的报错来每条都给定位思路和修法。报错一401 Unauthorized这是最高频的。日志里出现 401基本可以锁定在 Key 上。三种可能Key 复制时带了首尾空格或换行Key 已经失效或被删除Key 填到了错误的变量名里。排查顺序是先确认变量名是ANTHROPIC_AUTH_TOKEN再确认值没有多余字符。可以用下面这条命令检查当前 shell 里实际生效的值echo $ANTHROPIC_AUTH_TOKEN | cat -Acat -A会把行尾符号显示出来如果看到$之外还有^M之类的字符说明复制时混入了 Windows 换行重新复制一遍即可。报错二local proxy failed / connection refused这个报错通常出现在 Base URL 配置上。检查两点一是地址是不是https://taotoken.net/api有没有漏掉/api二是本地网络能不能正常访问该地址。可以先用 curl 直接测通道curl -s -o /dev/null -w %{http_code}\n https://taotoken.net/api如果返回 401 或 403说明网络是通的只是没带鉴权这反而说明地址没问题如果返回连接超时或 refused那就是网络或地址写错了。注意别把官网首页地址填进 Base URL两者不是一回事。报错三reading choices / Cannot read properties of undefined这个报错说明请求发出去了但返回结构不符合预期常见原因是 Model ID 写错或者用了当前账号没有权限的模型。回到控制台复制准确的 Model ID填进ANTHROPIC_MODEL。另外要确认你用的 SDK 版本和模型接口是对齐的老版本 SDK 配新模型有时会出现字段解析失败。报错四OAuth / 登录相关提示如果你之前用官方账号登录过 Claude Code本地可能残留了 OAuth 凭据导致它优先走旧通道而不是你配的 TaoToken。处理方式是清理旧的登录状态确保环境变量或 settings 里的配置生效。可以临时把ANTHROPIC_AUTH_TOKEN显式 export 一遍再启动守护进程观察日志里实际请求的 Base URL 是哪个。报错五微信侧一直转圈日志无输出这说明消息根本没到本地进程。检查守护进程是否真的在跑npm run daemon -- status以及扫码绑定是否成功。如果绑定信息丢了重新执行npm run setup扫码即可。排查时记住一个原则先分层再定位。微信到本地是一层本地到 Claude Code 是一层Claude Code 到 TaoToken 是一层。用/status验证第一层用claude -p验证第三层中间那层看日志。分层之后问题基本跑不掉。6. 把通道固定下来长期使用与 CTA跑通一次不难难的是长期稳定。几个实用建议。第一把守护进程做成开机自启。macOS 用 launchdLinux 用 systemd项目文档里有对应配置。这样电脑重启后不用手动敲命令微信随时能派活。第二Key 和 Base URL 只维护一份。如果你同时用 Claude Code、Cline、Codex 等多个工具全部指向https://taotoken.net/apiKey 用同一个或按用途分开Model ID 各自填对。这样换模型、查用量、调额度都在一个控制台完成不用满世界找配置。第三会话持久化别关。ClawBot 支持跨消息恢复上下文关掉之后每次发消息都是新会话体验会差很多。数据文件路径在.env里的SESSION_STORE定期备份一下。第四权限审批模式按场景调。日常轻量任务可以放宽涉及文件写入、命令执行的任务保持手动审批微信里回y/n也就一秒的事。如果你还没建 Key从这里进控制台https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入过程中遇到配置问题对照文档更省时间https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想先确认模型通道是否正常可以直接在对话页试一句https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你打算长期跑编码和 Agent 任务Coding Plan 会更合适https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后回到那条链路微信发消息本地进程收Claude Code 干活结果回微信。整套东西跑在你自己电脑上不需要公网 IP不需要域名。配置里最容易出错的永远是那三件套——Base URL、Key、Model ID。把这三样对齐剩下的就是扫码、启动、发消息。