remote-console（远程控制台）

远程控制台 Skill

通过 ttyd + SSH 隧道，在手机浏览器中访问主机上的 Claude Code。

⚠️ 重要：优先使用 Python 脚本

所有操作必须通过 Python 脚本执行，禁止直接拼接 Shell 命令！

脚本目录：./scripts/（与 SKILL.md 同目录）

前置依赖

pip install psutil

快速命令

启动远程控制台

python ./scripts/start_console.py <项目名>
python ./scripts/start_console.py <项目名> -c <命令名>
python ./scripts/start_console.py --path /path/to/project

停止远程控制台

python ./scripts/stop_console.py

检查状态

python ./scripts/check_tunnel.py
python ./scripts/check_tunnel.py --json

验证配置

python ./scripts/validate_config.py

用户操作指南

1. 启动远程控制台

触发: "打开 {项目名} 的远程控制台"

执行:

python ./scripts/start_console.py {项目名}

返回格式:

✅ 远程控制台已启动

📁 项目：{项目名称}
🔗 访问地址：http://{host}:{port}
📂 工作目录：{project.path}
🚀 启动命令：{command}

2. 停止远程控制台

触发: "关闭远程控制台" / "停止远程终端"

执行:

python ./scripts/stop_console.py

3. 检查状态

触发: "远程控制台状态" / "检查隧道"

执行:

python ./scripts/check_tunnel.py

4. 验证配置

触发: "验证远程控制台配置"

执行:

python ./scripts/validate_config.py

5. 项目管理

查看所有项目:

python ./scripts/start_console.py

配置文件

配置文件：./config.json（与 SKILL.md 同目录）

{
  "servers": {
    "default": {
      "name": "my-server",
      "host": "your-server.com",
      "port": 2222,
      "user": "your-username",
      "ssh_alias": "ssh-config-alias"
    }
  },
  "ttyd": {
    "port": 7681,
    "path": "ttyd",
    "options": "-W -t fontSize=16"
  },
  "defaults": {
    "command": "claude",
    "server": "default"
  },
  "commands": {
    "claude": "claude",
    "claude-bypass": "claude --dangerously-skip-permissions",
    "codex": "codex"
  },
  "projects": {
    "项目名": {
      "path": "/path/to/project",
      "command": "claude-bypass"
    }
  }
}

预定义命令

⚠️ 安全警告

claude-bypass 命令风险

claude-bypass 使用 --dangerously-skip-permissions 标志，会跳过所有权限检查。

仅在以下情况使用：

• ✅ 完全信任的私有网络环境
• ✅ 个人非敏感项目
• ✅ 你了解并接受所有操作将自动执行

绝不使用于：

• ❌ 生产环境或敏感数据处理
• ❌ 公共或共享网络
• ❌ 不确定安全性的项目

故障排查

架构

手机浏览器 → 服务器:{port} → SSH 隧道 → 主机 ttyd → Shell + Claude Code

首次使用检查清单

1. 安装依赖: pip install psutil
2. 配置文件: 修改 config.json 中的服务器信息
3. SSH 密钥: 确保免密登录 ssh {ssh_alias} echo test
4. ttyd 安装: Windows scoop install ttyd，Linux sudo apt install ttyd
5. 服务器配置: GatewayPorts yes 和 AllowTcpForwarding yes
6. 验证: 运行 python ./scripts/validate_config.py