# Show GN: 터미널 한영전환 실수 방지 zsh 플러그인

> Clean Markdown view of GeekNews topic #22660. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=22660](https://news.hada.io/topic?id=22660)
- GeekNews Markdown: [https://news.hada.io/topic/22660.md](https://news.hada.io/topic/22660.md)
- Type: show
- Author: [gomjellie](https://news.hada.io/@gomjellie)
- Published: 2025-08-22T10:38:30+09:00
- Updated: 2025-08-22T10:38:30+09:00
- Original source: [github.com/gomjellie](https://github.com/gomjellie/zsh-hangul)
- Points: 27
- Comments: 19

## Summary

터미널 작업 중 **한글-영문 입력 전환 실수**로 인한 오타 문제를 자동으로 해결해주는 **zsh 플러그인**이 공개되었습니다. 사용자가 영어 명령어를 한글 입력 상태로 타이핑해도 실시간으로 올바른 영문 명령어로 자동 변환하며, **문자열 예외 처리**와 **붙여넣기 보호** 등 개발 환경에 실질적으로 필요한 기능을 갖추고 있습니다. **oh-my-zsh** 사용자라면 손쉽게 적용할 수 있고, bash 버전도 함께 지원하여 다양한 개발 환경에 도입할 수 있습니다.

## Topic Body

### 소개   
  
터미널에서 작업하다 보면 영어를 입력해야 하는데 실수로 한글로 타이핑하는 경우가 있습니다. ㅣㄴ을 입력하고 나서야 ls를 타이핑하려던 것을 깨닫거나, `햣`를 치고 git을 입력하려던 것을 알아차리는 상황 말이죠.  
  
이런 불편함을 해결하기 위해 zsh-hangul을 만들었습니다. 한글로 잘못 입력된 명령어를 실시간으로 영어로 자동 변환해주는 zsh 플러그인입니다.  
  
주요 기능:  
  
- 실시간 한영 자동 변환: ㅊㅇ → cd, ㅣㄴ → ls  
- 문자열 예외 처리: 따옴표("한글", '한글',  \`한글\`) 내부에서는 변환하지 않음  
- 복사-붙여넣기 보호: 직접 타이핑한 경우에만 변환하여 의도하지 않은 변환 방지  
- AI 툴 지원: Cursor 등 AI 도구에서는 변환하지 않음 (ai는 키보드 타이핑을 안하니 실수도 할 일이없음)  
  
### 왜 만들게 되었나요?  
  
개발자라면 누구나 경험해봤을 터미널에서의 한영 오타 문제를 해결하고 싶었습니다. 기존에는 잘못 입력하면 지우고 다시 타이핑해야 했는데, 이 플러그인을 사용하면 자연스럽게 올바른 명령어로 변환되어 타이핑 흐름이 끊기지 않습니다.  
  
### 설치 및 사용  
  
Oh My Zsh 사용자라면 간단하게 설치할 수 있습니다. 자세한 설치 가이드는 프로젝트의 INSTALL.md에서 확인하실 수 있습니다.  
  
bash 사용자를 위한 별도 버전도 제공하고 있습니다.  
  
GitHub: https://github.com/gomjellie/bash-hangul  
  
터미널에서 한영 오타로 고생하셨던 분들께 도움이 되었으면 좋겠습니다. 사용해보시고 피드백이나 개선 아이디어가 있으시면 언제든 공유해주세요! (PR 및 이슈 생성 환영합니다)

## Comments



### Comment 43056

- Author: edunga1
- Created: 2025-08-28T10:24:37+09:00
- Points: 1

설치 직후에는 체감이 안되다가, 저도 모르게 한글로 명령어 치고 있는 걸 보면.. 아주 편리하네요! ㅎ  
궁금한 점이 있는데, pager에서도 적용할 수 있을까요?

### Comment 43057

- Author: gomjellie
- Created: 2025-08-28T10:29:29+09:00
- Points: 1
- Parent comment: 43056
- Depth: 1

저한테는 생소한데 pager 가 어떤툴이에요?

### Comment 43061

- Author: edunga1
- Created: 2025-08-28T11:18:06+09:00
- Points: 1
- Parent comment: 43057
- Depth: 2

`less` 같은거요! 셸 레벨에서 처리 가능한지 모르겠지만...

### Comment 42856

- Author: dontdieych
- Created: 2025-08-25T09:01:29+09:00
- Points: 1

Fish shell도! 😁  
  
90년대 후반이었나 인터넷 익스가 시장을 지배하고 있을 때 익스용 툴바 만들기가 유행이었던 적이 있었는데요. 네이버 툴바, 다음 툴바 이런 것들요.  
  
한컴에서 나온 툴바 였나 그게 이런 기능이 있었드랬죠. ㅈㅈㅈ -> www 로 바꿔 주면서 한영 전환 자동으로 해주는.  
  
리눅스에서 fcitx 입력기를 쓰는 데 이 기능이 있으면 참 좋겠네요.

### Comment 42879

- Author: gomjellie
- Created: 2025-08-25T10:52:43+09:00
- Points: 1
- Parent comment: 42856
- Depth: 1

fish shell 버전도 커서한테 포팅 한번 부탁해볼게요 ㅋㅋㅋ   
  
아이폰같은경우는 이중언어 키보드 기능이 있는데 맥은 없어서 아쉽더라구요...

### Comment 42811

- Author: eajrezz
- Created: 2025-08-23T14:19:19+09:00
- Points: 1

https://inputsource.pro/kr  
  
저는 위 프로그램을 사용하는데요, 특정 프로그램 전환시 사용할 입력 소스를 강제할 수 있는 맥앱입니다.

### Comment 42878

- Author: gomjellie
- Created: 2025-08-25T10:48:48+09:00
- Points: 1
- Parent comment: 42811
- Depth: 1

오.. 좋은 프로그램 소개 감사합니다!

### Comment 42790

- Author: micjung
- Created: 2025-08-22T22:17:56+09:00
- Points: 1

오 안그래도 이런건 없나 했는데 감사합니다 ㅎㅎ

### Comment 42877

- Author: gomjellie
- Created: 2025-08-25T10:48:31+09:00
- Points: 1
- Parent comment: 42790
- Depth: 1

제가 더 감사합니다 ㅎㅎ

### Comment 42784

- Author: fetiu
- Created: 2025-08-22T15:30:04+09:00
- Points: 1

예전부터 zsh한글 잘 써오고 있었는데 이걸 긱뉴스에서 다시 보네요ㅎㅎ  
시대에 걸맞게 AI 툴 지원도 추가해주시고, 꾸준히 좋은 프로그램 개발해주셔서 정말 감사합니다^^

### Comment 42787

- Author: gomjellie
- Created: 2025-08-22T16:52:40+09:00
- Points: 1
- Parent comment: 42784
- Depth: 1

헉... 감사합니다 ㅋㅋㅋ

### Comment 42778

- Author: idunno
- Created: 2025-08-22T14:13:59+09:00
- Points: 1

설치해봐야겠네요. 감사합니다. 👍

### Comment 42780

- Author: gomjellie
- Created: 2025-08-22T14:27:47+09:00
- Points: 1
- Parent comment: 42778
- Depth: 1

감사합니다!

### Comment 42777

- Author: qhdgkdbs
- Created: 2025-08-22T14:10:31+09:00
- Points: 1

개발은 6년전에 하셨군요!

### Comment 42786

- Author: gomjellie
- Created: 2025-08-22T16:52:27+09:00
- Points: 1
- Parent comment: 42777
- Depth: 1

옛날에 개발해서 방치해두고 있다가 cursor의 힘을 빌려서 최근에 다시 건드려보고 있습니다 ㅎㅎ

### Comment 42770

- Author: c1t1d0s7
- Created: 2025-08-22T11:35:31+09:00
- Points: 1

너무 좋습니다.👍

### Comment 42781

- Author: gomjellie
- Created: 2025-08-22T14:29:00+09:00
- Points: 1
- Parent comment: 42770
- Depth: 1

👍감사합니다

### Comment 42768

- Author: chl11wq12
- Created: 2025-08-22T10:59:34+09:00
- Points: 1

오 재밌네

### Comment 42785

- Author: gomjellie
- Created: 2025-08-22T16:51:10+09:00
- Points: 1
- Parent comment: 42768
- Depth: 1

감사합니다 ㅎㅎ