远程指令助手

1. 这是什么

远程指令助手是一款 Windows 桌面应用，通过微信小程序实现 PC 端控制台的远程实时预览与控制。无论你身在何处，打开手机就能查看和操控电脑上的终端进程。

• 实时推流 — 终端输出毫秒级同步到微信小程序
• 远程操控 — 手机上直接输入指令，控制 PC 端进程
• 多项目管理 — 同时配置管理多个项目目录和启动指令
• Claude CLI 优化 — 针对 Claude Code 的推流模式做了专门优化
• WebSocket 连接 — 通过云服务器中转，低延迟双向通信
• 秒级绑定 — 扫描二维码即可绑定，无需复杂配置
• 快捷指令 — 预设常用指令，一键发送到终端
• 多标签终端 — 支持同时打开多个 PTY 标签页

2. 效果演示

以下为远程指令助手的使用演示：

3. 核心功能

3.1 实时终端推流

PC 端终端输出通过 WebSocket 实时推送到微信小程序，支持 ANSI 颜色、光标控制等完整终端特性。内置 xterm.js 渲染引擎，体验接近本地终端。

3.2 推流优化模式

针对 Claude CLI 等高频刷新控制台程序，提供推流优化选项：行内 \r 覆盖合并到最后一帧后再推送，大幅减少网络流量和渲染压力。普通终端则默认每帧全量推送，保证实时性。

3.3 多项目与多标签

侧边栏管理多个项目，每个项目配置独立的启动文件、工作目录和启动参数。支持同时打开多个 PTY 终端标签页，一键切换。

3.4 快捷指令

保存常用指令到侧边栏，一键发送到当前终端。适合反复使用的指令如 claude、git status、npm run build 等。

3.5 微信小程序绑定

打开 PC 端应用后生成绑定二维码，微信扫码即可完成绑定。后续打开小程序自动连接，无需重复扫码。支持解绑和重新绑定。

4. 快速开始

4.1 下载安装

下载后运行安装程序即可。首次启动会提示防火墙权限，请允许以便 WebSocket 连接。搭配 Claude Code 便携版教程。

4.2 绑定微信小程序

1. 在微信中搜索小程序 「远程指令助手」
2. 打开小程序，扫描 PC 端显示的二维码
3. 绑定成功后，PC 端状态变为"已连接"
4. 手机端即可看到 PC 端的实时画面

微信扫码体验小程序

4.3 添加项目

点击侧边栏 「+ 添加」按钮，配置项目信息：

4.4 启动终端

点击项目卡片右侧的 ▶ 按钮即可启动终端。PC 端和手机端将同时显示终端画面，并支持双向输入。

5. 与 Claude Code 便携版的协同

远程指令助手与 Claude Code 便携版 深度配合，形成完整的「移动 AI 编程」体验：

5.1 推荐配置

在远程指令助手中添加 Claude Code 便携版项目：

5.2 使用流程

1. 在 PC 上启动远程指令助手
2. 微信扫码绑定小程序
3. 在助手中启动 Claude AI 助手 项目（即 start.bat）
4. 终端中会进入 Claude Code 便携版环境
5. 输入 claude 启动 Claude Code
6. 现在，你可以出门在外通过手机查看 Claude 的执行进度
7. 需要时直接在小程序中输入指令，控制 Claude 继续工作

5.3 启动脚本配置

如果你是通过 npm install -g @anthropic-ai/claude-code 在线安装的 Claude Code，可以创建以下启动脚本，分别用于全新会话和恢复上一次会话：

方式一：新启动一个会话

每次启动都是全新的对话上下文，适合开始新任务：

@echo off
:: 设置控制台UTF8编码，解决中文乱码、方块
chcp 65001 >nul
:: 设置窗口标题
title Claude Code CLI
:: 启动claude，%* 转发所有自定义参数（claude doctor / claude "写代码"）
claude %*
:: 执行完毕不自动关闭窗口，方便看报错
echo.
echo ======================================
echo Claude 会话已结束，按任意键关闭窗口
pause >nul

保存为 start.bat，每次启动都是空白对话。

方式二：恢复上一次会话

启动后自动加载上一次的对话历史，适合中断后继续跟进同一个长任务：

@echo off
:: 设置控制台UTF8编码，解决中文乱码、方块
chcp 65001 >nul
:: 设置窗口标题
title Claude Code CLI
:: 启动claude，%* 转发所有自定义参数（claude doctor / claude "写代码"）
claude -c%*
:: 执行完毕不自动关闭窗口，方便看报错
echo.
echo ======================================
echo Claude 会话已结束，按任意键关闭窗口
pause >nul

保存为 start-continue.bat，Ctrl+C 中断后重启即可从上次断开的地方继续。

在远程指令助手中添加项目示例：

6. 常见问题