Claude Code 與 GitHub Enterprise Server
將 Claude Code 連接到您自託管的 GitHub Enterprise Server 實例，以進行網頁會話、代碼審查和插件市場。
GitHub Enterprise Server (GHES) 支持讓您的組織使用 Claude Code 與託管在自管理 GitHub 實例上的存儲庫，而不是 github.com。一旦管理員連接您的 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 on the web | ✅ 支持 | 管理員連接 GHES 實例一次；開發人員像往常一樣使用 claude --remote 或 claude.ai/code |
| Code Review | ✅ 支持 | 與 github.com 相同的自動化 PR 審查 |
| Claude Security | ✅ 支持 | 在 Enterprise 計劃的公開測試版中提供，位於 claude.ai/security |
| Teleport sessions | ✅ 支持 | 使用 --teleport 在網頁和終端之間移動會話 |
| Plugin marketplaces | ✅ 支持 | 使用完整的 git URL 而不是 owner/repo 簡寫 |
| Contribution metrics | ✅ 支持 | 通過 webhooks 傳遞到 analytics dashboard |
| GitHub Actions | ✅ 支持 | 需要手動工作流設置；/install-github-app 僅適用於 github.com |
| GitHub MCP server | ❌ 不支持 | GitHub MCP server 不適用於 GHES 實例 |
管理員設置
管理員將您的 GHES 實例連接到 Claude Code 一次。之後，您組織中的開發人員可以使用 GHES 存儲庫，無需任何額外配置。您需要對 Claude 組織具有管理員訪問權限，以及在 GHES 實例上創建 GitHub Apps 的權限。
引導式設置生成 GitHub App 清單，並將您重定向到 GHES 實例以一鍵創建應用。如果您的環境阻止重定向流，可以使用 替代手動設置。
打開 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 和 contribution metrics，使用與 github.com 相同的配置。
GitHub App 權限
清單使用 Claude 在網頁會話、Code Review、Claude Security 和 contribution metrics 中需要的權限和 webhook 事件配置 GitHub App：
| 權限 | 訪問 | 用途 |
|---|---|---|
| Contents | 讀寫 | 克隆存儲庫和推送分支 |
| Pull requests | 讀寫 | 創建 PR 和發佈審查評論 |
| Issues | 讀寫 | 響應問題提及 |
| Checks | 讀寫 | 發佈 Code Review 檢查運行 |
| Actions | 讀 | 讀取 CI 狀態以進行自動修復 |
| Repository hooks | 讀寫 | 接收 contribution metrics 的 webhooks |
| Metadata | 讀 | GitHub 對所有應用都需要 |
應用訂閱 pull_request、issue_comment、pull_request_review_comment、pull_request_review 和 check_run 事件。
手動設置
如果引導式重定向流被您的網絡配置阻止，請點擊 Add manually 而不是 Connect。在您的 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
然後開始網頁會話。Claude 從您的 git 遠程檢測 GHES 主機，並通過您組織的配置實例路由會話：
claude --remote "Add retry logic to the payment webhook handler"
會話在 Anthropic 基礎設施上運行，從 GHES 克隆您的存儲庫，並將更改推送回分支。使用 /tasks 或在 claude.ai/code 監控進度。有關完整的遠程會話工作流（包括 diff 審查、自動修復和例程），請參閱 Claude Code on the web。
Teleport 會話到您的終端
使用 claude --teleport 將網頁會話拉入您的本地終端。Teleport 在獲取分支和加載會話歷史之前驗證您在同一 GHES 存儲庫的簽出中。有關詳細信息，請參閱 teleport 要求。
GHES 上的插件市場
在您的 GHES 實例上託管插件市場，以在您的組織中分發內部工具。市場結構與 github.com 託管的市場相同；唯一的區別是您如何引用它們。
添加 GHES 市場
owner/repo 簡寫始終解析為 github.com。對於 GHES 託管的市場，使用完整的 git URL：
/plugin marketplace add git@github.example.com:platform/claude-plugins.git
HTTPS URL 也可以工作：
/plugin marketplace add https://github.example.com/platform/claude-plugins.git
有關構建市場的完整指南，請參閱 Create and distribute a plugin marketplace。
在託管設置中將 GHES 市場列入白名單
如果您的組織使用 託管設置 來限制開發人員可以添加的市場，請使用 hostPattern 源類型來允許來自您的 GHES 實例的所有市場，而無需列舉每個存儲庫：
{
"strictKnownMarketplaces": [
{
"source": "hostPattern",
"hostPattern": "^github\\.example\\.com$"
}
]
}
您也可以為開發人員預先註冊市場，以便它們無需手動設置即可顯示。此示例使內部工具市場在整個組織中可用：
{
"extraKnownMarketplaces": {
"internal-tools": {
"source": {
"source": "git",
"url": "git@github.example.com:platform/claude-plugins.git"
}
}
}
}
有關完整的架構，請參閱 strictKnownMarketplaces 和 extraKnownMarketplaces 設置參考。
限制
一些功能在 GHES 上的行為與 github.com 上不同。功能表 總結了支持；本部分涵蓋了解決方案。
/install-github-app命令：改為遵循 claude.ai 上的 管理員設置 流程。如果您還想在 GHES 上使用 GitHub Actions 工作流，請手動調整 示例工作流。- GitHub MCP server：改為使用為您的 GHES 主機配置的
ghCLI。運行gh auth login --hostname github.example.com進行身份驗證，然後 Claude 可以在會話中使用gh命令。
故障排除
網頁會話無法克隆存儲庫
如果 claude --remote 因克隆錯誤而失敗，請驗證您的管理員已完成 GHES 實例的設置，並且 GitHub App 已安裝在您正在使用的存儲庫上。與您的管理員確認在 Claude 設置中註冊的實例主機名與您的 git 遠程中的主機名匹配。
市場添加因策略錯誤而失敗
如果 /plugin marketplace add 因您的 GHES URL 而被阻止，您的組織已限制市場源。要求您的管理員在 託管設置 中為您的 GHES 主機名添加 hostPattern 條目。
GHES 實例無法訪問
如果審查或網頁會話超時，您的 GHES 實例可能無法從 Anthropic 基礎設施訪問。確認您的防火牆允許來自 Anthropic API IP 地址 的入站連接。
相關資源
這些頁面更深入地涵蓋了本指南中引用的功能：
- Claude Code on the web：在雲基礎設施上運行 Claude Code 會話
- Code Review：自動化 PR 審查
- Plugin marketplaces：構建和分發插件目錄
- Analytics：跟踪使用情況和貢獻指標
- Managed settings：組織範圍的策略配置
- Network configuration：防火牆和 IP 白名單要求