Claude Code と GitHub Enterprise Server
Claude Code を自社ホストの GitHub Enterprise Server インスタンスに接続して、Web セッション、コードレビュー、プラグインマーケットプレイスを利用できます。
GitHub Enterprise Server（GHES）サポートにより、組織は github.com ではなく自社管理の GitHub インスタンスでホストされているリポジトリで Claude Code を使用できます。管理者が GHES インスタンスを接続すると、開発者はリポジトリごとの設定なしで Web セッションを実行し、自動コードレビューを取得できます。インスタンスでホストされているプラグインマーケットプレイスもサポートされており、認証情報の要件は GHES 上のプラグインマーケットプレイス で説明されているように、サーフェスによって異なります。
github.com 上のリポジトリについては、Claude Code on the web および Code Review を参照してください。Claude を独自の CI インフラストラクチャで実行するには、GitHub Actions を参照してください。
GitHub Enterprise Server で動作する機能
以下の表は、Claude Code のどの機能が GHES をサポートしているか、および github.com の動作との違いを示しています。
| 機能 | GHES サポート | 注記 |
|---|---|---|
| Claude Code on the web | ✅ サポート | 管理者が GHES インスタンスを 1 回接続すると、開発者は通常通り claude --cloud または claude.ai/code を使用できます |
| Code Review | ✅ サポート | github.com と同じ自動 PR レビュー |
| Claude Security | ✅ サポート | Enterprise プランの公開ベータで claude.ai/security で利用可能 |
| Teleport セッション | ✅ サポート | --teleport で Web とターミナル間でセッションを移動 |
| プラグインマーケットプレイス | ✅ サポート | 表面によって認証情報の要件が異なります。GHES 上のプラグインマーケットプレイスを参照してください |
| 貢献度メトリクス | ✅ サポート | 分析ダッシュボード への Webhook 経由で配信 |
| GitHub Actions | ✅ サポート | 手動ワークフロー設定が必要。/install-github-app は github.com のみ |
| GitHub MCP サーバー | ❌ サポートなし | GitHub MCP サーバーは GHES インスタンスでは動作しません |
管理者セットアップ
管理者が GHES インスタンスを Claude Code に 1 回接続します。その後、組織の開発者は追加の設定なしで GHES リポジトリを使用できます。Claude 組織への Owner または Primary Owner ロールと、GHES インスタンスで GitHub App を作成する権限が必要です。
ガイド付きセットアップは GitHub App マニフェストを生成し、GHES インスタンスにリダイレクトして 1 クリックでアプリを作成します。環境がリダイレクトフローをブロックしている場合は、代替手動セットアップ が利用可能です。
Claude Code 管理者設定を開く
claude.ai/admin-settings/claude-code にアクセスして、GitHub Enterprise Server セクションを見つけます。
ガイド付きセットアップを開始
Connect をクリックします。接続の表示名と GHES ホスト名（例：github.example.com）を入力します。GHES インスタンスが自己署名証明書またはプライベート認証局を使用している場合は、CA 証明書をオプションフィールドに貼り付けます。
GitHub App を作成
Continue to GitHub Enterprise をクリックします。ブラウザが事前入力されたアプリマニフェストを含む GHES インスタンスにリダイレクトされます。設定を確認して Create GitHub App をクリックします。GHES はアプリ認証情報が自動的に保存された状態で Claude にリダイレクトします。
リポジトリにアプリをインストール
GHES インスタンスの GitHub App ページから、Claude がアクセスする必要があるリポジトリまたは組織にアプリをインストールします。最初はサブセットで開始して、後で追加できます。
機能を有効化
claude.ai/admin-settings/claude-code に戻り、GHES リポジトリの Code Review、Claude Security、および 貢献度メトリクス を github.com と同じ設定で有効化します。
GitHub App の権限
マニフェストは、Web セッション、Code Review、Claude Security、および貢献度メトリクス全体で Claude が必要とする権限と Webhook イベントで GitHub App を設定します。
| 権限 | アクセス | 用途 |
|---|---|---|
| Contents | 読み取りと書き込み | リポジトリのクローンとブランチのプッシュ |
| Pull requests | 読み取りと書き込み | PR の作成とレビューコメントの投稿 |
| Issues | 読み取りと書き込み | Issue メンションへの応答 |
| Checks | 読み取りと書き込み | Code Review チェック実行の投稿 |
| Actions | 読み取り | 自動修正用の CI ステータスの読み取り |
| Repository hooks | 読み取りと書き込み | 貢献度メトリクス用の Webhook 受信 |
| Metadata | 読み取り | すべてのアプリで GitHub が必須 |
アプリは pull_request、issue_comment、pull_request_review_comment、pull_request_review、および check_run イベントをサブスクライブします。
手動セットアップ
ネットワーク設定によってガイド付きリダイレクトフローがブロックされている場合は、Connect の代わりに Add manually をクリックします。上記の権限とイベント を使用して GHES インスタンスで GitHub App を作成し、フォームにアプリ認証情報を入力します。ホスト名、OAuth クライアント ID とシークレット、GitHub App ID、クライアント ID、クライアントシークレット、Webhook シークレット、および秘密鍵です。
ネットワーク要件
GHES インスタンスは Anthropic インフラストラクチャから到達可能である必要があります。これにより Claude はリポジトリをクローンしてレビューコメントを投稿できます。GHES インスタンスがファイアウォールの背後にある場合は、Anthropic API IP アドレス をホワイトリストに登録します。
開発者ワークフロー
管理者が GHES インスタンスを接続した後、開発者側の設定は不要です。Claude Code は作業ディレクトリの git リモートから GHES ホスト名を自動的に検出します。
通常通り GHES インスタンスからリポジトリをクローンします。
git clone git@github.example.com:platform/api-service.git
cd api-service
次に Web セッションを開始します。Claude は git リモートから GHES ホストを検出し、セッションを組織の設定されたインスタンスを通じてルーティングします。
claude --cloud "Add retry logic to the payment webhook handler"
セッションは Anthropic インフラストラクチャで実行され、GHES からリポジトリをクローンし、変更をブランチにプッシュバックします。/tasks で、または claude.ai/code で進捗を監視します。diff レビュー、自動修正、ルーチンを含む完全なクラウドセッションワークフローについては、Claude Code on the web を参照してください。Claude Code on the web を参照してください。
セッションをターミナルに Teleport する
claude --teleport で Web セッションをローカルターミナルにプルします。Teleport は、ブランチをフェッチしてセッション履歴を読み込む前に、同じ GHES リポジトリのチェックアウトにいることを確認します。詳細については、teleport 要件 を参照してください。
GHES 上のプラグインマーケットプレイス
GHES インスタンスでプラグインマーケットプレイスをホストして、組織全体に内部ツールを配布します。マーケットプレイス構造は github.com でホストされているマーケットプレイスと同じですが、マーケットプレイスを追加する場所によってインストール方法が異なり、サーフェス全体で認証情報が異なります。
| サーフェス | インストール方法 | 各ユーザーに必要なもの |
|---|---|---|
| Claude Code CLI とデスクトップ | Claude Code はマシンの既存の git 認証情報を使用してマーケットプレイスリポジトリをクローンします | マシンから GHES ホストへの Git アクセス |
管理設定（extraKnownMarketplaces） |
Claude Code はエントリを登録し、マシンの既存の git 認証情報を使用してリポジトリをクローンします | マシンから GHES ホストへの Git アクセス |
| claude.ai 組織プラグイン設定 | Owner が GHES インスタンスをソースとして選択します。Anthropic のバックエンドが admin setup の GitHub App を使用してリポジトリをフェッチして同期します | 追加後はユーザーごとに不要です。それを追加する Owner は、アクセスチェックとして独自の GitHub Enterprise アカウントを接続する必要があり、GitHub App をマーケットプレイスリポジトリにインストールする必要があります |
| claude.ai ユーザー設定 | Anthropic のバックエンドが送信ユーザーの GitHub Enterprise 接続を使用してリポジトリをフェッチします | Claude に接続された独自の GitHub Enterprise アカウント |
| Claude Code on the web | クラウドセッションはセッションサンドボックス内でマーケットプレイスをクローンします。サンドボックスは、セッションのリポジトリが同じインスタンス上にある場合にのみ GHES インスタンスに到達でき、git 認証情報はセッションのリポジトリにスコープされます | GHES でホストされているマーケットプレイスには信頼できません。セッションのリポジトリとは異なるホストに到達できず、同じインスタンスのインストールでも失敗する可能性があります。代わりに CLI、管理設定、または claude.ai を使用してください |
GHES マーケットプレイスを追加
owner/repo ショートハンドは常に github.com に解決されます。GHES でホストされているマーケットプレイスの場合は、完全な git URL を使用します。HTTPS URL が推奨されます。
/plugin marketplace add https://github.example.com/platform/claude-plugins.git
マシンが既に GHES ホストを信頼している場合、SSH URL が機能します。
/plugin marketplace add git@github.example.com:platform/claude-plugins.git
Claude Code は git を非対話的に実行し、マシンの known_hosts ファイルにないホストへの SSH 接続を拒否します。git 認証情報ヘルパーを備えた HTTPS URL は known_hosts 要件を回避します。
マーケットプレイスの構築の完全なガイドについては、プラグインマーケットプレイスの作成と配布 を参照してください。
管理設定で GHES マーケットプレイスを事前登録
extraKnownMarketplaces 設定はマーケットプレイスを事前登録して、開発者が手動セットアップなしでそれを取得できるようにします。これは 任意の設定ファイル から機能します。リポジトリの .claude/settings.json を含めて、管理設定はそれを組織全体に配信します。
{
"extraKnownMarketplaces": {
"internal-tools": {
"source": {
"source": "git",
"url": "https://github.example.com/platform/claude-plugins.git"
}
}
}
}
Claude Code はこれらのマーケットプレイスをローカルにインストールします。各エントリを登録し、マシンの既存の git 認証情報を使用してリポジトリをクローンします。このパスは claude.ai を通過しないため、ユーザーごとの GitHub Enterprise 接続は不要です。成功したロールアウトのために。
- 完全な git URL を使用します。
owner/repoショートハンドは常に github.com に解決され、GHES ホストを参照できません。 - HTTPS URL を優先します。 SSH クローンは GHES ホストキーを既に信頼していないマシンで失敗します。組織の標準 git 認証情報ヘルパーを備えた HTTPS URL は、認証情報が設定されているすべてのマシンで機能します。
- 各マシンが GHES ホストからクローンできることを確認します。 マシンに認証情報がない場合、マーケットプレイスは登録されますが、インストールされず、そのプラグインは認証情報を求めるのではなく見つからないと報告されます。
- 設定が各マシンに到達することを確認します。 管理設定ファイルは、デバイス管理システムを通じて配置されたマシンなど、配置されたマシンにのみ有効です。管理設定 のファイルの場所を参照してください。
管理設定で GHES マーケットプレイスをホワイトリストに登録
組織が 管理設定 を使用して開発者が追加できるマーケットプレイスを制限している場合は、hostPattern ソースタイプを使用して、各リポジトリを列挙することなく GHES インスタンスからすべてのマーケットプレイスを許可します。
{
"strictKnownMarketplaces": [
{
"source": "hostPattern",
"hostPattern": "^github\\.example\\.com$"
}
]
}
完全なスキーマについては、strictKnownMarketplaces および extraKnownMarketplaces 設定リファレンスを参照してください。
制限事項
いくつかの機能は GHES では github.com と異なる動作をします。機能表 はサポートをまとめています。このセクションでは回避策について説明します。
/install-github-appコマンド：claude.ai で 管理者セットアップ フローに従ってください。GHES で GitHub Actions ワークフローも必要な場合は、サンプルワークフロー を手動で適応させてください。- GitHub MCP サーバー：代わりに GHES ホスト用に設定された
ghCLI を使用してください。gh auth login --hostname github.example.comを実行して認証し、Claude はセッションでghコマンドを使用できます。
トラブルシューティング
Web セッションがリポジトリのクローンに失敗
claude --cloud がクローンエラーで失敗する場合は、Owner が GHES インスタンスのセットアップを完了し、GitHub App が作業しているリポジトリにインストールされていることを確認してください。インスタンスを接続した Owner に確認して、Claude 設定に登録されているホスト名が git リモートのホスト名と一致することを確認してください。
マーケットプレイス追加がポリシーエラーで失敗
GHES URL の /plugin marketplace add がブロックされている場合、組織はマーケットプレイスソースを制限しています。管理者に 管理設定 で GHES ホスト名の hostPattern エントリを追加するよう依頼してください。
claude.ai でのマーケットプレイス追加が GitHub アクセスエラーで失敗
ユーザー設定から GHES マーケットプレイスを追加する際に「Marketplace couldn't be added」のような一般的なエラーで失敗する場合は、まず GitHub Enterprise 接続を確認してください。これは、組織の GHES インスタンスが設定されており他のユーザーが接続されている場合でも、独自の GitHub Enterprise アカウントが Claude に接続されていない場合に表示されます。ダイアログは GitHub Enterprise 接続フローを指していません。また、Browse タブの「Connect to GitHub」オプションは github.com にサインインするため、GHES リポジトリへのアクセス権を付与しません。
GitHub Enterprise アカウントを接続するには、claude.ai/code のリポジトリピッカーが設定済みの各 GHES インスタンスの接続オプションを提供します。また、Owner は Claude Code 管理設定 の GitHub Enterprise セクションからも接続できます。その後、マーケットプレイスを再度追加してください。または、Owner に組織プラグイン設定でマーケットプレイスを追加するよう依頼してください。これにより、ユーザーごとの接続要件が削除されます。
他の claude.ai サーフェスでは、GHES マーケットプレイスの「Repository not found. If it's private, GitHub access is required」エラーは通常、同じ接続の欠落を示しています。上記のいずれかのパスを通じて GitHub Enterprise アカウントを接続してから、もう一度試してください。
GHES インスタンスに到達不可
レビューまたは Web セッションがタイムアウトする場合、GHES インスタンスは Anthropic インフラストラクチャから到達不可能な可能性があります。ファイアウォールが Anthropic API IP アドレス からのインバウンド接続を許可していることを確認してください。
関連リソース
これらのページは、このガイド全体で参照されている機能をより詳しく説明しています。
- Claude Code on the web：クラウドインフラストラクチャで Claude Code セッションを実行
- Code Review：自動 PR レビュー
- プラグインマーケットプレイス：プラグインカタログの構築と配布
- 分析：使用状況と貢献度メトリクスの追跡
- 管理設定：組織全体のポリシー設定
- ネットワーク設定：ファイアウォールと IP ホワイトリストの要件