项目速览

属性内容
GitHubmy-claude-utils/clsh
Stars293
语言TypeScript
特点跨设备终端访问、PWA 支持、WebSocket 实时同步
最后更新2 天前

它解决了什么问题

作为开发者，你是否遇到过这些场景：

  • 外出时服务器报警，手头只有手机，却急需连上终端处理
  • 在 iPad 上想用 Claude Code，但终端操作受限
  • 多台设备间切换，环境配置总是不同步
  • SSH 连接需要公网 IP 和端口转发，配置麻烦

clsh 就是为这些问题而生。它让你可以通过浏览器，从任何设备访问你的本地终端，无需复杂的网络配置。

核心特性

1. 全设备覆盖

clsh 采用 PWA（渐进式 Web 应用）架构，支持：

  • 📱 手机端（iOS/Android）
  • 📱 平板（iPad/安卓平板）
  • 💻 桌面端（Windows/macOS/Linux）

只要有浏览器，就能访问你的终端。

2. 实时 WebSocket 同步

基于 WebSocket 技术，clsh 提供低延迟的终端交互体验：

  • 输入响应几乎无感知延迟
  • 支持 tmux 会话保持
  • 断线自动重连

3. Claude Code 集成

clsh 原生支持 Claude Code：

# 在本地启动 clsh 后
clsh
# 然后在手机浏览器访问本地地址
# 即可使用完整的 Claude Code 功能

这意味着你可以在手机上用 Claude Code 进行代码审查、重构，甚至完整的开发工作流。

4. 自托管与隐私

clsh 完全开源，支持自托管：

  • 数据不经过第三方服务器
  • 可自行部署到内网或云服务器
  • 支持访问控制和认证

快速开始

# 安装
npm install -g @my-claude-utils/clsh

# 启动服务
clsh

# 默认在 http://localhost:3000 运行
# 使用 ngrok 或类似工具暴露到公网后
# 即可从任何设备访问

同类工具对比

工具Stars特点适用场景
ttyd8.1kC 语言编写，性能极致服务器常驻
ShellHub2.8k完整的 SSH 管理平台团队管理
tmate5.7k即时分享终端会话结对编程
clsh293Claude Code 集成、PWAAI 辅助开发

clsh 的独特优势在于与 Claude Code 的深度集成。如果你已经习惯用 Claude Code 进行开发，clsh 是目前唯一能让你在移动设备上保持相同工作流的方案。

适用场景

  • 紧急运维：外出时需要快速登录服务器处理故障
  • 移动开发：在 iPad 上用 Claude Code 进行轻量级开发
  • 演示分享：临时分享终端会话给同事查看
  • 多设备协作：在 Mac 上开始工作，在 iPad 上继续

注意事项

  1. 网络安全：暴露终端到网络存在风险，建议配合 VPN 或内网使用
  2. 移动体验：手机屏幕较小，复杂操作仍建议在桌面端完成
  3. 依赖 Claude Code：部分功能需要本地安装 Claude Code

总结

clsh 是一个小而精的工具，它解决了开发者多设备协作的一个真实痛点。293 个 Star 说明它还处于早期阶段，但代码质量和功能完整性已经相当不错。

如果你经常需要在不同设备间切换，或者想在 iPad 上体验完整的 AI 编程工作流，clsh 值得一试。

属性内容
仓库https://github.com/my-claude-utils/clsh
许可证MIT
语言TypeScript
维护者@my-claude-utils