在 Xcode 26 / 27 的 Intelligence 设置里把 Router One 加为聊天 provider

确认 Xcode 版本，并为这台 Mac 单独建 Key

编程智能功能内置在 Xcode 26 和 Xcode 27 里。Apple 按版本给出 macOS 要求：Xcode 26 到 26.3 要求 macOS Sequoia 15.6 或更新版本，Xcode 26.4 到 26.6 要求 macOS Tahoe 26.2 或更新版本，Xcode 27 要求 macOS Tahoe 26.6 或更新版本；Xcode 27 的发布说明还写明它只能在 Apple silicon 的 Mac 上安装和运行。26.3 的发布说明修复了自定义模型 provider 在 Xcode 重启后消失的问题，能升级就用 26.3 或更新版本。然后为这台 Mac 单独创建一把设了 maxSpend 的 Router One Key，它只填进 Add a Chat Provider 对话框。SDK 和多数客户端用的带 /v1 的 base URL 不要拿来填 Xcode：这个对话框要的是主机根地址，下文说明。受管理的 Mac 上，如果 MDM 配置把 CodingAssistantAllowExternalIntegrations 设为 false，编程助手会整个关闭，也就加不了任何 provider。

把 Xcode 配置到 Router One base URL

选择 Xcode > Settings，在侧栏选 Intelligence，点 Chat 下方的 Add a Chat Provider。对话框里选 Internet Hosted；Locally Hosted 是给运行在你 Mac 上的模型服务用的，填的是端口和可选的描述，不是 URL。URL 填不带 /v1 的主机根地址 https://api.router.one：Apple 文档把 provider 必须提供的两个端点写成 {Model provider URL}/v1/models 和 {Model provider URL}/v1/chat/completions，也就是说 Xcode 会在你填的地址后面自己拼上 /v1/models 和 /v1/chat/completions，OpenAI 兼容 SDK 用的带 /v1 的 base URL 会让这一段重复出现。Key 那一行填为这台 Mac 创建的 Router One Key：Apple 文档对对话框其余内容只写了「the URL and other details」，WWDC25 的 What's new in Xcode 26 讲到接入其他 provider 时说的是「enter your API key」；网关按 Authorization: Bearer 校验这把 Key。点 Add。Xcode 通过 GET /v1/models 拉取模型列表，Router One 的这个端点需要 Key；选择器里显示的就是它返回的目录 ID，例如 anthropic/claude-sonnet-5 或 openai/gpt-5.5，你可以选择显示哪些模型并标记常用。使用时点 Coding Assistant 按钮或按 Command-0，点 New Conversation，在 Chat 下选这个 ID；消息输入框的占位文字会显示当前模型。之后每次提交的提问都会以这个 ID 发到 POST /v1/chat/completions：

URL

https://api.router.one

# Xcode → Settings → Intelligence → Chat → Add a Chat Provider
# Select Internet Hosted (Locally Hosted asks for a port on your Mac instead)
URL:      https://api.router.one
API key:  sk-your-router-one-key
# Xcode itself requests {URL}/v1/models and {URL}/v1/chat/completions
# Coding Assistant (Command-0) → New Conversation → Chat: <exact-model-id-from-/models>

每个值填在哪里，怎么验证

来自 Router One 的值只有两个，其余都是 Xcode 自己的行为；最后两行说明这个地址不负责配置什么：

给一台 Mac 的对话定预算，并逐条核对

在会话里提交的每个提问至少是一个 POST /v1/chat/completions，源代码编辑器里的 coding tools 操作也一样：Explain、Document、Generate a Playground、Generate a Preview 和 Generate Fix for Issue 都发给当前聊天模型。Apple 的发布说明还提到编程助手使用的工具，例如「find text in file」；Xcode 用到这些工具时，模型的每一次往返都是又一个请求，有各自的 request_id 和费用。Chat Completions 不在服务端保存对话状态，Apple 也说明新消息会保留之前问答的上下文，所以每一轮都会重发对话记录，连同 Xcode 收集的项目上下文和你附加的文件；长对话的输入 tokens 一轮比一轮多，日志里某一行比上一行贵时先查这一点。Stop 按钮在 Xcode 侧结束回复：网关在回复完成前看到连接关闭，Trace 会记为 HTTP 499 client_cancelled，只按上游报告的用量计费；已经完成的回复照全额计费，而且 Apple 的 Xcode 26 说明列出了一个已知问题：状态栏的 Cancel 按钮有时不能停止正在执行的消息。给这台 Mac 单独一把设了 maxSpend 的 Key：失控的对话会在上限处收到 HTTP 402 停下，花费不会超过这个上限，你的其他 Key 也照常可用。按时间、模型和 request_id 对账；对话太长时新开一个会话来重置记录，不要一直续。Router One 只记录模型调用；应用改动、修改历史、Git 快照和 Xcode 的工具都在 Xcode 里运行。

Xcode 该填哪个模型 ID？

从 /models 页复制精确的模型 ID，保留大小写、连字符和版本后缀，不要用展示名称代替。打开该模型的详情页，核对支持的 API 端点、上下文窗口和工具调用等能力，再与 Xcode 当前选择的 provider 和功能对应。模型出现在目录里，不等于当前客户端能调用它的所有功能。建议为每个客户端或应用单独建 API Key，并设置 maxSpend 消费上限。

Xcode 用的是哪种 API 协议？

OpenAI 兼容描述的是接口格式，不能据此推断 Chat Completions（/v1/chat/completions）、Responses（/v1/responses）和 Anthropic Messages（/v1/messages）可以互换。先核对工具当前版本、provider 配置和实际请求路径，再查模型详情与 API 兼容性事实页。一次普通对话成功，也不能证明服务端工具、历史状态或文件编辑功能都受支持。

在请求日志里核对 Xcode 的调用

先在 Xcode 发出一次简单文本请求，再到控制台 → 日志按时间、模型和 request_id 找到这条记录，核对 Token、花费、总耗时和状态码。成功后再分别验证流式输出、工具调用和多轮历史。失败时保留实际请求路径、完整错误消息及 request_id；没有对应日志时，要么请求没到达网关（客户端配置或网络问题），要么网关在调用模型之前就拒绝了它——Key 问题的 401、余额不足或 Key 达到 maxSpend 上限的 402、Key 或账户自身限额触发的 429，或模型 ID、端点不对的 400 / 404；在输出任何内容之前就失败的流式请求也可能没有日志。看客户端收到的状态码和错误消息就能区分是哪一种；先确认这一点，再判断是不是网关或上游故障。

常见问题