跳到正文

// konsolity cli

命令行中的 Konsolity,运行在您的服务器上。

就像终端里的 Claude Code:konsolity 程序只需一行命令即可安装在 Linux 服务器、Mac 或 Windows 上,用在账户中批准的代码激活,然后即可访问您托付给它的主机、代码片段和会话。它还可以作为 Claude 智能体的本地 MCP 服务器。

// 安装

一行命令即可安装。

支持 Linux x64 和 arm64、Intel 与 Apple silicon 上的 macOS,以及 Windows x64。安装程序在安装任何内容之前,都会校验 SHA-256 校验和与发布者签名。

Linux 和 macOScurl -fsSL https://konsolity.com/cli/install.sh | sh
Windows(PowerShell)irm https://konsolity.com/cli/install.ps1 | iex
Homebrewbrew install konsolity/tap/konsolity

适用于 Debian、Ubuntu、Fedora、RHEL 及其衍生版的 .deb 和 .rpm 软件包,以及 .tar.gz 和 .zip 压缩包,均附 SHA-256 校验和: 下载

// 激活

用代码激活,从不使用密码。

无需在机器上输入任何密码或密钥。

1

运行 konsolity login

该命令会显示一个地址、一个 XXXX-XXXX 格式的代码和机器指纹;如果终端支持,还会显示二维码。

2

在您的账户中批准

在应用中输入代码(设置,CLI 机器),或打开 app.konsolity.com/cli/activate,并确认显示的指纹与终端中的一致。

3

选择范围

主机、代码片段、会话、MCP;只读或完全访问;命令规则;有效期从一天到一年,或永不过期。

4

用第二因素确认

在同一次批准中提供双重验证码或通行密钥。账户未启用第二因素时,无法激活任何机器。

$ konsolity login --name web-01
  https://app.konsolity.com/cli/activate
  code         KQ7M-4TZP
  fingerprint  9F3A-C21D

$ konsolity status

// 范围

机器只能看到您托付给它的内容。

范围在激活时选择,之后可在 CLI 机器页面中修改。扩大范围需要第二因素,缩小范围立即生效。

主机

所选主机、其身份以及已固定的主机密钥。范围之外的主机永远不会被复制到机器上。

代码片段

所选代码片段,可列出,也可在范围内的主机上运行。

会话

账户中正在进行的 CLI 会话,可跟踪或结束。

MCP

供 Claude Code 和 Claude 智能体使用的本地 MCP 服务器,以及通过 konsolity serve 处理的 Claude 连接器队列。

只读或完全访问

只读模式下,机器只列出内容并显示状态,不运行任何命令。完全访问模式下,它会运行您的规则所允许的命令。

命令规则

允许的模式(精确、前缀或 glob)以及最长运行时间。服务器和机器都会拒绝未被允许的操作。

// 安全

端到端加密的机器保险库。

Konsolity CLI 沿用 Konsolity 的安全模型:服务器读不到您的主机、密钥和规则。

保险库密钥留在您的设备上

机器永远不会收到您的保险库密钥。批准的设备会给它一把只为它密封的机器密钥,然后只提供已授权项目的加密副本。

与机器绑定

令牌与机器指纹绑定:复制到其他地方会被拒绝,您也会收到提醒。本地机密使用该机器专属的密钥加密。

自动轮换

令牌每 24 小时自动更新一次,服务不会中断。

5 秒内撤销

在应用或账户中撤销机器或结束会话:连接被切断,命令被停止,本地机密被清除。

破坏性命令需要确认

rm -rf、DROP、reboot、terraform destroy 等破坏性命令,无论范围如何,都要等待您在应用中批准。5 分钟内未答复,则不执行任何操作。

全部记入日志

激活、每条命令及其退出码、确认、轮换、撤销。从不记录输出或任何机密。可导出为 CSV 或 JSON。

提醒

新机器、指纹不同、撤销、确认请求:通过电子邮件、应用通知,以及已关联的 Telegram 发送。

必须使用第二因素

激活机器或扩大其范围,都需要双重验证码或通行密钥。

// mcp

供 Claude 使用的本地 MCP 服务器。

konsolity mcp 为 Claude Code 和 Claude 智能体提供 list_hosts、list_snippets、run_command、run_snippet 和 list_sessions 工具,范围、规则和确认机制完全相同。只需一行命令即可接入。

$ claude mcp add konsolity -- konsolity mcp

使用 konsolity serve,机器还会像桌面应用一样处理您账户的 Claude 连接器队列,而无需打开桌面应用。 Claude 连接器

// 命令

主要命令。

konsolity login用在账户中批准的代码激活机器。
konsolity status账户、机器、范围、有效期、令牌时长以及可访问的主机。
konsolity hosts列出范围内的主机,不显示任何机密。
konsolity run <host> -- <command>通过 SSH 在主机上运行命令,实时输出并返回退出码。
konsolity snippet list · run列出代码片段,或在主机上运行其中一个。
konsolity sessions [--follow]跟踪账户中正在进行的 CLI 会话,或结束其中一个。
konsolity mcp供 Claude 使用的本地 MCP 服务器(stdio)。
konsolity serve作为系统服务处理 Claude 连接器队列。
konsolity setup-token用于 CI 或容器的长期令牌,只显示一次。
konsolity update校验签名后更新程序。
konsolity logout撤销机器并清除本地所有内容。

// studio

包含在 Studio 套餐中。

Studio 每月 €99 或每年 €999。 与 Claude 连接器一样,Konsolity CLI 仅限 Studio 及其 7 天免费试用。机器每次调用时,服务器都会核验套餐。

7 天免费试用 安装指南 Claude 连接器

// faq

常见问题

Konsolity 服务器能读取机器收到的内容吗?

不能。为机器复制的项目使用机器密钥加密,只有您的设备和该机器知道这把密钥。服务器只存储不透明的数据块,机器也永远不会收到您的保险库密钥。

如果机器被盗或被入侵怎么办?

在 CLI 机器页面撤销它:5 秒内即被切断,其副本也会从服务器上删除。只有其范围内的主机受影响;为谨慎起见,请更换这些主机的 SSH 密钥。

应用需要保持打开吗?

不需要。机器会在其范围内独立工作。应用只用于激活机器、修改范围和确认破坏性命令,而且可以在您的手机上完成。

支持哪些系统?

Linux x64 和 arm64(Debian、Ubuntu、Fedora、RHEL 及其衍生版,或通过压缩包安装的任何发行版),Intel 与 Apple silicon 上的 macOS,以及 Windows x64。

可以在 CI 或容器中使用吗?

可以,使用 konsolity setup-token:生成一个只显示一次的长期令牌,保存在您的机密管理工具中,并通过 KONSOLITY_TOKEN 提供。它和机器一样有范围、日志和撤销功能。

需要哪个套餐?

Studio,包括 7 天免费试用。激活机器还要求账户启用双重验证或通行密钥。