我花 3 天摸透了 Claude Code 的全部配置文件，这篇指南帮你少走弯路

后端开发基础免费分享

458人浏览 · 2026-04-06 16:47:40

后端开发基础免费分享 · 2026-04-06 16:47:40 发布

我花 3 天摸透了 Claude Code 的全部配置文件，这篇指南帮你少走弯路

"Claude Code 挺聪明，但就是不够懂我。"

这句话我听了不下十遍。每次都要重复说"用中文回复"、"先读我的记忆文件"、"提交代码要写清楚原因"——你也是这样吗？

真相是：Claude Code 有一套完整的配置体系，就像给 AI 写了一份"员工手册"。配好了，它就是你的专属编程搭档；没配好，它就是个通用聊天机器人。

今天我把所有核心配置文件梳理了一遍，看完这篇，30 分钟搭出你自己的 AI 工作流。

一、总览：7 个核心配置文件

Claude Code 的所有配置住在 ~/.claude/ 目录下。

~ 是"家目录"缩写，.claude 前面的点表示隐藏目录，Finder 默认不显示。终端里 ls -la 才能看到。

打开这个目录，核心就这 7 个：

~/.claude/
├── CLAUDE.md              # 行为准则（最高优先级）
├── settings.json          # 控制面板（API、插件、环境变量）
├── settings.local.json    # 权限白名单
├── .mcp.json              # 外部工具连接
├── memory/MEMORY.md       # 长期记忆索引
├── skills/*.md            # 技能包
└── agents/*.md            # AI 分身

先搞懂全局配置（CLAUDE.md + settings），再按需扩展 Skill 和 Agent。 下面逐个拆解。

二、CLAUDE.md：给 AI 写"员工手册"

位置：~/.claude/CLAUDE.md 作用：每次启动对话时自动读取，作为"行为准则" 优先级：项目级 > 用户级

两个层级

用户级：~/.claude/CLAUDE.md（对所有项目生效）
项目级：项目根目录下的 CLAUDE.md（仅对当前项目生效，可覆盖用户级）

真实示例

# CLAUDE.md

## 语言和风格
- 始终使用简体中文回复
- 禁止废话，直接回答问题

## 核心铁律（最高优先级）
1. 不确定 = 说不确定
2. 没有证据 = 不下结论
3. 能验证则验证

## 工作方式
1. 理解需求
2. 简要说明方案
3. 再开始实现

小贴士：用 ## 分大类，用编号列表写规则。规则越具体越好——"用中文回复"比"注意语言"有效 100 倍。

行为准则写好了，接下来配置底层参数。

三、settings.json：控制面板

位置：~/.claude/settings.json 作用：管理 API、插件、环境变量、Hook 等

核心配置

{
  "enabledPlugins": {
    "context7@claude-plugins-official": true,
    "playwright@claude-plugins-official": true
  },
  "env": {
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514"
  },
  "hooks": {
    "SessionEnd": [{
      "hooks": [{
        "async": true,
        "command": "/bin/bash ~/.claude/hooks/my-hook.sh",
        "type": "command"
      }]
    }]
  }
}

配置项	作用
`enabledPlugins`	开关官方插件（代码审查、文档查询等）
`env`	环境变量（API 密钥、模型选择）
`hooks`	生命周期钩子

settings.local.json：权限白名单

管理"哪些操作不需要用户确认"：

{
  "permissions": {
    "allow": [
      "WebSearch",
      "Bash(git:*)",
      "Bash(python3:*)"
    ]
  }
}

小贴士：把 git、python3、ls 等常用命令加入 allow，省去反复确认。千万别放危险命令（如 rm -rf）。

控制面板配好了，再让它能连接外部工具。

四、.mcp.json：连接外部工具

位置：~/.claude/.mcp.json 作用：通过 MCP 协议让 AI 调用外部工具（浏览器、数据库等）

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest"]
    }
  }
}

一行配置，Claude Code 就能控制 Chrome 浏览器——截图、点击、填表全自动。

工具接好了，让它拥有记忆。

五、memory/ 目录：让 AI 拥有长期记忆

位置：~/.claude/memory/MEMORY.md 作用：跨会话持久化重要信息

MEMORY.md 示例

# Claude Code Memory Index

## 偏好
- 编码风格：Java 为主，Vue 前端
- 部署方式：Docker + Jenkins

## 工具
- opencli 使用指南: ~/.claude/memory/opencli-guide.md

设计理念：MEMORY.md 做索引，不堆细节。真正的内容放在第二大脑目录，多个 AI 工具共享。

和 SECOND-BRAIN.md 配合

~/.claude/SECOND-BRAIN.md 告诉 Claude 去哪里找信息：

# 第二大脑桥接

统一事实源：
- ~/second-brain/user/preferences.md
- ~/second-brain/work/current-focus.md

这样 Claude Code、OpenClaw 等多个 AI 工具共享同一份记忆，不会各写各的。

有了记忆，再给它装技能包。

六、skills/ 目录：给 AI 装技能包

位置：~/.claude/skills/*.md 作用：为 Claude 提供专用工作流程和领域知识

类比：Claude Code 是手机 OS，Skill 就是 App。

SKILL.md 格式

---
name: build-deploy
description: 打包部署。触发词："打包"、"打生产包"
---

# 打包部署

## 工作流程
1. 检查环境变量
2. 执行 mvn clean package -P prod
3. 压缩输出到 web.zip
4. 移动到 ~/Documents/

三要素：name（名称）+ description（含触发词）+ 正文（工作流程）

技能包装好了，再来创建 AI 分身。

七、agents/ 目录：创建 AI 分身

位置：~/.claude/agents/*.md 作用：为不同任务创建独立 Agent

和 Skill 的区别：Agent 可以指定 tools（工具白名单）和 model（模型选择）。

---
name: wechat-publisher
description: 公众号运营专家
tools: Read, Write, Edit, Bash, Grep, Glob
model: inherit
---

# 微信公众号运营 Agent

## 脚本位置
~/.cc-switch/skills/wechat-mp-publisher/scripts/

## 模式
- 热点快报：触发词"AI 快报"
- 深度文章：触发词"写篇文章"

tools 实现安全隔离，model: inherit 表示继承主进程模型。

最后，自动化一切。

八、hooks/ 目录：自动化事件响应

位置：~/.claude/hooks/*.sh（在 settings.json 中引用）作用：特定事件触发时自动执行脚本

支持的事件

事件	触发时机
`SessionEnd`	会话结束
`Stop`	Claude 停止生成
`PreToolUse`	调用工具前
`PostToolUse`	调用工具后

真实示例：任务完成后通知另一个 AI

#!/bin/bash
OUTPUT=$(cat)

curl -s -X POST "http://127.0.0.1:18789/api/cron/wake" \
  -H "Authorization: Bearer $GATEWAY_TOKEN" \
  -d '{"text": "Claude Code 任务完成"}'

echo "$OUTPUT"

Claude 完成任务 → 自动通知 OpenClaw 取结果 → 发射后不管。

九、完整配置优先级

规则冲突时，优先级从高到低：

项目级 CLAUDE.md > 用户级 CLAUDE.md
    > Agent 定义 > Skill 定义 > 默认行为

十、30 分钟快速上手清单

按这个顺序来，效率最高：

第 1 步：写 CLAUDE.md（5 分钟）

nano ~/.claude/CLAUDE.md

写入语言偏好和工作方式。这是投入产出比最高的配置。

第 2 步：配 settings.json（5 分钟）

nano ~/.claude/settings.json

设置模型选择，开启常用插件。

第 3 步：设权限白名单（5 分钟）

nano ~/.claude/settings.local.json

把 git、python3、ls 加入 allow，告别确认弹窗。

第 4 步：搭记忆系统（10 分钟）

mkdir -p ~/.claude/memory
nano ~/.claude/memory/MEMORY.md

写一个索引文件，记录工具偏好和项目信息。

第 5 步：按需扩展

有重复任务时，再逐步加 Skill、Agent、Hook。

一张图总结

文件	一句话作用
`CLAUDE.md`	AI 的行为准则
`settings.json`	控制面板
`settings.local.json`	权限白名单
`.mcp.json`	外部工具连接
`memory/MEMORY.md`	长期记忆索引
`skills/*.md`	技能包
`agents/*.md`	AI 分身