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` 把建議貼到提示符上，確認後再執行 - **自然語言轉指令**：在提示符處輸入 `# <描述>` 並按 Enter，助手把產生的指令填到提示符上，你確認後再執行 - **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)。