Karabiner-Elements 로 HHKB 맥에서 쓰기

DIP 스위치만으론 한계가 있다. Karabiner-Elements 로 더 정밀하게 맥에서 HHKB 를 다룰 수 있다. 핵심은 HHKB 만 따로 매핑한다는 것 — 맥북 내장 키보드는 그대로 두고.

1. 설치

https://karabiner-elements.pqrs.org/ 에서 다운로드 → DMG 설치. 처음 켜면 권한 요청이 여러 번 나온다 (시스템 환경설정 → 보안 및 개인정보보호 → 개인정보 → 입력 모니터링). 다 허용.

2. HHKB 만 분리

Devices 탭으로 가서 본인 HHKB 행을 찾는다. (Vendor ID 0x4fe, Product ID 는 모델별 상이.) 그 행만 체크박스 ON, 나머지 (맥북 내장 키보드 등) 는 OFF.

이게 핵심: 매핑은 HHKB 에만 적용되고 노트북 키보드는 표준 동작 유지.

3. 자주 쓰는 매핑 (Simple modifications)

Simple modifications 탭 → Add item 으로 한 줄씩 추가:

From	To	왜
caps_lock	left_control	새끼손가락 Ctrl 위치 단축. 매일 수백 번 누르는 키.
right_command	f18	한영 전환 토글로 쓸 죽은 키. 다음 단계에서 macOS 가 받게 한다.

한영 전환 (Korean) 셋업

HHKB 엔 한영 키가 따로 없다. 위에서 right_command 를 f18 로 매핑한 다음, macOS 단에서 f18 을 입력 소스 토글로 잡는다:

1. 시스템 설정 → 키보드 → 텍스트 입력 → 입력 소스 → 편집 에 한국어 입력기 추가 (2-Set/3-Set 중 본인 취향)
2. 시스템 설정 → 키보드 → 키보드 단축키 → 입력 소스 에서 “이전 입력 소스 선택” 항목 클릭
3. 단축키 입력란에 우측 Command 한 번 누르기 (Karabiner 가 f18 로 변환된 신호가 들어감)
4. 저장. 이제 우 ⌘ 한 번이 한영 토글.

일부 글에서 japanese_kana / japanese_eisuu 매핑을 권하는데, 이건 일본어 입력기용이라 한국어엔 안 맞다. f18/f19 같은 죽은 키 우회가 정석.

4. 한 키 두 역할 (Complex modifications)

진짜 강력한 건 여기다. Complex modifications → Add rule → Import more rules from the Internet.

추천 룰 두 개:

“Tab 을 길게 누르면 Hyper, 짧게 누르면 Tab”

Tab 키 하나에 두 가지 역할. 짧게 누르면 일반 Tab, 길게 누르면 Cmd+Ctrl+Opt+Shift (Hyper). 단축키 충돌 0 인 새 modifier 가 생긴다.

검색: “Change tab to hyper”.

”왼쪽 Cmd 를 길게 누르면 ESC”

vim 사용자에게 황금 매핑. 짧게 누르면 Cmd, 길게 누르면 ESC. ESC 키를 떠나지 않음.

검색: “Change left_command to escape if alone”.

5. 설정 파일 백업

~/.config/karabiner/karabiner.json 이 모든 설정을 담는다. 새 컴퓨터로 옮길 때 이 파일 한 장 복사하면 끝. 점파일 레포에 넣어두면 좋다.

자주 막히는 것

HHKB 가 안 뜸 → USB 케이블 꽂은 상태로 Karabiner 재실행. 무선 모드면 페어링 후 한 번 키 누르고 재실행.

한영 전환이 안 됨 → 입력기 (Hangul, 한컴 등) 가 같은 키를 가져가서 그렇다. 시스템 환경설정 → 키보드 → 단축키 → 입력 소스 에서 충돌하는 것 정리.

---

다음 가이드: vim/터미널 유저용 매핑