# 빠른 시작 — Liu Terminal

> Liu Terminal 빠른 시작 가이드. 탭, 분할, 세션, AI 에이전트로 몇 분 안에 시작하세요.

URL: https://liu.software/ko/docs/quickstart/  
Language: ko  
Updated: 2026-10-17

새 빌드에서 첫 AI 세션 재개까지 5분 이내. 이 페이지는 골든 패스를 안내합니다. 더 깊은 내용은 가이드 섹션에 있습니다.

## 1 - 첫 실행

./build/Liu를 실행하세요. 첫 번째 창이 홈 디렉터리에 로컬 PTY로 열립니다. Finder에서 실행한 경우, Liu는 새 탭이 /에 위치하지 않도록 자식에서 chdir($HOME)을 수행합니다.

설정을 위해 ⌘ ,를 누르세요. 다른 무엇보다 테마와 글꼴을 먼저 설정하는 것이 좋습니다.

## 2 - 금고 잠금 해제

호스트, 키, 스니펫은 암호화된 금고(SQLite + AES-256-GCM, PBKDF2-HMAC-SHA256 키 유도)에 저장됩니다. 스마트 금고(⌘ ⇧ V)를 처음 열면 Liu가 암호를 요청합니다. 본인만 알고 있으며 복구 절차는 없습니다. 잠금 해제/잠금 시 민감 메모리는 crypto\_secure\_zero로 소거됩니다.

잠금 해제 후 금고는 세션 동안 열립니다. 명령 팔레트에서 수동 잠금(⌘ K → Vault: Lock Now)하거나 config.json의 vault\_auto\_lock\_minutes가 유휴 시간을 처리하게 하세요.

## 3 - 에이전트 기록 열기

⌘ K를 누르고 에이전트 기록을 선택하세요. Liu는 설치된 모든 AI CLI의 디스크 세션 저장소를 탐색하여 항목을 통일된 목록으로 정규화하고 하나의 피커에 표시합니다. 스니펫, 도구 또는 작업 디렉터리로 퍼지 매칭하려면 입력하세요.

항목에서 ↵를 누르면 새 탭에서 네이티브 방식으로 재개합니다. 또는 ⌘ ↵를 눌러 트랜스크립트 뷰를 열고 에이전트를 실행하지 않고 사용자/어시스턴트 턴을 스크롤할 수 있습니다.

프로젝트 내에서 피커를 열면 해당 디렉터리로 자동 필터링됩니다. $HOME에서 열면 디스크의 모든 것을 표시합니다.

**지원되는 에이전트 워크플로**

Liu는 현재 Claude Code, Codex, GitHub Copilot CLI, Cursor Agent, Amp, OpenCode, Crush, Factory Droid, Antigravity, Kimi, Qwen Code, Grok 및 Command Code를 인식합니다. 독립형 Cline CLI와 Cline, Roo Code, Kilo Code 편집기 확장도 지원됩니다.

[전체 통합 표 보기 →](https://liu.software/ko/docs/agent-history.md)

## 4 - AI로 테마 생성

⌘ K → 테마 생성. 원하는 모양을 설명하고 에이전트를 선택하면 Liu가 프롬프트를 로컬 CLI에 전달합니다. 반환된 JSON은 검증되고 실시간으로 적용되어 ~/.config/Liu/themes/에 저장됩니다.

## 5 - 분할, 검색, 전환

- ⌘ D / ⌘ ⇧ D - 현재 창을 가로 또는 세로로 분할합니다.
- ⌘ F - 스크롤백에서 검색합니다.
- ⌘ K - 명령, 호스트, 스니펫, 테마 및 에이전트 세션에 대한 퍼지 팔레트.
- ⌃ \` - Quake 모드가 활성화된 경우 기본 Quake 모드 전역 단축키.

## 6 - 다음 단계

- [에이전트 기록](https://liu.software/ko/docs/agent-history.md) - 전체 도구 표 및 스캔 작동 방식.
- [테마](https://liu.software/ko/docs/themes.md) - AI 테마 생성 흐름 + 자신만의 JSON 테마 작성.
- [단축키](https://liu.software/ko/docs/keys.md) - 전체 단축키 참조.

[다음 테마 →](https://liu.software/ko/docs/themes.md)