GitHub에 Claude Code 설치하기 (즉시 백그라운드 에이전트)

채널 아이콘
Ian Nuttall 구독자 2,620명

요약

이 영상은 GitHub 레포지토리에 Claude Code GitHub 액션을 설치해 백그라운드 에이전트로 활용하는 방법을 설명합니다. 설정만 하면 수면 중에도 Claude가 코드 이슈를 찾아 풀 리퀘스트(PR)를 생성해 주어, 별도 데스크톱 없이도 비동기 개발이 가능합니다. 무료로 제공되는 Pro·Max 플랜 사용자라면 추가 요금 없이 무제한 이용이 가능하며, 필요에 따라 리뷰 프롬프트와 워크플로우를 맞춤 구성할 수 있습니다.

주요 키워드

Claude Code GitHub Actions 백그라운드 에이전트 Pull Request Long-lived token 워크플로우 코드 리뷰 Async 개발 배포 다운타임 Vite Manifest

하이라이트

  • 🚀 GitHub 액션으로 Claude Code를 백그라운드 에이전트처럼 사용해 코드 이슈를 자동 검출하고 PR을 생성할 수 있다.
  • 🔑 Claude Pro·Max 플랜에서는 API 요청 요금 없이 무제한으로 GitHub 액션을 활용할 수 있다.
  • ⚙️ 설치는 Claude 내에서 `/ask install GitHub app` 명령 한 번으로 간편하게 진행된다.
  • 📌 워크플로우로 ‘Claude Code’ 이슈 태깅과 ‘Code Review’ 자동 리뷰를 각각 설정해 두면 매 PR마다 잠재적 문제를 사전에 파악할 수 있다.
  • 🔒 Long-lived 토큰을 생성해 GitHub 앱과 연동하면 별도의 API 키 관리 없이도 지속적으로 동작시킬 수 있다.
  • ✍️ 코드 리뷰 프롬프트를 직접 작성해 특정 버그나 보안 취약점만 간결하게 검토하도록 커스터마이징 가능하다.
  • 🛠️ 데모에서는 Vite Manifest가 없을 때 발생하는 배포 다운타임 문제를 대비해 유지보수 페이지와 사전 빌드 스크립트를 제안한다.
  • 💻 로컬에서 PR을 빠르게 풀 다운받아 테스트 후 안전하게 병합하는 워크플로우를 직접 확인했다.
  • 🎨 추가 예시로 뉴스레터 컴포넌트를 리디자인해 비개발자도 이해하기 쉬운 UI를 자동 생성했다.
  • ⏱️ 비동기 개발 설정으로 수면·식사·다른 작업 중에도 Claude가 병렬로 작업해 생산성을 두 배로 높일 수 있다.

용어 설명

Claude Code

Anthropic의 AI 코드 도우미로, 이슈 감지와 PR 생성을 자동화한다.

GitHub Actions

GitHub 레포지토리에서 CI/CD 워크플로우를 실행하는 자동화 도구다.

Long-lived token

만료 기한이 긴 인증 토큰으로, API 키 없이도 지속 연결을 유지한다.

Pull Request

코드 변경 사항을 검토·병합 요청하는 GitHub 협업 기능이다.

Vite Manifest

Vite 번들러가 생성하는 자산 매핑 정보 파일로, 없는 경우 예외가 발생할 수 있다.

[00:00:00] 소개: Claude Code GitHub 액션의 역할

Claude Code를 GitHub 레포지토리에 설치해 백그라운드 에이전트처럼 활용하는 개념을 설명한다. 코드 이슈 자동 감지와 PR 생성 기능을 통해 데스크톱 없이도 비동기 개발이 가능해진다.

