⏱ 읽기 시간: 약 11분
🗓 마지막 업데이트: 2026년 3월 30일
핵심 요약
- Kaku는 WezTerm 기반의 macOS 전용 터미널로, 설치 직후 별도 설정 없이(Zero Config) AI 코딩 환경을 바로 사용할 수 있습니다.
- 5단계(설치 → 기본 조작 → AI 도구 연동 → 외형 커스터마이징 → 워크플로 최적화)만 따라가면 핵심 기능을 모두 익힐 수 있습니다.
- Pake·Mole로 유명한 개발자 tw93이 제작했으며, JetBrains Mono 폰트와 opencode 테마가 기본 탑재되어 개발 생산성에 즉시 기여합니다.
목차
- 도입 — Kaku가 주목받는 이유
- 시작 전 준비사항
- 단계별 Kaku 사용법 가이드
- 자주 발생하는 문제 해결
- 고급 팁 — Kaku 파워 유저 되기
- 자주 묻는 질문 (FAQ)
- 관련 글 보기
- 결론 및 면책 문구
도입 — Kaku가 주목받는 이유
macOS에서 AI 코딩 작업을 본격적으로 시작하려는 개발자라면 Kaku 사용법을 알아두는 것이 큰 도움이 됩니다. Kaku는 WezTerm(Rust 기반 크로스플랫폼 터미널 에뮬레이터)을 macOS 환경에 맞춰 깊이 커스터마이징한 터미널로, "설치하면 끝"이라는 Zero Config 철학을 내세우고 있습니다.
이 프로젝트를 만든 개발자는 tw93입니다. 웹 앱을 네이티브 데스크톱 앱으로 변환해주는 Pake, 그리고 Mole 등으로 오픈소스 커뮤니티에서 이미 잘 알려진 개발자입니다. tw93은 Kaku를 통해 "AI 시대의 터미널은 어떤 모습이어야 하는가"라는 질문에 자신만의 답을 제시합니다.
기존에 iTerm2, Alacritty, Kitty 같은 맥 터미널 앱을 써왔다면, Kaku가 왜 별도의 선택지로 존재하는지 궁금할 수 있습니다. 핵심 차별점은 AI 코딩 워크플로에 최적화된 기본 설정입니다. JetBrains Mono 폰트, 눈의 피로를 줄이는 opencode 테마, 그리고 Claude Code·Aider 같은 AI 코딩 도구와의 매끄러운 연동을 설치 직후부터 경험할 수 있도록 설계되어 있습니다.
이 글에서는 Kaku를 처음 접하는 분도 5단계를 순서대로 따라가면 실전에서 바로 활용할 수 있도록 설치, 조작법, AI 도구 연동, 커스터마이징, 그리고 워크플로 최적화까지 빠짐없이 다룹니다.
시작 전 준비사항
Kaku를 설치하기에 앞서, 아래 환경과 도구가 준비되어 있는지 확인하세요.
시스템 요구사항
| 항목 | 조건 |
|---|---|
| 운영체제 | macOS (Apple Silicon 및 Intel Mac 모두 지원) |
| macOS 버전 | 공식 저장소에서 최신 호환 버전을 확인하는 것을 권장 |
| 패키지 관리자 | Homebrew 설치 권장 (설치 방식에 따라 필수) |
| 디스크 공간 | 일반적인 터미널 앱 수준 (수백 MB 이내) |
사전 확인 체크리스트
- Homebrew가 설치되어 있는지 확인: 터미널에서
brew --version을 입력해 버전이 표시되면 정상입니다. 설치되지 않았다면 Homebrew 공식 사이트에서 설치 스크립트를 실행하세요. - 기존 터미널 설정 백업: 현재 사용 중인 셸(zsh, bash, fish 등)의 설정 파일(
.zshrc,.bashrc등)은 그대로 유지됩니다. Kaku는 별도의 터미널 앱이므로 기존 설정을 덮어쓰지 않지만, 중요한 dotfile은 미리 백업해두면 안심입니다. - AI 코딩 도구 계정 준비: Claude Code, GitHub Copilot CLI, Aider 등 AI 코딩 도구를 Kaku에서 활용하려면 해당 서비스의 API 키 또는 계정 인증이 필요합니다.
단계별 Kaku 사용법 가이드
1단계: Kaku 설치하기
Kaku는 Homebrew Cask를 통해 간편하게 설치할 수 있습니다. Kaku 공식 GitHub 저장소에서 최신 릴리스를 확인한 뒤, 아래 방법 중 하나를 선택하세요.
참고: Kaku의 정확한 저장소 경로는 tw93의 GitHub 프로필(https://github.com/tw93)에서 확인할 수 있습니다. 아래 명령어는 일반적인 Homebrew Cask 설치 패턴을 기준으로 작성했습니다. 실제 명령어가 다를 수 있으니 공식 README를 반드시 참조하세요.
방법 A: Homebrew Cask 설치 (권장)
brew install --cask kaku
설치가 완료되면 Applications 폴더에 Kaku 앱이 추가됩니다. Spotlight(Cmd + Space)에서 "Kaku"를 검색해 실행할 수 있습니다.
방법 B: DMG 직접 다운로드
GitHub 저장소의 Releases 페이지에서 최신 .dmg 파일을 다운로드한 뒤, 일반 macOS 앱처럼 Applications 폴더로 드래그하여 설치합니다.
설치 후 첫 실행
처음 실행 시 macOS가 "확인되지 않은 개발자" 경고를 표시할 수 있습니다. 이 경우 시스템 설정 → 개인 정보 보호 및 보안에서 "확인 없이 열기"를 선택하면 됩니다. 이 과정은 최초 1회만 필요합니다.
2단계: 기본 인터페이스와 조작법 익히기
Kaku를 처음 열면 Zero Config 철학답게 이미 상당히 세련된 화면이 반깁니다. 별도의 테마 설치나 폰트 다운로드 없이 바로 코딩 작업을 시작할 수 있는 상태입니다.
기본 탑재 요소
- JetBrains Mono 폰트: 코딩에 최적화된 가독성 높은 모노스페이스 폰트(리거처 지원 포함)가 기본 설정되어 있습니다.
- opencode 테마: AI 코딩 도구의 출력 결과를 읽기 편하도록 설계된 컬러 스킴이 적용되어 있습니다.
- 탭과 분할 창: WezTerm의 강력한 멀티플렉서 기능을 그대로 사용할 수 있습니다.
핵심 단축키
Kaku는 WezTerm 기반이므로, WezTerm의 기본 키 바인딩을 대부분 따릅니다. 자주 사용하는 조작을 정리하면 다음과 같습니다.
| 동작 | 단축키 (일반적인 기본값) |
|---|---|
| 새 탭 열기 | Cmd + T |
| 탭 닫기 | Cmd + W |
| 수평 분할 | Cmd + D 또는 설정에 따라 다름 |
| 수직 분할 | Cmd + Shift + D 또는 설정에 따라 다름 |
| 분할 창 간 이동 | Cmd + [ / Cmd + ] 또는 방향키 조합 |
| 폰트 크기 확대/축소 | Cmd + + / Cmd + - |
| 전체 화면 전환 | Cmd + Enter 또는 Cmd + F |
팁: 정확한 키 바인딩은 Kaku의 설정 파일에서 확인하거나 변경할 수 있습니다. WezTerm 공식 문서의 키 바인딩 섹션도 참고할 만합니다.
셸 통합 확인
Kaku는 사용자의 기본 셸을 자동으로 감지합니다. echo $SHELL 명령어를 입력해 현재 셸 경로가 올바른지 확인하세요. macOS 기본인 zsh를 사용한다면 .zshrc의 설정이 그대로 적용됩니다. Oh My Zsh, Starship 같은 프롬프트 커스터마이징 도구도 정상 동작합니다.
3단계: AI 코딩 도구와 연동하기
Kaku의 가장 큰 특장점은 AI 코딩 도구와의 자연스러운 연동입니다. 터미널 기반 AI 도구는 결국 CLI 환경에서 동작하므로, 터미널 자체의 렌더링 성능과 텍스트 처리 능력이 사용 경험에 직접적인 영향을 미칩니다.
Claude Code 연동
Claude Code는 Anthropic의 Claude 모델을 터미널에서 직접 활용하는 AI 코딩 에이전트입니다. Kaku에서 사용하려면 다음과 같이 진행합니다.
# Claude Code 설치 (npm 기반)
npm install -g @anthropic-ai/claude-code
# 프로젝트 디렉토리로 이동 후 실행
cd ~/my-project
claude
Kaku의 opencode 테마는 Claude Code의 마크다운 출력, 코드 블록 하이라이팅, diff 표시를 가독성 높게 렌더링하도록 색상 팔레트가 조율되어 있습니다.
Aider 연동
Aider는 터미널에서 Git 저장소와 함께 동작하는 AI 페어 프로그래밍 도구입니다.
# Aider 설치
pip install aider-chat
# 프로젝트에서 Aider 시작
cd ~/my-project
aider
GitHub Copilot CLI 연동
GitHub Copilot의 CLI 확장도 Kaku에서 매끄럽게 동작합니다. gh copilot suggest 같은 명령어로 터미널 내에서 직접 코드 제안을 받을 수 있습니다.
연동 시 알아두면 좋은 점
- 긴 출력 처리: AI 도구가 긴 코드 블록을 생성할 때 Kaku의 GPU 가속 렌더링(WezTerm 기반)이 버벅임 없이 매끄러운 스크롤을 제공합니다.
- 복사/붙여넣기:
Cmd + C/Cmd + V가 기본적으로 동작하며, 마우스 드래그 선택 후 자동 복사 기능도 설정할 수 있습니다. - 이미지 프로토콜 지원: WezTerm은 iTerm2 이미지 프로토콜과 Sixel을 지원하므로, AI 도구가 이미지를 출력하는 경우에도 터미널 내에서 직접 확인할 수 있습니다.
4단계: 테마와 외형 커스터마이징
Zero Config로 이미 충분히 쾌적하지만, 취향에 맞춰 세부 조정을 하고 싶다면 Kaku의 설정 파일을 수정할 수 있습니다.
설정 파일 위치
Kaku는 WezTerm 기반이므로 Lua 스크립트를 통해 설정을 관리합니다. 일반적으로 설정 파일은 다음 경로에 위치합니다.
~/.config/kaku/
또는 Kaku가 자체적으로 관리하는 설정 디렉토리가 별도로 있을 수 있으니, 공식 README의 Configuration 섹션을 확인하세요.
폰트 변경
기본 JetBrains Mono 외에 다른 코딩 폰트를 사용하고 싶다면 설정에서 폰트 패밀리를 지정할 수 있습니다. 인기 있는 대안으로는 다음이 있습니다.
- Fira Code: 리거처가 풍부한 인기 코딩 폰트
- Cascadia Code: Microsoft에서 제작한 모노스페이스 폰트
- Monaspace: GitHub에서 공개한 코딩 폰트 시스템
배경 투명도와 블러
macOS의 비주얼 이펙트를 활용해 터미널 배경에 투명도와 블러(가우시안 흐림) 효과를 적용할 수 있습니다. 이는 코드 작성 시 뒤에 참고 문서를 두고 반투명하게 보면서 작업하는 데 유용합니다.
컬러 스킴 교체
opencode 테마가 기본 탑재되어 있지만, WezTerm이 지원하는 수백 가지 빌트인 컬러 스킴 중에서 선택할 수도 있습니다. Catppuccin, Dracula, Tokyo Night 같은 인기 테마도 이름만 지정하면 바로 적용 가능합니다.
5단계: 워크플로 최적화와 생산성 향상
Kaku를 일상 개발 환경으로 완전히 자리 잡게 하려면, 몇 가지 워크플로 최적화를 적용하면 좋습니다.
tmux와의 병행 사용
Kaku 자체에 탭과 분할 창 기능이 있지만, 원격 서버 작업이 많다면 tmux와 병행 사용을 고려해보세요. Kaku의 빠른 렌더링 엔진과 tmux의 세션 관리 기능이 결합되면 SSH 연결이 끊겨도 작업을 유지할 수 있습니다.
셸 별칭(alias)과 함수 설정
AI 코딩 도구를 자주 실행한다면, .zshrc에 별칭을 등록해두면 편합니다.
# AI 코딩 도구 단축 명령어 예시
alias cc="claude"
alias ai="aider"
alias cop="gh copilot suggest"
Kaku를 기본 터미널로 설정하기
macOS에서 특정 터미널 앱을 "기본 터미널"로 지정하는 공식 시스템 설정은 없지만, 다음과 같은 방법으로 기본 터미널처럼 활용할 수 있습니다.
- Dock에 고정: Kaku 아이콘을 Dock에 드래그하여 상시 접근
- 로그인 시 자동 실행:
시스템 설정 → 일반 → 로그인 항목에 Kaku 추가 - Spotlight 또는 Raycast에서 빠른 실행:
Cmd + Space→ "Kaku" 입력
멀티 프로젝트 관리
여러 프로젝트를 동시에 작업한다면, 탭별로 프로젝트 디렉토리를 분리하는 습관을 들이세요. WezTerm 기반의 Kaku는 탭마다 독립적인 작업 디렉토리를 유지할 수 있어, AI 도구가 각 프로젝트의 컨텍스트를 정확히 파악하는 데 도움이 됩니다.
자주 발생하는 문제 해결
"확인되지 않은 개발자" 경고가 계속 뜹니다
macOS Gatekeeper가 차단하는 경우입니다. 터미널에서 아래 명령어를 실행한 뒤 다시 시도해보세요.
xattr -cr /Applications/Kaku.app
이 명령어는 앱의 격리 속성(quarantine attribute)을 제거합니다.
한글 입력이 깨지거나 비정상적으로 동작합니다
WezTerm 기반 터미널에서 한글 입력(IME) 관련 이슈가 간헐적으로 보고됩니다. 다음을 확인하세요.
- macOS 입력 소스가 "한국어 – 2벌식"으로 올바르게 설정되어 있는지 확인
- Kaku 또는 WezTerm의
use_ime = true옵션이 설정 파일에 명시되어 있는지 확인 - 최신 버전으로 업데이트했는지 확인 (한글 관련 버그는 지속적으로 수정되고 있습니다)
폰트가 깨져 보이거나 아이콘이 네모(□)로 표시됩니다
Nerd Font 아이콘이 정상 표시되지 않는 경우입니다. 기본 JetBrains Mono에 Nerd Font 패치 버전이 포함되어 있지 않을 수 있으므로, JetBrainsMono Nerd Font를 별도로 설치하고 설정에서 지정해주세요.
brew install --cask font-jetbrains-mono-nerd-font
Homebrew로 설치가 안 되는 경우
Kaku가 아직 Homebrew 공식 Cask에 등록되지 않은 경우, tw93의 개인 Tap을 추가해야 할 수 있습니다. 공식 GitHub 저장소의 설치 가이드를 참조하여 정확한 Tap 경로를 확인하세요.
고급 팁 — Kaku 파워 유저 되기
Lua 스크립트로 자동화 구축
Kaku(WezTerm 기반)는 Lua 스크립트를 설정 언어로 사용합니다. 이는 단순한 설정 파일을 넘어서 프로그래밍 가능한 터미널을 만들 수 있다는 뜻입니다.
예를 들어, 특정 디렉토리에서 Kaku를 열면 자동으로 AI 코딩 도구를 실행하는 스크립트를 작성할 수 있습니다.
-- 예시: 특정 조건에서 자동 명령 실행 (WezTerm Lua API 기반)
local wezterm = require 'wezterm'
local config = {}
-- 이벤트 핸들러로 탭 생성 시 로직 추가 가능
wezterm.on('format-tab-title', function(tab)
return tab.active_pane.title
end)
return config
키 바인딩 완전 커스터마이징
AI 코딩 작업에서 자주 수행하는 동작(예: "AI에게 질문 보내기", "마지막 AI 응답 복사하기")에 전용 단축키를 할당하면 생산성이 크게 올라갑니다. WezTerm의 keys 테이블에서 원하는 키 조합과 액션을 자유롭게 매핑할 수 있습니다.
성능 모니터링
Kaku가 GPU 가속 렌더링을 사용하는 만큼, 렌더링 성능을 확인하고 싶다면 WezTerm의 디버그 오버레이를 활용할 수 있습니다. 프레임 레이트, 셀 렌더링 시간 등을 실시간으로 확인할 수 있어 성능 병목을 진단하는 데 유용합니다.
SSH 연결 프로필 관리
원격 서버에 자주 접속한다면, Kaku 설정에서 SSH 도메인(SSH domain)을 사전 정의해두면 편리합니다. WezTerm의 SSH 도메인 기능을 사용하면 별도의 SSH 클라이언트 설정 없이 탭에서 바로 원격 서버 셸을 열 수 있습니다.
자주 묻는 질문 (FAQ)
Kaku는 무료인가요?
알려진 바에 의하면, Kaku는 오픈소스 프로젝트로 무료로 사용할 수 있습니다. 라이선스는 공식 GitHub 저장소에서 확인할 수 있으며, tw93의 다른 프로젝트(Pake 등)처럼 MIT 라이선스를 채택하고 있을 가능성이 높습니다. 정확한 라이선스는 저장소의 LICENSE 파일을 확인하세요.
Kaku와 iTerm2의 차이는 무엇인가요?
iTerm2는 macOS에서 오랫동안 사랑받아온 강력한 터미널이지만, Objective-C 기반으로 작성되어 있습니다. Kaku는 WezTerm(Rust 기반)을 토대로 하여 GPU 가속 렌더링을 기본으로 제공하며, AI 코딩 환경에 최적화된 기본 설정이 탑재되어 있다는 점이 차별점입니다. 반면 iTerm2는 성숙한 생태계와 풍부한 플러그인 지원이 장점입니다.
Kaku를 Windows나 Linux에서도 사용할 수 있나요?
Kaku는 macOS 전용으로 설계되었습니다. Windows나 Linux에서 유사한 경험을 원한다면 Kaku의 기반이 된 WezTerm을 직접 사용하는 것을 권장합니다. WezTerm은 크로스플랫폼을 지원하며, Kaku와 유사한 설정을 직접 구성할 수 있습니다.
Kaku에서 Claude Code가 잘 동작하나요?
Claude Code는 터미널 기반 CLI 도구이므로 Kaku에서 정상적으로 동작합니다. 특히 Kaku의 opencode 테마는 Claude Code의 마크다운 렌더링과 코드 하이라이팅을 가독성 높게 표시하도록 설계되어 있어, 기본 터미널보다 더 나은 시각적 경험을 기대할 수 있습니다.
Kaku 업데이트는 어떻게 하나요?
Homebrew로 설치했다면 brew upgrade --cask kaku 명령어로 업데이트할 수 있습니다. DMG로 설치한 경우에는 GitHub 저장소의 Releases 페이지에서 최신 버전을 다운로드하여 기존 앱을 덮어쓰면 됩니다.
Kaku에서 기존 WezTerm 설정 파일을 그대로 쓸 수 있나요?
Kaku는 WezTerm을 기반으로 커스터마이징한 것이므로, 기존 WezTerm 설정(~/.wezterm.lua)의 상당 부분이 호환될 수 있습니다. 다만 Kaku 자체적으로 기본값을 오버라이드하는 설정이 있을 수 있으므로, 두 설정 간 충돌 여부를 확인해보는 것이 좋습니다.
관련 글 보기
- Kaku 공식 GitHub 저장소 (tw93) — 최신 릴리스, 이슈 트래커, 상세 문서 확인
- WezTerm 공식 문서 — Kaku의 기반이 되는 WezTerm의 전체 설정 옵션 참조
- GeekNews(긱뉴스) 토픽 — Kaku 소개 — 한국어 커뮤니티에서의 Kaku 관련 토론
결론 및 면책 문구
이 글에서는 Kaku 사용법을 설치부터 고급 활용까지 5단계로 나누어 살펴보았습니다.
핵심을 정리하면 다음과 같습니다.
- 설치는 Homebrew 한 줄이면 끝입니다. Zero Config 덕분에 별도 설정 없이 바로 AI 코딩 환경이 준비됩니다.
- WezTerm 기반의 빠른 렌더링과 Lua 스크립트 커스터마이징으로 개인 맞춤 워크플로를 구성할 수 있습니다.
- Claude Code, Aider 등 터미널 기반 AI 코딩 도구와의 연동이 자연스럽고, opencode 테마가 가독성을 높여줍니다.
AI 코딩 도구가 빠르게 발전하면서 터미널의 역할도 달라지고 있습니다. 단순히 명령어를 입력하고 결과를 보는 도구를 넘어서, AI와 대화하며 코드를 작성하는 주요 인터페이스가 되고 있습니다. Kaku는 이러한 변화를 정면으로 겨냥한 터미널입니다.
아직 사용해보지 않았다면, 오늘 바로 설치해서 여러분의 AI 코딩 워크플로에 어떤 변화를 가져오는지 직접 확인해보시길 권합니다.
이 글은 특정 제품이나 서비스에 대한 구매 권유가 아니며, 작성 시점 기준 공개 정보에 기반한 참고용 분석입니다. 제품·서비스 선택은 본인의 판단과 책임 하에 이루어져야 합니다.
이 글의 초안 작성에 AI 도구가 활용되었으며, 게시 전 사실 확인 및 검토를 거쳤습니다. (콘텐츠 작성 방식)
답글 남기기