개요

Omarchy — Arch Linux 기반 데스크톱 OS — 를 새로 설치한 사용자를 위한 5단계 설정 가이드. 저장소는 yelixir-dev/omarchy-starter이며, 각 장마다 초보자용 설명, 직접 실행할 명령어, AI 코딩 에이전트에 그대로 붙여넣을 수 있는 프롬프트를 함께 제공한다. 한국어 입력기만 필수이고 나머지는 자신의 환경(Intel Mac, VPN 필요 여부 등)에 맞을 때만 진행하면 된다.

5개 장 구성

1. OMO 코딩 에이전트 (선택)

터미널에서 자연어로 명령을 대신 실행해주는 AI 에이전트. 이후 장들의 설치를 이 에이전트에게 맡길 수 있도록 가장 먼저 배치되어 있다.

npm i -g omo-ai@beta
omo
/login

이미 쓰는 AI 도구가 있다면 그대로 사용해도 된다고 명시한다.

2. 한국어 입력기 — Fcitx5 + 한글 엔진 (필수)

Arch Linux 계열(Omarchy는 omarchy 패키지 명령, 그 외는 pacman)을 대상으로 한다. 저장소의 install-fcitx5-hangul.sh를 실행하면:

git clone https://github.com/yelixir-dev/omarchy-starter.git
cd omarchy-starter
chmod +x install-fcitx5-hangul.sh
./install-fcitx5-hangul.sh
  1. fcitx5·GTK/Qt 연동 모듈·한글 엔진 설치, 2) 기존 프로필을 profile.bak.<날짜-시간>.<임의문자>로 백업, 3) 세션에서 fcitx5 시작, 4) 영문/한글 입력기를 기본 그룹에 등록, 5) X11이면 입력기 환경변수를 별도 파일에 저장, 6) hangul 등록 여부 확인까지 자동 수행한다. 전환키는 기본 Ctrl+Space.

3. 팜 리젝션 (2019년형 이하 Intel Mac, 선택)

T2 칩이 내장 트랙패드를 “외장 장치”로 오인식해 타이핑 중 커서가 튀는 문제를 install-intel-mac-palm-rejection.sh --dry-run → 실행으로 해결하고, libinput list-devices의 Disable-w-typing: enabled로 검증한다.

4. VPN — Tailscale + NordVPN 조합 (선택)

  • Tailscale: 기기 간 사설 메시 네트워크(100.x.x.x 대역) 구성. omarchy pkg add tailscale → tailscaled 서비스 활성화 → tailscale up --accept-routes=false.
  • NordVPN: 자체 앱 대신 NetworkManager의 OpenVPN 프로필로만 연결 (nmcli connection import). 2023년 6월 이후 계정 자격증명이 아닌 별도 “서비스 자격증명”이 필요.
  • 충돌 경고: NordVPN 자체 앱과 Tailscale 동시 사용 금지, Tailscale exit node·Nord Meshnet 금지(100.64.0.0/10 대역 겹침). 안전한 조합은 Tailscale(mesh 전용) + NetworkManager OpenVPN 뿐이라고 명시한다.
  • 상태바 VPN 토글 아이콘은 install-vpn-bar-toggles.sh로 추가하며, 암호 없이 토글하려면 sudo tailscale set --operator=$USER가 필요하다.

5. 카카오톡 & 스크린샷 (선택)

  • 카카오톡: install-kakaotalk-bottles.sh로 Bottles(Wine) 위에 Windows판을 실행, Super+Shift+K 단축키 자동 등록. 한글 입력 문제 시 patch-kakaotalk-korean-input.sh로 별도 패치.
  • 스크린샷: install-screenshot-shortcuts.sh로 macOS 스타일 단축키 (Super+Shift+9 영역 캡처, Super+Shift+0 전체 화면)를 등록, 결과는 ~/Pictures에 저장되고 클립보드에도 복사된다.

평가

문서 구조 자체가 “필수 1개 + 선택 4개, 각 항목마다 설치→검증→제거” 패턴을 일관되게 반복하며, VPN 조합처럼 실수하면 네트워크가 먹통이 될 수 있는 조합에 대해 명시적으로 경고를 넣은 점이 실용적이다. 모든 스크립트는 저장소 yelixir-dev/omarchy-starter에 있으며 페이지 자체에는 출처/버전 정보가 거의 없어(단일 작성자 기준) 스크립트의 최신성은 저장소를 직접 확인해야 한다.

관련: moc-dev-tools, 2026-04-20-claude-desktop-debian