GitHub Enterprise Server 연동

기준일: 2026-07-26
공식 기준: Claude Code with GitHub Enterprise Server

개요

GitHub Enterprise Server(GHES) 지원은 Team 및 Enterprise 플랜에서 사용할 수 있습니다.

조직이 self-managed GitHub 인스턴스의 저장소를 github.com 대신 Claude Code와 연결할 수 있습니다. Owner가 GHES 인스턴스를 한 번 연결하면 개발자는 저장소별 추가 설정 없이 웹 세션·자동 코드 리뷰를 사용할 수 있습니다. 인스턴스 호스팅 플러그인 마켓플레이스도 지원되며 표면별 자격 증명 요구는 아래 표와 같습니다.

github.com 저장소: Claude Code on the web, Code Review. 자체 CI: GitHub Actions.

핵심 개념

기능	GHES	비고
Claude Code on the web	✅	Owner 1회 연결; claude --cloud / claude.ai/code
Code Review	✅	github.com과 동일한 자동 PR 리뷰
Claude Security	✅	Enterprise public beta, claude.ai/security
Teleport	✅	--teleport로 웹↔터미널
Plugin marketplaces	✅	표면별 자격 증명 상이
Contribution metrics	✅	webhook → analytics
GitHub Actions	✅	수동 workflow; /install-github-app는 github.com only
GitHub MCP server	❌	GHES에서 미지원

상세

Admin 설정

Owner 또는 Primary Owner + GHES에 GitHub App 생성 권한 필요. 가이드 설정이 App 매니페스트를 만들고 GHES로 리다이렉트. 리다이렉트가 막히면 수동 설정.

1. claude.ai/admin-settings/claude-code → GHES 섹션
2. Connect — 표시 이름, 호스트명(예: github.example.com). self-signed/private CA면 선택 필드에 CA 인증서
3. Continue to GitHub Enterprise — 매니페스트 검토 후 Create GitHub App. 자격 증명 자동 저장
4. GHES에서 앱을 저장소/조직에 설치
5. 동일 관리 페이지에서 Code Review, Claude Security, contribution metrics 활성화

GitHub App 권한

권한	접근	용도
Contents	R/W	clone, 브랜치 push
Pull requests	R/W	PR 생성·리뷰 코멘트
Issues	R/W	멘션 응답
Checks	R/W	Code Review check runs
Actions	Read	auto-fix용 CI 상태
Repository hooks	R/W	contribution metrics webhook
Metadata	Read	GitHub 필수

이벤트: pull_request, issue_comment, pull_request_review_comment, pull_request_review, check_run.

수동 설정

Add manually — 동일 권한·이벤트로 App 생성 후 hostname, OAuth client ID/secret, App ID, client ID/secret, webhook secret, private key 입력.

네트워크

Anthropic 인프라가 GHES에 도달해야 clone·리뷰 코멘트 가능. 방화벽이면 Anthropic API IP allowlist.

개발자 워크플로

Owner 연결 후 개발자 측 추가 설정 없음. working directory git remote에서 GHES 호스트 자동 감지.

git clone git@github.example.com:platform/api-service.git
cd api-service
claude --cloud "Add retry logic to the payment webhook handler"

세션은 Anthropic 인프라에서 실행, GHES에서 clone, 브랜치에 push. /tasks 또는 claude.ai/code로 모니터링.

Teleport

claude --teleport — 동일 GHES 저장소 checkout인지 검증 후 브랜치·세션 이력 로드.

GHES 플러그인 마켓플레이스

표면	설치 방식	사용자 필요
CLI·Desktop	머신 git 자격 증명으로 clone	GHES git 접근
Managed extraKnownMarketplaces	동일, 머신 git	GHES git 접근
claude.ai org plugin settings	Owner가 GHES 소스 선택; 백엔드가 org GitHub App으로 sync	사용자 추가 불필요(추가 시 Owner 개인 GHE 연결 + App이 마켓 저장소에 설치)
claude.ai user settings	제출 사용자 GHE 연결로 fetch	본인 GHE 계정 연결
Claude Code on the web	세션 샌드박스 clone. 같은 인스턴스 세션 저장소일 때만 도달 가능·불안정	CLI/managed/claude.ai 권장

경고: claude.ai의 GHE 연결은 사용자별. org admin setup이 개인 계정을 대신 연결하지 않음. org plugin settings로 Owner가 추가한 마켓은 지속 fetch에 org App을 쓰므로 사용자 연결 불필요(추가 시점 Owner 연결은 필요).

마켓 추가

owner/repo 단축은 항상 github.com. GHES는 전체 git URL (HTTPS 권장):

/plugin marketplace add https://github.example.com/platform/claude-plugins.git

SSH는 호스트가 known_hosts에 있을 때. git non-interactive라 미신뢰 호스트 SSH 거부.

managed 사전 등록

{
  "extraKnownMarketplaces": {
    "internal-tools": {
      "source": {
        "source": "git",
        "url": "https://github.example.com/platform/claude-plugins.git"
      }
    }
  }
}

전체 URL, HTTPS 선호, 머신 clone 가능 여부 확인, managed 파일이 디바이스에 배포됐는지 확인.

allowlist hostPattern

{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}

제한·대안

• /install-github-app → claude.ai admin setup. GHA workflow는 example 수동 적용
• GitHub MCP → GHES용 gh auth login --hostname github.example.com 후 gh 명령

트러블슈팅

• clone 실패: Owner setup·App 설치·등록 호스트명 vs git remote
• marketplace policy error: admin hostPattern 추가
• claude.ai GitHub access error: 본인 GHE 계정 미연결. repository picker 또는 admin 설정에서 연결. Browse “Connect to GitHub”는 github.com만
• 인스턴스 미도달: Anthropic IP allowlist
• Unable to get organization UUID: Team/Ent 조직 /login. API 키만이면 더 이른 실패

체크리스트

• Team/Enterprise이고 Owner가 GHES App을 연결·설치했다
• Anthropic IP가 GHES에 도달한다
• 개발자는 git remote 기반 자동 감지를 확인했다
• GHES 마켓은 전체 URL·HTTPS·표면별 자격 증명을 맞췄다
• GitHub MCP를 기대하지 않고 gh 대안을 준비했다

다음 단계

• Claude Code on the web
• Code Review
• Plugin marketplaces
• Analytics
• Managed settings
• Network configuration

기준일

• 문서 작성·동기화 기준일: 2026-07-26
• 원문: https://code.claude.com/docs/en/github-enterprise-server