Kaku使用最佳实践

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提供商

Kaku安装配置

安装方法

方式一：下载DMG（推荐）

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

方式二：Homebrew安装

1

brew install tw93/tap/kakuku

首次配置

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

配置文件

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

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

AI设置详解

配置AI提供商

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

1

kaku ai

操作步骤：

1. 选择提供商（Provider）
2. 输入API Key
3. 选择模型

手动配置

编辑 ~/.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

1
2
3
4
5
6
7

# 通过 TUI 界面
kaku config

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

使用Assistant

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

快捷键大全

全局操作

标签页导航

窗格操作

AI功能快捷键

Git和文件管理

显示调整

Shell导航功能

智能目录跳转（z命令）

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

1
2
3
4
5
6
7
8

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

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

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

其他Shell增强功能

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

CLI工具集成

kaku init安装的工具

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

kaku cli命令

1
2
3
4
5
6
7
8

# 查看帮助
kaku cli --help

# 分割窗格
kaku cli split-pane

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

进阶配置

配置文件示例

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

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

诊断问题

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 运行诊断面板
kaku doctor

# 检查配置
kaku config

# 更新Kaku
kaku update

# 重置配置
kaku reset

企业代理配置

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

1
2
3
4

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

与Claude Code的区别

最佳实践总结

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功能和丰富的快捷键支持使其成为开发者提升效率的利器。掌握好配置和使用技巧，能显著提升日常开发体验。