配置参考手册

用户1208

5月29日修改

settings.json 配置和环境变量的完整参考手册。涵盖截至 Claude Code v2.1.81 的所有已确认设置。​

图例：

•
无标记 = 已在官方文档中确认​

•
📋 仅限 Schema = 存在于 JSON Schema 中但未出现在官方设置页面——仍然有效​

•
⚠️ 未验证 = 未经官方来源确认​

作用域与优先级

Claude Code 使用四个设置作用域，按从高到低的优先级应用：

数组合并： 像 permissions.allow、sandbox.filesystem.allowWrite 和 allowedHttpHookUrls 这样的设置会在各作用域间拼接并去重——不会替换。​

拒绝优先级： permissions.deny 规则始终生效，无论任何作用域下的允许/询问规则如何。​

托管设置交付方式：

•
服务器托管（Claude.ai 管理员控制台）​

•
macOS MDM：com.anthropic.claudecode plist​

•
Windows 注册表：HKLM\SOFTWARE\Policies\ClaudeCode​

•
文件：位于 /Library/Application Support/ClaudeCode/（macOS）、/etc/claude-code/（Linux/WSL）、C:\Program Files\ClaudeCode\（Windows）的 managed-settings.json​

•
下拉目录：与 managed-settings.json 并排的 managed-settings.d/*.json，按字母顺序合并​

其他配置： ~/.claude.json 存储 OAuth 会话、MCP 服务器配置、每个项目的信任状态以及 editorMode 等偏好设置。不要将 ~/.claude.json 中的键放入 settings.json——这会触发 Schema 验证错误。​

设置键

核心配置

$schema

类型： string作用域： all默认值：无

用于 IDE 验证和自动补全的 JSON Schema URL。添加 "https://json.schemastore.org/claude-code-settings.json" 以在 VS Code、Cursor 和其他编辑器中启用内联验证。

代码块

{​
  "$schema": "https://json.schemastore.org/claude-code-settings.json"​
}​
​

model

类型： string作用域： all默认值： "default"

覆盖所有会话的默认模型。接受别名（"sonnet"、"opus"、"haiku"、"opusplan"）或完整模型 ID，如 "claude-sonnet-4-6"。ANTHROPIC_MODEL 环境变量优先级更高。​

代码块

{ "model": "opus" }

agent

类型： string作用域： all默认值：无

以命名子智能体的方式运行主线程。应用该智能体的系统提示、工具限制和模型。值必须匹配 .claude/agents/ 中定义的智能体。也可通过 --agent CLI 标志使用。​

代码块

{ "agent": "code-reviewer" }

language

类型： string作用域： all默认值： "english"

Claude 偏好的响应语言。也设置语音听写语言。例如："japanese"、"spanish"、"french"。​

cleanupPeriodDays

配置参考手册​