AX 팁 22 — git pull 하면 설치본까지 바로 반영

작성

  • AX 팁
  • Claude Code
  • 개발 환경 자동화
  • git hooks

설정 저장소를 받았는데 기기에는 옛 설정이 계속 돈다면, 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 한 번이 하는 일은 이렇습니다.

git pull 한 번이 부르는 것git pull → post-merge 훅; git pull → post-rewrite 훅(rebase); post-merge 훅 → post-pull.py; post-rewrite 훅(rebase) → post-pull.py; post-pull.py → 설치본 점검 → 어긋나면 설치; post-pull.py → 예약 작업 경로 다시 등록; post-pull.py → 감시 스크립트 재설치; post-pull.py → 다른 기기 기록 가져오기; post-pull.py → 플러그인 바뀌면 다시 읽기 안내git pullpost-merge 훅post-rewrite훅(rebase)post-pull.py설치본 점검 → 어긋나면설치예약 작업 경로 다시등록감시 스크립트 재설치다른 기기 기록가져오기플러그인 바뀌면 다시읽기 안내
git 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개가 쌓였습니다. 굵직한 장면은 셋입니다.

pull 자동 반영이 배운 것10-19 post-merge·post-rewrite 처음 만듦; 10-27 일을 파이썬 한 곳으로 옮기고 단계 병렬화; 11-12 임시 작업폴더에서는 건너뜀 (홈 링크가 임시 폴더를 가리킴)10-19post-merge·post-rewrite 처음 만듦10-27일을 파이썬 한 곳으로 옮기고 단계 병렬화11-12임시 작업폴더에서는 건너뜀홈 링크가 임시 폴더를 가리킴
pull 자동 반영이 배운 것
  • 복사본 설치가 위험했습니다. 도구 호출을 검사하는 훅은 고장 나면 막는 쪽으로 동작하게 해 두었는데, 깨진 사본이 깔리면 모든 도구 호출이 막힙니다. 그래서 설치 단계는 새 파일을 임시 폴더에 먼저 복사해 실제로 한 번 돌려 보고, 문법 검사까지 통과할 때만 설치 폴더로 옮깁니다. 실패하면 지금 설치본을 그대로 둡니다.
  • 설치 순서도 정했습니다. 다른 훅이 불러 쓰는 모듈을 먼저, 등록된 훅을 나중에 복사합니다. 중간에 멈춰도 「새 훅이 옛 모듈을 부르는」 조합이 생기지 않습니다.
  • 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초 남짓입니다.

사이트를 만들어볼까요?

무료 상담 받기