安装和配置 Claude Cowork 与第三方平台的集成

密钥

类型

描述

inferenceProvider

字符串

选择推理后端。设置此密钥可激活第三方平台模式。值：bedrock、vertex、foundry、gateway。

inferenceGatewayBaseUrl

字符串

网关基础 URL。当提供商 = gateway 时为必需。

inferenceGatewayApiKey

字符串

网关的 API 密钥。当提供商 = gateway 时为必需。

inferenceGatewayAuthScheme

字符串

网关凭证的发送方式（auto / x-api-key / bearer）。

inferenceGatewayHeaders

字符串（JSON 数组，包含 "Name: Value" 字符串）

可选的额外 HTTP 标头，在每个推理请求中发送到您的网关。

inferenceVertexProjectId

字符串

GCP 项目 ID。当提供商 = vertex 时为必需。

inferenceVertexRegion

字符串

GCP 区域。当提供商 = vertex 时为必需。

inferenceVertexCredentialsFile

字符串

服务账户 JSON 或 ADC 文件的绝对路径。不支持波浪号或环境变量扩展。当提供商 = vertex 时为必需。

inferenceVertexBaseUrl

字符串

覆盖 Vertex AI 端点（例如，私有服务连接）。保持未设置以使用公共区域端点。

inferenceVertexOAuthClientId

字符串

用于交互式按用户 Google 登录的 OAuth 客户端 ID，作为共享服务账户文件的替代方案。

inferenceVertexOAuthClientSecret

字符串

与上述客户端 ID 配对的 OAuth 客户端密钥。

inferenceVertexOAuthScopes

字符串（JSON 数组，包含作用域字符串）

要请求的 OAuth 作用域的 JSON 字符串数组。默认为 Vertex 预测所需的作用域。

inferenceBedrockRegion

字符串

AWS 区域。当提供商 = bedrock 时为必需。

inferenceBedrockBearerToken

字符串

AWS 持有者令牌。当提供商 = bedrock 时为必需。

inferenceBedrockBaseUrl

字符串

覆盖 Bedrock 端点（例如 VPC 接口端点或 LLM 网关）。留空以使用公共区域端点。

inferenceBedrockProfile

字符串

来自 ~/.aws/config 的 AWS 命名配置文件。在凭证由 AWS CLI、SSO 或企业凭证流程管理时使用。

inferenceBedrockAwsDir

字符串

包含 AWS 配置/凭证文件的目录的绝对路径（如果不是默认的 ~/.aws）。复制到沙箱中以便命名配置文件在那里解析。

inferenceFoundryResource

字符串

Azure AI Foundry 资源名称。当 provider = foundry 时必需。

inferenceFoundryApiKey

字符串

Azure AI Foundry API 密钥。当 provider = foundry 时必需。

inferenceModels

字符串

模型 ID 或别名的 JSON 数组（sonnet、opus、haiku）。第一个条目是选择器默认值。Vertex、Bedrock 和 Foundry 必需。

inferenceCredentialHelper

字符串

可执行文件的绝对路径，其标准输出是推理凭证。在会话开始时在主机上运行。

inferenceCredentialHelperTtlSec

整数

缓存辅助程序输出的时长（以秒为单位）。默认值：3600。

键

类型

描述

deploymentOrganizationUuid

字符串

标识此部署的稳定 UUID。限定本地存储和遥测范围。

autoUpdaterEnforcementHours

整数

设置后，无论用户活动如何，都会在指定小时数后强制安装待处理更新。未设置时，应用使用 72 小时窗口，但在用户活跃时延迟。

disableAutoUpdates

布尔值

阻止应用检查和下载更新。应用保持在已安装版本，直到通过其他方式更新。

键

类型

描述

disableEssentialTelemetry

布尔值

阻止发送给 Anthropic 的崩溃和错误报告以及性能计时数据。

disableNonessentialTelemetry

布尔值

阻止产品使用分析 — 功能使用、导航模式、UI 操作。

disableNonessentialServices

布尔值

阻止连接器图标（会泄露 MCP 主机名）和工件预览沙箱。连接器回退到字母图标；工件不呈现。

otlpEndpoint

字符串

OTLP 收集器的基础 URL。设置后，会话将导出日志和指标（提示、工具调用、令牌计数）。端点主机会自动添加到沙箱网络允许列表。

otlpProtocol

字符串

http/protobuf（默认）、http/json 或 grpc。

otlpHeaders

字符串

在每个 OTLP 请求上发送的逗号分隔的 key=value 对（标准 OTEL_EXPORTER_OTLP_HEADERS 格式）。

键

类型

描述

isDesktopExtensionEnabled

布尔值

允许用户安装本地桌面扩展（.dxt 或 .mcpb）。

isDesktopExtensionDirectoryEnabled

布尔值

在连接器 UI 中显示 Anthropic 扩展目录。

isDesktopExtensionSignatureRequired

布尔值

拒绝未由受信任发布者签名的桌面扩展。

isLocalDevMcpEnabled

布尔值

允许用户添加自己的本地 MCP 服务器。设置为 false 时，仅托管列表中的服务器可用。

isClaudeCodeForDesktopEnabled

布尔值

显示代码选项卡（基于终端的编码会话）。会话在主机上运行，不在虚拟机内运行。

managedMcpServers

字符串

远程 MCP 服务器配置的 JSON 数组。每个条目需要 name 和 url。可选：transport（http 或 sse）、headers、oauth、toolPolicy。

disabledBuiltinTools

字符串

要从代理工具列表中移除的工具名称的 JSON 数组。请参阅 MCP 文章了解完整工具列表。

coworkEgressAllowedHosts

字符串（主机名的 JSON 数组）

用户可以附加为工作区文件夹的绝对路径。前导 ~ 扩展为用户的主目录。设置后，此列表外的任何路径都会被拒绝。

键

类型

描述

allowedWorkspaceFolders

字符串

用户可以附加为工作区文件夹的绝对路径的 JSON 数组。前导 ~ 扩展为每用户主目录。未设置 = 无限制。

inferenceMaxTokensPerWindow

整数

在拒绝 sendMessage 之前，每个滚动窗口允许的总输入+输出令牌数。在桌面主进程中强制执行。未设置 = 无限制。

inferenceTokenWindowHours

整数

令牌限制的滚动窗口长度。最多 720 小时（30 天）。当 now >= windowStartMs + windowHours×3600×1000 时，计数器重置。