Claude Code 与 GitHub Enterprise Server¶

将 Claude Code 连接到自托管的 GitHub Enterprise Server 实例，用于 web 会话、代码审查和插件市场。

GitHub Enterprise Server 支持面向 Team 和 Enterprise 计划。

GitHub Enterprise Server（GHES）支持让你的组织使用 Claude Code 处理托管在自管理 GitHub 实例上的仓库，而非 github.com。 Owner 连接 GHES 实例后，开发者无需任何仓库级配置即可运行 web 会话和获得自动代码审查。GHES 上托管的插件市场也受支持；凭据要求因界面而异，详见 GHES 上的插件市场。

github.com 上的仓库请参见 Claude Code on the web 和 Code Review。要在自己的 CI 基础设施中运行 Claude，参见 GitHub Actions。

支持的功能¶

管理员设置¶

Owner 一次性将 GHES 实例连接到 Claude Code。 之后组织中的开发者无需额外配置即可使用 GHES 仓库。你需要 Claude 组织中的 Owner 或 Primary Owner 角色，以及在 GHES 实例上创建 GitHub App 的权限。

引导设置生成 GitHub App manifest 并重定向你到 GHES 实例一键创建应用。如果环境阻止重定向流程，可使用手动设置。

步骤 1：打开 Claude Code 管理设置

前往 claude.ai/admin-settings/claude-code 找到 GitHub Enterprise Server 部分。

步骤 2：开始引导设置

点击 Connect。输入连接的显示名称和 GHES 主机名，例如 github.example.com。如果 GHES 实例使用自签名或私有 CA 证书，在可选字段粘贴 CA 证书。

步骤 3：创建 GitHub App

点击 Continue to GitHub Enterprise。浏览器重定向到你的 GHES 实例并预填应用 manifest。审查配置并点击 Create GitHub App。GHES 将你重定向回 Claude，应用凭据自动存储。

步骤 4：在仓库上安装应用

从 GHES 实例上的 GitHub App 页面，在你要让 Claude 访问的仓库或组织上安装应用。可以先安装部分后续再添加。

步骤 5：启用功能

返回 claude.ai/admin-settings/claude-code，使用与 github.com 相同的配置为 GHES 仓库启用 Code Review、Claude Security 和贡献指标。

GitHub App 权限¶

manifest 为 GitHub App 配置 Claude 跨 web 会话、Code Review、Claude Security 和贡献指标所需的权限和 webhook 事件：

应用订阅 pull_request、issue_comment、pull_request_review_comment、pull_request_review 和 check_run 事件。

手动设置¶

如果引导重定向流程被网络配置阻止，点击 Add manually 而非 Connect。在 GHES 实例上使用上述权限和事件创建 GitHub App，然后在表单中输入凭据：主机名、OAuth client ID 和 secret、GitHub App ID、client ID、client secret、webhook secret 和私钥。

网络要求¶

你的 GHES 实例必须从 Anthropic 基础设施可达，以便 Claude 克隆仓库和发布审查评论。如果 GHES 实例在防火墙后，将 Anthropic API IP 地址加入白名单。

开发者工作流¶

Owner 连接 GHES 实例后，开发者无需任何配置。 Claude Code 从工作目录的 git remote 自动检测 GHES 主机名。

照常从 GHES 实例克隆仓库：

git clone [email protected]:platform/api-service.git
cd api-service

然后启动 web 会话。Claude 从 git remote 检测 GHES 主机并通过组织配置的实例路由会话：

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

会话在 Anthropic 基础设施上运行，从 GHES 克隆仓库并将变更推送回分支。用 /tasks 或在 claude.ai/code 监控进度。参见 Claude Code on the web 了解完整的云会话工作流包括 diff 审查、auto-fix 和 routines。

Teleport 会话到终端¶

用 claude --teleport 将 web 会话拉入本地终端。Teleport 在获取分支和加载会话历史前验证你在同一 GHES 仓库的检出中。参见 teleport 要求。

GHES 上的插件市场¶

在 GHES 实例上托管插件市场以在组织内分发内部工具。 市场结构与 github.com 托管的完全相同，但安装方式因你在哪里添加市场而异，凭据也因界面不同：

添加 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 [email protected]:platform/claude-plugins.git

Claude Code 非交互式运行 git，拒绝连接不在机器 known_hosts 文件中的 SSH 主机。使用 HTTPS URL 配合 git credential helper 可避免 known_hosts 要求。

参见 Create and distribute a plugin marketplace 了解构建市场的完整指南。

通过托管设置预注册 GHES 市场¶

extraKnownMarketplaces 设置预注册市场，让开发者无需手动设置即可获得。它可在任何设置文件中使用；托管设置可组织范围交付：

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

在托管设置中白名单 GHES 市场¶

如果组织使用托管设置限制开发者可添加的市场，使用 hostPattern 源类型允许 GHES 实例上的所有市场，无需枚举每个仓库：

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

限制¶

部分功能在 GHES 上的行为与 github.com 不同：

• /install-github-app 命令：改为在 claude.ai 上按照管理员设置流程操作。如果还需要 GHES 上的 GitHub Actions workflow，手动适配示例 workflow。
• GitHub MCP server：改为使用配置了 GHES 主机的 gh CLI。运行 gh auth login --hostname github.example.com 认证，然后 Claude 可在会话中使用 gh 命令。

故障排除¶

Web 会话无法克隆仓库¶

如果 claude --cloud 因克隆错误失败，验证 Owner 已为你的 GHES 实例完成设置，且 GitHub App 已安装在你正在使用的仓库上。请连接实例的 Owner 确认 Claude 设置中注册的主机名与你 git remote 中的主机名匹配。

市场添加因策略错误失败¶

如果 /plugin marketplace add 因你的 GHES URL 被阻止，你的组织限制了市场来源。请管理员在托管设置中为 GHES 主机名添加 hostPattern 条目。

claude.ai 上市场添加因 GitHub 访问错误失败¶

如果从用户设置添加 GHES 市场失败且显示通用错误如 "Marketplace couldn't be added"，先检查 GitHub Enterprise 连接。这是你自己的 GitHub Enterprise 账户未连接到 Claude 时出现的错误，即使组织的 GHES 实例已配置且其他用户已连接。

要连接 GitHub Enterprise 账户：claude.ai/code 的仓库选择器为每个已配置的 GHES 实例提供连接选项。或者请 Owner 在组织插件设置中添加市场，这移除了每用户连接要求。

GHES 实例不可达¶

如果审查或 web 会话超时，你的 GHES 实例可能从 Anthropic 基础设施不可达。确认防火墙允许来自 Anthropic API IP 地址的入站连接。

相关资源¶

• Claude Code on the web：在云基础设施上运行 Claude Code 会话
• Code Review：自动 PR 审查
• Plugin marketplaces：构建和分发插件目录
• Analytics：跟踪使用和贡献指标
• Managed settings：组织级策略配置
• Network configuration：防火墙和 IP 白名单要求