Amp 自定义连接接入：Model Routing、路径拼接与实际路由

登录 Amp 与连接模型是两回事

Amp CLI 的 amp login 管理客户端账户，AMP_API_KEY 可以覆盖已保存账户。 这项凭证不是任意模型网关的 Key。上游模型连接要在 Model Routing 管理，而不是把模型服务地址塞进客户端账户设置。

官方文档把连接分为单厂商 API Key、订阅和路由网关。Custom URL 所属的网关功能目前仍处于实验性早期开放，文档列出了适用账户范围。 先检查自己账户的 Add 菜单是否显示这类连接；没有入口时不要猜测隐藏配置字段。

在 Custom URL 里明确格式

个人设置中的 Model Routing 管理个人连接，工作区连接则由管理员管理。官方 Custom URL 支持四种格式，并按格式追加请求路径。 下面只是表单填写清单，不是配置文件或可执行命令：

示例连接名称：80321-example
API 格式：responses
Base URL：https://80321.cn/v1
API Key：YOUR_API_KEY
目标模型示意：YOUR_MODEL_ID

这段地址仅为占位示例，本站不存在已由本文验证的真实接口。Responses 会追加 /responses，Chat Completions 会追加 /chat/completions；Messages 和 Google 原生接口有各自规则，应以表单展示的最终 URL 为准。 不要把完整操作路径重复填进 Base URL。

模型映射决定有没有走到连接

连接保存成功不代表所有请求都经过它。Amp 依次检查个人连接、工作区连接，未被连接覆盖的模型仍由 Amp 提供。 用量或回答速度不能作为路由证明。

映射是匹配 Agent 已选的模型，不是任意增加一个 Agent 模型。尤其是 Google 原生格式，官方说明映射可以改变运行位置，但不会改变 Agent 选择。 第一次只匹配一个已确认模型，避免通配规则把其他模型也导向尚未验证的端点。

Check Access 与短对话分开看

官方提供 Check Access，CLI 的 amp config model-providers test 也用于连接检查。 广泛映射时检查可能读取模型列表；精确单模型映射会发起短推理，Google 原生格式也使用短请求。因此检查并非完全离线，只有确认真实服务与授权后才操作。

通过访问检查后，再开一条不附带代码的对话，要求只回答 OK、不调用工具，并检查实际匹配的连接。若没有命中，先查映射、连接启用状态和优先顺序，而不是反复更换 Key。

排错和安全范围

认证问题应核对所选格式的请求头；HTTP 返回成功但内容是错误，不能算访问通过，官方说明检查会识别这种情况。 地址问题则看表单显示的最终请求 URL，并确认端点在实际执行环境中可达。

不要误把本地能访问的地址当成所有 Amp 运行方式都能访问。CLI 可以在本机、orb 或 runner 中运行，第一次选定一种环境再验收。 不扩大工作区共享连接，不展示上游 Key。本页核对了官方规则，没有创建连接、调用接口或验证示例服务。