通过网关在 GitHub Copilot Chat 中使用 Claude：自定义端点配置、智能体模式与问题修复

VS Code 的聊天功能可以使用你自行提供的模型。内置的 Anthropic 提供商只接受 API 密钥，没有用于指定其他地址的字段，因此需要通过自定义端点提供商添加网关。选择 Messages API 类型，并在以下文件中列出模型： chatLanguageModels.json。自 1.122 版本起，此功能已纳入 VS Code 稳定版。

自备密钥支持哪些功能

从 VS Code 1.122 开始，无需登录 GitHub，也无需订阅 Copilot 套餐，即可使用这些模型。在 Copilot Business 和 Enterprise 中，BYOK 默认开启，管理员可以通过 **自备语言模型密钥** 策略将其关闭。

将网关添加为自定义端点

1. 打开聊天视图，打开模型选择器并选择 **管理语言模型**，或从命令面板运行 **聊天：管理语言模型**。
2. 选择 **添加模型**，然后选择 **自定义端点** 提供商。
3. 输入显示名称和网关 API 密钥。
4. 选择 API 类型 **Messages**。随后，VS Code 会打开 chatLanguageModels.json 以配置模型列表。

chatLanguageModels.json

[
  {
    "name": "AI Prime Tech",
    "vendor": "customendpoint",
    "apiKey": "${input:aiprimeApiKey}",
    "apiType": "messages",
    "models": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5",
        "url": "https://aiprimetech.io/v1/messages",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 200000,
        "maxOutputTokens": 32000
      },
      {
        "id": "claude-opus-5-5",
        "name": "Claude Opus 5.5",
        "url": "https://aiprimetech.io/v1/messages",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 200000,
        "maxOutputTokens": 32000
      },
      {
        "id": "claude-haiku-4-5",
        "name": "Claude Haiku 4.5",
        "url": "https://aiprimetech.io/v1/messages",
        "toolCalling": true,
        "vision": true,
        "maxInputTokens": 168000,
        "maxOutputTokens": 32000
      }
    ]
  }
]

使用 Messages 类型时，VS Code 会将密钥发送到 x-api-key 请求头中，这正是网关所期望的方式。模型 ID 必须与网关中的 ID 完全一致。

使用同一密钥的 GPT 模型

Custom Endpoint 提供商也支持 OpenAI 格式。要添加使用网关 Codex 分组密钥的 GPT 模型，请添加另一个提供商，并设置 "apiType": "chat-completions" 以及模型 URL 为 https://aiprimetech.io/v1/chat/completions。一个密钥只能访问其所属分组的模型，因此 Claude 和 GPT 通常需要分别配置条目，并使用各自的密钥。

旧版 github.copilot.chat.customOAIModels 设置和 **OpenAI Compatible** 提供商已弃用，改由 Custom Endpoint 取代。请将旧条目迁移到 chatLanguageModels.json.

故障排查

要查看详细信息，请运行 **开发人员：设置日志级别**，选择 **跟踪**，然后打开 **输出** 并选择 **GitHub Copilot Chat**。聊天调试视图会显示确切的请求。如果日志行显示 BYOK 提供商因策略不允许而被取消注册，则说明问题出在组织策略上。

更喜欢终端？同一个密钥也可以运行 VS Code 中的 Claude Code 通过其专属扩展使用。

常见问题

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。