Claude Code 设置

使用全局和项目级设置以及环境变量配置 Claude Code。

配置作用域

Claude Code 使用作用域系统来确定配置应用的位置以及与谁共享。

可用作用域

作用域	位置	影响范围	与团队共享？
Managed	服务器管理的设置、plist / 注册表	机器上的所有用户	是（由 IT 部署）
User	~/.claude/ 目录	您，跨所有项目	否
Project	存储库中的 .claude/	此存储库上的所有协作者	是（提交到 git）
Local	.claude/*.local.* 文件	您，仅在此存储库中	否（gitignored）

作用域优先级

当在多个作用域中配置相同的设置时，更具体的作用域优先：

1. Managed（最高）- 无法被任何内容覆盖
2. 命令行参数 - 临时会话覆盖
3. Local - 覆盖项目和用户设置
4. Project - 覆盖用户设置
5. User（最低）- 当没有其他内容指定设置时应用

设置文件位置

类型	文件位置
用户设置	~/.claude/settings.json
项目设置	.claude/settings.json
本地项目设置	.claude/settings.local.json
全局状态	~/.claude.json
项目 MCP 服务器	.mcp.json
托管 MCP 服务器	managed-mcp.json

环境变量

Claude Code 支持通过环境变量配置行为：

变量	描述
CLAUDE_CODE_EFFORT_LEVEL	控制思考深度：low、medium、high
MAX_THINKING_TOKENS	限制思考令牌预算
CLAUDE_CODE_DISABLE_AUTO_MEMORY	设置为 1 禁用自动记忆
ENABLE_TOOL_SEARCH	控制 MCP tool search：auto、true、false
MAX_MCP_OUTPUT_TOKENS	MCP 工具输出令牌限制（默认 25000）
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS	设置为 1 禁用后台任务

权限设置

权限模式

模式	描述
default	标准行为：在首次使用每个工具时提示权限
acceptEdits	自动接受会话的文件编辑权限
plan	Plan Mode：Claude 可以分析但不能修改文件
dontAsk	自动拒绝工具，除非预先批准
bypassPermissions	跳过所有权限提示

权限规则语法

权限规则遵循格式 Tool 或 Tool(specifier)：

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git commit *)",
      "Read(/src/**/*.ts)"
    ],
    "deny": [
      "Bash(git push *)"
    ]
  }
}

通配符模式

Bash 规则支持带有 * 的 glob 模式：

• Bash(npm run build) - 匹配确切的命令
• Bash(npm run test *) - 匹配以 npm run test 开头的命令
• Bash(* install) - 匹配任何以 install 结尾的命令

Read 和 Edit 规则

Read 和 Edit 规则支持四种路径类型：

模式	含义	示例
//path	从文件系统根目录的绝对路径	Read(//Users/alice/secrets/**)
~/path	从主目录的路径	Read(~/.zshrc)
/path	相对于项目根目录的路径	Edit(/src/**/*.ts)
path 或 ./path	相对于当前目录的路径	Read(*.env)

可用设置

模型配置

{
  "model": {
    "default": "sonnet",
    "opus": {
      "effort": "medium"
    }
  }
}

权限配置

{
  "permissions": {
    "defaultMode": "default",
    "allow": ["Bash(npm run *)"],
    "deny": ["Bash(rm -rf *)"]
  }
}

工具配置

{
  "tools": {
    "enable": ["Read", "Edit", "Bash"],
    "disable": ["Write"]
  }
}

环境变量配置

{
  "env": {
    "CLAUDE_CODE_EFFORT_LEVEL": "high",
    "MAX_THINKING_TOKENS": "10000"
  }
}

配置命令

使用 /config 命令打开交互式设置界面：

/config

这会显示一个选项卡式设置界面，您可以在其中查看状态信息并修改配置选项。

重置配置

要将 Claude Code 重置为默认设置：

# 重置所有用户设置和状态
rm ~/.claude.json
rm -rf ~/.claude/

# 重置项目特定设置
rm -rf .claude/
rm .mcp.json

托管设置

对于组织部署，管理员可以部署托管设置：

托管设置位置

• macOS：/Library/Application Support/ClaudeCode/
• Linux/WSL：/etc/claude-code/
• Windows：C:\Program Files\ClaudeCode\

仅托管设置

某些设置仅在托管设置中有效：

设置	描述
disableBypassPermissionsMode	防止 bypassPermissions 模式
allowManagedPermissionRulesOnly	仅允许托管权限规则
allowManagedHooksOnly	仅允许托管 hooks
allowManagedMcpServersOnly	仅允许托管 MCP servers
blockedMarketplaces	被阻止的插件市场
allow_remote_sessions	允许或阻止远程会话

---

本文档来自 Claude Code 官方文档