Skip to main content
Cowork 通过网关模式连接第三方端点。该网关必须实现 Anthropic Messages API,我们将其运行在 POST /v1/messages Cowork 不提供设置 start_within 的位置,因此截止时间会附加到密钥上。请先创建一个密钥(参见代理密钥)。 在托管密钥上,不带流式传输的持续时间会在三到十分钟的窗口内与 Claude 的更便宜层级竞争。交互式会话会进行流式传输,因此请在此处选择一个层级,而不是 Flex race。参见Claude 持续时间需要更长的窗口 在开始之前,您的组织必须能够运行 Anthropic。对于您自己的密钥,这意味着在提供商密钥选项卡上有一个 Anthropic provider key,因为我们不转售推理服务。对于托管密钥,这意味着 Anthropic 已启用并获得资金支持。 Cowork 将这些设置隐藏在菜单后面,因此本页没有代理设置提示。使用下面的导出功能将相同的配置推送到整个设备群。

启用开发者模式

开发者菜单在您启用它之前是隐藏的。
  1. 打开 Claude Desktop。
  2. 前往帮助,然后是故障排除
  3. 按下启用开发者模式
然后,开发者会出现在菜单栏中。

配置 Cowork

  1. 前往开发者,然后是配置第三方推理…
  2. 推理提供商设置为网关
  3. 网关基础 URL 设置为路由器地址,不带 /v1 后缀。
  4. 将您的代理密钥粘贴到网关 API 密钥中。
  5. 凭据类型保留为静态 API 密钥
  6. 网关认证方案保留为 Bearer。我们拒绝 x-api-key
  7. 在模型选择器中选择一个 claude-* 模型。
Cowork 读取我们的 GET /v1/models 响应来填充选择器。它只列出它识别为 Claude 的模型,这正是您在此处想要的。

跨设备群部署

在同一窗口中点击导出,以获取 macOS 上的 .mobileconfig 文件或 Windows 上的 .reg 文件,然后使用您的 MDM 进行推送。 三个密钥用于集成。 仅当选择器中缺少您预期的模型时,才将 inferenceModels 设置为明确的列表。

关闭 Beta 功能

Cowork 默认关闭 Claude Code 的实验性 Beta 功能,因为严格的网关会拒绝它们添加的 anthropic-beta 标头和请求字段。我们就是其中之一,并且我们不转发这些标头。 出于同样的原因,请将 toolSearchEnabled 保持未设置状态。启用它会发送我们不转发的 Beta 标头,然后请求将失败。

确认密钥已应用

每个响应都带有 x-flexinference-defaults-applied。Cowork 不显示响应标头,因此请改为在仪表板的日志下查看请求。

故障排除

没有开发者菜单。 开发者模式已关闭,它会完全隐藏菜单。请在帮助故障排除下,然后启用开发者模式来打开它。 401 missing_api_key 网关认证方案设置为 x-api-key,我们不读取此值。请将其切换为 Bearer 模型选择器为空。 Cowork 会将 GET /v1/models 过滤为它识别为 Claude 的 ID。请确认您的组织可以运行 claude-* 模型,或者自行设置 inferenceModels 启用工具搜索后,每个请求都返回 400 toolSearchEnabled 会使 Cowork 发送实验性的 anthropic-beta 标头和字段,我们不转发这些内容。请将其保持未设置状态。 400 unsupported_parameter 命名 output_config 选择器选择了非 Claude 模型,Cowork 发送了我们拒绝错误翻译的 Anthropic 原生字段。请选择一个 claude-* 模型。 有关我们返回的所有拒绝信息,请参见错误;有关非 Cowork 特定的错误,请参见代理密钥;有关终端客户端,请参见Claude Code