본문으로 건너뛰기

macOS용 한글 입력기


문장을 고치다 한 글자가 사라졌나요?
글가드는 조합 중인 한글을 먼저 확정해
글자 누락을 줄입니다.

macOS 14 이상 · Apple Silicon 및 Intel

눌러 보는 MacBook Pro 키보드

익숙한 문장으로 확인해 보세요.

설치 후 한글을 쓰고, 지우고, 커서를 옮겨 보세요.

입력 준비됨

이 공간은 일반 입력창입니다. 글가드를 설치한 뒤 입력 소스를 바꿔 사용하세요.입력 내용은 저장하거나 전송하지 않습니다.

다음 동작 전에,
한글부터 확정합니다.

방향키를 누르는 순간

‘루’는 아직 조합 중입니다.

조합 확정 순서를 보여주는 예시입니다.

“좋은 하루”를 쓴 뒤 커서를 옮기면, 마지막 ‘루’는 조합 중일 수 있습니다.글가드는 ‘루’를 먼저 확정한 뒤 방향키 동작을 앱에 넘깁니다.

커서를 옮길 때
방향키·Tab·Return으로 이동하기 전에 마지막 조합 글자를 확정합니다.
단축키를 누를 때
Command·Control·Option 조합은 글자를 확정한 뒤 원래 앱이 처리하도록 넘깁니다.
한 글자를 고칠 때
조합 중 Backspace를 누르면 자소를 하나씩 지웁니다. 예를 들어 ‘루’는 ‘ㄹ’로 돌아갑니다.
앱별 검증 결과와 현재 한계

개인정보 보호

글가드는 문장을
수집하지 않습니다.

내 Mac · 조합 메모리

입력을 기다립니다.

메모리 사용량이 아닌 조합 과정 예시
소스 코드 보기
입력 기록을 남기지 않습니다.
조합 중인 글자는 메모리에서 처리하고, 입력 내용을 파일이나 로그로 저장하지 않습니다.
서버로 보내지 않습니다.
글가드는 네트워크 연결 없이 Mac 안에서 한글을 조합해 사용 중인 앱에 전달합니다.
코드로 확인할 수 있습니다.
입력을 처리하는 코드와 빌드 스크립트를 GitHub에 공개합니다.

글가드 설치 방법

설치는 세 단계면 끝.

  1. GeulGuard.pkg를 열고 설치를 진행하세요. 관리자 인증이 필요합니다.

  2. 작업을 저장하고 로그아웃한 뒤 다시 로그인하세요.

  3. 시스템 설정 키보드 텍스트 입력 편집에서 추가하세요.

설치 파일 다운로드

선택 설정 · Karabiner

한·영 전환은
Caps Lock 하나로.

대문자 고정 대신, 한글과 영어를 오가는 키로 쓰세요.

Caps Lock으로 한·영 전환

시스템 설정에서 ‘이전 입력 소스 선택’을 Control+Space로 설정하세요.

Karabiner Complex Modifications Add your own rule에 아래 코드를 붙여 넣으면 됩니다.

karabiner-caps-lock.json
{
  "description": "GeulGuard: Caps Lock으로 입력 소스 전환만",
  "manipulators": [
    {
      "type": "basic",
      "from": {
        "key_code": "caps_lock",
        "modifiers": {
          "mandatory": [
            "any"
          ]
        }
      },
      "to": [
        {
          "key_code": "spacebar",
          "modifiers": [
            "left_control"
          ],
          "repeat": false
        }
      ]
    }
  ]
}

에이전트에게 맡겨도 됩니다.

저장소에 접근할 수 있는 코딩 에이전트에 설치를 요청하세요.
관리자 인증과 권한 승인은 직접 마무리합니다.

설치 요청문: https://github.com/jureuk7/GeulGuard 의 AGENTS.md와 docs/agent-setup.md를 읽고 글가드를 설치해 줘. 영어는 ABC, 한글은 글가드를 쓰고, Caps Lock은 카라비너로 입력 전환만 하게 해 줘. 기존 설정을 백업하고 가능한 설치와 설정을 진행한 뒤, 필요한 사용자 조작과 실제 검증 결과를 알려 줘.

설치 전에 궁금한 점