Claude Code와 GitHub를 함께 사용한다면 Claude Code GitHub 액션을 설치해야 합니다. 이것은 Claude Code를 백그라운드 에이전트로 만들어서 코드베이스의 문제들을 자동으로 찾아내고 풀 리퀘스트를 생성해주는 기능입니다.
Claude는 GitHub 저장소 안에서 이슈와 PR을 감시하며, 언제든지 Claude Code를 언급하면 모든 것을 검토해줍니다. 잠자리에 들기 전에 이슈를 등록하면 아침에 일어나서 Claude가 만든 풀 리퀘스트를 받을 수 있어, 마치 24시간 백그라운드에서 작업하는 또 다른 개발자가 있는 것과 같습니다.
[00:00:59] 이용 요금 및 플랜

이전에는 API 요청당 과금되었으나, 이제 Claude Pro·Max 플랜에서는 GitHub 액션을 무료로 무제한 사용할 수 있다. 예상치 못한 비용 없이 편하게 활용 가능하다.

이전에는 API를 통해서만 사용할 수 있어 모든 요청에 비용을 지불해야 했지만, 최근 Claude Pro와 Max 플랜 사용자들에게 제공되기 시작했습니다. 더 이상 API 요금을 지불하지 않으며, 데스크톱에서 사용하는 것과 정확히 같은 방식으로 작동합니다.
설정하려면 Claude를 열고 /ash 명령어로 GitHub 앱을 설치합니다. 기존 프로젝트의 저장소를 선택하거나 다른 저장소를 입력할 수 있습니다.
[00:01:30] 앱 설치: `/ask install GitHub app`

Claude 대화창에서 `/ask install GitHub app` 명령어를 입력하면 GitHub 설치 페이지로 이동한다. 설치할 레포지토리를 선택하거나 전체 레포지토리에 적용하도록 설정할 수 있다.

GitHub로 이동해서 Claude GitHub 앱을 설치할 수 있습니다. 모든 저장소에 설치할지 선택된 저장소에만 설치할지 결정할 수 있습니다.
설정 완료 후 두 가지 워크플로우를 설치할 수 있습니다. Claude Code는 이슈와 풀 리퀘스트 댓글에서 Claude를 태그할 수 있게 해주고, Claude Code 리뷰는 모든 새로운 풀 리퀘스트에 대해 자동으로 코드를 감사하고 라이브 사이트에 병합하기 전에 잠재적인 문제들을 찾아냅니다.
[00:02:02] 워크플로우 선택

설치 후 ‘Claude Code’ 워크플로우로 이슈 태깅 기능을, ‘Claude Code Review’ 워크플로우로 PR 자동 리뷰 기능을 각각 활성화한다. PR 발생 시 잠재적 문제를 사전에 검출한다.

타임라인 정보가 없습니다.

[00:02:27] Long-lived 토큰 연동

API 키 대신 플랜 구독으로 제공되는 long-lived 토큰을 생성해 GitHub 앱과 연동한다. 별도 비용·키 관리 없이 안정적으로 서비스를 유지할 수 있다.

새로운 기능으로 구독으로 장기간 토큰을 생성할 수 있습니다. API 키를 사용할 수도 있지만, Claude Max 플랜 사용자는 장기간 토큰으로 진행할 수 있습니다. 인증 화면에서 승인을 클릭하면 앱이 설치되고 API 키가 저장되며, 이 변경사항을 저장소에 병합하기 위한 풀 리퀘스트가 자동으로 생성됩니다.
[00:02:48] 자동 PR 생성 및 리뷰봇 작동

앱이 설치되면 자동으로 레포에 PR을 생성해 GitHub ReviewBot이 검토를 시작한다. 파일 변경 사항을 검토하고 안전하게 병합할 준비가 되었는지 알려준다.

