Appearance
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" 对话框中填写:
| 字段 | 填写内容 |
|---|---|
| URL | https://openrouter.ai/api |
| API Key Header | Authorization |
| API Key | Bearer YOUR_API_KEY_HERE(替换为你的 OpenRouter API key,格式 sk-or-v1-...) |
| Description | OpenRouter(或你喜欢的名称) |
重要: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 等),确认功能正常后再扩展使用其他模型。