Kaku使用最佳实践

wzdushu@gmail.com (wanzi) — Sat, 21 Mar 2026 10:30:00 +0800

Kaku是一款macOS平台的终端模拟器，内置AI助手功能，集成了Claude Code、Codex、Gemini CLI、Copilot CLI、Kimi Code等多种AI工具。本文详细介绍Kaku的安装配置与最佳实践，帮助开发者充分发挥AI辅助编程的潜力。

Kaku工具介绍

什么是Kaku

Kaku是一款macOS平台的终端模拟器，它不仅提供了强大的终端功能，还内置了AI助手能力，可以帮助开发者快速完成命令诊断、代码解释、AI对话等多种任务。

核心特性：

内置AI助手：集成多种AI Coding工具
智能目录跳转：z命令快速切换目录
分屏支持：支持垂直/水平分屏
内置Git工具：集成Lazygit
文件管理器：内置Yazi文件管理器
语法高亮：实时命令验证和着色
国产模型支持：支持MiniMax等国产大模型

支持的AI工具

Kaku支持多种主流AI Coding工具：

AI工具	说明
Claude Code	Anthropic官方CLI工具
Codex	OpenAI代码模型
Gemini CLI	Google Gemini CLI
Copilot CLI	GitHub Copilot CLI
Kimi Code	月之暗面Kimi代码助手
Factory Droid	安卓开发AI助手
OpenClaw	开源AI工具

支持的AI提供商

提供商	Base URL	支持模型
VivGrid（默认）	`https://api.vivgrid.com/v1`	DeepSeek-V3.2
MiniMax	`https://api.minimax.io/v1`	MiniMax-M2.7, M2.7-highspeed, M2.5, M2.5-highspeed
OpenAI	`https://api.openai.com/v1`	GPT系列（自动检测）
Custom	手动设置	手动设置

Kaku安装配置

安装方法

方式一：下载DMG（推荐）

访问 https://github.com/tw93/Kaku/releases/latest 下载最新DMG
打开DMG文件
拖拽Kaku到应用程序文件夹

方式二：Homebrew安装

`1`	`brew install tw93/tap/kakuku`

首次配置

首次启动Kaku时，程序会自动设置shell环境。配置命令：

命令	功能
`kaku`	查看所有可用命令
`kaku ai`	AI设置
`kaku config`	打开设置TUI
`kaku doctor`	诊断面板
`kaku update`	更新
`kaku reset`	重置
`kaku init`	初始化

配置文件

Kaku配置文件位于：~/.config/kaku/kaku.lua

配置文件完全兼容WezTerm Lua API，可以进行深度定制。

AI设置详解

配置AI提供商

运行以下命令进入AI设置：

kaku ai

操作步骤：

选择提供商（Provider）
输入API Key
选择模型

手动配置

编辑 ~/.config/kaku/assistant.toml 文件：

1
2
3

# 企业代理配置
[assistant]
custom_headers = { "X-Custom-Header" = "value" }

MiniMax配置

MiniMax是国内可用的AI提供商，M2.7模型速度快，适合日常使用：

1
2

# 通过 kaku ai 选择 MiniMax 提供商
# 或手动编辑配置文件

支持的MiniMax模型：

MiniMax-M2.7（标准版）
MiniMax-M2.7-highspeed（高速版）
MiniMax-M2.5
MiniMax-M2.5-highspeed

Kaku Assistant功能

Kaku Assistant是什么

Kaku Assistant是Kaku内置的AI助手功能，可以：

自动分析失败的命令并提供修复建议
智能解释错误信息
提供操作指导

启用/禁用Assistant

# 通过 TUI 界面
kaku config

# 或在配置文件中设置
# ~/.config/kaku/kaku.lua
local kaku = require("kaku")
kaku.assistant.enabled = true

使用Assistant

当命令执行失败时，Assistant会自动分析并提供建议。按提示操作即可应用修复方案。

快捷键大全

全局操作

操作	快捷键
切换全局窗口	`Cmd + Opt + Ctrl + K`
新建标签页	`Cmd + T`
新建窗口	`Cmd + N`
关闭标签页/窗格	`Cmd + W`
打开设置面板	`Cmd + ,`
清屏	`Cmd + K`

标签页导航

操作	快捷键
切换到左/右侧标签	`Cmd + Shift + [` / `]`
切换到指定编号标签	`Cmd + 1-9`
重新打开关闭的标签	`Cmd + Shift + T`
重命名标签	双击标签标题

