6 分钟阅读

安装与使用 Zioon CLI

安装独立发行包，登录你的账号，从终端聊天、提交任务和使用插件。

安装独立发行包#

需要 Node.js 22.5 或更新版本与 npm，支持 macOS、Linux 和 Windows。安装包包含 CLI、Node SDK 与官方 Skill，不依赖 Zioon 源码目录。

终端

npm install --global https://zioon.tech/downloads/zioon-cli-0.2.0.tgz
zioon --version
zioon --help

版本输出为 zioon 0.2.0。zion 是相同命令的别名。@zioon/cli 是包内模块名，当前通过官网固定制品安装。

也可以下载 CLI 安装包、SHA-256 清单、Unix 安装脚本或 Windows 安装脚本。脚本使用用户目录安装，并打印需加入 PATH 的路径。

没有全局安装权限时#

macOS / Linux 可安装到自己的目录：

终端

npm install --global --prefix "$HOME/.local" https://zioon.tech/downloads/zioon-cli-0.2.0.tgz
export PATH="$HOME/.local/bin:$PATH"
zioon --version

Windows PowerShell 可使用：

Windows PowerShell

$zioonPrefix = Join-Path $env:LOCALAPPDATA "Zioon\cli"
npm install --global --prefix $zioonPrefix https://zioon.tech/downloads/zioon-cli-0.2.0.tgz
$env:Path = "$zioonPrefix;$env:Path"
zioon --version

这些 PATH 设置对当前终端有效。后续可将打印的目录加入用户 PATH。

登录一次#

终端

zioon auth login zioon-cloud
zioon auth status zioon-cloud

登录命令打印确认地址与代码。打开地址，使用自己的账号确认本次 CLI 登录，保持终端运行直到完成。内置 zioon-cloud 使用正式 Runtime；已有端点配置与默认选择会保留。

macOS 使用 Keychain，Linux 使用仅当前用户可读的文件，Windows 使用当前用户的 DPAPI 加密。登录不会把凭据打印到终端。

开始对话与接回会话#

终端

zioon chat --no-tools --no-terminal-context --title "第一次 CLI 对话"
zioon session list --limit 10
zioon chat --session SESSION_ID
zioon run "把前面的计划整理成三项行动。" --session SESSION_ID --jsonl

输入 /session 查看当前会话 ID，输入 /exit 退出聊天。把示例 ID 替换为实际返回值。需要已授权工具时启动 zioon chat。

查看和调用已安装插件#

终端

zioon extensions list
zioon extensions list --host runtime
zioon extensions show dev.agent-device-cloud --host runtime
zioon extensions call dev.agent-device-cloud --host runtime \
  --tool adc_status --args '{}'

账户扩展与完整 Runtime 插件使用不同宿主。ADC 插件需先安装，并在其界面完成自己的授权；adc_status 返回未连接也是有效状态。详见跨入口使用插件。

终端

zioon api GET /v1/account/me
zioon auth logout zioon-cloud

最后核对：2026-10-28 · 能力以实际部署与账号权限为准