远程控制台 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	claude	标准 Claude Code
claude-bypass	claude --dangerously-skip-permissions	⚠️ 跳过权限检查
codex	codex	OpenAI Codex
cursor	cursor-agent	Cursor Agent

---

⚠️ 安全警告

claude-bypass 命令风险

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

仅在以下情况使用： - ✅ 完全信任的私有网络环境 - ✅ 个人非敏感项目 - ✅ 你了解并接受所有操作将自动执行

绝不使用于： - ❌ 生产环境或敏感数据处理 - ❌ 公共或共享网络 - ❌ 不确定安全性的项目

---

故障排查

问题	解决方案
链接无法访问	运行 check_tunnel.py 检查隧道状态
配置错误	运行 validate_config.py 验证配置
端口被占用	运行 stop_console.py 先停止再启动

---

架构

手机浏览器 → 服务器:{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