Claude Code 與 GitHub Enterprise Server

將 Claude Code 連接到您自託管的 GitHub Enterprise Server 實例，以進行網頁會話、代碼審查和插件市場。

GitHub Enterprise Server (GHES) 支持讓您的組織使用 Claude Code 與託管在自管理 GitHub 實例上的存儲庫，而不是 github.com。一旦 Owner 連接您的 GHES 實例，開發人員可以運行網頁會話和獲得自動化代碼審查，無需任何按存儲庫的配置。您實例上託管的插件市場也受支持；憑證要求因表面而異，如 GHES 上的插件市場 中所述。

對於 github.com 上的存儲庫，請參閱 Claude Code on the web 和 Code Review。要在您自己的 CI 基礎設施中運行 Claude，請參閱 GitHub Actions。

GitHub Enterprise Server 支持的功能

下表顯示了 Claude Code 的哪些功能支持 GHES，以及與 github.com 行為的任何差異。

管理員設定

組織擁有者連接您的 GHES 執行個體到 Claude Code 一次。之後，您組織中的開發人員可以使用 GHES 儲存庫，無需任何額外設定。您需要在 Claude 組織中擁有擁有者或主要擁有者角色，以及在 GHES 執行個體上建立 GitHub Apps 的權限。

引導式設定會產生 GitHub App 資訊清單，並將您重新導向到 GHES 執行個體以一鍵建立應用程式。如果您的環境阻止重新導向流程，可以使用替代手動設定。

GitHub App 權限

資訊清單使用下列權限和 webhook 事件設定 GitHub App，這些權限和事件共同涵蓋網頁工作階段、程式碼審查、Claude Security、外掛程式市集和貢獻指標：

應用程式訂閱 pull_request、issue_comment、pull_request_review_comment、pull_request_review、check_run 和 status 事件。

GitHub 只在建立應用程式時套用資訊清單，因此從較早版本資訊清單建立的應用程式會保留建立時的權限和事件。如果您的應用程式缺少上述任何權限或事件，請在 GHES 執行個體上的應用程式設定中新增它們。GitHub 隨後會要求每個安裝的擁有者核准新權限，安裝會保留其舊權限，直到他們核准為止。

手動設定

如果您的網路設定阻止引導式重新導向流程，請點擊手動新增而不是連接。在 GHES 執行個體上使用上述權限和事件建立 GitHub App，然後在表單中輸入連接詳細資訊：顯示名稱、GHES 主機名稱和選用連接埠，以及應用程式 ID、用戶端 ID、用戶端密碼、webhook 密碼和私密金鑰。表單也接受選用的自訂 CA 憑證和讀取複本主機名稱。

Claude 在您儲存連接時產生應用程式的 webhook URL。在您點擊新增設定後，開啟連接的更多選項功能表，選擇複製 webhook URL，並將 URL 貼到 GHES 執行個體上應用程式的 webhook 設定中。使用您在表單中輸入的相同 webhook 密碼。

網路需求

對於 Anthropic 代管的工作階段，您的 GHES 執行個體必須可從 Anthropic 基礎結構存取，以便 Claude 可以複製儲存庫和發佈審查評論。如果您的 GHES 執行個體位於防火牆後面，請將 Anthropic 的出站 IP 位址加入允許清單。自我代管環境中的工作階段會從您的網路內部複製，除非執行者選擇加入Anthropic git proxy，該 proxy 從 Anthropic 端擷取並需要相同的可達性；SCM 連接器涵蓋代管的前置工作階段流程，例如儲存庫選擇器，適用於僅在內部可路由的 GHES 主機。

開發者工作流程

一旦擁有者連接了 GHES 執行個體，開發者端就不需要任何設定。Claude Code 會自動從您工作目錄中的 git remote 偵測您的 GHES 主機名稱。

從您的 GHES 執行個體複製儲存庫，方式與平常相同，將 github.example.com 和儲存庫路徑替換為您的 GHES 主機名稱和儲存庫：

git clone git@github.example.com:platform/api-service.git
cd api-service

然後啟動網頁工作階段。Claude 會從您的 git remote 偵測 GHES 主機，並透過您組織設定的執行個體路由工作階段：

claude --cloud "Add retry logic to the payment webhook handler"

工作階段會從 GHES 複製您的儲存庫，並將變更推送回分支。在 claude.ai/code 監控進度。請參閱 Claude Code on the web 以了解完整的雲端工作階段工作流程，包括差異檢閱、自動修復和例行程序。

將 Teleport 工作階段傳送到您的終端機

使用 claude --teleport 將網頁工作階段拉入您的本機終端機。Teleport 會驗證您是否在相同 GHES 儲存庫的簽出中，然後再擷取分支並載入工作階段歷史記錄。請參閱 teleport requirements 以了解詳細資訊。

GHES 上的插件市場

