安装 Konsolity CLI

更新于 2026年11月10日

Konsolity CLI 就是 konsolity 命令,用于安装在服务器或没有图形界面的机器上。从您的账户激活后,它可以在您授予的范围内访问保险库中的主机、代码片段和会话,并可作为 Claude 代理(例如 Claude Code)的本地 MCP 服务器。它的用法与命令行中的 Claude Code 相同:安装,用一个代码激活一次,然后即可使用。

所需套餐

Konsolity CLI 仅限 Studio 套餐及其免费试用。服务器会在机器每次调用时检查套餐:没有该套餐时,每条命令都会返回“需要订阅”。即使没有该套餐,机器列表和撤销功能也始终可用。

选择机器

任何能够通过 SSH 访问您主机的电脑均可:管理服务器、小型虚拟机、Mac mini、开发工作站、CI 运行器。该机器无需任何入站端口,只需能够通过 HTTPS 出站访问 api.konsolity.com。

系统 架构 格式
Linux(Debian、Ubuntu、Fedora、RHEL 及其衍生版本,其他任何发行版可使用压缩包) x64、arm64 脚本、.deb、.rpm、.tar.gz
macOS(Intel 和 Apple 芯片) 每种架构一个压缩包(x64、arm64),二进制文件带 Developer ID 签名并经过公证 · macOS 11 或更高版本 脚本、Homebrew、.tar.gz
Windows x64 PowerShell 脚本、.zip

Linux 和 macOS:安装脚本

这是最简单的方式。脚本会检测系统和架构,下载对应的文件,校验其 SHA-256 哈希值和发布者的 Ed25519 签名,然后进行安装:

curl -fsSL https://konsolity.com/cli/install.sh | sh

如需在运行前阅读脚本:

curl -fsSLO https://konsolity.com/cli/install.sh
less install.sh
sh install.sh

如果哈希值或签名不匹配,脚本会停止,不安装任何内容。

Linux:.deb 软件包(Debian、Ubuntu)

下载与您的架构对应的软件包,然后运行:

sudo apt install ./konsolity_<version>_amd64.deb

在 arm64 上(Raspberry Pi 4 或 5、Graviton 或 Ampere 服务器),请选择 konsolity_<version>_arm64.deb。之后通过 apt 进行更新。

Linux:.rpm 软件包(Fedora、RHEL、Rocky、Alma)

sudo dnf install ./konsolity-<version>.x86_64.rpm

在 arm64 上,文件名以 .aarch64.rpm 结尾。之后通过 dnf 进行更新。

Linux:.tar.gz 压缩包

对于其他任何发行版,压缩包中只包含二进制文件:

tar -xzf konsolity_<version>_linux_amd64.tar.gz
sudo install -m 0755 konsolity /usr/local/bin/konsolity

在 ARM 机器上,请将 amd64 替换为 arm64。

macOS:Homebrew

brew install konsolity/tap/konsolity

之后通过 brew upgrade konsolity 进行更新。安装脚本和 konsolity-<version>-macos-x64.tar.gz (Intel) / konsolity-<version>-macos-arm64.tar.gz (Apple silicon) 压缩包同样可用。

Windows:PowerShell

在 PowerShell 中(无需管理员权限):

irm https://konsolity.com/cli/install.ps1 | iex

该脚本执行与 Linux 上相同的校验,将 konsolity.exe 安装到您的用户配置文件目录中,并将其添加到用户 PATH。请打开一个新的终端来使用它。

Windows:.zip 压缩包

konsolity_<version>_windows_amd64.zip 压缩包中包含 konsolity.exe。将其解压到您选择的文件夹,然后将该文件夹添加到 PATH。

校验下载的文件

每个版本都由已签名的清单 https://konsolity.com/cli/latest.json 描述:版本号、文件列表(系统、架构、格式、地址、SHA-256 哈希值)以及发布者的 Ed25519 签名。安装脚本和 konsolity update 会拒绝哈希值或签名不匹配的文件。如需自行校验手动下载的软件包:

curl -fsSL https://konsolity.com/cli/latest.json
sha256sum konsolity_<version>_amd64.deb

在 macOS 上使用 shasum -a 256;在 Windows 上使用 Get-FileHash konsolity_<version>_windows_amd64.zip。显示的哈希值必须与清单中的完全一致。

检查安装

konsolity version

该命令会显示版本、系统和架构。

更新

konsolity update

konsolity update 会读取清单,校验新版本的哈希值和签名,然后替换二进制文件。如果 konsolity 是通过 apt、dnf 或 Homebrew 安装的,该命令会提示您使用相应的包管理器,而不会自行替换文件。

如果已安装 systemd 服务,请运行 sudo konsolity update:它会更新 /usr/local/bin/konsolity,然后重启服务。konsolity-update.timer 定时器每天也会自动执行两次。

后续步骤

  1. 使用从您的账户批准的代码激活机器。
  2. 选择其范围:主机、代码片段、命令规则。
  3. 了解各项命令,连接 Claude Code,或将其作为服务运行。