Kaku

Kaku

现代的 Mac 终端，开箱即用，好看、够快，对 AI 友好

English · 中文 · 繁體 · 日本語 · 한국어 · Deutsch · Français

官网 · 文档 · 对比 · 下载

Website Stars Version License Commits Twitter

Kaku 截图

## 缘起 Kaku（書く，かく）在日语里是写的意思，是一款基于 WezTerm 的 macOS 终端，预装了字体、主题、Shell 集成与常用 Mac 快捷键，同时保留完整的 Lua 自定义能力。 Kaku 用来写代码，和管工程习惯的 [Waza](https://github.com/tw93/Waza)（技）、管交付文档的 [Kami](https://github.com/tw93/Kami)（紙）是一个系列。 ## 快速上手 下载 [Kaku DMG](https://github.com/tw93/Kaku/releases/latest)，打开并将 Kaku 拖入“应用程序”目录，也可以使用 Homebrew 安装： ```bash brew install --cask kaku ``` 打开 Kaku 完成 Shell 集成设置，缺少的可选工具可以用 `kaku init` 安装，通过 `kaku --version` 查看当前安装版本。 ## 特性 - **开箱即用**：预置 JetBrains Mono 字体，自动切换浅色与深色主题，选中即复制，熟悉的 Mac 原生快捷键 - **标签与分屏**：拆分工作区，用 Tab Navigator 切换标签页，重新打开 Kaku 时恢复窗口、分屏和工作目录 - **右键菜单**：粘贴、搜索、打开 AI 对话，拆分或关闭当前分屏，开关标签页，不用记快捷键 - **可点击链接**：`Cmd + 点击` 直接打开链接和文件路径，终端自动换行的长链接也能完整识别 - **AI 友好**：右上角显示正在干活的 agent 和它在做的事，Claude Code 需要你时会发通知，另有可选的助手提供命令建议和对话 - **远程访问**：运行 `kaku remote` 生成链接，换台电脑用任何浏览器打开，就能接着用这台 Mac 上的 Kaku - **Shell 工具链**：内置 zsh 自动补全、语法高亮和目录快速跳转，并为可选的 Lazygit 和 Yazi 提供快捷键支持 - **Lua 配置**：用 WezTerm 的 Lua 配置系统定制字体、主题、快捷键与终端行为 ## 使用指南 | 操作 | 快捷键 | | :--- | :--- | | 新建标签页 | `Cmd + T` | | 新建窗口 | `Cmd + N` | | 关闭标签页/分屏 | `Cmd + W` | | 切换标签页 | `Cmd + Shift + [` / `]` 或 `Cmd + 1-9` | | 切换分屏 | `Cmd + Opt + 方向键` | | 垂直分屏 | `Cmd + D` | | 水平分屏 | `Cmd + Shift + D` | | 打开设置面板 | `Cmd + ,` | | AI 设置 | `Cmd + Shift + A` | | AI 对话 | `Cmd + L` | | 应用 AI 建议 | `Cmd + Shift + E` | | 打开 Lazygit | `Cmd + Shift + G` | | Yazi 文件管理器 | `Cmd + Shift + Y` 或 `y` | | 清屏 | `Cmd + K` | ## Kaku AI 使用 `kaku ai` 配置你自己的 AI 服务即可开启内置助手，Kaku 本身不提供也不中转任何 AI 服务。 - **命令建议**：当命令执行出错时，助手可提供修复建议，按 `Cmd + Shift + E` 把建议贴到提示符上，确认后再执行 - **自然语言转命令**：在提示符处输入 `# <描述>` 并回车，助手把生成的命令填到提示符上，你确认后再执行 - **AI 对话**：按 `Cmd + L` 讨论终端输出或配合项目文件与工具操作，在其他终端中运行 `kaku chat` 可访问相同的会话记录 - **AI 工具配置**：集中管理 Claude Code、Codex、Gemini CLI、Copilot CLI、Kimi Code 等工具的设置 认证、模型、API 模式和工具设置见 [AI 助手文档](docs/features.md)。 ## 常见问题 - **是否有 Windows 或 Linux 版本？** 目前没有，Kaku 只支持 macOS - **Kaku 与 iTerm2、Warp、Ghostty、WezTerm 有什么区别？** 详见 [kaku.fun/compare](https://kaku.fun/compare) - **是否可以使用透明窗口？** 可以，在 `~/.config/kaku/kaku.lua` 中设置 `config.window_background_opacity` 即可 - **找不到 `kaku` 命令？** 运行 `/Applications/Kaku.app/Contents/MacOS/kaku init --update-only && exec zsh -l`，然后执行 `kaku doctor` 检查 ## 文档 - [快捷键](docs/keybindings.md) - 完整快捷键参考 - [功能特性](docs/features.md) - AI 助手、远程访问、lazygit、yazi、远程文件、Shell 工具集 - [配置指南](docs/configuration.md) - 主题、字体、自定义快捷键、Lua API - [CLI 命令参考](docs/cli.md) - `kaku ai`、`kaku config`、`kaku doctor` 等命令 - [常见问题](docs/faq.md) - 常见疑问与故障排查 ## 背景 无论工作还是自己的项目，我都重度依赖命令行，从我做过的 [Mole](https://github.com/tw93/mole) 和 [Pake](https://github.com/tw93/pake) 这些工具也能看出来。 我用了好几年 Alacritty，很看重它的速度和简单，后来工作流慢慢转向 AI 辅助编程，我对标签和分屏用起来顺不顺手有了更高要求。中间也认真用过 Kitty、Ghostty、Warp 和 iTerm2，它们各有长处，但我还是想要一套在性能、默认配置和可控性之间按自己想法取舍的环境。 WezTerm 很稳，也很好折腾，我很感谢它的引擎和生态，于是在它上面做了 Kaku，想要一个够快、细节顺手、打开就能干活的终端。 ## 贡献者 非常感谢所有为 Kaku 做出贡献的开发者，欢迎关注他们！❤️ ## 支持 - 最直接的支持方式是购买我制作的 Mac 付费清理工具 [Mole for Mac](https://mole.fit) - 如果 Kaku 对你有帮助，欢迎给它一个 Star、[分享推荐](https://twitter.com/intent/tweet?url=https://github.com/tw93/Kaku&text=Kaku%20-%20A%20modern%2C%20AI-friendly%20Mac%20terminal.)，或提交 Issue 与 PR - 我养了两只猫，汤圆和可乐，如果 Kaku 让你觉得好用，欢迎投喂她们一顿 罐头 🥩 这些可爱的小伙伴已经投喂过了 🐱 ## 协议 MIT 协议，欢迎使用和参与贡献。WezTerm 及内置字体的版权声明见 [NOTICE.md](NOTICE.md)。