> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code 與 GitHub Enterprise Server

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

<Note>
  GitHub Enterprise Server 支持適用於 Team 和 Enterprise 計劃。
</Note>

GitHub Enterprise Server (GHES) 支持讓您的組織使用 Claude Code 與託管在自管理 GitHub 實例上的存儲庫，而不是 github.com。一旦 Owner 連接您的 GHES 實例，開發人員可以運行網頁會話、獲得自動化代碼審查，並從內部市場安裝插件，無需任何按存儲庫的配置。

對於 github.com 上的存儲庫，請參閱 [Claude Code on the web](/zh-TW/claude-code-on-the-web) 和 [Code Review](/zh-TW/code-review)。要在您自己的 CI 基礎設施中運行 Claude，請參閱 [GitHub Actions](/zh-TW/github-actions)。

<h2 id="what-works-with-github-enterprise-server">
  GitHub Enterprise Server 支持的功能
</h2>

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

| 功能                     | GHES 支持 | 備註                                                                                       |
| :--------------------- | :------ | :--------------------------------------------------------------------------------------- |
| Claude Code on the web | ✅ 支持    | 管理員連接 GHES 實例一次；開發人員像往常一樣使用 `claude --remote` 或 [claude.ai/code](https://claude.ai/code) |
| Code Review            | ✅ 支持    | 與 github.com 相同的自動化 PR 審查                                                                |
| Claude Security        | ✅ 支持    | 在 Enterprise 計劃的公開測試版中提供，位於 [claude.ai/security](https://claude.ai/security)             |
| Teleport sessions      | ✅ 支持    | 使用 `--teleport` 在網頁和終端之間移動會話                                                             |
| Plugin marketplaces    | ✅ 支持    | 使用完整的 git URL 而不是 `owner/repo` 簡寫                                                        |
| Contribution metrics   | ✅ 支持    | 通過 webhooks 傳遞到 [analytics dashboard](/zh-TW/analytics)                                  |
| GitHub Actions         | ✅ 支持    | 需要手動工作流設置；`/install-github-app` 僅適用於 github.com                                          |
| GitHub MCP server      | ❌ 不支持   | GitHub MCP server 不適用於 GHES 實例                                                           |

<h2 id="admin-setup">
  管理員設置
</h2>

一位擁有者將您的 GHES 實例連接到 Claude Code 一次。之後，您組織中的開發人員可以使用 GHES 存儲庫，無需任何額外配置。您需要在 Claude 組織中具有擁有者或主要擁有者角色，以及在 GHES 實例上創建 GitHub Apps 的權限。

引導式設置生成 GitHub App 清單，並將您重定向到 GHES 實例以一鍵創建應用。如果您的環境阻止重定向流，可以使用 [替代手動設置](#manual-setup)。

<Steps>
  <Step title="打開 Claude Code 管理員設置">
    轉到 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 並找到 GitHub Enterprise Server 部分。
  </Step>

  <Step title="開始引導式設置">
    點擊 **Connect**。輸入連接的顯示名稱和您的 GHES 主機名，例如 `github.example.com`。如果您的 GHES 實例使用自簽名或私有證書頒發機構，請將 CA 證書粘貼到可選字段中。
  </Step>

  <Step title="創建 GitHub App">
    點擊 **Continue to GitHub Enterprise**。您的瀏覽器重定向到您的 GHES 實例，並預填充應用清單。檢查配置並點擊 **Create GitHub App**。GHES 將您重定向回 Claude，應用憑據自動存儲。
  </Step>

  <Step title="在您的存儲庫上安裝應用">
    從 GHES 實例上的 GitHub App 頁面，在您希望 Claude 訪問的存儲庫或組織上安裝應用。您可以從一個子集開始，稍後添加更多。
  </Step>

  <Step title="啟用功能">
    返回 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 並為您的 GHES 存儲庫啟用 [Code Review](/zh-TW/code-review#set-up-code-review)、Claude Security 和 [contribution metrics](/zh-TW/analytics#enable-contribution-metrics)，使用與 github.com 相同的配置。
  </Step>
</Steps>

<h3 id="github-app-permissions">
  GitHub App 權限
</h3>

清單使用 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` 事件。

<h3 id="manual-setup">
  手動設置
</h3>

如果引導式重定向流被您的網絡配置阻止，請點擊 **Add manually** 而不是 Connect。在您的 GHES 實例上使用 [上述權限和事件](#github-app-permissions) 創建 GitHub App，然後在表單中輸入應用憑據：主機名、OAuth 客戶端 ID 和密鑰、GitHub App ID、客戶端 ID、客戶端密鑰、webhook 密鑰和私鑰。

<h3 id="network-requirements">
  網絡要求
</h3>

您的 GHES 實例必須可從 Anthropic 基礎設施訪問，以便 Claude 可以克隆存儲庫並發佈審查評論。如果您的 GHES 實例在防火牆後面，請將 [Anthropic API IP 地址](https://platform.claude.com/docs/en/api/ip-addresses) 列入白名單。

<h2 id="developer-workflow">
  開發人員工作流
</h2>

一旦您的管理員連接了 GHES 實例，就不需要開發人員端的配置。Claude Code 從您工作目錄中的 git 遠程自動檢測您的 GHES 主機名。

像往常一樣從您的 GHES 實例克隆存儲庫：

```bash theme={null}
git clone git@github.example.com:platform/api-service.git
cd api-service
```

然後開始網頁會話。Claude 從您的 git 遠程檢測 GHES 主機，並通過您組織的配置實例路由會話：

```bash theme={null}
claude --remote "Add retry logic to the payment webhook handler"
```

會話在 Anthropic 基礎設施上運行，從 GHES 克隆您的存儲庫，並將更改推送回分支。使用 `/tasks` 或在 [claude.ai/code](https://claude.ai/code) 監控進度。有關完整的遠程會話工作流（包括 diff 審查、自動修復和例程），請參閱 [Claude Code on the web](/zh-TW/claude-code-on-the-web)。

<h3 id="teleport-sessions-to-your-terminal">
  Teleport 會話到您的終端
</h3>

使用 `claude --teleport` 將網頁會話拉入您的本地終端。Teleport 在獲取分支和加載會話歷史之前驗證您在同一 GHES 存儲庫的簽出中。有關詳細信息，請參閱 [teleport 要求](/zh-TW/claude-code-on-the-web#teleport-requirements)。

<h2 id="plugin-marketplaces-on-ghes">
  GHES 上的插件市場
</h2>

在您的 GHES 實例上託管插件市場，以在您的組織中分發內部工具。市場結構與 github.com 託管的市場相同；唯一的區別是您如何引用它們。

<h3 id="add-a-ghes-marketplace">
  添加 GHES 市場
</h3>

`owner/repo` 簡寫始終解析為 github.com。對於 GHES 託管的市場，使用完整的 git URL：

```bash theme={null}
/plugin marketplace add git@github.example.com:platform/claude-plugins.git
```

HTTPS URL 也可以工作：

```bash theme={null}
/plugin marketplace add https://github.example.com/platform/claude-plugins.git
```

有關構建市場的完整指南，請參閱 [Create and distribute a plugin marketplace](/zh-TW/plugin-marketplaces)。

<h3 id="allowlist-ghes-marketplaces-in-managed-settings">
  在託管設定中將 GHES 市場列入白名單
</h3>

如果您的組織使用 [託管設定](/zh-TW/settings) 來限制開發人員可以添加的市場，請使用 `hostPattern` 源類型來允許來自您的 GHES 實例的所有市場，而無需列舉每個存儲庫：

```json theme={null}
{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}
```

您也可以為開發人員預先註冊市場，以便它們無需手動設定即可顯示。此示例使內部工具市場在整個組織中可用：

```json theme={null}
{
  "extraKnownMarketplaces": {
    "internal-tools": {
      "source": {
        "source": "git",
        "url": "git@github.example.com:platform/claude-plugins.git"
      }
    }
  }
}
```

有關完整的架構，請參閱 [strictKnownMarketplaces](/zh-TW/settings#strictknownmarketplaces) 和 [extraKnownMarketplaces](/zh-TW/settings#extraknownmarketplaces) 設定參考。

<h2 id="limitations">
  限制
</h2>

一些功能在 GHES 上的行為與 github.com 上不同。[功能表](#what-works-with-github-enterprise-server) 總結了支持；本部分涵蓋了解決方案。

* **`/install-github-app` 命令**：改為遵循 claude.ai 上的 [管理員設置](#admin-setup) 流程。如果您還想在 GHES 上使用 GitHub Actions 工作流，請手動調整 [示例工作流](https://github.com/anthropics/claude-code-action/blob/main/examples/claude.yml)。
* **GitHub MCP server**：改為使用為您的 GHES 主機配置的 `gh` CLI。運行 `gh auth login --hostname github.example.com` 進行身份驗證，然後 Claude 可以在會話中使用 `gh` 命令。

<h2 id="troubleshooting">
  故障排除
</h2>

<h3 id="web-session-fails-to-clone-repository">
  網頁會話無法克隆存儲庫
</h3>

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

<h3 id="marketplace-add-fails-with-a-policy-error">
  市場添加因策略錯誤而失敗
</h3>

如果 `/plugin marketplace add` 因您的 GHES URL 而被阻止，您的組織已限制市場源。要求您的管理員在 [託管設置](#allowlist-ghes-marketplaces-in-managed-settings) 中為您的 GHES 主機名添加 `hostPattern` 條目。

<h3 id="ghes-instance-not-reachable">
  GHES 實例無法訪問
</h3>

如果審查或網頁會話超時，您的 GHES 實例可能無法從 Anthropic 基礎設施訪問。確認您的防火牆允許來自 [Anthropic API IP 地址](https://platform.claude.com/docs/zh-TW/api/ip-addresses) 的入站連接。

<h2 id="related-resources">
  相關資源
</h2>

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

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