远程、认证、更新与企业设置

作用域缩写：任何文件 = 用户/项目/本地/托管任一处；全局配置 = 键写在 ~/.claude.json 里。取值与默认值以官方为准。

远程、桌面与通知

键	作用域	说明
remoteControlAtStartup	任何文件	会话启动时自动连接 Remote Control（不设则应用自动连接的默认值）
disableRemoteControl	任何文件	在所有能启动它的地方关闭 Remote Control（默认 false）
remote.defaultEnvironmentId	任何文件	选择 claude --cloud 的默认云环境（env_… 或 ccpool_… 形式的 ID；自托管的 ccpool_ ID 只从用户和托管设置及 --settings 读取）
sshConfigs	用户或托管	向桌面环境下拉菜单添加 SSH 连接（每项必填 id、name、sshHost，可选 sshPort、sshIdentityFile）
sshHostAllowlist	仅托管	限制桌面 SSH 会话能到达哪些主机（主机名模式数组）
disableDesktopLocalSessions	仅托管	关闭在设备上运行的桌面 Code 会话，保留到其他主机的 SSH 和云会话（只有 JSON 布尔值 true 生效）
disableDeepLinkRegistration	任何文件	设为 "disable" 阻止 Claude Code 注册 claude-cli:// 处理器
agentPushNotifEnabled	任何文件	让 Claude 在它自己决定时向你手机发推送通知（默认 false）
inputNeededNotifEnabled	任何文件	Claude 在等你时收到推送通知（默认 false）
preferredNotifChannel	任何文件	选择任务完成时用终端响铃还是桌面通知（auto、terminal_bell、iterm2、iterm2_with_bell、kitty、ghostty、notifications_disabled 等，默认 "auto"）
awaySummaryEnabled	任何文件	关闭你回到终端时显示的会话回顾（不设则开启）
enableArtifact	任何文件	在任何文件里设为 false 关闭 Artifact 工具，且没有文件能再把它打开
disableArtifact	任何文件	已弃用，改用 enableArtifact

认证与服务商

键	作用域	说明
apiKeyHelper	任何文件	用你自己的命令生成 API 凭证（shell 命令行）
awsAuthRefresh	任何文件	用你自己的命令刷新 .aws 里过期的 Bedrock 凭证
awsCredentialExport	任何文件	让你自己的命令以 JSON 提供 Bedrock 凭证；不设则用环境里的 AWS 凭证链
gcpAuthRefresh	任何文件	用你自己的命令刷新 Google Cloud 凭证
otelHeadersHelper	任何文件	用你自己的命令生成轮换的 OpenTelemetry 请求头（可执行路径或 shell 命令行）
allowedProviders	仅托管	限制一台机器可用的 API 服务商（anthropic、bedrock、vertex、foundry、anthropicAws、mantle 等；不设则任何服务商都可用）
forceLoginMethod	任何文件	把登录限制为 claude.ai、Claude Console 或云网关（claudeai、console、gateway）
forceLoginOrgUUID	任何文件	把 claude.ai 登录固定到你的组织（一个 UUID 或 UUID 数组；只有托管来源会强制执行）
forceLoginGatewayUrl	仅托管	设置登录界面连接的网关 URL（含协议的完整 URL）
gatewayInternalNetworks	仅托管	让 /login 能连接你组织内部使用的公网 IPv4 地址空间里的云网关（最多四个 /8 到 /32 的 CIDR 块，互不重叠；不设则 /login 只接受私有地址上的网关）

更新与版本

键	作用域	说明
autoUpdatesChannel	任何文件	跟随 stable 稳定发布通道而不是 latest（不设则跟随 latest）
minimumVersion	任何文件	阻止自动更新安装低于某版本的任何东西（如 "2.1.100"；无效版本号被忽略）
requiredMinimumVersion	仅托管	在比你组织要求更旧的版本上拒绝启动
requiredMaximumVersion	仅托管	在比你组织允许更新的版本上拒绝启动

隐私与清理

键	作用域	说明
cleanupPeriodDays	任何文件	选择 Claude Code 保留转录多少天后删除（整数，最小 1，默认 30）
desktopSessionCleanupPeriodDays	用户或托管	为 Claude Desktop 和 Cowork 转录设置天数上限（整数，最小 0，默认 0 即无年龄限制）
feedbackDrafts	用户或托管	控制 Claude 是否排队等你评审反馈草稿（notify 默认、quiet、off）
feedbackSurveyRate	任何文件	改变会话质量调查出现的频率（0 到 1 之间的数；不设则用 Anthropic 远程设定或内置的频率）
skipWebFetchPreflight	任何文件	在无法连到 Anthropic 时跳过 WebFetch 的主机名检查（不设则会话里对每个主机名第一次抓取前先检查）

企业与托管设置

键	作用域	说明
managedSourcesBehavior	仅托管	组合你部署的所有托管来源，而不是只用最高优先级的那个（first-wins 默认，或 merge）
parentSettingsBehavior	仅托管	部署托管设置时，应用或丢弃 SDK 或 IDE 宿主传入的限制（first-wins 默认，或 merge）
forceRemoteSettingsRefresh	仅托管	启动时阻塞，直到服务端托管设置被重新拉取（默认 false）
policyHelper	仅托管	在启动时运行一个可执行文件来计算托管设置：含 path（绝对路径、规范形式）、timeoutMs（毫秒，最小 1000，默认 10000）、refreshIntervalMs（0 关闭刷新，否则至少 60000；不设则只在启动时运行一次）
disableSideloadFlags	仅托管	拒绝用来旁加载插件、子智能体和 MCP 服务器的 CLI 标志（默认 false）
wslInheritsWindowsSettings	仅托管	让 WSL 从 Windows 策略链读取托管设置（默认 false，即 WSL 只读 /etc/claude-code）

托管设置的部署方式见托管设置。

全局配置（~/.claude.json）

这些键不在 settings.json 里，而在 ~/.claude.json：

键	说明
autoConnectIde	在外部终端里自动连接正在运行的 VS Code 或 JetBrains IDE（默认 false）
autoInstallIdeExtension	关闭在 VS Code 终端里自动安装 IDE 扩展（默认 true）
claudeInChromeDefaultEnabled	每个交互 CLI 会话都开启 Chrome 集成而不必传 --chrome（不设则关闭，Claude Code 仍可提示设置）
copyFullResponse	让 /copy 直接复制完整回复而不显示代码块选择器（默认 false）
copyOnSelect	关闭全屏渲染和智能体视图里「选中文字即自动复制」（默认 true）
defaultToAgentsView	运行不带参数的 claude 时打开智能体视图而不是新对话（默认 false）
diffTool	选择 Claude 提议的文件改动在 VS Code 或 JetBrains 的 diff 查看器里打开（auto），还是留在终端里（terminal）
externalEditorContext	按 Ctrl+G 编辑时把 Claude 的上一条回复作为注释显示（默认 false）
leftArrowOpensAgents	关闭 ← 快捷键（把会话转后台并打开智能体视图，默认 true）
prStatusFooterEnabled	关闭提示页脚的 PR 评审状态徽章及其背后的 PR 检查（默认 true）
permissionExplainerEnabled、teammateDefaultModel	已分别在 v2.1.257 和 v2.1.234 移除