Claude Code 设置

Claude Code 提供多种设置来配置其行为以满足您的需求。您可以通过在使用交互式 REPL 时运行 /config 命令来配置 Claude Code。

​

设置文件

settings.json 文件是我们通过分层设置配置 Claude Code 的官方机制：

• 用户设置在 ~/.claude/settings.json 中定义，适用于所有项目。
• 项目设置保存在您的项目目录中：
  • .claude/settings.json 用于检入源代码控制并与您的团队共享的设置
  • .claude/settings.local.json 用于不检入的设置，对个人偏好和实验很有用。Claude Code 会在创建时配置 git 忽略 .claude/settings.local.json。
• 对于 Claude Code 的企业部署，我们还支持企业管理的策略设置。这些设置优先于用户和项目设置。系统管理员可以在 macOS 上将策略部署到 /Library/Application Support/ClaudeCode/policies.json，在 Linux 和通过 WSL 的 Windows 上部署到 /etc/claude-code/policies.json。

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

​

可用设置

settings.json 支持多个选项：

​

设置优先级

设置按优先级顺序应用：

1. 企业策略（参见 IAM 文档）
2. 命令行参数
3. 本地项目设置
4. 共享项目设置
5. 用户设置

​

环境变量

Claude Code 支持以下环境变量来控制其行为：

​

配置选项

我们正在将全局配置迁移到 settings.json。

claude config 将被弃用，取而代之的是 settings.json

要管理您的配置，请使用以下命令：

• 列出设置：claude config list
• 查看设置：claude config get <key>
• 更改设置：claude config set <key> <value>
• 推送到设置（对于列表）：claude config add <key> <value>
• 从设置中删除（对于列表）：claude config remove <key> <value>

默认情况下，config 更改您的项目配置。要管理您的全局配置，请使用 --global（或 -g）标志。

​

全局配置

要设置全局配置，请使用 claude config set -g <key> <value>：

​

Claude 可用的工具

Claude Code 可以访问一组强大的工具，帮助它理解和修改您的代码库：

权限规则可以使用 /allowed-tools 或在权限设置中配置。

​

另请参阅

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