Skip to content

Xcode 26 Beta 新增 Apple Intelligence 编程助手功能,支持自定义第三方模型 Provider。通过 macOS Tahoe 26.0 Beta 的 Settings > Intelligence > Add a Model Provider,配置 URL 为 https://openrouter.ai/api(不加 /v1)、API Key Header 为 Authorization、API Key 填入 Bearer sk-or-v1-xxx,即可在 Xcode 中使用 OpenRouter 上的所有模型(Anthropic Claude、Google Gemini、Meta Llama 等)用于代码补全、解释、重构和文档生成。

Xcode 26 的 Apple Intelligence 功能支持接入自定义模型 Provider。通过配置 OpenRouter,可以在 Xcode 开发环境中访问 300+ AI 模型,远超默认的 ChatGPT 集成。

前置要求:Apple Intelligence 目前仍在 Beta 阶段,需要:

  • macOS Tahoe 26.0 Beta 或更新版本
  • Xcode 26 beta 4 或更新版本

配置步骤

第一步:进入 Intelligence 设置

在 macOS 系统偏好设置中,导航到 Settings > Intelligence > Add a Model Provider

第二步:配置 OpenRouter Provider

在 "Add a Model Provider" 对话框中填写:

字段填写内容
URLhttps://openrouter.ai/api
API Key HeaderAuthorization
API KeyBearer YOUR_API_KEY_HERE(替换为你的 OpenRouter API key,格式 sk-or-v1-...
DescriptionOpenRouter(或你喜欢的名称)

重要:URL 末尾不要加 /v1,这与常规 API 调用的 URL 格式不同。

点击 Add 保存配置。

第三步:浏览可用模型

配置完成后,点击 OpenRouter 查看所有可用模型。由于 OpenRouter 提供数百个模型,建议将常用模型加入书签(Bookmark),收藏的模型会显示在列表顶部,便于快速访问。

可用的模型涵盖:

  • Anthropic:Claude Opus、Sonnet 等系列
  • Google:Gemini 各系列
  • Meta:Llama 各系列
  • OpenAI:GPT 各系列
  • 以及数百个其他 Provider 的模型

第四步:开始在 Xcode 中使用

返回 Xcode 顶部的聊天界面,选择你收藏的模型,即可开始在 Xcode 内与 AI 对话。

支持的功能

配置完成后,可以在 Xcode 中使用 Apple Intelligence 的以下功能:

功能说明
代码补全智能代码建议
代码解释询问代码的作用和逻辑
重构辅助获取改进代码结构的建议
文档生成生成注释和文档字符串

常见问题

Q: 为什么 URL 不加 /v1

A: Xcode Apple Intelligence 通过特殊的 API 端点与 OpenRouter 通信,这个端点路径与标准 OpenAI 兼容 API 不同。Apple 和 OpenRouter 对接时使用的是 https://openrouter.ai/api,不是 https://openrouter.ai/api/v1,添加 /v1 会导致连接失败。

Q: 我需要将 API Key 格式填为 Bearer xxx 而不是直接填 key?

A: 是的。Xcode 的 Model Provider 配置将 API Key Header(Authorization)和 API Key 值分开填写,所以 API Key 字段需要包含完整的 HTTP Header 值,即 Bearer sk-or-v1-xxx

Q: 目前 Beta 版本有哪些限制?

A: Apple Intelligence 在 Xcode 中仍处于 Beta 阶段,部分模型可能不完全兼容 Apple Intelligence 的接口格式。建议优先测试主流模型(Claude Sonnet、GPT-4o、Gemini Flash 等),确认功能正常后再扩展使用其他模型。