VibeTerminal

Appearance

快速开始 ​

🎯 5 分钟完成配置 ​

按照以下步骤，快速开始你的 Vibe Coding 之旅！

📋 前置要求 ​

硬件要求 ​

  • Android 设备：Android 8.0 (API 26) 或更高版本
  • 开发服务器：Linux / macOS / WSL

软件要求 ​

在开发服务器上安装：

  • ✅ SSH 服务：确保 SSH 服务已启动
  • ✅ Zellij：终端复用器，安装指南
  • ✅ Claude Code：AI 编程助手，官网下载

网络要求 ​

推荐使用 Tailscale（可选但强烈推荐）：

  • 🔐 端到端加密连接
  • 🌐 自动穿透 NAT
  • ⚡ 低延迟直连

Tailscale 安装指南

📱 第一步：安装 VibeTerminal ​

下载 APK ​

📥 下载最新版本

安装步骤 ​

  1. 从 GitHub Releases 下载最新的 app-release.apk
  2. 在 Android 设备上打开下载的 APK 文件
  3. 允许"从此来源安装应用"（如果系统提示）
  4. 点击"安装"

授予权限 ​

安装后，请确保授予以下权限：

  • ✅ 通知权限：接收 Claude Code 的任务完成通知
  • ✅ 存储权限（可选）：导入 SSH 密钥文件

🔧 第二步：配置 SSH 连接 ​

添加服务器 ​

  1. 打开 VibeTerminal
  2. 点击"添加 SSH 服务器"
  3. 填写服务器信息：
yaml
名称: 我的开发服务器
主机: 192.168.1.100  # 或 Tailscale IP (100.x.x.x)
端口: 22
用户名: your-username

认证方式 ​

方式一：密码认证（简单快速）

  • 直接输入 SSH 密码
  • 支持保存密码（加密存储）

方式二：密钥认证（推荐）

  • 点击"选择密钥文件"
  • 选择私钥文件（如 ~/.ssh/id_rsa 或 id_ed25519）
  • 如果密钥有密码，输入密钥密码

测试连接 ​

点击"测试连接"按钮，确保配置正确。

📂 第三步：创建项目 ​

选项一：连接现有 Zellij 会话 ​

如果你已经在服务器上运行了 Zellij 会话：

  1. 在项目列表页面点击"添加项目"
  2. 选择"连接现有会话"
  3. 从列表中选择已有的 Zellij 会话
  4. 点击"确认"

选项二：创建新项目 ​

从零开始创建新项目：

  1. 点击"添加项目"
  2. 选择"创建新项目"
  3. 填写项目信息：
yaml
项目名称: MyAwesomeProject
项目路径: /home/you/projects/my-project
Zellij 会话名: my-project
  1. 点击"创建"

VibeTerminal 会自动：

  • 通过 SSH 连接到服务器
  • 创建或附加到指定的 Zellij 会话
  • 进入项目目录

🚀 第四步：开始使用 ​

浏览对话历史 ​

  1. 在项目主页，选择"对话"标签
  2. 查看按时间或主题分组的对话历史
  3. 点击任意对话查看详情
  4. 使用搜索功能快速定位内容

连接到终端 ​

  1. 点击右下角的"三角形"图标
  2. 进入 Zellij 终端界面
  3. 开始与 Claude Code 协作！

使用快速发送 ​

在终端输入框难以编辑长文本时：

  1. 点击输入框上方的"笔"图标
  2. 在弹出的编辑器中输入消息
  3. 点击"发送"

支持语音输入，长按输入框启用！🎤

🔔 第五步：配置推送通知（可选） ​

启用 Webhook 服务器 ​

  1. 进入"设置" → "终端" → "Webhook 服务器"
  2. 开启 Webhook 服务器
  3. 点击"查看服务器配置"
  4. 记下显示的 Tailscale IP 和认证令牌

配置 Claude Code ​

在开发服务器上编辑 ~/.claude/settings.json：

json
{
  "hooks": {
    "Stop": [
      {
        "type": "command",
        "command": "curl -sf -X POST 'http://<phone-ip>:8765/notify' -H 'Content-Type: application/json' -H 'Authorization: Bearer <AUTH_TOKEN>' -d '{\"event\":\"stop\",\"project\":\"'\"$(basename \"$PWD\")\"'\"}' > /dev/null 2>&1 || true"
      }
    ],
    "Notification": [
      {
        "type": "command",
        "command": "curl -sf -X POST 'http://<phone-ip>:8765/notify' -H 'Content-Type: application/json' -H 'Authorization: Bearer <AUTH_TOKEN>' -d '{\"event\":\"input\",\"project\":\"'\"$(basename \"$PWD\")\"'\"}' > /dev/null 2>&1 || true"
      }
    ]
  }
}

替换以下占位符：

  • <phone-ip>：你的手机 Tailscale IP（通常是 100.x.x.x）
  • <AUTH_TOKEN>：配置对话框中显示的认证令牌

测试通知 ​

在服务器上运行 Claude Code，完成任务后，手机应该会收到推送通知！🔔

🎨 使用技巧 ​

横屏模式 ​

  • 旋转手机到横屏，获得更大的终端视图
  • 横屏模式下会显示 Minimap，方便快速导航

日期跳转 ​

  • 在对话界面点击"日历"图标
  • 选择日期，快速跳转到指定时间的对话

全文搜索 ​

  • 点击"搜索"图标
  • 输入关键词，秒速定位所有相关对话
  • 支持跨会话搜索

语音输入 ​

  • 使用手机自带的语音输入功能
  • 长文本场景下特别方便
  • 告别手机打字的痛苦！

🐛 常见问题 ​

SSH 连接失败 ​

检查清单：

  • ✅ 服务器 IP 和端口是否正确
  • ✅ 服务器的 SSH 服务是否运行（systemctl status sshd）
  • ✅ 防火墙是否允许 SSH 连接
  • ✅ 如果使用 Tailscale，检查双方是否在线

Zellij 会话找不到 ​

解决方法：

  • 在服务器上运行 zellij list-sessions 查看所有会话
  • 确保会话名称拼写正确
  • 如果会话不存在，创建新项目

推送通知不工作 ​

检查：

  • ✅ 手机的通知权限已授予
  • ✅ Webhook 服务器已启用
  • ✅ ~/.claude/settings.json 配置正确
  • ✅ 手机和服务器都在 Tailscale 网络中

🎉 大功告成！ ​

恭喜！你已经完成了 VibeTerminal 的配置 🎊

现在你可以：

  • ☕ 在咖啡厅优雅地 Coding
  • 🚇 在通勤路上查看 AI 生成的代码
  • ✈️ 在旅行途中保持项目进度

开始你的 Vibe Coding 之旅吧！

Released under the MIT License.

Copyright © 2024-present VibeTerminal