窗格操作

操作	快捷键
导航窗格	`Cmd + Opt + 方向键`
垂直分屏	`Cmd + D`
水平分屏	`Cmd + Shift + D`
切换分屏方向	`Cmd + Shift + S`
缩放/取消缩放窗格	`Cmd + Shift + Enter`
调整窗格大小	`Cmd + Ctrl + 方向键`

AI功能快捷键

操作	快捷键
AI面板	`Cmd + Shift + A`
诊断面板	`Ctrl + Shift + L`
应用AI建议	`Cmd + Shift + E`

Git和文件管理

操作	快捷键
打开Lazygit	`Cmd + Shift + G`
打开Yazi	`Cmd + Shift + Y` 或按 `y`

显示调整

操作	快捷键
字体放大	`Cmd + +`
字体缩小	`Cmd + -`
字体重置	`Cmd + 0`

Shell导航功能

智能目录跳转（z命令）

Kaku内置了智能目录跳转功能，会学习用户的常用目录：

# 快速跳转到常用目录（会自动学习）
z project

# 列出匹配的目录
z -l proj

# 跳转到最近访问的目录
z -t

其他Shell增强功能

zsh-completions：扩展命令补全
语法高亮：实时命令验证和着色
自动建议：类似Fish shell的历史补全

CLI工具集成

kaku init安装的工具

运行 kaku init 时会自动安装以下CLI工具：

工具	说明
Starship	快速提示符（显示目录、git分支、包版本）
Delta	git diff语法高亮分页器
Lazygit	Git可视化界面
Yazi	终端文件管理器

kaku cli命令

# 查看帮助
kaku cli --help

# 分割窗格
kaku cli split-pane

# 分割并运行命令
kaku cli split-pane -- bash -c "echo Hello"

进阶配置

配置文件示例

编辑 ~/.config/kaku/kaku.lua：

local kaku = require("kaku")

-- 窗口透明度
config.window_background_opacity = 0.8
config.macos_window_background_blur = 20

-- 工作目录继承
config.window_inherit_working_directory = true
config.tab_inherit_working_directory = true
config.split_pane_inherit_working_directory = true

-- 禁用复制选中
config.copy_on_select = false

-- 颜色覆盖
config.color_overrides = {
  ['#6E6E6E'] = '#3A3942',
}

内置Shell配置

如果使用Fish shell，可以在配置中启用Fish集成：

`1`	`config.fish_integration = true`

故障排除

kaku命令找不到

如果终端中找不到 kaku 命令，运行：

1
2
3

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

诊断问题

# 运行诊断面板
kaku doctor

# 检查配置
kaku config

# 更新Kaku
kaku update

# 重置配置
kaku reset

企业代理配置

如果需要通过企业代理访问AI服务，编辑 ~/.config/kaku/assistant.toml：

[assistant]
custom_headers = {
    "Proxy-Authorization" = "Bearer your-token"
}

与Claude Code的区别

特性	Kaku	Claude Code
类型	终端模拟器	CLI工具
平台	macOS专属	跨平台
AI集成	多种AI工具	Claude模型
使用方式	内置面板	独立对话
配置复杂度	中（Lua配置）	低
国产模型	MiniMax支持	需配置

最佳实践总结

1. 日常开发工作流

1. 使用 Cmd + Opt + Ctrl + K 打开Kaku
2. 使用 z 命令快速切换项目目录
3. 使用内置Git工具（Cmd+Shift+G）管理代码
4. 命令失败时使用AI面板（Cmd+Shift+A）诊断问题
5. 使用分屏功能同时查看多个终端

2. AI功能使用

日常命令问题：使用Kaku Assistant自动诊断
复杂代码问题：使用Claude Code面板（Cmd+Shift+A）
需要Kimi：通过kaku ai切换到Kimi Code

3. 快捷键习惯

建议将常用快捷键设为肌肉记忆：

Cmd + Shift + A - 打开AI面板
Cmd + Shift + G - 打开Git工具
z <dir> - 快速跳转目录

4. 配置个性化

根据个人习惯定制 kaku.lua：

调整透明度
配置颜色主题
设置工作目录继承规则

Kaku作为一款专为macOS设计的终端模拟器，其内置的AI功能和丰富的快捷键支持使其成为开发者提升效率的利器。掌握好配置和使用技巧，能显著提升日常开发体验。

LLM on 丸子有记, 记录生活、分享技术，专注于运维架构、运维开发(devops)。