> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexinference.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Cowork

> 通过网关模式将 Claude Cowork 指向 FlexInference。

Cowork 通过网关模式连接第三方端点。该网关必须实现 Anthropic Messages API，我们将其运行在 `POST /v1/messages`。

Cowork 不提供设置 `start_within` 的位置，因此截止时间会附加到密钥上。请先创建一个密钥（参见[代理密钥](/zh/agent-keys)）。

在托管密钥上，不带流式传输的持续时间会在三到十分钟的窗口内与 Claude 的更便宜层级竞争。交互式会话会进行流式传输，因此请在此处选择一个层级，而不是 **Flex race**。参见[Claude 持续时间需要更长的窗口](/zh/deadline-routing)。

在开始之前，您的组织必须能够运行 Anthropic。对于您自己的密钥，这意味着在**提供商密钥**选项卡上有一个 Anthropic provider key，因为我们不转售推理服务。对于[托管密钥](/zh/billing)，这意味着 Anthropic 已启用并获得资金支持。

Cowork 将这些设置隐藏在菜单后面，因此本页没有代理设置提示。使用下面的**导出**功能将相同的配置推送到整个设备群。

## 启用开发者模式

**开发者**菜单在您启用它之前是隐藏的。

1. 打开 Claude Desktop。
2. 前往**帮助**，然后是**故障排除**。
3. 按下**启用开发者模式**。

然后，**开发者**会出现在菜单栏中。

## 配置 Cowork

1. 前往**开发者**，然后是**配置第三方推理...**。

2. 将**推理提供商**设置为**网关**。

3. 将**网关基础 URL** 设置为路由器地址，不带 `/v1` 后缀。

   ```text theme={null}
   https://api.flexinference.com
   ```

4. 将您的代理密钥粘贴到**网关 API 密钥**中。

5. 将**凭据类型**保留为**静态 API 密钥**。

6. 将**网关认证方案**保留为 **Bearer**。我们拒绝 `x-api-key`。

7. 在模型选择器中选择一个 `claude-*` 模型。

Cowork 读取我们的 `GET /v1/models` 响应来填充选择器。它只列出它识别为 Claude 的模型，这正是您在此处想要的。

## 跨设备群部署

在同一窗口中点击**导出**，以获取 macOS 上的 `.mobileconfig` 文件或 Windows 上的 `.reg` 文件，然后使用您的 MDM 进行推送。

三个密钥用于集成。

| 密钥                           | 值                               |
| ---------------------------- | ------------------------------- |
| `inferenceGatewayBaseUrl`    | `https://api.flexinference.com` |
| `inferenceGatewayApiKey`     | 您的代理密钥                          |
| `inferenceGatewayAuthScheme` | `bearer`，默认值                    |

仅当选择器中缺少您预期的模型时，才将 `inferenceModels` 设置为明确的列表。

## 关闭 Beta 功能

Cowork 默认关闭 Claude Code 的实验性 Beta 功能，因为严格的网关会拒绝它们添加的 `anthropic-beta` 标头和请求字段。我们就是其中之一，并且我们不转发这些标头。

出于同样的原因，请将 `toolSearchEnabled` 保持未设置状态。启用它会发送我们不转发的 Beta 标头，然后请求将失败。

## 确认密钥已应用

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

## 故障排除

**没有开发者菜单。** 开发者模式已关闭，它会完全隐藏菜单。请在**帮助**、**故障排除**下，然后**启用开发者模式**来打开它。

**[`401 missing_api_key`](/zh/errors#missing_api_key)。** **网关认证方案**设置为 **x-api-key**，我们不读取此值。请将其切换为 **Bearer**。

**模型选择器为空。** Cowork 会将 `GET /v1/models` 过滤为它识别为 Claude 的 ID。请确认您的组织可以运行 `claude-*` 模型，或者自行设置 `inferenceModels`。

**启用工具搜索后，每个请求都返回 `400`。** `toolSearchEnabled` 会使 Cowork 发送实验性的 `anthropic-beta` 标头和字段，我们不转发这些内容。请将其保持未设置状态。

**[`400 unsupported_parameter`](/zh/errors#unsupported_parameter) 命名 `output_config`。** 选择器选择了非 Claude 模型，Cowork 发送了我们拒绝错误翻译的 Anthropic 原生字段。请选择一个 `claude-*` 模型。

有关我们返回的所有拒绝信息，请参见[错误](/zh/errors)；有关非 Cowork 特定的错误，请参见[代理密钥](/zh/agent-keys)；有关终端客户端，请参见[Claude Code](/zh/claude-code)。