Xcode ↗ 支持使用 OpenAI Chat Completions API 的互联网托管聊天提供商。将聊天提供商指向受 Cloudflare Access 保护的 AI Gateway 自定义域。Xcode 使用存储为 API 密钥的 Access 服务令牌进行身份验证。
此集成使用静态凭据。Xcode 无法使用 cloudflared 生成短期 Access 令牌。
开始之前,你需要:
- 带 自定义域 的 AI Gateway。
- 已在自定义域上启用 Cloudflare Access。
- 由 Service Auth 策略允许的 Access 服务令牌。
- Access 应用已配置为使用
Authorization标头验证服务令牌。 - 每个模型的 Unified Billing 积分或已存储的提供商密钥。
- 已安装并更新到最新版本的 Xcode。
-
在 Xcode 中,转到 Xcode > Settings > Intelligence。
-
在 Chat 下,选择 Add a Chat Provider > Internet Hosted。
-
输入提供商名称,例如
AI Gateway。 -
对于 URL,输入你的 AI Gateway 自定义域并追加
/compat。将
ai.example.com替换为你的自定义域。https://ai.example.com/compatXcode 会追加
/v1/models以列出可用模型,并将提示发送到/v1/chat/completions。AI Gateway 在compat端点下接受这两条路径。 -
对于 API Key,输入以下单标头服务令牌值。将
<CLIENT_ID>和<CLIENT_SECRET>替换为你的 Access 服务令牌值。{"cf-access-client-id":"<CLIENT_ID>","cf-access-client-secret":"<CLIENT_SECRET>"} -
将 API Key Header 设为
Authorization。 -
选择 Add。
-
启用一个模型,然后在编码助手中选择它并发送提示。请求现在会通过 AI Gateway 路由。
有关自定义聊天提供商的更多信息,请参阅 Setting up coding intelligence ↗。
要确认流量已到达 AI Gateway,请参阅验证是否生效。