설정 저장소를 받았는데 기기에는 옛 설정이 계속 돈다면, git 의 post-merge 훅에서 설치 스크립트를 다시 부르면 됩니다. git pull --rebase 로 받는 경우를 위해 post-rewrite 훅도 같은 일을 하게 두고, 훅 폴더는 core.hooksPath 로 저장소 안의 폴더를 가리켜 다른 기기에도 그대로 따라오게 합니다. 훅은 실패해도 pull 을 막지 않도록 늘 종료 코드 0 으로 끝냅니다.
AI 생성 이미지
지난 편에서는 새 기기 설치와 복구를 스크립트 하나로 하는 이야기를 했습니다. 그 스크립트를 사람이 기억해서 돌려야 한다면 절반만 자동화된 셈입니다. 이번 편은 그 나머지 절반, 「받기만 하면 알아서 돌게」 만든 이야기입니다.
왜 pull 을 받았는데도 옛 설정이 돌았을까?
에이전트가 쓰는 훅 스크립트와 상태줄 스크립트는 저장소 원본을 그대로 쓰지 않고 홈 폴더의 설치 폴더(~/.claude/ 아래)로 복사해서 씁니다. 처음에는 링크로 이었는데, 원본이 macOS 의 보호 폴더(데스크톱) 안에 있다 보니 세션이 끝나는 순간에 도는 훅이 권한 오류로 막혔습니다. 링크를 거쳐도 최종 대상이 같은 폴더라 소용이 없어서 복사로 바꿨습니다.
복사로 바꾸자 새 문제가 생겼습니다. 다른 기기에서 고친 것을 git pull 로 받으면 저장소 원본만 새것이 되고, 실제로 도는 복사본은 옛것 그대로입니다. 2026년 10월 18일에 상태줄 스크립트를 고쳤는데, 다른 기기의 복사본은 하루 넘게 옛 모양으로 돌았습니다. 받았는데 안 바뀌니 「고친 게 왜 안 보이지?」를 한참 찾았습니다.
검색해 보면 「git pull 한 뒤에 자동으로 스크립트 돌리기」를 묻는 글이 많고, 답은 거의 모두 post-merge 훅입니다. package.json 이 바뀌었을 때만 npm install 을 다시 돌리는 예가 가장 흔합니다. 제 경우는 그 「npm install」 자리에 설치 스크립트가 들어간다고 보면 됩니다.
pull 한 번에 무엇이 일어나게 했을까?
2026년 10월 19일에 처음 만든 훅은 설치 스크립트의 점검 모드를 먼저 돌려 보고, 어긋난 것이 있을 때만 실제 설치를 돌렸습니다. 2026년 10월 27일에는 할 일이 늘어나서 일을 파이썬 파일 하나로 옮기고, 서로 독립인 단계를 동시에 돌리게 바꿨습니다. 지금 pull 한 번이 하는 일은 이렇습니다.
다섯 단계는 서로의 결과를 쓰지 않아서 동시에 돌려도 됩니다. 이 글을 쓰면서 쓰던 맥에서 아무것도 바꾸지 않는 연습 모드로 돌려 보니 4.09초가 걸렸습니다(2026년 11월 16일 기준). pull 을 기다리는 사람이 답답하지 않을 정도입니다.
바꾼 방법 1: 훅은 짧게, 일은 다른 파일에
git 은 훅을 셸에서 실행하니 훅 파일 자체는 셸이어야 합니다. 그렇다고 셸에 로직을 쌓으면 시험하기 어렵고 병렬로 돌리기도 번거롭습니다. 그래서 훅은 불러 주는 일만 합니다.
#!/usr/bin/env bash
# 연결 작업폴더(git worktree)에서는 건너뛴다
[ "$(git rev-parse --absolute-git-dir)" != "$(cd "$(git rev-parse --git-common-dir)" && pwd -P)" ] && exit 0
REPO="$(git rev-parse --show-toplevel)"
cd "$REPO" || exit 0
python3 scripts/session/post-pull.py 2>&1 | head -30
exit 0
마지막 exit 0 은 「설치가 실패해도 받기는 받은 것」이라는 뜻으로 넣었습니다. 설치가 잘못되면 설치 스크립트의 점검 모드가 다음에 알려 주니, 훅은 어떤 경우에도 성공으로 끝냅니다. 출력은 head -30 으로 잘라 터미널이 설치 로그로 뒤덮이지 않게 했습니다.
바꾼 방법 2: rebase 로 받을 때도 같은 일을
git pull --rebase 로 받으면 병합이 일어나지 않으니 post-merge 가 아예 돌지 않습니다. 저는 평소에 rebase 로 받기 때문에, 첫날부터 이 구멍을 막는 훅을 같이 만들었습니다. rebase 가 끝나면 도는 post-rewrite 훅이 첫 인자로 rebase 를 받을 때만 같은 훅을 부릅니다.
#!/usr/bin/env bash
[ "$1" = "rebase" ] && exec bash "$(git rev-parse --show-toplevel)/scripts/git-hooks/post-merge"
exit 0
첫 인자를 보는 이유는 post-rewrite 가 git commit --amend 때도 돌기 때문입니다. 커밋 메시지 하나 고칠 때마다 설치 스크립트가 돌면 곤란합니다.
바꾼 방법 3: 훅 폴더를 저장소 안에 둔다
.git/hooks/ 폴더는 git 이 추적하지 않습니다. 거기에 훅을 넣으면 새 기기에는 따라가지 않습니다. 그래서 훅을 저장소 안의 평범한 폴더에 커밋해 두고, git 에게 그 폴더를 훅 폴더로 쓰라고 알려 줍니다.
git config core.hooksPath scripts/git-hooks
이 한 줄은 지난 편의 설치 스크립트가 넣어 줍니다. 새 기기에서 설치 스크립트를 한 번 돌리면 그 뒤로는 pull 할 때마다 훅이 돌고, 훅이 다시 설치 스크립트를 부릅니다. 설치와 반영이 서로를 이어 주는 구조라 손이 한 번만 갑니다. 훅 파일에는 실행 권한(chmod +x)이 있어야 git 이 실행한다는 점도 커밋할 때 함께 챙깁니다.
그동안 어디서 막혔을까?
처음 만든 뒤로 post-merge 훅에는 2026년 11월 16일 기준 커밋 7개가 쌓였습니다. 굵직한 장면은 셋입니다.
- 복사본 설치가 위험했습니다. 도구 호출을 검사하는 훅은 고장 나면 막는 쪽으로 동작하게 해 두었는데, 깨진 사본이 깔리면 모든 도구 호출이 막힙니다. 그래서 설치 단계는 새 파일을 임시 폴더에 먼저 복사해 실제로 한 번 돌려 보고, 문법 검사까지 통과할 때만 설치 폴더로 옮깁니다. 실패하면 지금 설치본을 그대로 둡니다.
- 설치 순서도 정했습니다. 다른 훅이 불러 쓰는 모듈을 먼저, 등록된 훅을 나중에 복사합니다. 중간에 멈춰도 「새 훅이 옛 모듈을 부르는」 조합이 생기지 않습니다.
- 2026년 11월 12일에는 이상한 일이 생겼습니다. 커밋만 따로 하려고
git worktree로 임시 작업폴더를 만들었는데, 거기서 pull 하자 훅이 돌면서 홈 폴더의 링크를 임시 폴더 경로로 바꿔 놓았습니다. 임시 폴더를 지우자 링크가 모두 깨졌습니다. 지금은 훅 첫 줄에서 git 폴더와 공통 git 폴더를 비교해, 다르면 연결 작업폴더로 보고 바로 끝냅니다.
지금은 하루가 어떻게 달라졌을까?
두 대의 맥을 오가며 일하는데, 한쪽에서 고치고 커밋하면 다른 쪽은 git pull 만 하면 됩니다. 「받은 다음 설치 스크립트 돌리기」를 기억할 필요가 없어졌고, 고친 게 안 보이는 일을 쫓는 시간도 없어졌습니다. 플러그인이 바뀐 날에는 훅이 「다시 읽기 명령을 치라」는 한 줄을 띄워 주니, 그 줄만 보고 따라 하면 됩니다.
설치 스크립트가 멱등이라는 점이 여기서 다시 쓸모가 있었습니다. 어긋난 것이 없으면 점검만 하고 끝나니, pull 할 때마다 돌아도 부담이 없습니다.
자주 묻는 질문
git pull 할 때 post-merge 훅이 안 돌아요. 왜 그런가요?
먼저 git pull --rebase 로 받고 있는지 보세요. rebase 로 받으면 병합이 없어서 post-merge 가 돌지 않으니 post-rewrite 훅이 필요합니다. 그다음은 실행 권한입니다. 훅 파일에 실행 권한이 없으면 git 은 그 훅을 실행하지 않습니다. 마지막으로 git config core.hooksPath 가 훅 파일이 있는 폴더를 가리키는지 확인합니다.
훅을 팀원이나 다른 기기와 어떻게 나눠 쓰나요?
.git/hooks/ 는 추적되지 않으니 훅 파일을 저장소의 일반 폴더에 커밋하고, 각 기기에서 git config core.hooksPath <그 폴더> 를 한 번 설정합니다. 그 설정을 설치 스크립트에 넣어 두면 새 기기도 한 번에 맞춰집니다.
pull 할 때마다 설치가 돌면 느리지 않나요?
설치 스크립트가 지금 상태와 원하는 상태를 비교해 다른 곳만 고치면 대부분은 점검만 하고 끝납니다. 서로 독립인 단계를 동시에 돌리면 더 줄어듭니다. 제 경우 연습 모드 기준으로 4초 남짓입니다.