클로드로 4시간 걸린 맥용 한자 공부 앱 : HAKA

난 꽤 오랜 취미로 언어 공부를 하고 있는데, 흥미가 이끄는 대로 하다 보니 무엇 하나 깊이 파고든 건 없더라구. 목표가 없으니 늘지 않는 것 같아서 작년부터 JLPT니, DELF, TestDaF 등등의 시험을 볼 궁리를 하고 있는데, 우선 제일 쉬운(?) 한자 3급을 먼저 따보려고 올해 1월부터 한자를 공부중이야. 

하지만 회사원이 각 잡고 공부하는 게 어디 쉽나. 회사 일, 가족 일에 밀려서 대충대충 하고 있지.

그런데 오늘은 회사를 좀 일찍 마치고 귀가했어.
어라? 갑자기 시간이 생겼네? ^^

클로드를 켜서 "한자를 평소에 익힐 수 있는 앱"을 만들어보자 하고 맥용 네이티브 앱을 만들어 보았는데...
허망하리만큼 쉽고 단순해서 놀랐어.

간단한 몇 번의 의견 교환으로 MVP를 완료한 게 20분, 로컬로 만들려 했던 초기 아이디어를 네이버 한자사전 API를 사용해 온라인화하는 수정 작업이 30분, 불투명한 디자인에서 네가티브한 디자인으로 수정하는 데 40분 정도. 투명도와 블러 값 미세 조정하다 타협하기까지 40분, 편의 기능 추가하고 글자 크기, 패딩 값, 색상과 폰트 웨이트, 아이콘 디테일과 각종 간격 수정에 1시간, 아이콘 그리기와 앱 아이콘 만들기 합쳐 10분, 에러 잡는데 30분 ... 다 해서 많이 잡아야 4시간 정도 걸린 것 같아.

우측이 초안, 좌측이 버전 1.05

여기서 본업 바이브 (디테일 집착의 시간ㅠㅠ)를 빼면 2시간도 안걸린 셈이지. 이게 말이 돼? 

* 제작 속도가 빨랐던 건, 앱 자체의 난도가 낮은 것도 한몫했을거야. 플래시가 여전히 존재했다면 이건 4시간... 아니, 하루면 만들었을 것 같아. 그냥 데이터 테이블 행렬 잘 짜고, 그걸 불러와서 입력값과 매칭되는 데이터를 보여주기만 하면 되니까. 완전히 '모르는' 기능을 만들기에는 내적인 두려움이 있었나 봄^^

---

일단 기능 설명을 하자면,

개인적인 용도로 만든 앱이니까 무조건 내가 쓰기 편하게. 

• 맥 윈도우에 항상 떠야 하는 좌상단의 닫기/최대화/최소화 버튼을 지웠어. 맨 윗줄을 날린 거지. 나는 그거 안쓰니까^^ (코맨드+Q로 닫음)
• 연속적으로 입력할 수 있도록, 엔터를 치면 한자가 뜨고 다시 엔터를 누르면 인풋창에 쓴 텍스트가 지워지고 다시 대기모드로 돌아가도록 했어. (개인적으로는 커서를 이동시키는 일을 적게 하고 싶어. 키보드만 치는 방향으로 진화하는 중)

• 공부할 목적이니까 동음이의어가 있으면 무조건 다 보여주기
• 문장을 쓰면 한자에 해당하는 부분만 한자로 써 주고, 좌우 방향키를 이용하여 단어간 이동 (요기서 약간의 trade off 발생, 긴 문장을 쓰면 에러가 뜨는 건 아직 못 잡음)
• 오른쪽 위에 작은 핀 = 항상 위에 고정

• 한 번 검색했던 한자를 다시 검색하면 볼드하게, 두번째는 노란색으로 보이도록. 눈에 익게 하는 게 목적이니까. (실제로 써보니 금세 다 노래져서 횟수와 단계를 늘임)
• 코맨드+E를 누르면 저장했던 검색내용 지우기, 지우면 한자 강조 기능 초기화

• 리사이징도 되고 창 이동도 되지만, 상단 바(닫기버튼이 있는 줄)가 보기 싫어 지워버렸기 때문에 쵸큼 불편함
• 그리고 보시다시피, 에러도 여전히 많음
• 애플같은 글래스모피즘(?)을 구현하거나 Background Blur를 보다 정밀하게 조정하고 싶었는데, 여러 번 시도해도 잘 안되더라구. 그런데 애플 문서를 좀 찾아보니 내가 얼마나 말도 안되는 요구를 클로드에게 한 건지 알게 되었음. 클로드에게 사과 백 번 함. 그래도 시간 되면 또 시도해볼 예정.
• 원래는 한국 한자와 일본 한자도 함께 공부할 목적으로 이름을 HAKA(Hanja+Kanji)로 지었는데, 일본한자의 모양이 다른데다가 (폰트 임베드 필요해짐), 두 개의 사전을 긁어와야 해서 내가 원하는 속도가 나오지 않았음. 걍 한국 한자만 하는 걸로 일단락.

---

