1. 微信遥控 ClaudeCode 的完整链路与 Windows 环境准备微信控制 ClaudeCode 远程打工本质是让手机微信发出的消息经过一个常驻在 Windows 开发机上的 Node.js 桥接服务转成 ClaudeCode 能理解的指令再把执行结果回传到微信。这套方案适合经常离开工位、但项目还在本机跑的人你在外面用手机发一句「帮我看看 D:\workspace\ctrl 目录下有什么」家里的 Windows 机器就真的去读文件、跑命令然后把结果发回微信。它不需要公网 IP也不需要内网穿透因为桥接服务是主动去连微信官方提供的机器人接口而不是等外部连进来。我试过把这套链路跑通核心难点不在微信侧而在 Windows 上让 Node.js 服务稳定常驻并且让 ClaudeCode 的鉴权走一条统一、可切换的通道。这里就引出 TaoToken 的作用它把模型鉴权收敛成一个统一 Key 和统一 Base URL桥接服务里只配一次后面换模型、换通道都不用改业务代码。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址固定为 https://taotoken.net/api 。在动手前先把 Windows 侧的地基打好。你需要 Node.js 18 或更高版本建议用 LTS。打开 PowerShell 验证node -v npm -v如果版本低于 18去 Node.js 官网下 LTS 安装包安装时勾选「Add to PATH」。接着确认 ClaudeCode 本体可用。ClaudeCode 是一个命令行 Agent安装方式按官方文档走装完后在终端里能直接调用claude命令。桥接服务本身不替代 ClaudeCode它只是把微信消息喂给 ClaudeCode 的 SDK所以 ClaudeCode 必须先在命令行里能独立跑起来。然后是目录规划。我习惯把桥接项目放在D:\workspace\wechat-claude-code日志和配置放在用户目录下的.wechat-claude-code。这样做的原因是 Windows 服务后面用 NSSM 注册对路径权限比较敏感放用户目录下能避免一部分权限报错。先建目录mkdir D:\workspace\wechat-claude-code mkdir $env:USERPROFILE\.wechat-claude-code\logs环境变量方面桥接服务需要读取 TaoToken 的 Key 和 Base URL。不要把这些写死在代码里而是放进配置文件后面注册成 Windows 服务时通过环境变量注入。先在 PowerShell 里临时设一下方便本地调试$env:TAOTOKEN_API_KEY你的TaoToken Key $env:TAOTOKEN_BASE_URLhttps://taotoken.net/api这里有个容易踩的坑Windows 的 PowerShell 设置的环境变量只在当前会话有效关掉窗口就没了。正式跑服务时要么写进系统环境变量要么在 NSSM 注册服务时用AppEnvironmentExtra参数注入。我建议后者因为服务化之后管理更集中。微信侧的准备相对简单你需要一个能对接微信官方机器人接口的桥接实现。excerpt 里提到的 ClawBot iLink API 是微信官方提供的机器人通道绑定后微信聊天列表里会出现一个机器人会话窗口。绑定过程通常是运行npm run setup终端会输出二维码用手机微信扫码确认。这一步不涉及任何非官方手段走的是微信官方接口所以封号风险低。扫码绑定后账号凭证会存到~/.wechat-claude-code/accounts目录后续服务启动时自动读取。把这几步做完你就有了一台能跑 Node.js、能跑 ClaudeCode、并且已经绑定微信机器人的 Windows 开发机。接下来才是把 TaoToken 的鉴权接进去让桥接服务调用模型时走统一通道。2. TaoToken 统一 Key 接入 ClaudeCode 的配置方法TaoToken 在这套链路里的定位是「统一鉴权网关」。ClaudeCode 默认会去读 Anthropic 的官方端点但在远程打工场景里你往往需要更灵活的模型切换和更集中的 Key 管理。TaoToken 提供兼容 Anthropic 的 API 格式你只要把 Base URL 指向https://taotoken.net/api把 Key 换成 TaoToken 的 KeyClaudeCode 和桥接服务就都走这条通道了。先说 Key 怎么拿。登录 TaoToken 控制台在 API Keys 页面创建一个新 Key。创建时注意权限范围远程打工场景只需要模型调用权限不需要开管理权限。创建完把 Key 复制下来它只显示一次。控制台地址走这个 deep linkhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你还没决定用哪个模型可以先在模型对话页面试一下https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 确认通道通不通再往桥接服务里配。ClaudeCode 读取配置的方式有好几种最稳的是通过环境变量。在 Windows 上你可以给 ClaudeCode 单独设一组环境变量让它走 TaoToken$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEY你的TaoToken Key $env:ANTHROPIC_MODELclaude-sonnet-4-6注意ANTHROPIC_BASE_URL后面不要带/v1TaoToken 的兼容层会自动处理路径。设完之后在终端里跑一次 ClaudeCode 的简单请求确认它能返回内容。如果返回 401说明 Key 不对或者没生效如果返回连接错误检查 Base URL 有没有写错。但桥接服务是常驻进程它不会继承你当前 PowerShell 会话的环境变量。所以更可靠的做法是把配置写进桥接项目的配置文件。excerpt 里提到的config.env位于C:\Users\你的用户名\.wechat-claude-code\config.env我们在这个文件里加上 TaoToken 相关项workingDirectoryD:\workspace\ctrl permissionModeacceptEdits systemPrompt使用中文回答 modelclaude-sonnet-4-6 ANTHROPIC_BASE_URLhttps://taotoken.net/api ANTHROPIC_API_KEY你的TaoToken Key这里有个细节config.env是桥接服务自己解析的不是系统级环境变量。所以桥接服务在启动 ClaudeCode 子进程时需要把这些值透传过去。如果你用的桥接实现是基于anthropic-ai/claude-agent-sdkSDK 初始化时会读ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY所以只要桥接服务在process.env里带上这两个值就行。可以在桥接入口文件里加一段// bridge-entry.js const fs require(fs); const path require(path); const os require(os); const configPath path.join(os.homedir(), .wechat-claude-code, config.env); const configText fs.readFileSync(configPath, utf-8); configText.split(\n).forEach(line { const trimmed line.trim(); if (!trimmed || trimmed.startsWith(#)) return; const idx trimmed.indexOf(); if (idx -1) return; const key trimmed.slice(0, idx).trim(); const value trimmed.slice(idx 1).trim(); process.env[key] value; }); console.log(TaoToken Base URL:, process.env.ANTHROPIC_BASE_URL); console.log(Model:, process.env.ANTHROPIC_MODEL || process.env.model);这段代码在服务启动最早期执行把config.env里的键值对灌进process.env后面 SDK 初始化就能读到。注意不要把 Key 打印到日志里上面只打印了 Base URL 和模型名这是安全的。如果你用的是 Claude Code 的 settings 文件方式也可以在项目根目录建.claude/settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的TaoToken Key, ANTHROPIC_MODEL: claude-sonnet-4-6 } }这种方式的优先级高于系统环境变量适合多项目隔离。但远程打工场景下桥接服务是全局的我建议还是用config.env统一管理避免每个项目目录都要放一份 settings。配好之后重启桥接服务看日志里有没有报鉴权错误。如果日志显示模型调用成功说明 TaoToken 通道已经接上了。这一步是整个链路的关键因为后面微信发指令、ClaudeCode 执行、结果回传全都依赖这条鉴权通道稳定。3. 可复制的 Node.js 桥接配置与微信消息路由桥接服务的核心职责有三个接收微信消息、把消息转成 ClaudeCode 的输入、把 ClaudeCode 的输出回传到微信。这一节给出可复制的配置和路由代码你照着改路径和 Key 就能跑。先看项目结构。在D:\workspace\wechat-claude-code下建这些文件wechat-claude-code/ ├── package.json ├── bridge-entry.js ├── message-router.js ├── claude-runner.js └── config/ └── default.jsonpackage.json里声明依赖{ name: wechat-claude-code, version: 1.0.0, main: bridge-entry.js, scripts: { start: node bridge-entry.js, setup: node setup.js }, dependencies: { anthropic-ai/claude-agent-sdk: latest, dotenv: ^16.0.0 } }bridge-entry.js负责启动服务、加载配置、注册消息处理器// bridge-entry.js const fs require(fs); const path require(path); const os require(os); const { routeMessage } require(./message-router); const configPath path.join(os.homedir(), .wechat-claude-code, config.env); if (fs.existsSync(configPath)) { const configText fs.readFileSync(configPath, utf-8); configText.split(\n).forEach(line { const trimmed line.trim(); if (!trimmed || trimmed.startsWith(#)) return; const idx trimmed.indexOf(); if (idx -1) return; process.env[trimmed.slice(0, idx).trim()] trimmed.slice(idx 1).trim(); }); } const WORK_DIR process.env.workingDirectory || D:\\workspace\\ctrl; const PERMISSION_MODE process.env.permissionMode || acceptEdits; console.log([bridge] 启动中工作目录:, WORK_DIR); console.log([bridge] 权限模式:, PERMISSION_MODE); console.log([bridge] TaoToken Base URL:, process.env.ANTHROPIC_BASE_URL); // 这里对接微信官方机器人 SDK 的消息回调 // 伪代码实际按你使用的微信机器人库替换 function onWechatMessage(userId, text) { console.log([wechat] 收到消息:, userId, text); routeMessage(userId, text).catch(err { console.error([wechat] 处理失败:, err.message); }); } module.exports { onWechatMessage };message-router.js是消息路由的核心它要处理命令、普通对话、审批回复三类消息// message-router.js const { runClaude } require(./claude-runner); const sessions new Map(); async function routeMessage(userId, text) { const trimmed text.trim(); // 命令处理 if (trimmed.startsWith(/)) { return handleCommand(userId, trimmed); } // 审批回复 if (trimmed y || trimmed n) { return handleApproval(userId, trimmed); } // 普通对话交给 ClaudeCode const session sessions.get(userId) || { cwd: process.env.workingDirectory }; const result await runClaude(session.cwd, trimmed); sessions.set(userId, session); return result; } async function handleCommand(userId, command) { const [cmd, ...args] command.split( ); switch (cmd) { case /cwd: sessions.set(userId, { cwd: args.join( ) }); return 已切换工作目录到 ${args.join( )}; case /status: return 当前模型: ${process.env.ANTHROPIC_MODEL || claude-sonnet-4-6}; case /clear: sessions.delete(userId); return 会话已清除; default: return 未知命令: ${cmd}; } } async function handleApproval(userId, answer) { // 把审批结果传给等待中的 ClaudeCode 进程 return answer y ? 已批准 : 已拒绝; } module.exports { routeMessage };claude-runner.js负责调用 ClaudeCode SDK把结果返回// claude-runner.js const { query } require(anthropic-ai/claude-agent-sdk); async function runClaude(cwd, prompt) { const messages []; for await (const message of query({ prompt, options: { cwd, permissionMode: process.env.permissionMode || acceptEdits, model: process.env.ANTHROPIC_MODEL || claude-sonnet-4-6 } })) { messages.push(message); } const last messages[messages.length - 1]; return last?.content || ClaudeCode 没有返回内容; } module.exports { runClaude };这套代码的关键点在于query调用时会读process.env.ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY所以前面bridge-entry.js里加载config.env的动作必须发生在 SDK 初始化之前。另外permissionMode设成acceptEdits时写文件自动通过执行命令仍需审批这符合远程打工的安全预期。微信消息路由的另一个重点是消息长度。微信单条消息有 2048 字限制ClaudeCode 返回长内容时会被截断。可以在claude-runner.js里加一个截断和续传逻辑function splitMessage(text, limit 2000) { const chunks []; for (let i 0; i text.length; i limit) { chunks.push(text.slice(i, i limit)); } return chunks; }返回时如果超过 2000 字先发第一段剩下的存到会话里用户发「继续」时再发下一段。这个逻辑不复杂但能显著提升远程使用的体验。配置层面config/default.json放一些非敏感的默认值{ maxMessageLength: 2000, approvalTimeoutMs: 120000, defaultModel: claude-sonnet-4-6 }敏感值全部走config.env这样即使项目目录被同步或备份Key 也不会泄露。把这几段代码拼起来桥接服务就具备了接收微信消息、路由命令、调用 ClaudeCode、返回结果的能力。下一步是验证它真的能跑通。4. 从微信发指令到 ClaudeCode 返回结果的验证请求验证要分两层先验证桥接服务本地能调用 ClaudeCode再验证微信消息能触发整条链路。不要一上来就用微信测否则出错时分不清是桥接问题还是微信问题。第一层本地验证。在D:\workspace\wechat-claude-code下开一个 PowerShell设好环境变量直接跑一个测试脚本cd D:\workspace\wechat-claude-code $env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEY你的TaoToken Key $env:ANTHROPIC_MODELclaude-sonnet-4-6 node -e const {runClaude}require(./claude-runner); runClaude(D:\\workspace\\ctrl,你好介绍一下你能做什么).then(rconsole.log(r)).catch(econsole.error(e))如果返回一段中文介绍说明 TaoToken 通道和 ClaudeCode SDK 都正常。如果报 401检查 Key如果报local proxy failed检查 Base URL 是不是写成了https://taotoken.net/api/带尾斜杠去掉尾斜杠再试如果报reading choices通常是返回体格式不对确认 TaoToken 的兼容层是否支持你选的模型。第二层微信验证。先确认桥接服务在跑cd D:\workspace\wechat-claude-code bash scripts/daemon.sh status看到Running (PID: xxxx)说明服务已启动。如果没有先bash scripts/daemon.sh start。然后在手机微信里找到绑定后的机器人会话发第一条消息你好介绍一下你能做什么正常情况你会收到 ClaudeCode 的回复同时终端日志里能看到它调用了哪些工具。如果微信没反应先看日志tail -50 $env:USERPROFILE\.wechat-claude-code\logs\stdout.log tail -50 $env:USERPROFILE\.wechat-claude-code\logs\stderr.logstdout.log里应该有[wechat] 收到消息和[bridge]相关输出。如果只有收到消息、没有后续说明runClaude卡住了多半是鉴权或网络问题。如果连收到消息都没有说明微信机器人回调没接上检查绑定状态和账号目录。接着测文件读取。在微信里发帮我看看 D:\workspace\ctrl 目录下有什么ClaudeCode 会调用文件系统工具列出目录内容并回复。这一步能验证「微信消息 → 桥接 → ClaudeCode 工具调用 → 结果回传」整条链路。如果它回复「权限不足」检查permissionMode是不是设成了planplan模式完全只读但读目录应该没问题如果设成了default所有操作都要审批你需要在微信里回复y。再测一个需要审批的操作。在微信里发在 D:\workspace\ctrl 下创建一个 test.txt内容写 hello如果permissionModeacceptEdits写文件会自动通过你直接收到成功回复。如果设成了default你会收到审批卡片 权限请求 工具: Write 输入: D:\workspace\ctrl\test.txt 回复 y 允许n 拒绝回复y后文件被创建ClaudeCode 返回结果。这一步验证了审批链路。注意 120 秒不回复会自动拒绝这是安全兜底。多项目切换也值得验证。在微信里发/cwd D:\workspace\myapp然后发这个目录下有什么ClaudeCode 会切换到新目录并读取。每个项目的会话上下文独立切换后之前的对话历史保留。这个特性在远程打工时很有用你可以在不同项目间来回切不用重新建立上下文。验证过程中如果遇到OAuth相关报错说明 ClaudeCode 在尝试走官方 OAuth 流程而不是走 TaoToken 的 Key 鉴权。检查ANTHROPIC_API_KEY是否被正确设置以及有没有其他环境变量比如CLAUDE_CODE_OAUTH_TOKEN覆盖了它。Windows 上环境变量优先级容易乱建议在桥接服务启动脚本里显式清掉无关变量。全部验证通过后你就有一条可复现的远程打工链路了手机微信发指令Windows 机器上的 ClaudeCode 执行结果回传微信。整个过程不需要公网 IP不需要内网穿透鉴权走 TaoToken 统一通道。5. 微信控制 ClaudeCode 常见报错排查与修复远程打工链路跑起来后最常见的报错集中在鉴权、网络、权限、服务稳定性四类。这一节按真实报错对照排查每条都给出可操作的修复动作。401 Unauthorized。这是鉴权失败出现在桥接服务调用模型时。先确认config.env里的ANTHROPIC_API_KEY是不是 TaoToken 的 Key而不是 Anthropic 官方的 Key。然后确认ANTHROPIC_BASE_URL是https://taotoken.net/api没有多余路径。如果 Key 刚创建等几秒再试有时候控制台同步有延迟。还有一个隐蔽原因Windows 环境变量里残留了旧的ANTHROPIC_API_KEY桥接服务读到了旧值。在 PowerShell 里跑Get-ChildItem Env: | Where-Object Name -like *ANTHROPIC*看看有没有冲突项有就清掉。local proxy failed。这个报错通常出现在 Base URL 配置错误或网络不通时。先确认https://taotoken.net/api在浏览器或 curl 里能访问curl https://taotoken.net/api如果 curl 报连接超时检查本机网络和 DNS。如果 curl 正常但桥接服务报错检查桥接服务是不是在代理环境下运行。Windows 服务默认不继承用户级代理设置如果你之前设过HTTP_PROXY在服务里可能读不到导致连接失败。解决办法是在config.env里显式不设代理或者把代理配置也写进去。reading choices 报错。这个报错说明返回体解析失败通常是模型返回格式和 SDK 预期不一致。先确认ANTHROPIC_MODEL设的是 TaoToken 支持的模型 ID比如claude-sonnet-4-6。如果模型 ID 写错TaoToken 可能返回一个错误结构SDK 解析时就报reading choices。另外检查config.env里有没有多余空格比如ANTHROPIC_MODELclaude-sonnet-4-6末尾带空格会导致模型 ID 不匹配。OAuth 相关报错。如果日志里出现OAuth或oauth token说明 ClaudeCode 在尝试走官方 OAuth 流程。这通常是因为ANTHROPIC_API_KEY没设或者被其他变量覆盖。在桥接服务启动时显式设置process.env.ANTHROPIC_API_KEY process.env.ANTHROPIC_API_KEY || ; delete process.env.CLAUDE_CODE_OAUTH_TOKEN;把无关的 OAuth 变量删掉强制走 Key 鉴权。微信发消息无响应。先跑bash scripts/daemon.sh status看服务在不在。如果服务在跑但没响应看stderr.log有没有崩溃堆栈。常见原因是 Node.js 版本太低SDK 用了新语法。升级到 Node.js 18 再试。另一个原因是微信机器人绑定过期重新跑npm run setup扫码绑定。服务频繁崩溃。看stderr.log里的错误类型。如果是内存溢出检查是不是会话历史无限增长可以在message-router.js里加一个历史长度限制超过 50 条就清理最早的。如果是未捕获异常在bridge-entry.js里加全局兜底process.on(uncaughtException, err { console.error([bridge] 未捕获异常:, err); }); process.on(unhandledRejection, err { console.error([bridge] 未处理 Promise 拒绝:, err); });这样即使某个请求出错服务也不会整个挂掉。Claude 回复被截断。微信单条消息 2048 字限制超过就截断。这是正常现象不是 bug。解决办法是在桥接层做分片超过 2000 字先发第一段用户发「继续」时发下一段。前面splitMessage函数就是干这个的。权限审批超时。审批卡片 120 秒不回复自动拒绝。如果你在忙可以先把permissionMode设成acceptEdits写文件自动通过只有执行命令才需要审批。如果连命令审批都不想等可以设成auto但这只建议在完全信任的场景用公共场合不要开。多项目切换后上下文丢失。检查sessionsMap 是不是按userId存的。如果按项目存切换后旧项目的上下文就找不到了。正确做法是按用户存每个用户维护自己的当前工作目录和会话历史。日志文件太大。stdout.log和stderr.log会一直增长。可以加一个日志轮转或者定期清理# 保留最近 7 天日志 Get-ChildItem $env:USERPROFILE\.wechat-claude-code\logs\*.log | Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-7) } | Remove-Item把这些排查动作过一遍大部分远程打工链路的问题都能定位。关键是养成看日志的习惯stdout.log看正常流程stderr.log看错误堆栈两个对照着看问题基本跑不掉。6. 长期远程编码的 TaoToken 通道与 Coding Plan 选择链路跑通之后接下来要考虑的是长期使用的成本和稳定性。远程打工不是一次性任务你可能连续几周每天用微信发几十条指令这时候鉴权通道的稳定性和额度管理就很重要。TaoToken 的 Coding Plan 适合长期编码和 Agent 场景。它把模型调用额度打包你不用每次单独充值也不用担心 Key 过期。对于微信控制 ClaudeCode 这种高频、长会话的场景Coding Plan 比按次调用更划算。入口在这里https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。开通后把 Coding Plan 对应的 Key 填进config.env的ANTHROPIC_API_KEY桥接服务不用改任何代码直接就能用。如果你还在调试阶段不确定用哪个模型可以先用模型对话页面测试不同模型的效果和响应速度https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。测好之后再把模型 ID 写进config.env。API Keys 管理页面在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 你可以为桥接服务单独创建一个 Key方便后续轮换和吊销。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有兼容 Anthropic 格式的详细说明包括 Base URL 路径、请求头、错误码。遇到鉴权问题时对照文档排查比盲目试错快得多。如果你用的是 Claude Code 的 Anthropic 兼容模式可以参考这个入口https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它说明了怎么把 Claude Code 的请求指向 TaoToken和前面config.env的配法一致但文档里有一些边界情况的处理比如流式响应、超时重试值得读一遍。长期使用还有几个实践建议。第一Key 定期轮换比如每个月换一次旧 Key 在控制台吊销。第二config.env不要提交到 Git如果项目要版本管理把config.env加进.gitignore。第三日志里不要打印 Key前面bridge-entry.js只打印 Base URL 和模型名这是安全的。第四如果多台机器共用一套 Key给每台机器单独建 Key方便追踪用量和吊销。远程打工链路的稳定性还依赖 Windows 服务的自启和崩溃重启。用 NSSM 把桥接服务注册成 Windows 服务nssm install WechatClaudeCode C:\Program Files\nodejs\node.exe D:\workspace\wechat-claude-code\bridge-entry.js nssm set WechatClaudeCode AppDirectory D:\workspace\wechat-claude-code nssm set WechatClaudeCode AppEnvironmentExtra ANTHROPIC_BASE_URLhttps://taotoken.net/api ANTHROPIC_API_KEY你的Key nssm set WechatClaudeCode Start SERVICE_AUTO_START nssm start WechatClaudeCode这样开机自启崩溃后 NSSM 会自动重启。配合 TaoToken 的稳定通道你就能长期用微信遥控 ClaudeCode 干活了。最后提醒一句不要在微信里发密码、API Key、Token 等敏感信息消息会经过微信服务器和模型服务商。保持acceptEdits模式公共场合不要开auto。需要暂停服务时跑bash scripts/daemon.sh stop需要时再start。
微信控制ClaudeCode远程打工指南：TaoToken统一Key接入与Windows Node.js验证
1. 微信遥控 ClaudeCode 的完整链路与 Windows 环境准备微信控制 ClaudeCode 远程打工本质是让手机微信发出的消息经过一个常驻在 Windows 开发机上的 Node.js 桥接服务转成 ClaudeCode 能理解的指令再把执行结果回传到微信。这套方案适合经常离开工位、但项目还在本机跑的人你在外面用手机发一句「帮我看看 D:\workspace\ctrl 目录下有什么」家里的 Windows 机器就真的去读文件、跑命令然后把结果发回微信。它不需要公网 IP也不需要内网穿透因为桥接服务是主动去连微信官方提供的机器人接口而不是等外部连进来。我试过把这套链路跑通核心难点不在微信侧而在 Windows 上让 Node.js 服务稳定常驻并且让 ClaudeCode 的鉴权走一条统一、可切换的通道。这里就引出 TaoToken 的作用它把模型鉴权收敛成一个统一 Key 和统一 Base URL桥接服务里只配一次后面换模型、换通道都不用改业务代码。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址固定为 https://taotoken.net/api 。在动手前先把 Windows 侧的地基打好。你需要 Node.js 18 或更高版本建议用 LTS。打开 PowerShell 验证node -v npm -v如果版本低于 18去 Node.js 官网下 LTS 安装包安装时勾选「Add to PATH」。接着确认 ClaudeCode 本体可用。ClaudeCode 是一个命令行 Agent安装方式按官方文档走装完后在终端里能直接调用claude命令。桥接服务本身不替代 ClaudeCode它只是把微信消息喂给 ClaudeCode 的 SDK所以 ClaudeCode 必须先在命令行里能独立跑起来。然后是目录规划。我习惯把桥接项目放在D:\workspace\wechat-claude-code日志和配置放在用户目录下的.wechat-claude-code。这样做的原因是 Windows 服务后面用 NSSM 注册对路径权限比较敏感放用户目录下能避免一部分权限报错。先建目录mkdir D:\workspace\wechat-claude-code mkdir $env:USERPROFILE\.wechat-claude-code\logs环境变量方面桥接服务需要读取 TaoToken 的 Key 和 Base URL。不要把这些写死在代码里而是放进配置文件后面注册成 Windows 服务时通过环境变量注入。先在 PowerShell 里临时设一下方便本地调试$env:TAOTOKEN_API_KEY你的TaoToken Key $env:TAOTOKEN_BASE_URLhttps://taotoken.net/api这里有个容易踩的坑Windows 的 PowerShell 设置的环境变量只在当前会话有效关掉窗口就没了。正式跑服务时要么写进系统环境变量要么在 NSSM 注册服务时用AppEnvironmentExtra参数注入。我建议后者因为服务化之后管理更集中。微信侧的准备相对简单你需要一个能对接微信官方机器人接口的桥接实现。excerpt 里提到的 ClawBot iLink API 是微信官方提供的机器人通道绑定后微信聊天列表里会出现一个机器人会话窗口。绑定过程通常是运行npm run setup终端会输出二维码用手机微信扫码确认。这一步不涉及任何非官方手段走的是微信官方接口所以封号风险低。扫码绑定后账号凭证会存到~/.wechat-claude-code/accounts目录后续服务启动时自动读取。把这几步做完你就有了一台能跑 Node.js、能跑 ClaudeCode、并且已经绑定微信机器人的 Windows 开发机。接下来才是把 TaoToken 的鉴权接进去让桥接服务调用模型时走统一通道。2. TaoToken 统一 Key 接入 ClaudeCode 的配置方法TaoToken 在这套链路里的定位是「统一鉴权网关」。ClaudeCode 默认会去读 Anthropic 的官方端点但在远程打工场景里你往往需要更灵活的模型切换和更集中的 Key 管理。TaoToken 提供兼容 Anthropic 的 API 格式你只要把 Base URL 指向https://taotoken.net/api把 Key 换成 TaoToken 的 KeyClaudeCode 和桥接服务就都走这条通道了。先说 Key 怎么拿。登录 TaoToken 控制台在 API Keys 页面创建一个新 Key。创建时注意权限范围远程打工场景只需要模型调用权限不需要开管理权限。创建完把 Key 复制下来它只显示一次。控制台地址走这个 deep linkhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你还没决定用哪个模型可以先在模型对话页面试一下https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 确认通道通不通再往桥接服务里配。ClaudeCode 读取配置的方式有好几种最稳的是通过环境变量。在 Windows 上你可以给 ClaudeCode 单独设一组环境变量让它走 TaoToken$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEY你的TaoToken Key $env:ANTHROPIC_MODELclaude-sonnet-4-6注意ANTHROPIC_BASE_URL后面不要带/v1TaoToken 的兼容层会自动处理路径。设完之后在终端里跑一次 ClaudeCode 的简单请求确认它能返回内容。如果返回 401说明 Key 不对或者没生效如果返回连接错误检查 Base URL 有没有写错。但桥接服务是常驻进程它不会继承你当前 PowerShell 会话的环境变量。所以更可靠的做法是把配置写进桥接项目的配置文件。excerpt 里提到的config.env位于C:\Users\你的用户名\.wechat-claude-code\config.env我们在这个文件里加上 TaoToken 相关项workingDirectoryD:\workspace\ctrl permissionModeacceptEdits systemPrompt使用中文回答 modelclaude-sonnet-4-6 ANTHROPIC_BASE_URLhttps://taotoken.net/api ANTHROPIC_API_KEY你的TaoToken Key这里有个细节config.env是桥接服务自己解析的不是系统级环境变量。所以桥接服务在启动 ClaudeCode 子进程时需要把这些值透传过去。如果你用的桥接实现是基于anthropic-ai/claude-agent-sdkSDK 初始化时会读ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY所以只要桥接服务在process.env里带上这两个值就行。可以在桥接入口文件里加一段// bridge-entry.js const fs require(fs); const path require(path); const os require(os); const configPath path.join(os.homedir(), .wechat-claude-code, config.env); const configText fs.readFileSync(configPath, utf-8); configText.split(\n).forEach(line { const trimmed line.trim(); if (!trimmed || trimmed.startsWith(#)) return; const idx trimmed.indexOf(); if (idx -1) return; const key trimmed.slice(0, idx).trim(); const value trimmed.slice(idx 1).trim(); process.env[key] value; }); console.log(TaoToken Base URL:, process.env.ANTHROPIC_BASE_URL); console.log(Model:, process.env.ANTHROPIC_MODEL || process.env.model);这段代码在服务启动最早期执行把config.env里的键值对灌进process.env后面 SDK 初始化就能读到。注意不要把 Key 打印到日志里上面只打印了 Base URL 和模型名这是安全的。如果你用的是 Claude Code 的 settings 文件方式也可以在项目根目录建.claude/settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的TaoToken Key, ANTHROPIC_MODEL: claude-sonnet-4-6 } }这种方式的优先级高于系统环境变量适合多项目隔离。但远程打工场景下桥接服务是全局的我建议还是用config.env统一管理避免每个项目目录都要放一份 settings。配好之后重启桥接服务看日志里有没有报鉴权错误。如果日志显示模型调用成功说明 TaoToken 通道已经接上了。这一步是整个链路的关键因为后面微信发指令、ClaudeCode 执行、结果回传全都依赖这条鉴权通道稳定。3. 可复制的 Node.js 桥接配置与微信消息路由桥接服务的核心职责有三个接收微信消息、把消息转成 ClaudeCode 的输入、把 ClaudeCode 的输出回传到微信。这一节给出可复制的配置和路由代码你照着改路径和 Key 就能跑。先看项目结构。在D:\workspace\wechat-claude-code下建这些文件wechat-claude-code/ ├── package.json ├── bridge-entry.js ├── message-router.js ├── claude-runner.js └── config/ └── default.jsonpackage.json里声明依赖{ name: wechat-claude-code, version: 1.0.0, main: bridge-entry.js, scripts: { start: node bridge-entry.js, setup: node setup.js }, dependencies: { anthropic-ai/claude-agent-sdk: latest, dotenv: ^16.0.0 } }bridge-entry.js负责启动服务、加载配置、注册消息处理器// bridge-entry.js const fs require(fs); const path require(path); const os require(os); const { routeMessage } require(./message-router); const configPath path.join(os.homedir(), .wechat-claude-code, config.env); if (fs.existsSync(configPath)) { const configText fs.readFileSync(configPath, utf-8); configText.split(\n).forEach(line { const trimmed line.trim(); if (!trimmed || trimmed.startsWith(#)) return; const idx trimmed.indexOf(); if (idx -1) return; process.env[trimmed.slice(0, idx).trim()] trimmed.slice(idx 1).trim(); }); } const WORK_DIR process.env.workingDirectory || D:\\workspace\\ctrl; const PERMISSION_MODE process.env.permissionMode || acceptEdits; console.log([bridge] 启动中工作目录:, WORK_DIR); console.log([bridge] 权限模式:, PERMISSION_MODE); console.log([bridge] TaoToken Base URL:, process.env.ANTHROPIC_BASE_URL); // 这里对接微信官方机器人 SDK 的消息回调 // 伪代码实际按你使用的微信机器人库替换 function onWechatMessage(userId, text) { console.log([wechat] 收到消息:, userId, text); routeMessage(userId, text).catch(err { console.error([wechat] 处理失败:, err.message); }); } module.exports { onWechatMessage };message-router.js是消息路由的核心它要处理命令、普通对话、审批回复三类消息// message-router.js const { runClaude } require(./claude-runner); const sessions new Map(); async function routeMessage(userId, text) { const trimmed text.trim(); // 命令处理 if (trimmed.startsWith(/)) { return handleCommand(userId, trimmed); } // 审批回复 if (trimmed y || trimmed n) { return handleApproval(userId, trimmed); } // 普通对话交给 ClaudeCode const session sessions.get(userId) || { cwd: process.env.workingDirectory }; const result await runClaude(session.cwd, trimmed); sessions.set(userId, session); return result; } async function handleCommand(userId, command) { const [cmd, ...args] command.split( ); switch (cmd) { case /cwd: sessions.set(userId, { cwd: args.join( ) }); return 已切换工作目录到 ${args.join( )}; case /status: return 当前模型: ${process.env.ANTHROPIC_MODEL || claude-sonnet-4-6}; case /clear: sessions.delete(userId); return 会话已清除; default: return 未知命令: ${cmd}; } } async function handleApproval(userId, answer) { // 把审批结果传给等待中的 ClaudeCode 进程 return answer y ? 已批准 : 已拒绝; } module.exports { routeMessage };claude-runner.js负责调用 ClaudeCode SDK把结果返回// claude-runner.js const { query } require(anthropic-ai/claude-agent-sdk); async function runClaude(cwd, prompt) { const messages []; for await (const message of query({ prompt, options: { cwd, permissionMode: process.env.permissionMode || acceptEdits, model: process.env.ANTHROPIC_MODEL || claude-sonnet-4-6 } })) { messages.push(message); } const last messages[messages.length - 1]; return last?.content || ClaudeCode 没有返回内容; } module.exports { runClaude };这套代码的关键点在于query调用时会读process.env.ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY所以前面bridge-entry.js里加载config.env的动作必须发生在 SDK 初始化之前。另外permissionMode设成acceptEdits时写文件自动通过执行命令仍需审批这符合远程打工的安全预期。微信消息路由的另一个重点是消息长度。微信单条消息有 2048 字限制ClaudeCode 返回长内容时会被截断。可以在claude-runner.js里加一个截断和续传逻辑function splitMessage(text, limit 2000) { const chunks []; for (let i 0; i text.length; i limit) { chunks.push(text.slice(i, i limit)); } return chunks; }返回时如果超过 2000 字先发第一段剩下的存到会话里用户发「继续」时再发下一段。这个逻辑不复杂但能显著提升远程使用的体验。配置层面config/default.json放一些非敏感的默认值{ maxMessageLength: 2000, approvalTimeoutMs: 120000, defaultModel: claude-sonnet-4-6 }敏感值全部走config.env这样即使项目目录被同步或备份Key 也不会泄露。把这几段代码拼起来桥接服务就具备了接收微信消息、路由命令、调用 ClaudeCode、返回结果的能力。下一步是验证它真的能跑通。4. 从微信发指令到 ClaudeCode 返回结果的验证请求验证要分两层先验证桥接服务本地能调用 ClaudeCode再验证微信消息能触发整条链路。不要一上来就用微信测否则出错时分不清是桥接问题还是微信问题。第一层本地验证。在D:\workspace\wechat-claude-code下开一个 PowerShell设好环境变量直接跑一个测试脚本cd D:\workspace\wechat-claude-code $env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEY你的TaoToken Key $env:ANTHROPIC_MODELclaude-sonnet-4-6 node -e const {runClaude}require(./claude-runner); runClaude(D:\\workspace\\ctrl,你好介绍一下你能做什么).then(rconsole.log(r)).catch(econsole.error(e))如果返回一段中文介绍说明 TaoToken 通道和 ClaudeCode SDK 都正常。如果报 401检查 Key如果报local proxy failed检查 Base URL 是不是写成了https://taotoken.net/api/带尾斜杠去掉尾斜杠再试如果报reading choices通常是返回体格式不对确认 TaoToken 的兼容层是否支持你选的模型。第二层微信验证。先确认桥接服务在跑cd D:\workspace\wechat-claude-code bash scripts/daemon.sh status看到Running (PID: xxxx)说明服务已启动。如果没有先bash scripts/daemon.sh start。然后在手机微信里找到绑定后的机器人会话发第一条消息你好介绍一下你能做什么正常情况你会收到 ClaudeCode 的回复同时终端日志里能看到它调用了哪些工具。如果微信没反应先看日志tail -50 $env:USERPROFILE\.wechat-claude-code\logs\stdout.log tail -50 $env:USERPROFILE\.wechat-claude-code\logs\stderr.logstdout.log里应该有[wechat] 收到消息和[bridge]相关输出。如果只有收到消息、没有后续说明runClaude卡住了多半是鉴权或网络问题。如果连收到消息都没有说明微信机器人回调没接上检查绑定状态和账号目录。接着测文件读取。在微信里发帮我看看 D:\workspace\ctrl 目录下有什么ClaudeCode 会调用文件系统工具列出目录内容并回复。这一步能验证「微信消息 → 桥接 → ClaudeCode 工具调用 → 结果回传」整条链路。如果它回复「权限不足」检查permissionMode是不是设成了planplan模式完全只读但读目录应该没问题如果设成了default所有操作都要审批你需要在微信里回复y。再测一个需要审批的操作。在微信里发在 D:\workspace\ctrl 下创建一个 test.txt内容写 hello如果permissionModeacceptEdits写文件会自动通过你直接收到成功回复。如果设成了default你会收到审批卡片 权限请求 工具: Write 输入: D:\workspace\ctrl\test.txt 回复 y 允许n 拒绝回复y后文件被创建ClaudeCode 返回结果。这一步验证了审批链路。注意 120 秒不回复会自动拒绝这是安全兜底。多项目切换也值得验证。在微信里发/cwd D:\workspace\myapp然后发这个目录下有什么ClaudeCode 会切换到新目录并读取。每个项目的会话上下文独立切换后之前的对话历史保留。这个特性在远程打工时很有用你可以在不同项目间来回切不用重新建立上下文。验证过程中如果遇到OAuth相关报错说明 ClaudeCode 在尝试走官方 OAuth 流程而不是走 TaoToken 的 Key 鉴权。检查ANTHROPIC_API_KEY是否被正确设置以及有没有其他环境变量比如CLAUDE_CODE_OAUTH_TOKEN覆盖了它。Windows 上环境变量优先级容易乱建议在桥接服务启动脚本里显式清掉无关变量。全部验证通过后你就有一条可复现的远程打工链路了手机微信发指令Windows 机器上的 ClaudeCode 执行结果回传微信。整个过程不需要公网 IP不需要内网穿透鉴权走 TaoToken 统一通道。5. 微信控制 ClaudeCode 常见报错排查与修复远程打工链路跑起来后最常见的报错集中在鉴权、网络、权限、服务稳定性四类。这一节按真实报错对照排查每条都给出可操作的修复动作。401 Unauthorized。这是鉴权失败出现在桥接服务调用模型时。先确认config.env里的ANTHROPIC_API_KEY是不是 TaoToken 的 Key而不是 Anthropic 官方的 Key。然后确认ANTHROPIC_BASE_URL是https://taotoken.net/api没有多余路径。如果 Key 刚创建等几秒再试有时候控制台同步有延迟。还有一个隐蔽原因Windows 环境变量里残留了旧的ANTHROPIC_API_KEY桥接服务读到了旧值。在 PowerShell 里跑Get-ChildItem Env: | Where-Object Name -like *ANTHROPIC*看看有没有冲突项有就清掉。local proxy failed。这个报错通常出现在 Base URL 配置错误或网络不通时。先确认https://taotoken.net/api在浏览器或 curl 里能访问curl https://taotoken.net/api如果 curl 报连接超时检查本机网络和 DNS。如果 curl 正常但桥接服务报错检查桥接服务是不是在代理环境下运行。Windows 服务默认不继承用户级代理设置如果你之前设过HTTP_PROXY在服务里可能读不到导致连接失败。解决办法是在config.env里显式不设代理或者把代理配置也写进去。reading choices 报错。这个报错说明返回体解析失败通常是模型返回格式和 SDK 预期不一致。先确认ANTHROPIC_MODEL设的是 TaoToken 支持的模型 ID比如claude-sonnet-4-6。如果模型 ID 写错TaoToken 可能返回一个错误结构SDK 解析时就报reading choices。另外检查config.env里有没有多余空格比如ANTHROPIC_MODELclaude-sonnet-4-6末尾带空格会导致模型 ID 不匹配。OAuth 相关报错。如果日志里出现OAuth或oauth token说明 ClaudeCode 在尝试走官方 OAuth 流程。这通常是因为ANTHROPIC_API_KEY没设或者被其他变量覆盖。在桥接服务启动时显式设置process.env.ANTHROPIC_API_KEY process.env.ANTHROPIC_API_KEY || ; delete process.env.CLAUDE_CODE_OAUTH_TOKEN;把无关的 OAuth 变量删掉强制走 Key 鉴权。微信发消息无响应。先跑bash scripts/daemon.sh status看服务在不在。如果服务在跑但没响应看stderr.log有没有崩溃堆栈。常见原因是 Node.js 版本太低SDK 用了新语法。升级到 Node.js 18 再试。另一个原因是微信机器人绑定过期重新跑npm run setup扫码绑定。服务频繁崩溃。看stderr.log里的错误类型。如果是内存溢出检查是不是会话历史无限增长可以在message-router.js里加一个历史长度限制超过 50 条就清理最早的。如果是未捕获异常在bridge-entry.js里加全局兜底process.on(uncaughtException, err { console.error([bridge] 未捕获异常:, err); }); process.on(unhandledRejection, err { console.error([bridge] 未处理 Promise 拒绝:, err); });这样即使某个请求出错服务也不会整个挂掉。Claude 回复被截断。微信单条消息 2048 字限制超过就截断。这是正常现象不是 bug。解决办法是在桥接层做分片超过 2000 字先发第一段用户发「继续」时发下一段。前面splitMessage函数就是干这个的。权限审批超时。审批卡片 120 秒不回复自动拒绝。如果你在忙可以先把permissionMode设成acceptEdits写文件自动通过只有执行命令才需要审批。如果连命令审批都不想等可以设成auto但这只建议在完全信任的场景用公共场合不要开。多项目切换后上下文丢失。检查sessionsMap 是不是按userId存的。如果按项目存切换后旧项目的上下文就找不到了。正确做法是按用户存每个用户维护自己的当前工作目录和会话历史。日志文件太大。stdout.log和stderr.log会一直增长。可以加一个日志轮转或者定期清理# 保留最近 7 天日志 Get-ChildItem $env:USERPROFILE\.wechat-claude-code\logs\*.log | Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-7) } | Remove-Item把这些排查动作过一遍大部分远程打工链路的问题都能定位。关键是养成看日志的习惯stdout.log看正常流程stderr.log看错误堆栈两个对照着看问题基本跑不掉。6. 长期远程编码的 TaoToken 通道与 Coding Plan 选择链路跑通之后接下来要考虑的是长期使用的成本和稳定性。远程打工不是一次性任务你可能连续几周每天用微信发几十条指令这时候鉴权通道的稳定性和额度管理就很重要。TaoToken 的 Coding Plan 适合长期编码和 Agent 场景。它把模型调用额度打包你不用每次单独充值也不用担心 Key 过期。对于微信控制 ClaudeCode 这种高频、长会话的场景Coding Plan 比按次调用更划算。入口在这里https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。开通后把 Coding Plan 对应的 Key 填进config.env的ANTHROPIC_API_KEY桥接服务不用改任何代码直接就能用。如果你还在调试阶段不确定用哪个模型可以先用模型对话页面测试不同模型的效果和响应速度https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。测好之后再把模型 ID 写进config.env。API Keys 管理页面在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 你可以为桥接服务单独创建一个 Key方便后续轮换和吊销。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有兼容 Anthropic 格式的详细说明包括 Base URL 路径、请求头、错误码。遇到鉴权问题时对照文档排查比盲目试错快得多。如果你用的是 Claude Code 的 Anthropic 兼容模式可以参考这个入口https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它说明了怎么把 Claude Code 的请求指向 TaoToken和前面config.env的配法一致但文档里有一些边界情况的处理比如流式响应、超时重试值得读一遍。长期使用还有几个实践建议。第一Key 定期轮换比如每个月换一次旧 Key 在控制台吊销。第二config.env不要提交到 Git如果项目要版本管理把config.env加进.gitignore。第三日志里不要打印 Key前面bridge-entry.js只打印 Base URL 和模型名这是安全的。第四如果多台机器共用一套 Key给每台机器单独建 Key方便追踪用量和吊销。远程打工链路的稳定性还依赖 Windows 服务的自启和崩溃重启。用 NSSM 把桥接服务注册成 Windows 服务nssm install WechatClaudeCode C:\Program Files\nodejs\node.exe D:\workspace\wechat-claude-code\bridge-entry.js nssm set WechatClaudeCode AppDirectory D:\workspace\wechat-claude-code nssm set WechatClaudeCode AppEnvironmentExtra ANTHROPIC_BASE_URLhttps://taotoken.net/api ANTHROPIC_API_KEY你的Key nssm set WechatClaudeCode Start SERVICE_AUTO_START nssm start WechatClaudeCode这样开机自启崩溃后 NSSM 会自动重启。配合 TaoToken 的稳定通道你就能长期用微信遥控 ClaudeCode 干活了。最后提醒一句不要在微信里发密码、API Key、Token 等敏感信息消息会经过微信服务器和模型服务商。保持acceptEdits模式公共场合不要开auto。需要暂停服务时跑bash scripts/daemon.sh stop需要时再start。