Claude ReviewBot이 풀 리퀘스트를 검토하고 병합 가능성을 확인하는 과정을 설명합니다. 두 개의 파일만 확인하면 되므로 비교적 간단할 것이라고 언급합니다.
검토 완료 후 변경사항을 병합하여 Claude를 제대로 사용할 수 있게 됩니다. Claude 코드 리뷰에서는 특정 부분에 집중하기 위해 프롬프트를 원하는 대로 변경할 수 있습니다.
풀 리퀘스트 검토 시 버그와 보안 이슈에 집중하도록 하는 프롬프트 예시를 제시합니다. 간결하고 요점을 전달하며 버그와 보안 취약점 여부만 확인하도록 설정합니다.
[00:03:44] 코드 리뷰 프롬프트 커스터마이징

기본 리뷰 대신 직접 작성한 프롬프트를 입력해 ‘버그·보안 취약점 검출’처럼 중점 항목만 간결하게 검토하도록 설정할 수 있다.

실제 playbooks GitHub 저장소에서 발생한 배포 문제를 예시로 설명합니다. 배포 완료 전에 사용자가 접속하면 Vite 매니페스트를 찾을 수 없다는 오류가 발생하는 문제입니다.
Claude에게 다운타임 없이 앱을 배포할 방법을 요청합니다. 휴대폰이나 어디서든 작업할 수 있으며, 데스크톱에 있을 필요가 없다는 점을 강조합니다.
[00:04:07] 배포 다운타임 문제 해결 데모

Vite Manifest 누락 시 발생하는 배포 오류 이슈를 예로 들어, 유지보수 페이지 노출과 사전 빌드 스크립트를 통해 다운타임을 최소화하는 솔루션을 자동 생성한다.

Claude가 문제를 분석한 결과, 앱 레이아웃의 디렉티브가 배포 중 매니페스트 JSON 파일이 누락되면 예외를 발생시킨다는 원인을 파악했습니다.
Claude가 제시한 솔루션은 문제 발생 시 유지보수 페이지를 보여주고, 다운타임을 최소화하기 위해 에셋을 교체하기 전에 빌드하는 배포 스크립트를 만드는 것입니다.
전체 솔루션에는 우아한 오류 처리와 배포 전략이 포함되어 있습니다. 작업 완료 후 풀 리퀘스트를 생성하여 저장소에 반영할 수 있습니다.
Cursor 프로젝트에서 git pull을 통해 변경사항을 가져오고, 라이브 배포 전에 로컬에서 솔루션이 실제로 작동하는지 테스트할 수 있습니다.
[00:05:34] 로컬 테스트 및 PR 병합

생성된 PR 브랜치를 로컬로 pull한 뒤 동작을 검증한다. 기능이 정상 작동하면 안전하게 라이브 사이트에 병합·배포할 수 있다.

Claude Code를 사용하면 개인 웹사이트의 뉴스레터 박스를 더 크고 눈에 띄게 만들고 싶을 때처럼, 다른 프로젝트도 매우 빠르게 작업할 수 있습니다. 레포지토리의 이슈에서 Claude에게 요청하면 됩니다.
[00:05:39] 뉴스레터 컴포넌트 리디자인 예시

새 이슈로 뉴스레터 박스 디자인 개선을 요청하면, Claude가 UI 구조·컬러·텍스트를 자동 재설계하고 미리보기까지 제공한다.

뉴스레터 컴포넌트를 다시 디자인해서 더 좋게 만들고 더 많은 가입을 유도해달라고 요청할 수 있습니다. 자신이 하는 일에 대한 맥락을 제공하고 마음에 들지 않는 헤드라인과 서브타이틀을 개선하도록 할 수 있습니다.
Claude Code가 전체 뉴스레터 가입 프로세스를 분석하여 사용하지 않는 터미널 컴포넌트에 실제 가입 로직을 구현했습니다. 두 컴포넌트 모두의 디자인을 부드럽게 만들고 메인 페이지를 개선했습니다.
더 부드럽고 친근한 컬러 팔레트를 사용하여 레트로 스타일을 유지하면서도 기술적이지 않은 사용자들에게 환영받는 느낌을 줍니다. 튜토리얼과 콘텐츠를 통해 개발자가 아니어도 AI를 사용할 수 있다는 것을 보여주는 것이 목표입니다.
[00:07:02] 비동기 개발의 이점 및 결론

