1. 为什么要在微信里遥控 Claude Code先说清楚这套方案到底解决什么问题。你有一台常开的电脑上面装着 Claude Code平时写代码、跑测试、改 Bug 都靠它。但人不可能一直坐在电脑前出门在外、躺沙发上、开会间隙突然想起某个项目要改一行配置、跑一次构建、看一段日志这时候掏出手机发条微信就能让电脑上的 Claude Code 干活比远程桌面舒服得多。xacpx 就是干这个的桥接层。它是一个 Node.js 程序跑在你的电脑上一头通过微信官方的 Bot 接口长轮询收消息另一头通过 acpxAgent Client Protocol把消息转给 Claude Code再把执行结果回传到微信。整条链路是手机微信 → 微信 Bot 服务器 → 你电脑上的 xacpx → Claude Code → 原路返回。但这里有个容易被忽略的坑当你同时用 Claude Code、Codex、Gemini CLI 好几个工具时每个工具都要单独配 Key改一处忘一处排查起来很烦。这篇的做法是用 TaoToken 做统一入口一份 Key 覆盖多个工具settings.json 和 config.toml 各写一次就行。下面从环境准备一路写到微信里发指令跑通每一步都能照着做。适合谁看本机已经能跑 Claude Code、想用手机远程下指令的开发者被多工具 Key 分散折磨过、想统一管理的人对 Node.js 桥接服务感兴趣、想搞懂 acpx 协议链路的人。2. 前置准备TaoToken 统一 Key 与运行环境2.1 为什么用 TaoToken 统一 KeyClaude Code 默认读~/.claude/settings.jsonCodex 读~/.codex/config.tomlGemini CLI 又有自己的一套。三个工具三份配置Key 一多就容易乱。TaoToken 提供统一的 API 入口你只需要在官网拿到一个 Key然后把它填进各个工具的配置文件里指向同一个 API 地址即可。这样换 Key、加额度、排查调用问题都只在一个地方处理。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。注意 API 地址不带 UTM 参数配置里写干净的就行。2.2 环境清单动手前确认这几样都到位Node.js 22 或更高版本终端执行node --version应输出 v22.x.x 以上。Claude Code 已安装并能正常跑claude --version有输出。npm 随 Node.js 一起装好npm --version能显示版本号。一台常开有网的电脑Windows 或 macOS 都行。手机装好微信。注意xacpx 只是桥梁它本身不提供 AI 能力。电脑上必须先能正常使用 Claude Code桥接才有意义。2.3 获取 TaoToken Key登录 TaoToken 控制台在 API Keys 页面创建一个新 Key复制保存。这个 Key 后面要填进 settings.json 和 config.toml。控制台地址走这个 deep linkhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。如果你还没决定用哪个模型可以先在模型对话页面试一下调用是否通https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。长期跑编码任务、想省心管理额度的可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。3. 可复制配置settings.json 与 config.toml 骨架3.1 Claude Code 的 settings.jsonClaude Code 的配置文件在~/.claude/settings.jsonWindows 是C:\Users\你的用户名\.claude\settings.json。用 TaoToken 统一 Key 的骨架如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的_TaoToken_Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [], deny: [] } }关键字段说明ANTHROPIC_BASE_URL指向 TaoToken 的 API 基址ANTHROPIC_AUTH_TOKEN填你刚创建的 KeyANTHROPIC_MODEL按你实际要用的模型名填。改完保存重启 Claude Code 生效。3.2 Codex 的 config.tomlCodex 的配置在~/.codex/config.toml。用同一份 TaoToken Key 的骨架model gpt-5-codex model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY [model_providers.taotoken.headers] Authorization Bearer 你的_TaoToken_Key这里把 provider 指向 TaoTokenenv_key是可选的环境变量方式你也可以直接在 headers 里写死 Key。两种方式选一种别重复。3.3 验证配置是否生效配置写完先别急着装 xacpx单独验证 Claude Code 能不能通claude --version claude -p 回复一句配置成功如果第二条命令能正常返回文本说明 TaoToken 的 Key 和地址都对了。这一步不通后面桥接一定失败先在这里排掉。4. 安装 xacpx 并桥接微信4.1 安装 xacpx终端执行npm install -g ganglion/xacpx --registryhttps://registry.npmjs.org装完验证xacpx version输出版本号就说明装好了。如果提示命令找不到检查 npm 全局路径是否在 PATH 里Windows 通常是C:\Users\你的用户名\AppData\Roaming\npm。4.2 注册工作区工作区就是你电脑上的项目文件夹提前注册好微信里用名字引用就行cd /你的/项目/绝对路径 xacpx workspace add my-project xacpx workspace list路径必须是绝对路径/home/me/project或C:\Users\me\project这种别用相对路径。4.3 确认 Agent 已注册xacpx agent list应该能看到claude driver: claude。如果没看到用xacpx agent add claude补上。4.4 登录微信xacpx login终端会打印二维码用手机微信扫一扫确认登录。如果二维码显示乱掉把终端窗口拉宽再试。登录成功后token 和 userId 会存在~/.xacpx/目录下只在本机不上传。4.5 启动服务xacpx start xacpx statusstatus显示运行中、有 PID、有日志路径就对了。调试阶段可以用xacpx run前台跑日志直接打屏幕上方便看问题。5. 验证请求从微信发指令到本机执行5.1 创建会话在微信里找到扫码后新增的 Bot 联系人发/ss claude --ws my-project这条命令创建一个会话用 my-project 这个工作区Agent 选 Claude Code。成功后会收到会话已创建的回复。5.2 发第一条真实指令之后发非斜杠开头的消息都会直接转给 Claude Code看一下这个项目的入口文件在哪里把路径告诉我Claude Code 会在你电脑上实际执行回复流式发到微信。到这一步整条链路就通了微信消息 → xacpx → acpx → Claude Code → 回传微信。5.3 调整回复模式默认是 verbose流式文本加工具调用都显示。想只看结果/replymode final想只看流式文本/replymode stream5.4 安全权限控制人不在电脑前时建议限制 AI 的操作范围/pm set read只允许读文件不允许写和执行。要完全放开再/pm set allow要禁止所有工具操作用/pm set deny。5.5 取消与切换任务跑太久想停/cancel。多个项目之间切换/ss列出所有会话/use my-project:claude切过去。6. 本篇常见错排查6.1 xacpx 命令找不到先看全局安装路径在不在 PATHnpm root -g npm list -g --depth0Windows 用户确认C:\Users\你的用户名\AppData\Roaming\npm在环境变量里。macOS 用户确认/usr/local/bin或 npm 的 bin 目录在 PATH。6.2 扫码后登录失败报登录失败: timeout通常是网络问题或者二维码过期。重新xacpx login再扫一次。必须用微信扫其他 App 扫无效。6.3 /ss 创建会话失败按顺序排查先确认claude --version本身能跑再确认路径是绝对路径且存在ls /你的/项目/路径能列出内容最后看日志cat ~/.xacpx/runtime/app.log日志里一般会写明是 Agent 启动失败还是路径不对。6.4 微信收不到回复xacpx status确认服务在跑、登录状态还在。如果 Bot 掉线重新xacpx login然后xacpx restart。改了配置一定要重启才生效。6.5 Windows 路径写法微信里发路径正斜杠反斜杠都行/ss claude -d C:/Users/me/my-project /ss claude -d C:\Users\me\my-project两种都能识别不用纠结。6.6 想完全重装xacpx stop xacpx logout rm -rf ~/.xacpx npm uninstall -g ganglion/xacpx npm install -g ganglion/xacpx --registryhttps://registry.npmjs.org xacpx login xacpx start7. 继续深入与 Key 管理建议跑通之后日常最省心的做法是把 TaoToken 的 Key 集中管理Claude Code 的 settings.json、Codex 的 config.toml 都指向同一个 API 基址换 Key 时只改一处不用满电脑找配置文件。如果你还要接更多工具接入文档里有各客户端的配置示例https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。用 Claude Code 的可以看 Anthropic 接入说明https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 。Key 的创建和管理在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。一个实测下来的小技巧xacpx 的/pm set read配合定时任务/lt可以让你在通勤路上发一条「两小时后检查 CI 是否通过」到点自动跑结果推回微信比一直盯着电脑省事。权限模式记得按场景切别长期挂在 allow 上。
1. 为什么要在微信里遥控 Claude Code先说清楚这套方案到底解决什么问题。你有一台常开的电脑上面装着 Claude Code平时写代码、跑测试、改 Bug 都靠它。但人不可能一直坐在电脑前出门在外、躺沙发上、开会间隙突然想起某个项目要改一行配置、跑一次构建、看一段日志这时候掏出手机发条微信就能让电脑上的 Claude Code 干活比远程桌面舒服得多。xacpx 就是干这个的桥接层。它是一个 Node.js 程序跑在你的电脑上一头通过微信官方的 Bot 接口长轮询收消息另一头通过 acpxAgent Client Protocol把消息转给 Claude Code再把执行结果回传到微信。整条链路是手机微信 → 微信 Bot 服务器 → 你电脑上的 xacpx → Claude Code → 原路返回。但这里有个容易被忽略的坑当你同时用 Claude Code、Codex、Gemini CLI 好几个工具时每个工具都要单独配 Key改一处忘一处排查起来很烦。这篇的做法是用 TaoToken 做统一入口一份 Key 覆盖多个工具settings.json 和 config.toml 各写一次就行。下面从环境准备一路写到微信里发指令跑通每一步都能照着做。适合谁看本机已经能跑 Claude Code、想用手机远程下指令的开发者被多工具 Key 分散折磨过、想统一管理的人对 Node.js 桥接服务感兴趣、想搞懂 acpx 协议链路的人。2. 前置准备TaoToken 统一 Key 与运行环境2.1 为什么用 TaoToken 统一 KeyClaude Code 默认读~/.claude/settings.jsonCodex 读~/.codex/config.tomlGemini CLI 又有自己的一套。三个工具三份配置Key 一多就容易乱。TaoToken 提供统一的 API 入口你只需要在官网拿到一个 Key然后把它填进各个工具的配置文件里指向同一个 API 地址即可。这样换 Key、加额度、排查调用问题都只在一个地方处理。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。注意 API 地址不带 UTM 参数配置里写干净的就行。2.2 环境清单动手前确认这几样都到位Node.js 22 或更高版本终端执行node --version应输出 v22.x.x 以上。Claude Code 已安装并能正常跑claude --version有输出。npm 随 Node.js 一起装好npm --version能显示版本号。一台常开有网的电脑Windows 或 macOS 都行。手机装好微信。注意xacpx 只是桥梁它本身不提供 AI 能力。电脑上必须先能正常使用 Claude Code桥接才有意义。2.3 获取 TaoToken Key登录 TaoToken 控制台在 API Keys 页面创建一个新 Key复制保存。这个 Key 后面要填进 settings.json 和 config.toml。控制台地址走这个 deep linkhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。如果你还没决定用哪个模型可以先在模型对话页面试一下调用是否通https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。长期跑编码任务、想省心管理额度的可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。3. 可复制配置settings.json 与 config.toml 骨架3.1 Claude Code 的 settings.jsonClaude Code 的配置文件在~/.claude/settings.jsonWindows 是C:\Users\你的用户名\.claude\settings.json。用 TaoToken 统一 Key 的骨架如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的_TaoToken_Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [], deny: [] } }关键字段说明ANTHROPIC_BASE_URL指向 TaoToken 的 API 基址ANTHROPIC_AUTH_TOKEN填你刚创建的 KeyANTHROPIC_MODEL按你实际要用的模型名填。改完保存重启 Claude Code 生效。3.2 Codex 的 config.tomlCodex 的配置在~/.codex/config.toml。用同一份 TaoToken Key 的骨架model gpt-5-codex model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY [model_providers.taotoken.headers] Authorization Bearer 你的_TaoToken_Key这里把 provider 指向 TaoTokenenv_key是可选的环境变量方式你也可以直接在 headers 里写死 Key。两种方式选一种别重复。3.3 验证配置是否生效配置写完先别急着装 xacpx单独验证 Claude Code 能不能通claude --version claude -p 回复一句配置成功如果第二条命令能正常返回文本说明 TaoToken 的 Key 和地址都对了。这一步不通后面桥接一定失败先在这里排掉。4. 安装 xacpx 并桥接微信4.1 安装 xacpx终端执行npm install -g ganglion/xacpx --registryhttps://registry.npmjs.org装完验证xacpx version输出版本号就说明装好了。如果提示命令找不到检查 npm 全局路径是否在 PATH 里Windows 通常是C:\Users\你的用户名\AppData\Roaming\npm。4.2 注册工作区工作区就是你电脑上的项目文件夹提前注册好微信里用名字引用就行cd /你的/项目/绝对路径 xacpx workspace add my-project xacpx workspace list路径必须是绝对路径/home/me/project或C:\Users\me\project这种别用相对路径。4.3 确认 Agent 已注册xacpx agent list应该能看到claude driver: claude。如果没看到用xacpx agent add claude补上。4.4 登录微信xacpx login终端会打印二维码用手机微信扫一扫确认登录。如果二维码显示乱掉把终端窗口拉宽再试。登录成功后token 和 userId 会存在~/.xacpx/目录下只在本机不上传。4.5 启动服务xacpx start xacpx statusstatus显示运行中、有 PID、有日志路径就对了。调试阶段可以用xacpx run前台跑日志直接打屏幕上方便看问题。5. 验证请求从微信发指令到本机执行5.1 创建会话在微信里找到扫码后新增的 Bot 联系人发/ss claude --ws my-project这条命令创建一个会话用 my-project 这个工作区Agent 选 Claude Code。成功后会收到会话已创建的回复。5.2 发第一条真实指令之后发非斜杠开头的消息都会直接转给 Claude Code看一下这个项目的入口文件在哪里把路径告诉我Claude Code 会在你电脑上实际执行回复流式发到微信。到这一步整条链路就通了微信消息 → xacpx → acpx → Claude Code → 回传微信。5.3 调整回复模式默认是 verbose流式文本加工具调用都显示。想只看结果/replymode final想只看流式文本/replymode stream5.4 安全权限控制人不在电脑前时建议限制 AI 的操作范围/pm set read只允许读文件不允许写和执行。要完全放开再/pm set allow要禁止所有工具操作用/pm set deny。5.5 取消与切换任务跑太久想停/cancel。多个项目之间切换/ss列出所有会话/use my-project:claude切过去。6. 本篇常见错排查6.1 xacpx 命令找不到先看全局安装路径在不在 PATHnpm root -g npm list -g --depth0Windows 用户确认C:\Users\你的用户名\AppData\Roaming\npm在环境变量里。macOS 用户确认/usr/local/bin或 npm 的 bin 目录在 PATH。6.2 扫码后登录失败报登录失败: timeout通常是网络问题或者二维码过期。重新xacpx login再扫一次。必须用微信扫其他 App 扫无效。6.3 /ss 创建会话失败按顺序排查先确认claude --version本身能跑再确认路径是绝对路径且存在ls /你的/项目/路径能列出内容最后看日志cat ~/.xacpx/runtime/app.log日志里一般会写明是 Agent 启动失败还是路径不对。6.4 微信收不到回复xacpx status确认服务在跑、登录状态还在。如果 Bot 掉线重新xacpx login然后xacpx restart。改了配置一定要重启才生效。6.5 Windows 路径写法微信里发路径正斜杠反斜杠都行/ss claude -d C:/Users/me/my-project /ss claude -d C:\Users\me\my-project两种都能识别不用纠结。6.6 想完全重装xacpx stop xacpx logout rm -rf ~/.xacpx npm uninstall -g ganglion/xacpx npm install -g ganglion/xacpx --registryhttps://registry.npmjs.org xacpx login xacpx start7. 继续深入与 Key 管理建议跑通之后日常最省心的做法是把 TaoToken 的 Key 集中管理Claude Code 的 settings.json、Codex 的 config.toml 都指向同一个 API 基址换 Key 时只改一处不用满电脑找配置文件。如果你还要接更多工具接入文档里有各客户端的配置示例https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。用 Claude Code 的可以看 Anthropic 接入说明https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 。Key 的创建和管理在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。一个实测下来的小技巧xacpx 的/pm set read配合定时任务/lt可以让你在通勤路上发一条「两小时后检查 CI 是否通过」到点自动跑结果推回微信比一直盯着电脑省事。权限模式记得按场景切别长期挂在 allow 上。
