Maccy와 터미널: macOS 파워 유저 세팅 가이드
빠른 답변: Maccy는 시스템 페이스트보드(pasteboard)를 감시하는데, 이는 pbcopy와 pbpaste가 읽고 쓰는 바로 그 페이스트보드입니다. 그래서 pbcopy로 파이프한 출력, tmux나 Neovim에서 복사한 내용(시스템 클립보드와 연결해 둔 경우), 터미널에서 드래그해 복사한 텍스트가 모두 Maccy App 히스토리에 쌓입니다. 이후에는 어떤 앱에서든 검색하고, 고정하고, 다시 붙여넣을 수 있습니다.
이 세팅은 어떤 문제를 해결하나요?
20분 전에 긴 kubectl 명령을 실행하고 파드 이름을 복사했습니다. 그다음 슬랙 메시지를 복사했고, 또 URL을 복사했죠. 이제 클립보드에서 파드 이름은 사라졌습니다. 셸 히스토리에도 없습니다. 직접 타이핑한 명령이 아니라 출력 결과에서 복사한 값이기 때문입니다.
셸 히스토리는 내가 입력한 것을 기록하고, 클립보드 매니저는 내가 옮긴 것을 기록합니다. 터미널 작업에는 후자가 정말 많습니다. 해시, 경로, IP, 토큰, 로그 한 줄, JSON 조각 같은 것들이죠. Maccy Mac는 이 빈틈을 메워 줍니다. 별도 데몬도, 계정도, 클라우드 동기화도 필요 없는 로컬 기반 오픈소스 메뉴 막대 앱입니다.
1단계: 설치와 꼭 만져야 할 설정
Homebrew로 설치하거나, 공식 사이트 또는 Mac App Store에서 내려받을 수 있습니다.
brew install --cask maccy
메뉴 막대 아이콘에서 설정 창을 열 수 있습니다(팝업이 열려 있을 때 ⌘,도 가능). 터미널 용도라면 아래 항목들을 손보는 것이 좋습니다.
| 설정 | 권장값 | 터미널 워크플로에서 중요한 이유 |
|---|---|---|
| 검색 모드 (General) | Mixed 또는 Regexp | 복사해 둔 IP나 해시를 글자 그대로가 아니라 패턴으로 찾을 수 있습니다. |
| 자동 붙여넣기 (General) | 손쉬운 사용 권한 요청을 허용한다면 켜기 | 항목을 고르면 클립보드에 올리기만 하는 게 아니라 포커스된 터미널에 바로 붙여넣어 줍니다. |
| 히스토리 크기 (Storage) | 스니펫을 많이 복사한다면 기본값보다 늘리기 | 로그 조각과 해시는 순식간에 쌓입니다. |
| 고정 항목 (Appearance/Pins) | 매일 다시 치는 문자열 3~5개를 고정 | 고정한 항목은 맨 위에 남아 있고 히스토리가 넘쳐도 밀려나지 않습니다. |
| 무시 목록 (Ignore 탭) | 비밀번호 관리자를 추가하고, 페이스트보드 타입과 정규식도 점검 | 비밀값이 히스토리에 남지 않게 합니다. 5단계에서 자세히 다룹니다. |
“자동 붙여넣기”는 Maccy Clipboard가 붙여넣기 키 입력을 대신 만들어 보내기 때문에 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용에서 권한을 줘야 합니다. macOS를 업그레이드한 뒤 갑자기 붙여넣기가 조용히 안 된다면 이 토글부터 확인해 보세요.
2단계: pbcopy와 pbpaste 파이프라인
pbcopy는 표준 입력을 시스템 페이스트보드에 쓰고, pbpaste는 페이스트보드 내용을 표준 출력으로 내보냅니다. Maccy도 같은 페이스트보드를 보고 있으니, pbcopy를 호출할 때마다 히스토리 항목이 하나씩 생깁니다.
# GitHub에 바로 붙여넣을 공개 SSH 키 pbcopy < ~/.ssh/id_ed25519.pub # 최근 로그 50줄 중 에러만 tail -n 50 app.log | grep -i error | pbcopy # 방금 복사한 JSON을 보기 좋게 정리해서 다시 복사 pbpaste | jq . | pbcopy # 현재 git 브랜치 이름 (끝의 개행 제거) git branch --show-current | tr -d '\n' | pbcopy # 클립보드에 있는 목록을 정렬하고 중복 제거 pbpaste | sort -u | pbcopy
pbpaste | 도구 | pbcopy 패턴이 핵심 관용구입니다. 브라우저에서 복사한 내용을 셸에서 가공하면, 정리된 결과가 Maccy의 최상단 항목이 됩니다. 원본도 한두 번의 키 입력이면 다시 꺼낼 수 있고요.
매일 쓰면서 알게 된 점 하나: Maccy는 푸시 알림을 받는 방식이 아니라 일정한 간격으로 페이스트보드를 폴링합니다. 스크립트가 1초도 안 되는 짧은 시간에 pbcopy를 여러 번 호출하면 중간 값은 놓치고 마지막 값만 기록될 수 있습니다. 대화형으로 쓸 때는 문제가 없지만, 반복문에서 값을 여러 개 만들면서 하나하나 남기고 싶다면 호출 사이에 짧은 sleep을 넣어 주세요.
3단계: tmux, Neovim, SSH
터미널에서 드래그한 선택 영역도 Maccy에 들어가나요?
터미널마다 다릅니다. Terminal.app에서는 선택 영역에 ⌘C를 누르면 시스템 페이스트보드에 기록되므로 Maccy가 이를 인식합니다. iTerm2에서 드래그만 해도 복사되게 하려면 Settings → General → Selection → Copy to pasteboard on selection을 켜야 합니다. 이 경우 선택할 때마다 히스토리 항목이 생기므로 꽤 지저분해질 수 있고, 원하는 동작인지 먼저 생각해 보세요.
tmux
복사 모드(copy-mode)에서 yank한 내용은 밖으로 파이프하지 않는 한 tmux 자체 버퍼에만 머뭅니다. ~/.tmux.conf에 아래 설정을 추가하세요.
set -g mode-keys vi bind -T copy-mode-vi v send -X begin-selection bind -T copy-mode-vi y send -X copy-pipe-and-cancel "pbcopy"
이제 복사 모드에서 y를 누르면 선택 영역이 pbcopy로, 곧 Maccy로 전달됩니다. 로컬 세션에서는 이대로 동작합니다. 원격 머신에 SSH로 접속한 상태에서는 pbcopy가 없으니 OSC 52를 써야 합니다.
Neovim과 Vim
" init.vim / .vimrc set clipboard=unnamedplus " Neovim 기준. macOS Vim에서는 필요하면 =unnamed 사용
이렇게 하면 yank(y)한 내용이 시스템 페이스트보드로 가고 Maccy가 이를 기록합니다. yank를 Vim 안에서만 쓰고 싶다면 이 설정은 끄고, 넘겨주고 싶을 때만 "+y를 쓰세요.
원격 서버에서 복사하기
OSC 52 이스케이프 시퀀스를 지원하는 터미널에서는 원격 프로그램이 내 로컬 클립보드에 쓸 수 있고, 그러면 Maccy도 이를 기록합니다. iTerm2는 지원하지만 설정으로 막아 두었습니다(Settings → General → Selection → Applications in terminal may access clipboard). tmux에서는 set -g set-clipboard on으로 전달할 수 있습니다. 지원 여부는 터미널마다 다르고, Terminal.app이 OSC 52를 처리한다고 단정하지는 않겠습니다. 아래 명령으로 테스트해 보세요.
printf '\033]52;c;%s\a' "$(printf 'hello from remote' | base64)"
“hello from remote”가 Maccy 맨 위에 나타난다면 연결이 제대로 된 것입니다.
4단계: 셸에 안전하게 붙여넣기
클립보드 매니저를 쓰면 붙여넣기가 너무 쉬워져서, 무엇을 붙여넣는지 잊기 쉽습니다. 몸에 익혀 둘 만한 습관이 두 가지 있습니다.
- 브래킷 붙여넣기(bracketed paste)를 활용하세요. 최신 zsh와 bash(readline 8.1 이상)는 브래킷 붙여넣기를 켜 두기 때문에, 여러 줄을 붙여넣어도 한 줄씩 실행되지 않고 프롬프트에 올라와 검토할 수 있습니다. 붙여넣자마자 실행된다면 사용 중인 셸이나 터미널이 이 기능을 쓰지 않는 것입니다. 웹에서 가져온 내용을 붙여넣기 전에 반드시 확인하세요.
- 일반 텍스트로 붙여넣으세요. Maccy는 서식 없이 붙여넣을 수 있고, 터미널에서는 거의 항상 그편이 낫습니다. 셸 자체에서는 서식 찌꺼기가 문제 되지 않지만, 터미널 안에서 돌아가는 에디터에서는 예상치 못한 일이 생길 수 있습니다. 사용 중인 버전의 Settings → General 토글과 보조 키 동작을 확인해 보세요.
웹 페이지에서 복사한 명령어는 화면에 보이는 것과 다를 수 있습니다(숨은 문자, 바꿔치기된 텍스트). Maccy 미리보기에서 잠깐 멈춰서 확인하거나, Return을 누르지 않고 프롬프트에 먼저 붙여넣어 읽어 보세요.
5단계: 비밀값과 기록하지 말아야 할 것들
대부분의 클립보드 매니저 가이드가 건너뛰는 부분입니다. API 토큰을 복사하면, 따로 막지 않는 한 Maccy는 그걸 기억합니다. 나를 지켜 주는 장치는 다음과 같습니다.
| 방법 | 동작 | 한계 |
|---|---|---|
| 페이스트보드 타입 필터링 | 원본 앱이 concealed 또는 transient로 표시한 항목은 nspasteboard.org 관례에 따라 Maccy가 건너뜁니다. 제대로 만든 비밀번호 관리자는 이 플래그를 설정합니다. | 원본 앱이 플래그를 설정해야만 동작합니다. pbcopy는 설정하지 않습니다. |
| 앱 무시 | 목록에 넣은 앱에서 복사한 것은 전부 건너뜁니다. | 앱 단위로 동작하므로, 같은 터미널 안에서 토큰과 무해한 문자열을 구분하지는 못합니다. |
| 정규식으로 무시 | 직접 정의한 패턴(예: 공백 없이 긴 토큰 모양)에 맞는 복사 텍스트를 건너뜁니다. | 휴리스틱입니다. 일부 비밀값은 놓치고, 가끔 무해한 문자열을 건너뛰기도 합니다. |
| 항목 삭제 | 사용 직후 히스토리에서 해당 항목을 지웁니다. | 수동입니다. 습관이 필요합니다. |
솔직하게 정리하면 이렇습니다. pbcopy로 보낸 내용은 평범한 페이스트보드 쓰기이므로 Maccy는 일반 텍스트로 취급합니다. 비밀값은 (플래그를 설정해 주는) 비밀번호 관리자에서 꺼내 쓰고, 남기려던 게 아닌 히스토리 항목은 바로 지우세요. 무시 목록에 ^[A-Za-z0-9+/=_-]{32,}$ 같은 정규식을 넣어 두면 토큰처럼 생긴 문자열에 대한 합리적인 안전망이 되지만, 보장은 아닙니다.
Maccy가 저장하는 모든 데이터는 Mac 안에만 있고 동기화 서비스도 거치지 않습니다. 프라이버시 측면에서 분명한 장점이지만, 반대로 히스토리의 보안 수준은 내 디스크와 로그인 세션의 보안 수준을 넘지 못한다는 뜻이기도 합니다.
예전 명령어나 해시를 빠르게 찾으려면?
Maccy를 열고(기본 단축키 ⇧⌘C) 바로 입력하면 됩니다. 검색 모드를 Regexp 또는 Mixed로 설정했다면 패턴 검색이 가능합니다.
| 찾고 싶은 것 | 입력 |
|---|---|
| IPv4 주소 | \b\d{1,3}(\.\d{1,3}){3}\b |
| 40자리 git SHA | \b[0-9a-f]{40}\b |
| kubectl 명령 전부 | ^kubectl |
| UUID | [0-9a-f]{8}-[0-9a-f]{4}- |
| 홈 디렉터리 아래 파일 경로 | ^/Users/ |
매일 다시 치게 되는 문자열은 고정해 두세요. 스테이징 서버 호스트명, Docker 로그인 명령, 길게 늘어진 rsync 옵션 같은 것들입니다. 고정 항목은 새로 복사한 내용에 밀려 목록에서 사라지는 일이 없습니다.
이 세팅의 한계는 어디일까요?
- 셸 히스토리를 대체하지 않습니다. Maccy는 클립보드에 올라온 것을 저장합니다. 타이핑한 명령은
atuin, Ctrl-R을 쓰는fzf, 또는 기본history로 찾으세요. 서로 보완하는 관계입니다. - 동기화가 없습니다. 로컬 우선 방식이라 원격 서버나 다른 Mac과 히스토리를 공유하지 않습니다.
- 폴링 방식입니다. 스크립트로 아주 빠르게 연속 복사하면 항목이 합쳐질 수 있습니다(2단계 참고).
- 선택만 해도 복사되는 데서 오는 노이즈. 선택 즉시 복사하는 터미널은 히스토리를 금방 채웁니다. 그 기능은 끄는 것을 고려해 보세요.
정리하며
파워 유저를 위한 최소 구성은 간단합니다. Maccy를 설치하고, 검색 모드를 Mixed나 Regexp로 바꾸고, 자동 붙여넣기를 허용하고, tmux와 Neovim을 pbcopy에 연결하고, 비밀값용 무시 규칙을 설정하는 것입니다. 그다음부터 가장 효과가 큰 습관은 다시 타이핑하는 대신 pbpaste | … | pbcopy를 쓰는 것입니다.
직접 써 본다면 이런 질문을 한번 던져 보세요. 나는 어떤 문자열 세 개를 가장 자주 다시 치고 있을까, 그리고 내일까지 그 세 개를 고정해 둘 수 있을까? 시작해 보고 싶다면 Maccy는 무료 오픈소스입니다.
SEO 패키지
1. 제목 후보
- Maccy와 터미널: macOS 파워 유저 세팅 가이드
- 터미널 클립보드 히스토리: Maccy 설정 가이드
- pbcopy, tmux, Neovim, Maccy: 하나로 잇는 클립보드 워크플로
2. 메타 설명
Maccy를 터미널, iTerm2, tmux, Neovim과 연동하는 방법. pbcopy/pbpaste 파이프라인, 안전한 붙여넣기, 비밀값 관리, 정규식 검색까지 정리한 macOS 실전 가이드.
3. URL 슬러그
/ko/blog/maccy-terminal-power-user-setup/
4. 키워드
핵심 키워드: maccy 터미널 설정
보조/의미 키워드: 개발자용 macOS 클립보드 매니저, pbcopy pbpaste, tmux 맥 시스템 클립보드 복사, iTerm2 클립보드 히스토리, Neovim macOS 시스템 클립보드, 맥 터미널 클립보드 히스토리, OSC 52 클립보드, 브래킷 붙여넣기(bracketed paste), 클립보드 매니저 정규식 검색, 클립보드 히스토리에서 비밀값 제외하기
