AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它通过实时的 VPN 检测和进程管理，防止 VPN 断开时 Claude 意外暴露，支持 macOS 和 Windows，并包含 CI 测试。

适合谁使用

本地运行 Claude 并需要 VPN 安全保护的开发者
担心 VPN 断线导致 IP 泄露的远程工作者
希望使用终端监控的 macOS 和 Windows 高级用户
需要自动化管理 Claude 进程的安全意识用户

典型使用场景

VPN 意外断开时自动停止所有 Claude 进程
快速查看正在运行的 Claude 进程数量
通过按键手动终止所有 Claude 进程
同时监控 VPN 连接状态与 Claude 进程活动

项目优势

轻量级，仅依赖操作系统内置工具，无需外部依赖
跨平台支持 macOS（Bash）和 Windows（PowerShell）
每两秒实时刷新，不填满终端回滚缓冲区
Windows 版本提供非破坏性自检模式，并有 CI 验证

使用前须知

可能误杀命令中包含 'claude' 但非 Claude 本身的进程
VPN 检测可能无法覆盖所有 VPN 服务商或自定义配置
没有用户可配置的白名单或黑名单，未检测到 VPN 时始终自动终止

README 快速开始

Claude Watch

Claude Watch is a lightweight, interactive macOS and Windows terminal monitor for Claude processes and VPN connectivity.

Features

Refreshes every two seconds without filling Terminal scrollback.
Shows the number of running processes whose command contains claude.
Detects system-managed VPNs and common third-party VPN adapters.
Automatically stops every matching Claude process when no VPN is detected.
Lets you manually stop all matching processes by pressing k.
Exits cleanly with x, q, or Control-C.

[!WARNING] Claude Watch intentionally terminates processes automatically whenever its VPN checks report no connection. Because matching is case-insensitive and command-line based, it may also stop other processes whose command contains claude.

macOS

Requirements: macOS, its included Bash version, and a Terminal that supports ANSI escape sequences.

Install and run:

git clone https://github.com/omidkorat/claude-watch.git
cd claude-watch
chmod +x claude-watch.sh
./claude-watch.sh

Windows

Requirements: Windows 10 or 11 and Windows PowerShell 5.1 or later.

Clone the repository, open PowerShell in its folder, and run:

powershell -NoProfile -ExecutionPolicy Bypass -File .\claude-watch.ps1

The execution-policy option applies only to that invocation and does not change the system policy.

Controls

Press k to stop every detected Claude process.
Press x or q to exit.

Status colors

Green: VPN connected, or no Claude processes detected.
Yellow: Claude is running while a VPN is connected.
Red: VPN disconnected, auto-kill armed, or an automatic stop was triggered.

VPN detection on macOS

Claude Watch checks, in order:

Connected VPN services reported by scutil --nc list.
Active utun tunnel interfaces reported by scutil --nwi.
Full-tunnel routes using utun, tun, tap, ppp, or ipsec interfaces, including OpenVPN's 0/1 plus 128/1 routing pattern used by VyprVPN.

Some Apple services and third-party networking tools may also use tunnel interfaces. Review the script's behavior for your setup before relying on it as a security control.

VPN detection on Windows

The PowerShell version checks, in order:

Connected Windows VPN profiles reported by Get-VpnConnection.
Active adapters reported by Get-NetAdapter whose names iden

项目描述

A macOS monitor that protects Claude usage with VPN-aware automatic process control.

claude-watch