在您的 GHES 實例上託管插件市場，以在您的組織中分發內部工具。市場結構與 github.com 託管的市場相同，但安裝方式取決於您在何處新增市場，且認證在不同介面上有所不同：

添加 GHES 市場

owner/repo 簡寫始終解析為 github.com。對於 GHES 託管的市場，請使用完整的 git URL，將 github.example.com 和存儲庫路徑替換為您自己的。建議使用 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 要求。

有關構建市場的完整指南，請參閱 Create and distribute a plugin marketplace。

使用託管設定預先註冊 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 主機複製。 如果機器缺少認證，市場已註冊但永遠不會安裝，其插件報告為未找到而不是提示輸入認證。
• 確認設定到達每台機器。 託管設定檔案只對部署到的機器生效，例如透過您的裝置管理系統。有關檔案位置，請參閱 Deploy managed settings。

在託管設定中將 GHES 市場列入白名單

如果您的組織使用 託管設定 來限制開發人員可以添加的市場，請使用 hostPattern 源類型來允許來自您的 GHES 實例的所有市場，而無需列舉每個存儲庫。有關每個平台上的檔案位置，請參閱 Delivery mechanisms。將 JSON 新增到您的 managed-settings.json 檔案或等效的 MDM 政策：

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

有關完整的架構，請參閱 strictKnownMarketplaces 和 extraKnownMarketplaces 設定參考。

限制

一些功能在 GHES 上的行為與 github.com 上不同。功能表 總結了支持；本部分涵蓋了解決方案。

• /install-github-app 命令：改為遵循 claude.ai 上的 管理員設置 流程。如果您還想在 GHES 上使用 GitHub Actions 工作流，請手動調整 示例工作流。
• GitHub MCP server：改為使用為您的 GHES 主機配置的 gh CLI。運行 gh auth login --hostname github.example.com 進行身份驗證，然後 Claude 可以在會話中使用 gh 命令。

故障排除

網頁會話無法克隆存儲庫

如果 claude --cloud 因克隆錯誤而失敗，請驗證 Owner 已完成您的 GHES 實例的設置，並且 GitHub App 已安裝在您正在使用的存儲庫上。與連接該實例的 Owner 確認在 Claude 設置中註冊的主機名與您的 git 遠端中的主機名匹配。

市場添加因策略錯誤而失敗

如果 /plugin marketplace add 因您的 GHES URL 而被阻止，您的組織已限制市場源。要求您的管理員在 託管設置 中為您的 GHES 主機名添加 hostPattern 條目。

claude.ai 上的市場添加因 GitHub 存取錯誤而失敗

如果從您的使用者設置添加 GHES 市場失敗並出現通用錯誤（例如「無法添加市場」），請先檢查您的 GitHub Enterprise 連接。這是當您自己的 GitHub Enterprise 帳戶未連接到 Claude 時出現的情況，即使您的組織的 GHES 實例已配置且其他使用者已連接。該對話框不會指向 GitHub Enterprise 連接流程，而「瀏覽」標籤上的「連接到 GitHub」選項會登入 github.com，這不會授予對 GHES 存儲庫的存取權限。

要連接您的 GitHub Enterprise 帳戶：claude.ai/code 上的存儲庫選擇器為每個已配置的 GHES 實例提供連接選項，Owner 也可以從 Claude Code 管理員設置 的 GitHub Enterprise 部分進行連接。然後再次添加市場。或者，要求 Owner 在組織外掛程式設置中添加市場，這樣可以消除每個使用者的連接要求。

在其他 claude.ai 表面上，GHES 市場上的「找不到存儲庫。如果是私有的，需要 GitHub 存取」錯誤通常表示相同的缺失連接。通過上述路徑之一連接您的 GitHub Enterprise 帳戶，然後重試。

GHES 實例無法訪問

如果審查或 Anthropic 託管的網頁會話超時，您的 GHES 實例可能無法從 Anthropic 基礎設施訪問。確認您的防火牆允許來自 Anthropic 的出站 IP 地址的入站連接。自託管環境中的會話從您的網路內部訪問 GHES，因此對於它們，請檢查執行器自身的網路路徑和SCM 連接器。

會話啟動失敗，出現 `Unable to get organization UUID`

網頁會話需要 Team 或 Enterprise 組織。使用 /login 以您的組織帳戶登入。如果您改用 API 金鑰進行身份驗證，網頁會話會更早失敗，並顯示要求您執行 /login 的訊息。

相關資源

這些頁面更深入地涵蓋了本指南中引用的功能：

• Claude Code on the web：在雲基礎設施上運行 Claude Code 會話
• Code Review：自動化 PR 審查
• Plugin marketplaces：構建和分發插件目錄
• Analytics：跟踪使用情況和貢獻指標
• Managed settings：組織範圍的策略配置
• Network configuration：防火牆和 IP 白名單要求