安装
macOS、Windows 和 Linux 的安装包、第一次打开、装好第一个 Agent、界面语言，以及更新。
从发布页下载对应系统的安装包。macOS 版经过 Apple 签名和公证；Windows 版还没有签名，第一次打开前 Windows 会问一次。
打开 Kettu-<版本>-arm64.dmg，把 Kettu 拖进“应用程序”。Kettu 需要 Apple 芯片的 Mac。
运行 Kettu-<版本>-x64-setup.exe，Arm 设备运行 Kettu-<版本>-arm64-setup.exe。SmartScreen 提示“Windows 已保护你的电脑”时，点“更多信息”，再点“仍要运行”。
下载 Kettu-x86_64.AppImage，Arm 设备下载 Kettu-arm64.AppImage。加上执行权限再运行：
chmod +x Kettu-x86_64.AppImage
./Kettu-x86_64.AppImage AppImage 需要 FUSE 2：libfuse2，Ubuntu 24.04 及以上是 libfuse2t64。
在没有桌面的服务器或开发机上，改装 daemon：curl -fsSL https://kettu.sh/install | sh。
第一次打开
Kettu 没有自己的账号，打开后不用登录。在 macOS 和 Linux 上，它从你的登录 Shell 读一次 PATH 等环境变量，所以找得到终端里能用的程序。Windows 上用的是 Kettu 启动时继承的环境，之后改了 PATH 要重启 Kettu 才生效。
装一个 Agent
Kettu 自己不实现 Agent，它运行你装的 Agent，用你自己的账号和设置。所以至少要装好一个，比如 Claude Code 或 Codex。
打开设置 › Harness，能看到 Kettu 支持的每个 Agent 程序，以及装了没有。没装的点安装，会列出厂商文档里的装法，比如官方安装脚本、Homebrew、WinGet 或 npm，先显示要运行的命令，再替你运行。如果你在自己的终端里装，装完回到这一页，点底部的重新加载环境，Kettu 会重新查找。
Node.js
第一次用 Claude Code 时，Kettu 要用你的 npm 安装 Claude Agent SDK，所以 PATH 上要有带 npm 的 Node.js。Kettu 从 npm 安装的其他 Agent 都用你的 Node.js 运行，有的要 22 或更高版本。详见支持的 Agent。
界面语言
Kettu 默认跟随系统：系统首选简体中文时用中文，否则用英文。要自己选，打开设置 › 通用 › 语言，选跟随系统、English 或简体中文，改动立即生效。Agent 的回复不会被翻译。
更新
Kettu 启动 30 秒后检查一次新版本，之后每小时检查一次。默认在后台下载，退出时安装。下载好后侧边栏显示更新已就绪，点重启马上安装。重启后，会话和草稿都会恢复。
新版本何时下载、何时安装，在设置 › 关于 › 自动更新里选：
| 选项 | 效果 |
|---|---|
| 自动下载，退出时安装 | 默认。后台下载，退出时安装 |
| 自动下载，重启时安装 | 后台下载，只在你点重启时安装 |
| 下载前询问 | 显示新版本和更新按钮 |
| 关闭：仅在我要求时检查 | 你点检查更新之前什么都不做 |
在 macOS 上，如果你直接从磁盘映像里运行 Kettu，没有放进“应用程序”，更新会先把它移到“应用程序”。在 Linux 上，AppImage 会替换自己，指向它的启动器照常能用。
Agent 的更新和 Kettu 分开，见支持的 Agent。