Claude Code 与 GitHub Enterprise Server

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

GitHub Enterprise Server (GHES) 支持让您的组织使用 Claude Code 处理托管在自管理 GitHub 实例上的存储库，而不是 github.com。一旦管理员连接您的 GHES 实例，开发人员可以运行网络会话、获得自动化代码审查，并从内部市场安装插件，无需任何按存储库的配置。

对于 github.com 上的存储库，请参阅 网络上的 Claude Code 和 代码审查。要在您自己的 CI 基础设施中运行 Claude，请参阅 GitHub Actions。

GitHub Enterprise Server 支持的功能

下表显示了哪些 Claude Code 功能支持 GHES 以及与 github.com 行为的任何差异。

管理员设置

管理员将您的 GHES 实例连接到 Claude Code 一次。之后，您组织中的开发人员可以使用 GHES 存储库，无需任何额外配置。您需要对 Claude 组织具有管理员访问权限，以及在 GHES 实例上创建 GitHub App 的权限。

引导式设置生成 GitHub App 清单，并将您重定向到 GHES 实例以一键创建应用。如果您的环境阻止重定向流，可以使用 替代手动设置。

GitHub App 权限

清单使用 Claude 在网络会话、代码审查、Claude Security 和贡献指标中需要的权限和 webhook 事件配置 GitHub App：

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

手动设置

如果引导式重定向流被您的网络配置阻止，请点击 手动添加 而不是连接。在您的 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 监控进度。有关完整的远程会话工作流（包括差异审查、自动修复和例程），请参阅 网络上的 Claude Code。

将会话 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

有关构建市场的完整指南，请参阅 创建和分发插件市场。

在托管设置中将 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 主机配置的 gh CLI。运行 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：在云基础设施上运行 Claude Code 会话
• 代码审查：自动化 PR 审查
• 插件市场：构建和分发插件目录
• 分析：跟踪使用情况和贡献指标
• 托管设置：组织范围的策略配置
• 网络配置：防火墙和 IP 白名单要求