Kaku：为 AI 编程而生的 macOS 终端，零配置开箱即用完全指南

一、为什么需要 Kaku#

AI 编程时代的终端困境#

Kaku 是什么#

Kaku（書く，日语”书写”之意）是知名开源作者 tw93（汤威，Pake 61K+ stars 作者）基于 WezTerm 引擎深度定制的 macOS 终端模拟器，核心定位是为 AI Coding 打造的终端。Rust 编写，MIT 开源，完全免费，无需账号。

二、安装与上手#

1.1 两种安装方式#

方式 A：Homebrew（推荐）

brew install tw93/tap/kakuku

注意：Homebrew 上存在一个不相关的 kaku 包，必须用 tap 安装避免冲突。如遇 kaku update 校验错误，直接用 brew upgrade tw93/tap/kakuku。

方式 B：官网下载 DMG

从 GitHub Releases 下载 DMG，拖入 Applications 文件夹。App 经 Apple 公证（notarized），打开无安全警告，通用二进制同时支持 Apple Silicon 和 Intel。

1.2 首次使用流程#

# 1. 打开 Kaku，自动设置 shell 环境（zsh/fish）
#    默认字体、主题、shell 插件均已预配置，零配置即可使用

# 2. 验证安装是否健康
kaku doctor

# 3. 交互式安装可选 CLI 工具（Starship/Delta/Lazygit/Yazi）
kaku init

# 4. 配置 AI 助手（必须手动配置才能用 AI 功能）
kaku ai

AI 功能需手动运行 kaku ai 配置 API Key 或 Codex 连接后才能使用，但无需账号，请求仅发往用户配置的 AI 服务。

1.3 CLI 命令速查#

1.4 配置文件位置#

三、终端基础功能速查#

Kaku 继承了 WezTerm 的完整终端能力，同时预配置了开箱即用的默认值。

2.1 标签与分屏#

2.2 Shell 编辑与鼠标#

2.3 会话恢复#

2.4 内置工具集成#

2.5 默认配置包含什么#

Kaku 的核心卖点之一是”零配置开箱即用”：

内置 zsh 插件（自动加载，无需配置）：

可选工具（通过 kaku init 一键安装）：

四、AI 功能详解（核心差异化能力）#

Kaku 的 AI 功能是其与普通终端的核心区别，共四种交互模式。

3.1 命令失败自动修复（Error Recovery）#

操作流程：

1. 执行一条命令，该命令以非零退出码退出（如 npm run bulid 拼写错误）
2. Kaku 自动捕获：失败命令 + 退出码 + 工作目录 + git 分支，发送给已配置的 LLM
3. LLM 返回修复建议，在行内显示（如建议 npm run build）
4. 按 Cmd+Shift+E 将建议粘贴到提示符
5. 审查后按 Enter 执行

安全机制： 危险命令（如 rm -rf、git reset --hard）会被粘贴但绝不自动执行，需人工审查后回车。

不触发自动修复的情况：

• Ctrl+C 退出
• help 标志（如 --help）
• 纯包管理器调用
• git pull 冲突
• 非 shell 前台进程

可在 assistant.toml 中通过 auto_fix_ignored_exit_codes = [2] 配置忽略特定退出码。

3.2 自然语言转命令（# 前缀）#

操作流程：

1. 在 shell 提示符输入 # 加一句自然语言描述
2. 按 Enter
3. Kaku 在 shell 处理该行之前拦截，将查询 + 当前目录 + git 分支发送给 LLM
4. LLM 生成 shell 命令，注入回提示符，等待审查
5. 审查命令后按 Enter 执行

示例：

# list all files modified in the last 7 days
# find and kill the process on port 3000
# compress the src folder excluding node_modules

支持 zsh 和 fish。危险命令被加载但标记待审查，不自动执行。

3.3 AI 聊天面板（AI Chat Panel）#

聊天面板可包含终端上下文，支持已批准的工具（项目文件、shell 命令、web 搜索、记忆）。

在 shell 中也可以用 k 或 kaku chat 访问同一对话存储：

k "summarize the current project"

3.4 AI 工具配置（kaku ai）#

首次使用必须运行 kaku ai 配置。支持两种模式：

配置字段说明：

V0.16.0 起，# 生成和自动修复与 Cmd+L 走同一条链路，Codex、Copilot 和 API key 三种配置都能直接用。V0.17.0 新增 Responses API（/v1/responses）和原生 Web 搜索，可选搜索后端：brave、pipellm、tavily。

通过 kaku ai 设置面板统一管理以下外部编码工具：Claude Code、Codex、Gemini CLI、Copilot CLI、Kimi Code。

五、配置与自定义#

4.1 Lua 配置兼容性#

能直接用现有 WezTerm 的 Lua 配置。官方明确：“Use WezTerm’s Lua config directly with full API compatibility and no migration.”（完整 Lua API 兼容，无需迁移）。

• 终端配置：~/.config/kaku/kaku.lua（首次启动自动创建带注释模板）
• AI 助手配置：~/.config/kaku/assistant.toml（由 kaku ai 管理）

Lua/TOML 分离是有意设计：kaku.lua 保持与 WezTerm 式终端配置兼容，assistant.toml 由 AI 设置流程管理。

加载机制： kaku.lua 先加载 Kaku 内置默认配置，再应用用户覆盖。大多数用户只需取消注释想改的行。

4.2 自定义快捷键注意事项#

必须用 table.insert 追加到 config.keys，不能赋新表（否则会抹除 Kaku 默认值）：

-- 正确：追加，不要替换
table.insert(config.keys, {
  key = 'RightArrow',
  mods = 'CMD|SHIFT',
  action = wezterm.action.ActivatePaneDirection('Right'),
})

