配置

配置文件层级

Claude Code 使用多层级配置系统：

文件	位置	用途
`settings.json`	`~/.claude/`	全局用户设置
`settings.local.json`	`~/.claude/`	本地覆盖（不提交 git）
`settings.json`	`.claude/` (项目)	项目级设置（可提交 git）
`settings.local.json`	`.claude/` (项目)	项目本地覆盖

常用设置

模型选择

{
  "model": "claude-sonnet-4-6",
  "smallFastModel": "claude-haiku-4-5-20251001"
}

可用模型：

claude-opus-4-6 — 最强能力
claude-sonnet-4-6 — 速度与智能平衡（默认）
claude-haiku-4-5-20251001 — 快速响应

主题设置

{
  "theme": "dark"
}

选项："dark" | "light" | "light-daltonized" | "dark-daltonized"

通知

{
  "notifications": {
    "enabled": true,
    "sound": true
  }
}

权限模式

Claude Code 提供三种权限级别：

默认模式

每次工具调用都需要用户确认。

自动接受模式

# 自动接受读取操作
claude --allowedTools "Read,Glob,Grep"

权限配置文件

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm run *)",
      "Bash(git *)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(sudo *)"
    ]
  }
}

权限规则语法：

"Read" — 允许所有读取
"Bash(npm run *)" — 仅允许匹配的 Bash 命令
"Write(src/**)" — 仅允许写入 src 目录

环境变量

变量	说明
`ANTHROPIC_API_KEY`	API Key
`CLAUDE_CODE_USE_BEDROCK`	使用 AWS Bedrock
`CLAUDE_CODE_USE_VERTEX`	使用 Google Vertex AI
`HTTP_PROXY`	HTTP 代理地址
`HTTPS_PROXY`	HTTPS 代理地址
`DISABLE_PROMPT_CACHING`	禁用 Prompt 缓存

/config 命令

在交互模式中使用 /config 快速修改设置：

> /config
# 打开设置菜单，可以修改：
# - 模型
# - 主题
# - 通知
# - 权限

最佳实践

项目级配置：将团队共享的设置放在 .claude/settings.json 中
本地覆盖：个人偏好放在 settings.local.json 中，加入 .gitignore
最小权限：只允许必要的工具权限
CLAUDE.md：用于项目上下文，不要和 settings.json 混淆

配置

On this page