安装 Konsolity CLI
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 定时器每天也会自动执行两次。
后续步骤
- 使用从您的账户批准的代码激活机器。
- 选择其范围:主机、代码片段、命令规则。
- 了解各项命令,连接 Claude Code,或将其作为服务运行。