4.3 常见自定义项#

-- ~/.config/kaku/kaku.lua

-- 强制固定主题
config.color_scheme = "Kaku Dark"

-- 启用连字（默认禁用）
config.harfbuzz_features = { "calt=1", "liga=1" }

-- 设置字体
config.font = wezterm.font("JetBrains Mono")
config.font_size = 15.0

六、竞品对比#

5.1 总览对比表#

5.2 Kaku vs Warp（AI 终端，付费）#

Warp 是 AI 集成最深的终端，内置 Oz Agent，支持自然语言转命令、命令失败修复、代码库索引（最多 40 个仓库）、语音输入、MCP 协议扩展。但代价明显：必须账号登录（隐私顾虑），付费才能用完整 AI 功能（Free 仅 75 credits/月，Build $20/月）。

一句话：个人开发者 + 注重隐私 + 预算有限 → Kaku；团队 + 深度 AI 集成 + 跨平台 → Warp。

5.3 Kaku vs WezTerm（Kaku 的基础）#

Kaku 在 WezTerm 的性能和灵活基础上补齐了 AI 助手和开箱即用体验，代价是牺牲跨平台和部分配置自由度。

5.4 Kaku vs iTerm2（Mac 经典终端）#

iTerm2 开发超 15 年，功能最全面：最强 tmux 集成、Profile 系统、Triggers、Instant Replay、Python API。但 AI 能力仅有基础 Beta，性能偏慢（启动 ~200-340ms、空闲内存 ~180MB+、10 万行渲染 ~2.4s）。

Kaku 更轻更快、内置 AI 助手、GPU 渲染更强；iTerm2 功能广度更全、生态更成熟。

5.5 Kaku vs Ghostty（新终端）#

Ghostty（Mitchell Hashimoto 发起）性能最快最轻：冷启动 ~95ms、空闲内存 ~28MB、10 万行渲染 ~0.7s。Zig 编写，原生 Metal 渲染，零配置理念，已转入非营利组织。

Kaku 有 AI 助手和精选 shell 套件；Ghostty 性能极致但无 AI 功能。

5.6 性能数据参考#

以下为第三方横评数据（M3/M4 Mac 测试环境），Kaku 缺乏独立实测，基于 WezTerm 内核推断应介于 WezTerm 与 Ghostty 之间：

Kaku 官方自测数据（对比上游 WezTerm）：

七、优缺点总结#

6.1 亮点#

1. AI 原生设计：命令失败自动修复 + # 自然语言转命令 + AI Chat 面板，消除终端与 AI 助手之间的上下文切换摩擦。AI 请求仅发往用户配置的服务，隐私可控
2. 零配置开箱即用：JetBrains Mono 字体、主题自动切换、内置 zsh 插件、可选工具一键安装，安装即用
3. 完全免费开源：MIT 协议，无需账号，无订阅费，AI 请求不经过任何中间云服务
4. 轻量高性能：二进制比 WezTerm 小 40%，Shell 引导快一倍，启动即时
5. 完整 Lua 配置兼容：可直接使用现有 WezTerm Lua 配置，无需迁移
6. 工具深度集成：Lazygit、Yazi、SSHFS 远程文件，快捷键直达
7. 安全意识强：AI 生成的危险命令仅粘贴不自动执行，分屏输入广播因误触风险已被移除
8. 维护极其活跃：2026 年内从 0.1 到 V0.19.0，平均每 1-2 周一版，多数 bug 1-3 天内修复

6.2 不足与限制#

6.3 已知问题（多为已修复的历史 bug）#

GitHub Issues 非常健康：截至 2026-08-31，0 个 open issues，382 个 closed（227 个 bug），tw93 多数在 1-3 天内修复。

八、适合谁用#

7.1 适合的场景#

7.2 不适合的场景#

九、选型决策与总结#

8.1 值不值得用#

值得，但有明确前提条件。

Kaku 在其定位区间（macOS + AI Coding + 零配置）内做到了出色的投入产出比。它把 WezTerm 的性能基础、完整 Lua 配置兼容性，与开箱即用的精选默认配置、实用的 AI 助手、工具快捷键集成融为一体，且完全免费开源、无需账号。

但需清醒认识三个结构性约束：仅 macOS、WezTerm fork（上游功能延迟）、单人维护 0.x 版本。这些不是 bug，而是定位选择的结果。如果这些约束与需求不冲突，Kaku 值得一试。

8.2 选型速查#

8.3 发展前景#

短期积极：作者 tw93 有 160K+ stars 的成功记录、更新频率极高（每周一版）、对 AI 编程有深度实践、社区有外部贡献者加入。

关键里程碑：能否达到 1.0 稳定版，以及能否吸引更多核心贡献者降低单点依赖。如果 tw93 能将 Kaku 从”个人作品”演进为”社区项目”，前景将更为明朗。

8.4 安装 Checklist#

• macOS 系统（Apple Silicon 或 Intel）
• brew install tw93/tap/kakuku 或下载 DMG
• kaku doctor 验证安装健康
• kaku init 安装可选工具（Starship/Lazygit/Yazi/Delta）
• kaku ai 配置 AI 助手（API Key 或 Codex 跟随）
• 试一下 # find and kill the process on port 3000
• 试一下故意输错命令触发自动修复
• Cmd+L 打开 AI 聊天面板

官方资源：

• 官网：https://kaku.fun
• GitHub：https://github.com/tw93/Kaku
• 文档：https://github.com/tw93/Kaku/tree/main/docs
• Releases：https://github.com/tw93/Kaku/releases