Source: https://aiprimetech.io/zh/learn/use-claude-api-with-github-copilot/ [首页](/zh/) / [学习](/zh/learn/) / 通过网关在 GitHub Copilot Chat 中使用 Claude：自定义端点设置、智能体模式与问题修复 # 通过网关在 GitHub Copilot Chat 中使用 Claude：自定义端点配置、智能体模式与问题修复 VS Code 的聊天功能可以使用你自行提供的模型。内置的 Anthropic 提供商只接受 API 密钥，没有用于指定其他地址的字段，因此需要通过自定义端点提供商添加网关。选择 Messages API 类型，并在以下文件中列出模型： chatLanguageModels.json。自 1.122 版本起，此功能已纳入 VS Code 稳定版。 ## 自备密钥支持哪些功能 | 功能 | 使用自备模型时 | 聊天、提问和规划 | 是 | 智能体模式、内置工具和 MCP 服务器 | 支持，前提是模型已标记为 toolCalling: true | 内联建议（代码补全）和下一步编辑建议 | 不支持：这些功能仍由 GitHub Copilot 提供 | 语义搜索及其他基于嵌入的功能 | 不支持：这些功能仍需要 GitHub 账户 从 VS Code 1.122 开始，无需登录 GitHub，也无需订阅 Copilot 套餐，即可使用这些模型。在 Copilot Business 和 Enterprise 中，BYOK 默认开启，管理员可以通过 **自备语言模型密钥** 策略将其关闭。 ## 将网关添加为自定义端点 - 打开聊天视图，打开模型选择器并选择 **管理语言模型**，或从命令面板运行 **聊天：管理语言模型**。 - 选择 **添加模型**，然后选择 **自定义端点** 提供商。 - 输入显示名称和网关 API 密钥。 - 选择 API 类型 **Messages**。随后，VS Code 会打开 chatLanguageModels.json 以配置模型列表。 ## 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 } ] } ] ``` | 字段 | 原因 | id | 发送给网关的模型 ID | url | 完整端点。对于以以下内容结尾的 URL，VS Code 会 /messages 原样使用；请提供完整路径，避免猜测 | toolCalling: true | 智能体模式必需。未启用此功能的模型不会出现在智能体的模型列表中 | maxInputTokens + maxOutputTokens | 两者之和不得超过模型的上下文窗口 | apiKey: ${input:...} | VS Code 会询问一次密钥并将其存储，因此密钥不会写入文件 使用 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. ## 故障排查 | 你会看到什么 | 原因 | 解决方法 | 模型未出现在选择器中 | 需要重新加载，或者 toolCalling 为 false，或者工作区处于受限模式 | 重启 VS Code，设置 toolCalling: true，并信任工作区 | 提供商列表中没有 Custom Endpoint | VS Code 版本低于 1.122，或者你的组织禁用了 BYOK | 更新 VS Code；向管理员询问 BYOK 策略 | 401 / API 密钥无效 | 存储的密钥有误，或属于另一个端点 | 点击提供商旁的齿轮图标，然后选择 **更新 API 密钥** | 模型不受支持 | 该 id 与网关模型 ID 不匹配 | 使用下表中的 ID | 上下文或 token 错误 | maxInputTokens 以及 maxOutputTokens 超出窗口大小 | 降低 maxInputTokens | Concurrency limit exceeded | 多个智能体或窗口同时使用同一个密钥运行 | 减少并行运行的数量 要查看详细信息，请运行 **开发人员：设置日志级别**，选择 **跟踪**，然后打开 **输出** 并选择 **GitHub Copilot Chat**。聊天调试视图会显示确切的请求。如果日志行显示 BYOK 提供商因策略不允许而被取消注册，则说明问题出在组织策略上。 | 模型 ID | 适用场景 | claude-sonnet-5 | 编程和智能体任务的默认选择：速度快、能力强、价格适中。 | claude-opus-5-5 | 更复杂的推理、大规模重构、长时间运行的智能体任务。 | claude-fable-5-1 | 能力最强，价格也最高；留给最困难的任务使用。 | claude-haiku-4-5 | 价格低、速度快：标题、摘要、分类和小步骤。 更喜欢终端？同一个密钥也可以运行 [VS Code 中的 Claude Code](/zh/claude-code/vscode/) 通过其专属扩展使用。 ## 常见问题 我可以在 GitHub Copilot 中使用自己的 Claude API 密钥吗？ 可以。在 VS Code 聊天中依次选择“管理语言模型”和“添加模型”。如使用 Anthropic 官方 API，选择 Anthropic 提供商；如使用网关，选择 Custom Endpoint，并将 API 类型设为 Messages。 我可以在 Copilot 中更改 Anthropic 基础 URL 吗？ 内置 Anthropic 提供商不支持，它只接受密钥。请使用 Custom Endpoint 提供商，并将每个模型的 url 设置为网关的 /v1/messages 端点。 BYOK 模型可以在 Copilot 智能体模式中使用吗？ 可以，只要模型标记为 toolCalling: true。内置工具和 MCP 服务器仍可正常使用；行内代码补全仍由 Copilot 提供。 使用自己的模型需要订阅 Copilot 吗？ 从 VS Code 1.122 起不再需要：BYOK 模型无需登录 GitHub 或订阅 Copilot 套餐即可使用。Business 和 Enterprise 组织可以通过策略禁用此功能。 几分钟内开始使用 Claude 获取 API 密钥，无需 Anthropic 账户，也无需加入候补名单。[获取你的 API 密钥](/register) AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。 ## 更多 Claude API 指南 [如何获取 Claude API 密钥](/zh/learn/how-to-get-a-claude-api-key/)[Claude API 定价详解](/zh/learn/claude-api-pricing-explained/)[使用 Claude API 最便宜的方式](/zh/learn/cheapest-way-to-use-claude-api/)[通过 Claude API 不限量使用 Cursor](/learn/use-claude-api-with-cursor/)[不限量访问 Claude Code](/zh/learn/use-claude-api-with-claude-code/)[Claude API 网关与 Anthropic 直连对比](/zh/learn/claude-api-vs-anthropic-direct/)[通过 OpenAI SDK 使用 Claude：OpenAI 兼容端点、流式传输、工具与限制](/zh/learn/openai-compatible-claude-api/)[Claude 模型详解：Claude Opus、Sonnet、Haiku 与 Fable 的模型对比——全部 Claude API 模型、Anthropic 模型名称与价格（2026）](/zh/learn/claude-api-models-compared/)[使用加密货币支付 Claude API 费用](/zh/learn/claude-api-with-crypto-payment/)[无需候补名单即可访问 Claude API](/zh/learn/claude-api-without-waitlist/)[如何减少 Claude 词元用量](/zh/learn/how-to-reduce-claude-token-usage/)[通过 Claude API 不限量使用 Cline](/zh/learn/use-claude-api-with-cline/)[通过 Claude API 不限量使用 Roo Code](/zh/learn/use-claude-api-with-roo-code/)[在 JetBrains IDE 中不限量使用 Claude](/zh/learn/use-claude-api-with-jetbrains/)[通过网关在 Aider 中使用 Claude：ANTHROPIC_API_BASE、配置文件、架构师模式与问题修复](/zh/learn/use-claude-api-with-aider/)[在 VS Code 中不限量使用 Claude](/zh/learn/use-claude-api-with-vscode/)[OpenCode 的 Claude 配置：opencode.json 设置、模型与常见错误](/zh/learn/use-claude-api-with-opencode/)[通过网关在 Hermes Agent 中使用 Claude：自定义提供商配置、成本控制与问题修复](/zh/learn/run-hermes-agent-with-claude-api/)[使用 Claude 不限量运行 OpenClaw](/zh/learn/run-openclaw-with-claude-api/)[兼容 Anthropic 的 API 意味着什么](/zh/learn/anthropic-compatible-api/)[Claude Code API 密钥 — ANTHROPIC_API_KEY：如何获取、配置，以及何时应改用 claude setup-token](/zh/learn/claude-code-api-key-setup/)[Claude Code API 成本 — 定价与降低成本的方法](/zh/learn/claude-code-api-costs/)[Claude API 错误详解：服务器错误 500、过载 529、速率限制 429、错误请求 400 — 以及各自的修复方法](/zh/learn/claude-api-errors-troubleshooting/)[如何购买 Claude API 额度，以及为什么购买 Claude 额度比任何“购买 Claude 账户”的方案都更好](/zh/learn/buy-claude-api-credits/)[Claude 免费 API：有免费的 Claude API 密钥吗？2026 年究竟有哪些内容免费？](/zh/learn/claude-api-free-trial/)[Claude API 与 Claude Pro/Max 订阅——如何选择](/zh/learn/claude-api-vs-subscription/)[通过自定义提供商使用 Codex CLI：config.toml、GPT 与 Claude 模型、IDE 扩展与问题修复](/zh/learn/use-claude-api-with-codex/)[将 Claude 连接到 n8n](/zh/learn/use-claude-api-with-n8n/)[通过 LiteLLM 路由到 Claude](/zh/learn/use-claude-api-with-litellm/)[在 Kilo Code 中使用 Claude](/zh/learn/use-claude-api-with-kilo-code/)[通过网关将 Zed 连接到 Claude](/zh/learn/use-claude-api-with-zed/)[将 Cherry Studio 连接到 Claude](/zh/learn/use-claude-api-with-cherry-studio/)[LangChain 中的 ChatAnthropic：导入、base_url、流式传输、工具和错误](/zh/learn/use-claude-api-with-langchain/)[Anthropic Python SDK：安装、设置 base_url、流式传输和错误处理](/zh/learn/anthropic-python-sdk/)[通过 Vercel AI SDK 使用 Claude：createAnthropic baseURL、流式传输和问题修复](/zh/learn/use-claude-api-with-vercel-ai-sdk/)[使用 Claude 运行 Factory Droid](/zh/learn/use-claude-api-with-factory-droid/)[Claude Code API 详解](/zh/learn/claude-code-api/)[将 Claude API 集成到您的应用中](/zh/learn/claude-api-integration/)[如何不受限制地使用 Claude，以及为什么不存在“Claude Code 破解版本”](/zh/learn/get-unlimited-claude-usage/)