gateway 类型的推理网关即可。
模型范围
在 Claude Cowork 3P 中使用 AIOHub API 时,模型范围不限于 Anthropic / Claude 模型。只要你的 API 令牌分组可见,并且 AIOHub 当前支持通过 Claude Messages 兼容网关调用,你也可以选择 OpenAI、开源模型等其他模型。 如果你使用包含auto 分组的 API 令牌,Cowork 3P 的模型选择界面可以展示并选择多种可用模型。实际可选列表仍以当前 API 令牌可见模型为准;建议先在控制台或通过 /v1/models 确认模型名称。
前置条件
- 已安装支持 Cowork 3P 的 Claude Desktop
- 已 创建 AIOHub API 令牌
- API 令牌的分组包含 Claude / Anthropic-compatible 模型
- 账户有充足余额
最小配置
配置 AIOHub 时,只需要填写两个字段:| 字段 | 值 |
|---|---|
| Gateway base URL | https://api.aiohub.org |
| Gateway API key | sk-你的API令牌 |
inferenceGatewayBaseUrl 填网关根地址,不要加 /v1。Cowork 3P 会向网关请求 POST /v1/messages;如果你填成 https://api.aiohub.org/v1,客户端可能请求到错误路径。Gateway auth scheme 和 Model list 可以保持默认值,不需要手动填写。使用包含 auto 分组的 API 令牌时,模型选择界面会按当前令牌可见模型展示可选项。
配置模型联网访问
如果你希望 Claude Cowork 3P 中的模型使用联网能力,再配置 Allowed egress hosts。它对应的配置键是coworkEgressAllowedHosts,控制 Cowork 沙箱内的网页抓取、Shell 命令和包安装可以访问哪些主机。
常见配置方式:
| 目标 | coworkEgressAllowedHosts |
|---|---|
| 允许访问全部网址 | ["*"] |
| 只允许访问指定域名 | ["docs.aiohub.org", "api.github.com"] |
| 允许访问某个域名及其子域名 | ["*.example.com"] |
coworkEgressAllowedHosts 控制的是 Cowork 沙箱内工具访问外部网站的范围,不是 AIOHub 模型推理网关的 Base URL。你配置的推理端点会被隐式允许访问。使用应用内配置向导
填写 AIOHub 信息
只填写这两个字段:
| 字段 | 值 |
|---|---|
| Gateway base URL | https://api.aiohub.org |
| Gateway API key | sk-你的API令牌 |
Gateway auth scheme 和 Model list 保持默认值即可。如果你的 API 令牌使用 auto 分组,模型选择界面会展示当前令牌可见的多种模型。如果你希望模型可以联网访问外部网站,再配置 Allowed egress hosts。要访问任意网址,填 *;如果只希望访问特定网站,逐项填写主机名,例如 docs.aiohub.org 或 *.example.com。本地用户配置示例
如果你不通过 MDM 下发配置,可以在本地用户配置中加入enterpriseConfig。适合个人测试,不适合团队分发真实 API 令牌。
- macOS
- Windows
配置文件位置:最小示例:如果需要模型联网访问全部网址,额外加入:
验证网关
先用 HTTP 请求确认 AIOHub API 令牌和模型可用:常见问题
启动后仍然进入普通 Claude 登录
启动后仍然进入普通 Claude 登录
检查
inferenceProvider 是否设置为 gateway,以及 inferenceGatewayBaseUrl 和 inferenceGatewayApiKey 是否同时存在。Cowork 3P 只有在推理服务商和必填凭证有效时才会进入第三方模式。请求路径错误或连接失败
请求路径错误或连接失败
确认 Gateway base URL 是
https://api.aiohub.org,不要包含 /v1。Cowork 3P 会自行请求 /v1/messages。模型列表为空
模型列表为空
AIOHub 支持
/v1/models,但可见模型仍取决于 API 令牌的分组。通常保持 Model list 默认即可;只有在客户端没有正确展示模型时,再显式设置 inferenceModels,例如 claude-sonnet-4-20250514。鉴权失败
鉴权失败
通常保持 Gateway auth scheme 默认即可。如果你的客户端版本没有自动识别
sk- API 令牌,可显式设置为 auto,或改为 x-api-key 后重试。没有 Chat 标签页
没有 Chat 标签页
这是 Cowork 3P 的预期限制之一。第三方推理模式主要提供 Cowork 和 Code 标签页,不等同于普通 Claude Chat。
模型无法访问网页
模型无法访问网页
检查 Allowed egress hosts 是否包含目标网站主机名。要允许访问全部网址,可以设置为
*;在 JSON 配置中写作 "coworkEgressAllowedHosts": ["*"]。