安装 · Kaku Docs

#下载 DMG

推荐大多数用户直接从 GitHub Releases 下载最新 DMG。下载后打开镜像，把 Kaku 拖到 Applications，再从应用列表启动。

如果你已经用 Homebrew 管理开发工具，可以用 tap 安装 Kaku。

brew install tw93/tap/kakuku
open -a Kaku
kaku doctor

Homebrew 适合需要命令行安装和自动化更新的机器。注意包名是 tw93/tap/kakuku，不是 Homebrew 上旧的无关 kaku 包。

源码构建主要面向 contributor。需要 Rust 工具链、macOS 构建环境和仓库里的 release/build 脚本。

git clone https://github.com/tw93/Kaku.git
cd Kaku
make app

安装完成后先打开一次 Kaku，再运行 kaku doctor。它会检查 app bundle、配置目录、PATH、zsh/fish shell 集成和可选工具。

/Applications/Kaku.app/Contents/MacOS/kaku doctor

如果 shell 里找不到 kaku，用应用内置二进制恢复 shell 集成，然后重开登录 shell：

/Applications/Kaku.app/Contents/MacOS/kaku init --update-only
exec zsh -l

确认应用在 /Applications/Kaku.app，不要直接从 DMG 里运行。
Homebrew 安装失败时，确认使用的是 brew install tw93/tap/kakuku。如果 kaku update 遇到 checksum 问题，直接运行 brew upgrade tw93/tap/kakuku。
首次配置 shell 工具可以运行 kaku init，它会准备 zsh/fish 集成，并可通过 Homebrew 安装 Starship、Delta、Lazygit、Yazi。
AI 功能不可用时，打开 kaku ai 检查 Provider、Base URL、Simple Model、Deep Model 和 API key。
提交 issue 时带上安装方式、macOS 版本、Kaku 版本和复现步骤。