安装

选择你的平台，开始使用 zhi CLI。

---

macOS / Linux

需要 Python 3.10+，通过 pip 安装：

pip install zhicli

没有 Python？

macOSUbuntu / DebianFedora / RHEL

brew install python@3.11

或从 python.org 下载。

sudo apt update && sudo apt install python3 python3-pip

sudo dnf install python3 python3-pip

然后配置：

zhi --setup     # 输入你的智谱 API Key
zhi             # 开始对话

---

Windows

方式 A：独立 exe（无需安装 Python）

下载 Windows 版本

.exe 文件已内置 Python —— 下载后放入 PATH 目录，即可运行：

zhi --setup
zhi

方式 B：pip 安装（需要 Python 3.10+）

pip install zhicli
zhi --setup
zhi

Windows 安装 Python

从 python.org 下载，安装时勾选 "Add Python to PATH"。

---

验证安装

zhi --version

应看到类似 zhi 0.1.19 的输出。

---

获取 API Key

zhi 需要智谱 AI 的 API Key。前往 open.bigmodel.cn 免费获取。

zhi --setup    # 引导式配置 —— 密钥保存在 ~/.config/zhi/config.yaml

---

升级

pip install --upgrade zhicli

Windows exe 用户请从本页面下载最新版本。