고작 한자사전의 위젯에 불과하지만, 하다보니 이런저런 기능 붙이고 재밌네. 소리도 넣고, 에러 메시지도 써보고, 라이선스 안전한 DB로도 교체해 보고... 아직은 한~참 멀었겠지만, 예전에 플래시를 처음 배우던 그 밤 같아. (하루에 천 리를 걸었더랬지!) 

정식으로 승인받은 앱이 아니어서, 열려면 [시스템 설정 - 개인정보 보호 및 보안 - 확인 없이 열기]를 하면 됨.

또한, 이 앱의 정확성이나 문제를 내가 보장하진 않습니다요. 앱을 사용하면서 생기는 문제는 사람의 책임이야. 그렇다고 내가 불법적인 것을 심어놓지는 않았으니 그건 안심해도 좋아. 내 공부용으로 만든 거니 데이터의 신뢰성은 내가 보기엔 괜찮은 것 같고. (오타는 좀 있음)

01haka.dmg

6.86MB

*
이 버전은 업데이트 기능을 추가하지 않아서 업데이트가 안돼요. 다음에 업데이트 되는 만들면 그 떄 오셔요.
하지만 이것도 몇 십만 어휘가 들어있으니까 크게 상관없을래나? 

Updates

 1.01. 2026. 04.11 8:52 AM
· 효과음 추가 : 성공과 실패에 따라 다른 beep음 추가
· 검색 실패 시 6개의 영어 문구 중 하나를 랜덤으로 출력
· 동음이의어의 한자와 훈/음을 시각적으로 연결하기 어려워서 옆에 작은 숫자를 붙임
· 그 중 가장 사용 빈도 높은 걸 앞에 두고 빨간 점 표기
· 데이터를 지울 때 (Erase Records) 팝업으로 경고하던 걸 없애고 바로 지움. (팝업에서 계속 에러가 생겨서 우회한 것임) 
· 한자를 연속으로 드래그해서 선택할 수 있도록 함 (기존엔 한 글자씩만 선택됐었음) - update. 취소하고 컴마 단위로 선택하게 변경
· 완전 오프라인 전환 (libhangul hanja.txt을 사용해서 외부 API 의존성 제거) - update. 단어의 의미는 online 일 때만 작동
· DMG 패키징 (해보고 싶어서. 근데 나처럼 캐주얼한 사용자는 걍 zip으로 묶어 올리는 게 더 나을 듯. 은근 번거롭네.)

1.02. 2026. 04.11 12:22 PM
· 괄호 안에 훈과 음을 넣으면, 그 한자를 찾아 줌 : 정확하게 쓰지 않으면 못 찾음. ㅠㅠ  (예 : (포도 포), 띄어쓰기해줘야 함)
· 앱 아이콘 조금 바꿈 : 피그마에 Glass 이펙트 써볼까 해서. (과정이 귀찮으나, 실무에 비하면 엄청 쉽지. 암요!)
· Always on Top에 단축키 할당 (코맨드+T)
· 비프 사운드와 한글 데이터에 대한 라이선스 기재함 

1.03 2026. 04.11 7:38 PM
· 방향키로 단어 간 이동 시, 활성단어가 좌측정렬되도록 수정 (동음이의어 제외)
· 훈과 음의 정렬 버그 수정 (상단 정렬로 수정함)

1.04 2026. 04.12 3:50 PM
· 한국어기초사전 Open API 추가 : 저작권 표기 추가 "Definitions by Korean Learners' Dictionary, NIKL (CC BY-SA 2.0 KR)" 
· 두 글자 이상의 단어일 때, 그 의미를 한국어 기초사전 API 통해 제공, 일일 50,000회 (온라인일 때만 동작) 
· 한국어문회 기준 급수 표기 (특급 ●,1급 ●, 2급 ●, 3급 ●, 4급~5급 ❹❺, 6~8급 ⑥⑦⑧, 기타  ●) - 난 어차피 3급 이상만 식별되면 되니까^^
· 아이콘 색상 또 바꿔 봄
· 한자의 검색이 반복될 때 변하는 규칙을 변경, (10회마다 한 단계씩 올라가는 것으로 변경, 총 6단계)
· 한 글자 검색 추가 + 괄호를 사용해서 훈과 음을 찾아 검색하거나 (서울 경), 훈만 검색할 수 있음 (서울)

당연히 쓸 때는 우측이 더 보기 편함 (코맨드+G)

1.05 2026. 04.13 9:534 PM
· 기본 모드를 Liquid Glass 모드로 하고, Command+G를 눌러서 기존 모드를 선택할 수 있게 함 (OS26 이하에서는 토글되지 않고 기존 모드로만 작동) 
· 방향키 작동 버그 수정
· 스크롤바 디테일 수정
· 이전까지는 어찌어찌 인텔맥에서도 설치 가능했던 거 같은데, 지금은 실리콘에서만 되나 봄. 이전에 된 게 신기한 쪽^^

---

원래부터 토큰 제공량이 박했던 클로드가 최근에 더 가난해진 덕분에... 돈을 더 많이 뜯어감.
Extra 사용량 구매 : 15불 가까이 썼네. ㅠㅠ

비싼 것 같다가도 하는 거 보면...