convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
DLbury

Clide — Terminal SSH com Claude Code e MCP

DLbury/clide

Terminal SSH + Claude Code com segurança de credenciais garantida

Ver no GitHub
BomPluginScore · de 0 a 100

Aplicativo desktop multiplataforma que integra um terminal SSH seguro com Claude Code, permitindo automação e resolução de problemas em servidores sem expor credenciais. Usa arquitetura local com MCP para executar comandos de forma segura, mantendo senhas e chaves privadas apenas na máquina do usuário.

Instalação

$npx convez-ai DLbury/clide

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
13
Forks
2
Acompanhando
1
Saúde
71%
Último commit
há 3 meses
Versão
v0.1.81
Issues abertas
5
Contribuidores
1

Casos de uso

  • Automação e troubleshooting de servidores com IA sem expor credenciais
  • Gerenciamento remoto de múltiplos servidores com interface unificada
  • Execução de comandos sudo segura através de IA sem compartilhar senhas

Veredito

Solução inovadora que resolve um problema real de segurança na automação DevOps com IA. A arquitetura de middleman local é bem pensada, mantendo credenciais isoladas enquanto aproveita inteligência do Claude para análise e troubleshooting. Altamente relevante para times de SRE/infraestrutura.

README

A tradução para o português deste README ainda está na fila.


简介

为什么你需要 Clide?

用 Claude Code 处理服务器问题时,你是不是一直被这些安全问题困扰?

❌ 必须给每台服务器配置 AI 的公钥,一旦 AI 端泄露,所有服务器全部沦陷
❌ 必须把明文密码告诉 Claude,密码会上传到 Anthropic 服务器
❌ Sudo 命令无法执行,要么配置无密码 sudo(安全红线),要么把 root 密码交给 AI

Clide 采用 本地中转架构 完美解决这些问题:

✅ SSH 连接完全由本地客户端建立和维护
✅ 你的密码和私钥永远只存在于你的电脑上,永远不会上传到任何第三方
✅ AI 执行 sudo 命令时,你在左侧 Shell 输入密码(SSH 登录可在本地弹窗输入),不会传递给 Claude
✅ 不需要在任何服务器上安装任何软件或配置额外公钥

Claude Code 只在你本机运行,通过 IDE 桥接 + MCP 把命令下发到 左侧真实 SSH Shell(与手动敲命令同一条 PTY),AI 读终端输出帮你分析。

同一窗口还提供多会话 SSH 终端、SFTP 文件浏览、资源监控与 Monaco 编辑远程配置,适合日常巡检、故障定位与变更操作。

关键词:运维终端 · AI 排障 · Claude Code · MCP · SSH · sudo 安全 · SRE · Tauri 桌面应用


目录


功能特性

🖥️ SSH 终端

  • 多标签 Shell、Dockview 分屏布局
  • xterm.js 实时 PTY(本地 PowerShell / 远程 SSH)
  • 会话分组、配置持久化
  • 启动时自动打开本地 Shell

📁 远程文件

  • SFTP 目录浏览、上传/下载
  • 拖拽移动、批量操作
  • Root 模式(sudo 提权操作)
  • 与 Monaco 编辑器联动打开/保存

📊 资源监控

  • SSH 连接后自动采集 CPU、内存、显存、磁盘
  • 独立 exec 通道,不干扰 PTY 交互

🤖 Claude Code 运维助手

  • 本机 Claude Code + MCP:runShellCommand 驱动左侧 Shell,非 AI 直连 SSH
  • 流式对话、工具调用与终端输出回传可视化
  • 密码边界清晰:SSH / sudo 仅在左侧 xterm 输入,AI 不索要、不嵌入命令
  • 长任务可轮询 getTerminalContext;终端上下文可注入对话

下载安装

在 Releases 页面下载最新版安装包:

平台格式说明
Windows.msi / .exe需 WebView2(Win10/11 通常已自带)
macOS.dmgApple Silicon(aarch64)与 Intel(x86_64)分别构建;v0.1.20 及更早版本存在与 Linux 相同的 MCP 启动问题,请用 v0.1.21+
Linux.deb / .AppImage需 WebKitGTK 等依赖(见下方 Linux 故障排除)

Linux 故障排除

v0.1.20 及更早的 .deb:若安装后无窗口,多为 MCP 资源路径错误导致启动即退出;请使用 v0.1.21+ 的 .deb 重新安装。

安装后没有窗口或点击无反应时,请在终端运行(便于看到错误信息):

# .deb 安装后(二进制一般在 /usr/bin,资源在 /usr/lib/Clide/)
clide

# 或 AppImage
chmod +x Clide_*.AppImage
./Clide_*.AppImage

若提示缺少库,Ubuntu/Debian 可安装:

sudo apt update
sudo apt install -y \
  libwebkit2gtk-4.1-0 \
  libgtk-3-0 \
  libayatana-appindicator3-1

Wayland 下若窗口仍异常,可尝试 X11 会话,或:

GDK_BACKEND=x11 clide

调试日志:

RUST_LOG=debug clide

前置条件

