Claude 基本配置选项详解

Claude Code 有一套灵活的配置体系，从全局用户配置到项目级别的 CLAUDE.md，每一层都可以精细调整。掌握这些配置，能让 Claude Code 更懂你、更懂你的项目。

配置体系概览

Claude Code 的配置分三个层级，优先级从高到低：

项目级 CLAUDE.md（最高优先级）
    ↓
用户级 ~/.claude/settings.json
    ↓
默认配置（最低优先级）

---

CLAUDE.md：项目级配置（最重要）

CLAUDE.md 是 Claude Code 配置里最重要的文件，放在项目根目录，每次启动 Claude Code 时自动读取。

把这个文件理解为”给 Claude 的项目说明书”：你把项目的关键信息写在这里，Claude Code 就不需要每次重新猜测你的项目情况。

CLAUDE.md 的基本结构

# 项目名称 / 背景

简短介绍这个项目是做什么的（1-3 句话）。

## 技术栈

- 语言：TypeScript 5.x
- 框架：Next.js 14（App Router）
- 数据库：PostgreSQL + Prisma ORM
- 测试：Jest + React Testing Library

## 开发规范

- 代码格式化：Prettier（配置在 .prettierrc）
- Lint：ESLint（配置在 .eslintrc.json）
- 提交前运行：`npm run lint && npm test`

## 常用命令

- 启动开发服务器：`npm run dev`
- 运行测试：`npm test`
- 构建：`npm run build`
- 数据库迁移：`npx prisma migrate dev`

## 注意事项（重要）

- 不允许修改 .env 文件，环境变量改动请找我确认
- 数据库迁移文件不要自行创建，迁移前先和我沟通
- 所有对外 API 接口必须有请求参数校验
- 测试覆盖率要求 > 80%

## 禁止行为

- 不要使用 any 类型（TypeScript 严格模式）
- 不要直接使用 console.log（生产代码用 logger 模块）
- 不要跳过 ESLint 规则（no-eslint-disable）

CLAUDE.md 的关键内容

一定要写的：

• 运行测试的命令（Claude Code 经常需要跑测试）
• 不允许 Claude Code 动的文件或目录
• 代码风格和规范的关键点
• 项目特有的注意事项

可选但有用的：

• 技术栈（帮助 Claude Code 选择正确的 API 和语法）
• 常用命令（Claude Code 执行任务时会用到）
• 架构说明（帮助理解项目结构）

多级 CLAUDE.md

你可以在项目的子目录里也放 CLAUDE.md，这样进入特定目录时会加载额外的说明：

my-project/
├── CLAUDE.md          # 全局项目说明
├── frontend/
│   └── CLAUDE.md      # 前端专属说明（React 规范等）
└── backend/
    └── CLAUDE.md      # 后端专属说明（API 规范等）

---

全局用户配置：~/.claude/settings.json

这里存放跨项目的个人偏好设置，不需要手动编辑，通过 Claude Code 的命令操作会自动更新。

常见配置项：

{
  "model": "claude-opus-4-5",
  "theme": "dark",
  "verbose": false,
  "autoApprove": []
}

选择默认模型

# 在 Claude Code 里切换模型
/model

# 或者通过命令行参数指定
claude --model claude-sonnet-4-5

模型选择建议：

模型	适合场景	速度	费用
claude-opus-4-7	复杂架构设计、难 Bug	较慢	高
claude-sonnet-4-6	日常开发任务（推荐）	中等	中等
claude-haiku-4-5	简单任务、快速问答	快	低

日常使用推荐 Sonnet 系列，在能力和速度之间平衡最好。

---

权限配置

Claude Code 执行任何文件修改或命令前都会请求你的确认，但你可以预先配置允许的操作，减少重复确认。

权限模式

# 查看当前权限设置
claude /permissions

# 三种权限模式
# 1. 默认模式：每个操作都请求确认
claude

# 2. 自动批准写文件（但命令还是需要确认）
claude --permission-mode acceptEdits

# 3. 完全自动（谨慎使用，适合 CI 环境）
claude --dangerously-skip-permissions

为特定工具配置权限

# 允许 Claude Code 自动执行测试命令
claude --allowedTools "Bash(npm test),Bash(npm run build)"

# 禁止 Claude Code 执行某些命令
claude --disallowedTools "Bash(rm),Bash(git push)"

---

输出格式配置

针对不同场景配置输出格式：

# 默认交互式输出（彩色，带格式）
claude

# 纯文本输出（适合记录日志）
claude --output-format text

# JSON 格式（适合脚本处理）
claude --output-format json -p "分析这个错误" < error.log

---

系统提示词（System Prompt）配置

给 Claude Code 设置额外的全局指令：

# 命令行指定
claude --system-prompt "你是一个 Python 专家，所有代码示例都用 Python 3.12"

# 从文件加载
claude --system-prompt-file ./my-system-prompt.txt

# 追加到默认系统提示（不替换）
claude --append-system-prompt "所有注释必须用中文写"

---

快速配置检查

设置完成后，运行以下命令验证配置是否生效：

# 检查整体状态
claude /status

# 查看当前配置
claude /config

# 查看 CLAUDE.md 是否被读取
claude -p "你读到了哪些 CLAUDE.md 文件？"

---

配置好这些之后，Claude Code 就已经”认识”你的项目了。下一步：配置连接本地开发环境，让 Claude Code 能直接运行你的命令。