Claude Code 配置

原文：Claude Code settings

一句话

配置 Claude Code 的行为，包括全局和项目级别的设置以及环境变量。

什么时候翻这页

1. 需要自定义 Claude Code 的行为和外观时
2. 在团队中共享项目设置和权限规则时
3. 需要配置插件、MCP 服务器或环境变量时
4. 需要管理敏感文件访问权限时

核心概念

• 配置范围（scope）：决定设置应用的位置和共享方式，包括 Managed（管理）、User（用户）、Project（项目）和 Local（本地）四种范围
• 设置文件：JSON 格式的配置文件，存储各种设置选项，如权限、环境变量、插件等
• 优先级系统：不同范围设置的优先级顺序，Managed > 命令行参数 > Local > Project > User
• 插件系统：通过市场places安装和管理插件，扩展 Claude Code 功能
• MCP 服务器：Model Context Protocol 服务器，提供额外的工具和集成

怎么做

查看和修改设置

1. 在交互式 REPL 中运行 /config 命令，打开带标签的设置界面
2. 在界面中查看状态信息并修改配置选项

配置范围选择

• Managed：用于组织级安全策略和合规要求，由 IT/DevOps 部署
• User：用于个人偏好设置，如主题、编辑器设置、API 密钥
• Project：用于团队共享设置，如权限、钩子、MCP 服务器
• Local：用于个人项目覆盖，测试配置，或特定于机器的设置

设置文件位置

• 用户设置：~/.claude/settings.json - 应用于所有项目
• 项目设置：.claude/settings.json - 团队共享，提交到版本控制
• 本地项目设置：.claude/settings.local.json - 个人项目设置，被 git 忽略
• 管理设置：系统级文件，无法被其他设置覆盖

插件管理

1. 使用 /plugin 命令浏览、安装、卸载插件
2. 在 settings.json 中配置 enabledPlugins 启用/禁用插件
3. 使用 extraKnownMarketplaces 添加额外的插件市场
4. 使用 strictKnownMarketplaces 限制可用的插件市场

环境变量配置

在 settings.json 的 env 部分配置环境变量：

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

命令 / 配置速查

初学者易错点

1. 设置不生效：不理解配置范围的优先级，导致设置被更高优先级的设置覆盖
2. 数组设置合并错误：数组值（如权限规则）在多个范围中是合并而非替换，不是简单的覆盖关系
3. 混淆设置文件用途：不清楚不同范围设置文件的用途和共享方式
4. 忽略管理设置优先级：管理设置具有最高优先级，无法被其他设置覆盖
5. 敏感文件访问：忘记使用 permissions.deny 配置排除敏感文件

相关词条

• permissions - 权限系统和规则语法
• plugins - 插件系统和市场places
• mcp - MCP 服务器配置
• authentication - 身份验证设置
• env-vars - 环境变量参考
• tools-reference - 可用工具参考