组件用途
Claude Code CLIAI 对话与 MCP 工具(需登录 Anthropic 账号)
Node.js 20+仅源码构建 / MCP stdio 脚本需要

快速开始

  1. 安装 — 从 Releases 下载并安装 Clide(本机)
  2. 配置 SSH — 侧边栏添加服务器 Profile(主机、端口、用户、密钥或密码——凭据留在应用内,不给 AI)
  3. 连接 Shell — 双击 Profile,在 左侧终端 完成登录(含密码 / 二次验证)
  4. 启用 AI — 本机安装并登录 Claude Code CLI,确认侧栏 IDE 桥接已就绪
  5. 排障 — 对 AI 描述现象,例如「查看这台机磁盘和负载」;Claude 调用 runShellCommand,你在左侧看到命令与输出,需要 sudo 时在 Shell 里输入密码
示例:
  你:这台机器磁盘快满了,帮我查一下
  AI:→ runShellCommand("df -h") → 左侧 Shell 执行并回传输出
  AI:→ runShellCommand("sudo du -sh /var/* | sort -rh | head") 
  你:在左侧 Shell 输入 sudo 密码(AI 看不到)

Claude Code & MCP 集成

Clide 让 Claude Code 扮演 本机运维副驾驶:它不持有你的 SSH 凭据,只通过 MCP 操作你已打开的 Shell 会话。

对比Claude Code 直连 SSHClide
Claude 安装位置本机或每台服务器仅本机
服务器凭据公钥分发或密码给 AI你在 UI 登录,AI 不接触
sudo难安全交互左侧 Shell 手动输入
命令可见性视工具而定与手工操作同一 xterm

集成采用 非侵入式 策略,不修改全局 shell 配置:

方式说明
IDE 桥接启用 AI 后在 127.0.0.1 启动 WebSocket 桥接,写入 ~/.claude/ide/*.lock
应用内对话启动 Claude 时注入 --ide 与 MCP 配置
项目 MCP仓库含 .mcp.json,可通过设置页「手动注册 MCP」
  1. 先启动 Clide 并保持 IDE 桥接连接,或
  2. 在项目目录执行 claude mcp add -s project 注册 MCP(参见 .mcp.json)

MCP 工具列表

aiterm MCP 服务器暴露以下工具,供 Claude Code 在 IDE 模式下调用:

工具功能
listServerProfiles列出所有 SSH Profile
listActiveConnections列出当前活跃连接
getFocusedServer获取当前聚焦的服务器 profileId
getTerminalContext读取终端最近输出
connectServer / disconnectServer连接 / 断开 SSH
runShellCommand在指定 Profile 的 PTY 中执行命令
listRemoteFiles / readRemoteFile浏览 / 读取远程文件
getWorkspaceFolders / getOpenFiles工作区与打开文件
getCurrentSelection编辑器当前选区

profileId 必须使用工具返回的稳定 ID,不要使用会话名称、主机名或 shellId。


架构概览

flowchart LR
  subgraph Desktop["Clide Desktop (Tauri 2)"]
    UI["Next.js UI"]
    PTY["PTY / SSH"]
    SFTP["Remote Files"]
    Bridge["IDE WebSocket Bridge"]
  end

  CLI["Claude Code CLI"]
  MCP["MCP aiterm"]

  UI --> PTY
  UI --> SFTP
  UI --> Bridge
  CLI -->|"--ide"| Bridge
  Bridge --> MCP
  MCP -->|"runShellCommand"| PTY
  MCP -->|"readRemoteFile"| SFTP

从源码构建

环境要求

开发模式

git clone https://github.com/DLbury/clide.git
cd clide

npm ci
npm ci --prefix view

# Next.js 热更新 + Tauri 桌面窗口
npm run dev:tauri

生产构建

npm ci
npm ci --prefix view
npm run build:tauri

安装包输出目录:src-tauri/target/release/bundle/

生成圆角图标

node scripts/generate-rounded-icons.mjs

项目结构

clide/
├── view/              # Next.js 前端(React、Tailwind、xterm、Monaco、Dockview)
├── src-tauri/         # Rust / Tauri 后端(SSH、PTY、Claude 桥接、MCP)
├── scripts/           # MCP stdio 转发脚本
├── docs/assets/       # README 配图
├── .mcp.json          # Claude Code 项目级 MCP 配置
└── package.json       # Tauri CLI 入口

发布说明

首次启用 GitHub Actions

  1. 仓库 Settings → Actions → General
  2. Actions permissions → Allow all actions
  3. Workflow permissions → Read and write permissions
  4. 若出现「Approve workflows」横幅,点击批准

打标签发布

git tag v0.1.21
git push origin v0.1.21

也可在 Actions 页手动运行 Release 工作流。工作流定义见 .github/workflows/release.yml。


技术栈

层级技术
桌面壳Tauri 2、Rust(russh、portable-pty)
前端Next.js、React、Tailwind CSS、xterm.js、Monaco、Dockview
AIClaude Code CLI、MCP、WebSocket IDE 协议

License

本项目采用 MIT License 开源。

Copyright © 2026 DLbury


Ver o original no GitHub

Bom para

Relacionados