CLI WeChat Bridge：用微信启动终端

这篇教程适合想用微信远程唤起本地终端的用户。完整流程是：安装 Node.js 24.17.0 或更高版本，在 CMD 里全局安装 cli-wechat-bridge，扫码登录，最后执行 wechat-setup，让微信端弹出启动终端的消息。

写作日期：2026.6.22 适用系统：Windows / macOS / Linux 工具：Node.js、npm、cli-wechat-bridge

版本说明：截至 2026-06-22，Node 官方发行索引里最新发行已到 v26.3.1；如果你在下载页看到的是 24.17.0，也可以直接安装。cli-wechat-bridge 当前 npm 最新版为 1.1.1，要求 Node >=24.0.0。

1. 安装 Node.js

打开 Node.js 官方下载页：

在页面里选择适合你系统的安装包。Windows 用户通常选择 Windows Installer (.msi)，一路按提示安装即可。教程推荐安装 Node.js 24.17.0 或更高版本，因为 cli-wechat-bridge 需要 Node 24 以上。

安装完成后，打开 CMD，检查版本：

node -v
npm -v

如果 node -v 显示 v24.17.0 或更高版本，就可以继续下一步。

在 Windows 上按 Win + R，输入 cmd 并回车。然后执行：

npm install -g cli-wechat-bridge@latest

安装完成后，建议检查命令是否已经注册成功：

wechat-setup --help
wechat-bridge --help

如果 CMD 提示找不到命令，通常是 npm 全局 bin 目录还没有进入环境变量。可以先关闭 CMD，再重新打开一个新的 CMD 窗口重试。

安装完成后，运行桥接命令。根据你的使用场景，可以先用通用入口启动：

wechat-bridge

终端里出现二维码后，用手机微信扫码确认。扫码完成后，保持这个终端窗口打开，它会作为本机和微信之间的桥接进程。

注意：二维码过期时，直接在终端里按提示刷新，或者重新执行命令生成新的二维码。第一次使用时，系统防火墙可能会弹出网络访问提示，按实际需要允许即可。

新开一个 CMD 窗口，执行：

wechat-setup

这一步会把常用启动方式配置好。执行成功后，微信端会弹出一条消息，里面通常会包含“启动终端”相关入口。点开这条消息后，就可以从微信侧触发本地终端任务。

如果你主要想和 Codex 配合使用，也可以查看当前包注册的 Codex 相关命令：

wechat-codex --help
wechat-codex-start --help
wechat-bridge-codex --help

检查项	成功表现
Node 环境	`node -v` 显示 v24.17.0 或更高版本
npm 安装	`wechat-setup --help` 能正常显示帮助信息
扫码登录	终端二维码扫码后进入已连接状态
微信消息	执行 `wechat-setup` 后，微信端收到启动终端相关消息
终端启动	从微信端点击后，本地终端可以被唤起或接收任务

Windows 用户可以用“以管理员身份运行”的 CMD 重试。macOS / Linux 用户如果遇到权限问题，优先考虑配置 npm 全局目录，不建议长期依赖 sudo npm install -g。

确认桥接终端没有关闭，网络没有被代理或防火墙拦截。二维码过期时重新运行 wechat-bridge。

先确认扫码登录已成功，再执行 wechat-check-update 检查是否有新版。也可以重新执行 npm install -g cli-wechat-bridge@latest 更新到最新版本。