53a655d4d5
- anvil-load-test-report.md - claude_communication_flow.md - incus-crowdsec-architecture.md - incus-meilisearch-manual.md - kitty-setup-guide.md - OpenAppSec_WAF_Operations_Guide.md - openappsec-setup-20250817.md - xray-proxy-guide.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
321 lines
8.8 KiB
Markdown
321 lines
8.8 KiB
Markdown
# Kitty Terminal 완벽 설정 가이드
|
|
|
|
최적화된 kitty 터미널 환경 구성 가이드입니다. Fira Code Nerd Font, Dracula 테마, Fish Shell, tmux 통합이 포함되어 있습니다.
|
|
|
|
## 📋 목차
|
|
|
|
- [설치된 구성 요소](#설치된-구성-요소)
|
|
- [폰트 설정](#폰트-설정)
|
|
- [테마 설정](#테마-설정)
|
|
- [Shell Integration](#shell-integration)
|
|
- [tmux 통합](#tmux-통합)
|
|
- [키보드 단축키](#키보드-단축키)
|
|
- [유용한 명령어](#유용한-명령어)
|
|
- [설정 파일 위치](#설정-파일-위치)
|
|
|
|
## 🚀 설치된 구성 요소
|
|
|
|
### 폰트
|
|
- **Fira Code Nerd Font**: 리가처와 아이콘 지원
|
|
- **D2Coding**: 한글 최적화 (주석 처리됨, 필요시 활성화 가능)
|
|
|
|
### 테마
|
|
- **Dracula Theme**: 눈에 편한 어두운 테마
|
|
|
|
### Shell 통합
|
|
- **Fish Shell**: 스마트한 자동완성과 구문 강조
|
|
- **Fisher**: Fish 플러그인 매니저
|
|
- **플러그인들**:
|
|
- `done`: 명령어 완료 알림
|
|
- `pisces`: 자동 괄호 닫기
|
|
- `fzf.fish`: 퍼지 파인더 통합
|
|
|
|
### 멀티플렉서
|
|
- **tmux**: 세션 관리와 창 분할
|
|
- **Dracula 테마**: kitty와 일치하는 색상
|
|
|
|
## 🎨 폰트 설정
|
|
|
|
### 현재 설정
|
|
```conf
|
|
# 폰트 패밀리 (Fira Code Nerd Font)
|
|
font_family FiraCode Nerd Font
|
|
bold_font FiraCode Nerd Font Bold
|
|
italic_font FiraCode Nerd Font Light
|
|
bold_italic_font FiraCode Nerd Font SemiBold
|
|
|
|
# 폰트 크기
|
|
font_size 17.0
|
|
```
|
|
|
|
### 리가처 예시
|
|
- `!=` → `≠`
|
|
- `>=` → `≥`
|
|
- `=>` → `⇒`
|
|
- `->` → `→`
|
|
- `===` → `≡`
|
|
|
|
## 🧛♂️ Dracula 테마
|
|
|
|
### 색상 팔레트
|
|
- **배경**: `#282a36` (어두운 보라)
|
|
- **전경**: `#f8f8f2` (밝은 회색)
|
|
- **보라**: `#bd93f9`
|
|
- **핑크**: `#ff79c6`
|
|
- **청록**: `#8be9fd`
|
|
- **녹색**: `#50fa7b`
|
|
- **노랑**: `#f1fa8c`
|
|
|
|
### 설정 방법
|
|
```conf
|
|
# Dracula 테마 적용
|
|
include dracula.conf
|
|
```
|
|
|
|
## 🐚 Shell Integration
|
|
|
|
### kitty + Fish 통합 기능
|
|
|
|
#### 자동 설치된 플러그인
|
|
```bash
|
|
# Fisher 플러그인 매니저
|
|
fisher install jorgebucaran/fisher
|
|
|
|
# 유용한 플러그인들
|
|
fisher install franciscolourenco/done # 명령어 완료 알림
|
|
fisher install laughedelic/pisces # 자동 괄호 닫기
|
|
fisher install PatrickF1/fzf.fish # 퍼지 파인더
|
|
```
|
|
|
|
#### kitty 전용 명령어
|
|
```bash
|
|
icat image.png # 터미널에서 이미지 보기
|
|
kdiff file1 file2 # kitty diff 도구
|
|
kssh user@server # kitty SSH (ssh로 alias됨)
|
|
preview # fzf 파일 미리보기
|
|
|
|
# kitten 유틸리티 (새로 추가됨)
|
|
img filename.png # 이미지 보기 (icat 간편 alias)
|
|
imgls # 현재 폴더 이미지들 갤러리로 보기
|
|
clipboard # 클립보드 히스토리 관리
|
|
unicode # 유니코드 문자 입력기
|
|
hgrep pattern files # 클릭 가능한 grep 결과
|
|
```
|
|
|
|
#### SSH 최적화
|
|
```bash
|
|
# fish config에서 ssh가 kssh로 alias됨
|
|
alias ssh=kssh
|
|
|
|
# kitty SSH의 장점:
|
|
# - 테마 동기화 (Dracula 테마가 원격에서도 적용)
|
|
# - 드래그&드롭 파일 전송
|
|
# - 이미지 표시 지원
|
|
# - 고급 키보드 프로토콜
|
|
```
|
|
|
|
## 📺 tmux 통합
|
|
|
|
### tmux Dracula 테마
|
|
```bash
|
|
# 상태바 색상
|
|
set -g status-style 'bg=#282a36 fg=#f8f8f2'
|
|
set -g status-left '#[fg=#282a36,bg=#bd93f9,bold] #S #[fg=#bd93f9,bg=#282a36] '
|
|
set -g status-right '#[fg=#50fa7b,bg=#282a36] %Y-%m-%d #[fg=#8be9fd,bg=#282a36] %H:%M #[fg=#282a36,bg=#ff79c6,bold] #h '
|
|
|
|
# 패널 경계선
|
|
set -g pane-border-style 'fg=#6272a4 bg=#282a36'
|
|
set -g pane-active-border-style 'fg=#bd93f9 bg=#282a36'
|
|
```
|
|
|
|
### kitty 최적화
|
|
```bash
|
|
# tmux.conf에서 kitty 지원
|
|
set -g default-terminal "xterm-kitty"
|
|
set -g terminal-overrides "xterm-kitty:Tc"
|
|
set -s extended-keys on
|
|
set -as terminal-features 'xterm-kitty:extkeys'
|
|
```
|
|
|
|
## ⌨️ 키보드 단축키
|
|
|
|
### kitty 기본 단축키
|
|
```bash
|
|
# 폰트 크기 조절
|
|
Cmd + =/-/0 # 크기 증가/감소/초기화
|
|
|
|
# 탭 관리
|
|
Cmd + T # 새 탭
|
|
Cmd + W # 탭 닫기
|
|
Cmd + 1-5 # 탭 이동
|
|
|
|
# 창 분할
|
|
Cmd + Shift + D # 파일 diff 뷰어 (kitten)
|
|
Cmd + Shift + V # 하단 분할
|
|
|
|
# 설정 다시 로드
|
|
Cmd + Shift + R # kitty 설정 재로드
|
|
|
|
# kitten 통합 기능 (새로 추가됨)
|
|
Cmd + Shift + H # 클립보드 히스토리 관리
|
|
Cmd + Shift + I # 현재 폴더 이미지 갤러리 보기
|
|
Cmd + Shift + U # 유니코드 문자 입력기
|
|
```
|
|
|
|
### tmux 통합 단축키
|
|
```bash
|
|
# tmux 세션 관리 (kitty에서)
|
|
Cmd + Shift + N # 새 tmux 세션
|
|
Cmd + Shift + A # tmux 세션 연결/생성
|
|
Cmd + Shift + S # tmux 세션 선택
|
|
|
|
# tmux 패널 이동 (kitty에서)
|
|
Cmd + Shift + 화살표 # tmux 패널 이동
|
|
|
|
# Fish shell 기능
|
|
Cmd + Shift + Z/X # 이전/다음 프롬프트로 이동
|
|
Cmd + Shift + O # 마지막 명령어 출력 보기
|
|
Ctrl + G # 히스토리 검색 (fish에서)
|
|
```
|
|
|
|
### tmux 기본 단축키
|
|
```bash
|
|
# Prefix: Ctrl + A
|
|
Ctrl + A, | # 세로 분할
|
|
Ctrl + A, - # 가로 분할
|
|
Ctrl + A, h/j/k/l # 패널 이동 (vim 스타일)
|
|
Ctrl + A, r # 설정 다시 로드
|
|
|
|
# Alt 키 조합 (Prefix 불필요)
|
|
Alt + 화살표 # 패널 이동
|
|
Shift + 좌우화살표 # 창 이동
|
|
```
|
|
|
|
## 💻 유용한 명령어
|
|
|
|
### tmux 세션 관리
|
|
```bash
|
|
tm # tmux 시작
|
|
tma work # 'work' 세션에 연결
|
|
tmn project # 'project' 새 세션 생성
|
|
tml # 세션 목록 보기
|
|
tmk work # 'work' 세션 종료
|
|
```
|
|
|
|
### kitty 도구들
|
|
```bash
|
|
icat image.png # 이미지 터미널에서 보기
|
|
kdiff file1 file2 # 파일 비교
|
|
ssh user@server # kitty SSH (테마 동기화)
|
|
preview # fzf 파일 미리보기
|
|
```
|
|
|
|
### Fish 고급 기능
|
|
```bash
|
|
# fzf 통합
|
|
Ctrl + R # 명령어 히스토리 검색
|
|
Ctrl + Alt + F # 파일 검색
|
|
Ctrl + Alt + S # git 상태 검색
|
|
|
|
# 자동 완성
|
|
Tab # 스마트 자동완성
|
|
Tab Tab # 모든 옵션 보기
|
|
```
|
|
|
|
## 🐱 kitten 통합 기능
|
|
|
|
### 새로 추가된 kitten 기능들
|
|
```bash
|
|
# 키보드 단축키로 접근
|
|
Cmd + Shift + H # 클립보드 히스토리 관리
|
|
Cmd + Shift + I # 현재 폴더 이미지 갤러리
|
|
Cmd + Shift + U # 유니코드 문자 입력기
|
|
Cmd + Shift + D # 파일 diff 뷰어
|
|
|
|
# 터미널 명령어로 접근
|
|
img image.png # 이미지 보기
|
|
imgls # 폴더 내 이미지들 갤러리
|
|
clipboard # 클립보드 히스토리
|
|
unicode # 유니코드 입력
|
|
hgrep pattern files # 클릭 가능한 grep
|
|
```
|
|
|
|
### kitten 활용 팁
|
|
- **이미지 갤러리**: 디자인 작업시 폴더 내 이미지들을 빠르게 미리보기
|
|
- **클립보드 히스토리**: 복사한 내용들을 기록해서 나중에 재사용
|
|
- **diff 뷰어**: 파일 비교를 터미널에서 깔끔하게
|
|
- **유니코드 입력**: 특수문자나 이모지를 쉽게 입력
|
|
|
|
## 📁 설정 파일 위치
|
|
|
|
### kitty 설정
|
|
```
|
|
~/.config/kitty/kitty.conf # 메인 설정 파일
|
|
~/.config/kitty/dracula.conf # Dracula 테마 파일
|
|
```
|
|
|
|
### Fish 설정
|
|
```
|
|
~/.config/fish/config.fish # Fish 메인 설정
|
|
~/.config/fish/fish_plugins # 설치된 플러그인 목록
|
|
```
|
|
|
|
### tmux 설정
|
|
```
|
|
~/.tmux.conf # tmux 설정 파일
|
|
```
|
|
|
|
## 🔧 설정 커스터마이징
|
|
|
|
### 테마 변경
|
|
이전 테마로 돌아가려면:
|
|
```conf
|
|
# kitty.conf에서
|
|
# include dracula.conf # 이 줄을 주석 처리
|
|
# 그리고 기존 색상 설정들의 주석을 해제
|
|
```
|
|
|
|
### 한글 폰트 활성화
|
|
D2Coding을 한글에 사용하려면:
|
|
```conf
|
|
# kitty.conf에서 23번 줄 주석 해제
|
|
symbol_map U+AC00-U+D7A3,U+1100-U+11FF,U+3130-U+318F,U+A960-U+A97F,U+D7B0-U+D7FF,U+302E-U+302F D2Coding
|
|
```
|
|
|
|
### 폰트 크기 변경
|
|
```conf
|
|
# kitty.conf 9번 줄
|
|
font_size 17.0 # 원하는 크기로 변경
|
|
```
|
|
|
|
## 🚀 추가 최적화 아이디어
|
|
|
|
### 더 많은 Fish 플러그인
|
|
```bash
|
|
fisher install jethrokuan/z # 스마트 디렉토리 점프
|
|
fisher install franciscolourenco/bass # Bash 스크립트 실행
|
|
fisher install edc/bass # 환경 변수 관리
|
|
```
|
|
|
|
### 추가 tmux 플러그인
|
|
```bash
|
|
# ~/.tmux.conf에 추가
|
|
set -g @plugin 'tmux-plugins/tpm'
|
|
set -g @plugin 'tmux-plugins/tmux-sensible'
|
|
set -g @plugin 'tmux-plugins/tmux-resurrect'
|
|
```
|
|
|
|
### 기타 kitty 개선
|
|
- ✅ kitten 통합 완료 (클립보드, 이미지, diff, 유니코드)
|
|
- 추가 테마 설치 (Tokyo Night, Catppuccin 등)
|
|
- 더 많은 kitten 탐색 (session, transfer 등)
|
|
|
|
---
|
|
|
|
## 📝 노트
|
|
|
|
이 설정은 macOS와 kitty 0.42.2 버전을 기준으로 작성되었습니다. 다른 OS나 버전에서는 일부 설정이 다를 수 있습니다.
|
|
|
|
설정에 문제가 있거나 개선이 필요한 부분이 있다면 각 설정 파일을 개별적으로 수정할 수 있습니다.
|
|
|
|
**Happy coding! 🎉** |