클로드코드 /install-github-app: PR마다 Claude가 자동으로 돕게

혼자 작업할 때는 클로드코드를 터미널에서 바로 부르면 됩니다. 그런데 깃허브(GitHub)에 코드를 올리고 협업하는 단계가 되면, 코드를 올릴 때마다 일일이 클로드코드를 켜서 검토받는 게 번거로워지죠. 이걸 자동으로 돌게 해주는 게 /install-github-app입니다.

정의 (뭐냐면)

/install-github-app은 내 깃허브 저장소에 Claude 깃허브 앱을 설치해, 코드 작업 흐름 안에서 Claude가 자동으로 동작하도록 연결하는 명령입니다.

여기서 깃허브 앱(GitHub App)이란 깃허브 저장소에 붙여서 특정 동작을 자동으로 하게 만드는 연동 프로그램입니다. 이 앱은 깃허브 액션(GitHub Actions, 깃허브에서 코드가 올라올 때 정해둔 작업을 자동 실행해 주는 기능)을 통해 작동합니다. 그래서 한번 설치해 두면, 풀 리퀘스트(Pull Request, 내가 작업한 코드를 본 저장소에 합쳐달라고 요청하는 것. 줄여서 PR)가 올라올 때마다 Claude가 끼어들어 도울 수 있습니다.

어떻게 쓰나 (난이도별)

기초 — 설치 시작하기

저장소가 열린 상태에서 입력합니다.

/install-github-app

이렇게 하면 설치 과정이 시작됩니다. 보통 깃허브 권한을 허용하는 단계를 거쳐, 어떤 저장소에 앱을 붙일지 고르게 됩니다. 화면 안내를 따라가면 됩니다.

응용 — 설치할 저장소 고르기

설치 과정에서 깃허브가 "어느 저장소에 이 앱을 허용할지" 묻습니다.

처음에는 연습용 저장소 하나에만 붙여보는 걸 권합니다. 모든 저장소에 한 번에 붙이기보다, 동작을 확인한 뒤 범위를 넓히는 게 안전합니다. 권한을 어디까지 줄지는 나중에 깃허브 설정에서 언제든 바꿀 수 있습니다.

심화 — PR 자동 도움 흐름 만들기

설치가 끝나면 협업 흐름에 Claude를 녹여 넣을 수 있습니다.

1. 작업한 코드를 PR로 올립니다.
2. 설치해 둔 Claude 앱이 PR 내용을 보고 자동으로 검토하거나 의견을 답니다.
3. 필요하면 PR 안에서 Claude에게 수정을 요청할 수도 있습니다.

매번 사람이 클로드코드를 켜서 "이 PR 좀 봐줘" 하지 않아도, 코드가 올라오는 순간 도움이 따라붙는 구조가 됩니다.

흔한 함정

• 설치하려면 그 저장소에 권한을 줄 수 있는 계정이어야 합니다. 회사나 팀 저장소라면 관리자 승인이 필요할 수 있으니 미리 확인하세요.
• 자동 동작은 깃허브 액션 위에서 돌아가므로, 저장소에서 액션 실행이 막혀 있으면 작동하지 않습니다. 액션이 켜져 있는지 점검하세요.
• 권한 범위를 너무 넓게 주면 부담스러울 수 있습니다. 꼭 필요한 저장소에만 붙이는 게 좋습니다.

실전 사례

한 입문 개발자가 친구와 함께 깃허브로 작은 프로젝트를 진행하면서, 서로 올린 코드를 일일이 검토하기가 벅찼습니다. /install-github-app으로 저장소에 Claude 앱을 붙여두니, PR이 올라올 때마다 자동으로 검토 의견이 달려 1차 점검이 끝난 상태에서 서로의 코드를 볼 수 있었죠. 사람이 봐야 할 부분에 더 집중할 수 있게 됐습니다.

이렇게 더 씁니다

깃허브 연동은 협업 자동화의 출발점입니다. PR에서 자동으로 고치는 흐름을 더 다듬고 싶다면 그쪽 기능들과 함께 쓰고, 같은 식으로 슬랙에서도 Claude를 부르고 싶다면 /install-slack-app으로 슬랙 연동까지 이어가면 됩니다. 한 번 자동화의 맛을 보면 어디까지 자동화할 수 있을지 자연스럽게 보입니다.

정리

/install-github-app은 깃허브 저장소에 Claude 앱을 설치해, PR마다 자동으로 도움을 받게 해주는 명령입니다. 처음에는 연습용 저장소 하나에만 붙여 동작을 확인하고, 익숙해지면 범위를 넓혀가세요. 협업 흐름 안에 Claude를 자연스럽게 녹여 넣는 첫걸음입니다.

FAQ · 자주 묻는 질문

모든 저장소에 권한을 줘야 하나요? 괜히 잘못 건드릴까 봐 무서워요.

아니요, 원하는 저장소만 골라서 붙일 수 있습니다. 처음에는 연습용 저장소 하나에만 설치해 동작을 확인한 뒤 범위를 넓히는 게 안전해요. 설치 과정에서 깃허브가 어느 저장소에 앱을 허용할지 직접 묻고, 권한 범위는 나중에 깃허브 설정에서 언제든 바꿀 수 있으니 부담 갖지 않아도 됩니다.

설치는 뭐부터 시작하면 되나요?

저장소가 열린 상태에서 /install-github-app을 입력하면 됩니다. 그러면 설치 과정이 시작되고, 깃허브 권한을 허용하는 단계를 거쳐 어떤 저장소에 앱을 붙일지 고르게 돼요. 별도의 복잡한 설정 없이 화면에 나오는 안내만 차례대로 따라가면 설치가 끝납니다.

설치했는데 PR을 올려도 아무 반응이 없어요. 뭘 확인해야 하나요?

먼저 저장소의 깃허브 액션이 켜져 있는지 확인하세요. 자동 동작은 깃허브 액션 위에서 돌아가기 때문에, 액션 실행이 막혀 있으면 작동하지 않습니다. 또 설치하려면 그 저장소에 권한을 줄 수 있는 계정이어야 해서, 회사나 팀 저장소라면 관리자 승인이 필요할 수 있어요.

기준: Claude Code v2.1.154 (2026.05)