Claude Code 设置

​

设置文件

• 用户设置在 ~/.claude/settings.json 中定义，适用于所有项目。
• 项目设置保存在您的项目目录中：
  • .claude/settings.json 用于检入源代码控制并与您的团队共享的设置
  • .claude/settings.local.json 用于未检入的设置，适用于个人偏好和实验。Claude Code 在创建 .claude/settings.local.json 时会将其配置为被 git 忽略。
• 对于 Claude Code 的企业部署，我们还支持企业管理策略设置。这些设置优先于用户和项目设置。系统管理员可以将策略部署到：
  • macOS: /Library/Application Support/ClaudeCode/managed-settings.json
  • Linux 和 WSL: /etc/claude-code/managed-settings.json
  • Windows: C:\ProgramData\ClaudeCode\managed-settings.json
• 企业部署还可以配置托管 MCP 服务器，这些服务器会覆盖用户配置的服务器。请参阅企业 MCP 配置：
  • macOS: /Library/Application Support/ClaudeCode/managed-mcp.json
  • Linux 和 WSL: /etc/claude-code/managed-mcp.json
  • Windows: C:\ProgramData\ClaudeCode\managed-mcp.json

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

​

可用设置

​

权限设置

​

沙箱设置

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker"],
    "network": {
      "allowUnixSockets": [
        "/var/run/docker.sock"
      ],
      "allowLocalBinding": true
    }
  },
  "permissions": {
    "deny": [
      "Read(.envrc)",
      "Read(~/.aws/**)"
    ]
  }
}

• 读取拒绝规则阻止沙箱中的文件读取
• 编辑允许规则允许文件写入（除了默认值，例如当前工作目录）
• 编辑拒绝规则阻止在允许的路径内写入

• WebFetch 允许规则允许网络域
• WebFetch 拒绝规则阻止网络域

​

设置优先级

1. 企业管理策略 (managed-settings.json)
   • 由 IT/DevOps 部署
   • 无法被覆盖
2. 命令行参数
   • 特定会话的临时覆盖
3. 本地项目设置 (.claude/settings.local.json)
   • 个人项目特定设置
4. 共享项目设置 (.claude/settings.json)
   • 源代码控制中的团队共享项目设置
5. 用户设置 (~/.claude/settings.json)
   • 个人全局设置

​

关于配置系统的要点

• 内存文件 (CLAUDE.md)：包含 Claude 在启动时加载的说明和上下文
• 设置文件 (JSON)：配置权限、环境变量和工具行为
• 斜杠命令：可在会话期间使用 /command-name 调用的自定义命令
• MCP 服务器：使用其他工具和集成扩展 Claude Code
• 优先级：更高级别的配置（企业）覆盖更低级别的配置（用户/项目）
• 继承：设置被合并，更具体的设置添加到或覆盖更广泛的设置

​

系统提示可用性

​

排除敏感文件

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Read(./build)"
    ]
  }
}

​

子代理配置

• 用户子代理：~/.claude/agents/ - 在所有项目中可用
• 项目子代理：.claude/agents/ - 特定于您的项目，可与您的团队共享

​

插件配置

​

插件设置

{
  "enabledPlugins": {
    "formatter@company-tools": true,
    "deployer@company-tools": true,
    "analyzer@security-plugins": false
  },
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": "github",
      "repo": "company/claude-plugins"
    }
  }
}

​

enabledPlugins

• 用户设置 (~/.claude/settings.json)：个人插件偏好
• 项目设置 (.claude/settings.json)：与团队共享的项目特定插件
• 本地设置 (.claude/settings.local.json)：每台机器的覆盖（未提交）

{
  "enabledPlugins": {
    "code-formatter@team-tools": true,
    "deployment-tools@team-tools": true,
    "experimental-features@personal": false
  }
}

​

extraKnownMarketplaces

1. 当团队成员信任该文件夹时，系统会提示他们安装市场
2. 然后提示团队成员从该市场安装插件
3. 用户可以跳过不需要的市场或插件（存储在用户设置中）
4. 安装遵守信任边界并需要明确同意

{
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": {
        "source": "github",
        "repo": "company-org/claude-plugins"
      }
    },
    "security-plugins": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/security/plugins.git"
      }
    }
  }
}

• github：GitHub 存储库（使用 repo）
• git：任何 git URL（使用 url）
• directory：本地文件系统路径（使用 path，仅用于开发）

​

管理插件

• 浏览市场中的可用插件
• 安装/卸载插件
• 启用/禁用插件
• 查看插件详细信息（提供的命令、代理、hooks）
• 添加/删除市场

​

环境变量

​

Claude 可用的工具

​

使用 hooks 扩展工具

​

另请参阅

• 身份和访问管理 - 了解 Claude Code 的权限系统
• IAM 和访问控制 - 企业策略管理
• 故障排除 - 常见配置问题的解决方案