수면·식사 중에도 Claude가 코드 작업을 병렬로 수행해 생산성을 극대화한다. 비동기 개발 환경을 구성해 프로젝트를 빠르고 안정적으로 진행하도록 권장한다.

풀 리퀘스트를 만들고 미리보기를 확인해보니 더 좋아 보입니다. 초록색 요소들은 없애고 디자인은 잘 했지만 텍스트는 바뀌지 않았습니다. 다크모드도 확인해보니 멋있게 나왔습니다.
이 모든 것이 백그라운드에서 처리되었습니다. 말 그대로 다른 일을 하고 돌아왔더니 완료되어 있었습니다. 이는 비동기 개발의 장점으로, Claude가 잠들거나 식사하거나 다른 작업에 집중하는 동안 작업할 수 있습니다.
Claude Code를 사용하고 있고 GitHub도
사용한다면, Claude Code GitHub
액션을 꼭 설치해야 합니다.
이것은 Claude Code를 기본적으로
백그라운드 에이전트로 만들어서
당신이 놓칠 수 있는 코드베이스의
문제들을 찾아내고 실제로
당신을 위해 풀 리퀘스트를 생성해서
데스크톱에 앉아 있지 않아도
코딩할 수 있게 해줍니다. 기본적으로
GitHub 저장소 안에 자리잡고
이슈와 PR을 감시합니다. 언제든지
Claude Code를 언급하면 Claude가
와서 모든 것을 검토해 줍니다.
즉, 잠자리에 들기 전에 GitHub에
이슈를 등록할 수 있습니다.
아침에 일어나면 Claude가 만든
풀 리퀘스트를 받게 되고,
작동하는지 확인할 수 있습니다.
병합하고 라이브 사이트에 배포하기 전에
데스크톱에서 테스트할 수 있습니다.
기본적으로 팀에 또 다른 개발자가
24시간 백그라운드에서 작업하는
것과 같습니다.
이전에는 API를 통해서만 사용할 수
있었는데, 이는 모든 요청에 대해
비용을 지불해야 했지만 최근에
Claude Pro와 Max 플랜 사용자들에게
제공되기 시작했습니다. 더 이상
비용을 지불하지 않습니다.
데스크톱에서 사용하는 것과
정확히 같습니다. API를 통해
청구되지 않습니다. 모르는 사이에
요금이 부과되지 않습니다. 그냥
사용하면 됩니다. 저는 월 200달러
Max 플랜을 사용하고 있고,
추가 요금 없이 원하는 만큼
사용할 수 있습니다. 이것을 설정하려면
Claude를 열고 /ash 명령어로
GitHub 앱을 설치합니다. 제 프로젝트는
이미 여기에 저장소가 있어서
그것을 선택할 예정이지만, 원한다면
다른 저장소를 입력할 수도 있습니다.
엔터를 누르겠습니다.
Claude GitHub 앱을 설치할 수 있는
GitHub로 이동됩니다. 모든
저장소에 설치할지 선택된
저장소에만 설치할지 결정할 수
있습니다. 저는 Claude를 모든 곳에서
사용하고 싶으므로 모두를 선택하겠습니다.
설정을 완료하면 워크플로우를
설치할 수 있는 옵션이 주어집니다.
Claude Code를 설치할 수 있는데,
이는 이슈와 풀 리퀘스트 댓글에서
Claude를 태그할 수 있다는 의미이고,
Claude Code 리뷰는 모든 새로운
풀 리퀘스트에 대한 자동 코드
리뷰입니다. 풀 리퀘스트가 있을
때마다 코드를 감사하고 라이브
사이트에 병합하기 전에 잠재적인
문제들을 찾아냅니다. 이 두
워크플로우를 모두 설치할 것임을
확인하기 위해 엔터를 누르겠습니다.
이제 구독으로 장기간 토큰을
생성할 수 있는 새로운 기능입니다.
API 키를 사용하고 싶다면 할 수
있지만, 저는 Claude Max 플랜을
가지고 있으므로 장기간 토큰으로
계속 진행하겠습니다. 이것은
승인을 클릭해야 하는 인증 화면으로
이동됩니다. 다시 돌아가면
API 키와 함께 앱이 설치되었음을
확인할 수 있고 저장되었습니다.
그리고 이 변경사항을 저장소에
병합하기 위해 자동으로 풀 리퀘스트를
생성하는 것을 볼 수 있습니다.
Claude ReviewBot이 이를 검토하고 있고
풀 리퀘스트가 병합해도 괜찮은지 확인하고 있습니다.
확인할 파일이 이 두 개뿐이라서
꽤 간단할 것 같습니다.
하지만 여기 있는 할 일 목록을
아주 빠르게 처리할 겁니다.
그리고 완료되면
이를 병합하고 Claude를
제대로 사용할 수 있습니다.
Claude 코드 리뷰에서는
특정 부분에 집중하고 싶다면
프롬프트를 변경할 수 있습니다.
원하는 대로 변경할 수 있어요.
예를 들어 이런 식으로
변경할 수 있습니다.
풀 리퀘스트를 검토해주세요.
버그와 보안 이슈를 중점적으로 살펴보세요.
잠재적인 버그와 취약점에 대해서만
피드백을 제공하세요.
간결하고 요점을 말하세요. 제가 중점적으로
원하는 것은 버그가 있는지와
보안 취약점이 있는지입니다.
이제 제 playbooks GitHub 저장소의
이 이슈에서 어떻게 사용하는지 봅시다.
가끔 배포할 때 문제가 생깁니다.
사용자가 배포가 완료되기 전에
사이트에 접속하면 오류가 발생합니다.
Vite 매니페스트를 찾을 수 없다는 오류죠.
Sentry에서 이 문제를 설명하는
정보를 얻었습니다.
그래서 Claude에게 이걸 살펴보고
다운타임 없이 앱을 배포할 방법을
찾을 수 있는지 물어봤습니다.
이제 Claude가 이를 검토하고 있습니다.
다운타임 문제를 분석할 겁니다.
현재 설정을 살펴보고
프로세스와 오류 처리를 살펴보고
누락된 Vite 매니페스트에 대한
우아한 처리를 구현할 겁니다.
그러면 이 문제를 해결할 수 있을 겁니다.
다시 말하지만, 휴대폰으로도
어디서든 할 수 있습니다.
Claude가 바로 들어와서
작업을 시작할 거예요. 이게 작동하려면
데스크톱에 있을 필요가 없습니다.
벌써 Claude가 문제를 찾았습니다.
앱 레이아웃이 디렉티브를 사용하는데
배포 중에 매니페스트 JSON 파일이
누락되면 예외가 발생합니다.
여기서 솔루션을 만들었는데
기본적으로 이런 일이 발생하면
유지보수 페이지를 보여줍니다. 그리고
다운타임을 최소화하기 위해
에셋을 교체하기 전에 빌드하는
배포 스크립트도 만들 수 있습니다.
또한 이를 수행하는 방법에 대한
전체 지침이 포함된 deployment.md도
만들었습니다. 여기 전체 솔루션이 있습니다.
우아한 오류 처리. 오류를 잡아서
유지보수 페이지를 보여주고
배포 전략도 권장합니다.
라이브로 가기 전에 에셋을
완전히 빌드하는 새로운 스크립트와 함께 말이죠.
그리고 여기 위쪽에서
작업이 완료되었다고 나와 있습니다.
수행한 작업을 보거나
그냥 Create PR을 클릭하면
저장소에 풀 리퀘스트를 만들어줍니다.
여기서 변경된 파일들을 볼 수 있습니다.
그리고 Cursor 내 프로젝트에서
git pull을 할 수 있습니다.
그러면 이슈를 확인할 수 있습니다.
이제 이 브랜치에 있습니다.
라이브로 배포하기 전에 로컬에서
실제로 작동하는지 테스트할 수 있습니다.
다른 프로젝트도 매우 빠르게 작업할 수 있습니다.
밖에 있다가 개인 웹사이트에서
뉴스레터 박스를 더 크고
눈에 띄게 만들고 싶다고 결정할 수 있습니다.
그럼 레포지토리로 가서 이슈에 가서
Claude에게 그걸 해달라고 요청할 수 있습니다.
새로운 이슈를 만들어서
뉴스레터 컴포넌트를 다시 디자인해서
더 좋게 만들고 더 많은 가입을
유도해달라고 요청할 수 있습니다.
제가 하는 일에 대한 맥락을 좀 줄 수 있고
헤드라인과 서브타이틀이
특별히 마음에 들지 않습니다.
이제 Claude Code가 이걸 처리해서
가서 작업하고
뉴스레터 가입을 위한 새로운 버전을 제안해줄 겁니다.
좋아요, 이것 좀 보세요.
말 그대로 제 뉴스레터 가입 프로세스 전체를 살펴보고
우선 제가 실제로 사용하지 않는
터미널 컴포넌트가 있고
거기에 할일이 있다는 걸 알아냈습니다.
그래서 실제 가입 로직을 구현했습니다.
이제 가서 디자인을 부드럽게 만들었습니다.
기본적으로 두 컴포넌트 모두에 대해서요.
두 개가 있었거든요.
메인 페이지를 조금 다시 디자인했고
더 많은 공간과 여백을 추가했습니다.
이제 더 부드럽고 친근한 컬러 팔레트를 사용하고 있습니다.
제 레트로 스타일을 유지하면서도
여전히 기술적이지 않은 사용자들에게
환영받는 느낌을 주고 있습니다.
제가 정말로 튜토리얼과 콘텐츠를 통해
도달하려고 하는 분들에게
개발자가 아니어도 AI를 사용할 수 있다는 것을
보여주려고 하는 거죠.
이제 위로 올라가서 풀 리퀘스트를
만들 수 있습니다.
셀에서 미리보기를 만들어줬으니
이제 미리보기를 볼 수 있습니다.
좋아요, 이게 더 좋아 보입니다.
Ian's list는 딱히 마음에 들지 않지만
초록색 요소들은 없애줬네요.
실제로는 텍스트는 바뀌지 않았지만
잘 디자인했습니다.
꽤 좋네요. 다크모드도 확인해보겠습니다.
좋아요, 멋있네요.
이게 이 새로운 테마를 중심으로
이 페이지를 완전히 다르게 디자인할
아이디어를 주네요.
사실 꽤 마음에 들어요.
정말 좋습니다.
시스템으로 돌아가보겠습니다.
괜찮아 보이네요.
이 모든 것이 백그라운드에서 처리되었습니다.
말 그대로 제가 가서 다른 일을 하고
돌아왔더니 완료되어 있었습니다.
이걸 직접 시도해보고 비동기 개발을 설정해보세요.
이는 Claude가 당신이 잠들거나 식사하거나
다른 작업에 집중하는 동안 작업할 수 있다는 뜻입니다.
GitHub 레포지토리 안에서
할 일을 줄 수 있습니다.
Claude Code와 동시에 작업해서
작업량을 두 배로 늘릴 수 있습니다.
그리고 풀 리퀘스트에서 작업할 때마다
이슈를 해결받을 수 있습니다.
당신이 문제라는 걸 알지도 못했던 것들을 찾아서
더 좋고 안전하고 보안이 강화된
앱을 출시할 수 있도록 도와줍니다.