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

我花 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: { context7claude-plugins-official: true, playwrightclaude-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-mcplatest] } } }一行配置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 是手机 OSSkill 就是 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会话结束StopClaude 停止生成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 $OUTPUTClaude 完成任务 → 自动通知 OpenClaw 取结果 → 发射后不管。九、完整配置优先级规则冲突时优先级从高到低项目级 CLAUDE.md 用户级 CLAUDE.md Agent 定义 Skill 定义 默认行为十、30 分钟快速上手清单按这个顺序来效率最高第 1 步写 CLAUDE.md5 分钟nano ~/.claude/CLAUDE.md写入语言偏好和工作方式。这是投入产出比最高的配置。第 2 步配 settings.json5 分钟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.mdAI 的行为准则settings.json控制面板settings.local.json权限白名单.mcp.json外部工具连接memory/MEMORY.md长期记忆索引skills/*.md技能包agents/*.mdAI 分身AI 工具的强大之处不在于出厂时能做什么而在于你花多少心思去调教它。先用 CLAUDE.md 和 settings.json 把基础打好日常使用中按需添加。一套好的配置能让 Claude Code 从能用变成离不开。你在配置 Claude Code 时遇到过什么坑评论区聊聊。