装完 Claude Code,第一件事找别人的配置抄。这很正常。
settings.json、CLAUDE.md、Skills、MCP、Hooks 五个维度,组合空间巨大,官方文档只告诉你每个选项是什么意思,不告诉你怎么配才好用。从能用到好用,中间差的就是一份经过实战验证的配置。
git clone https://github.com/anneheartrecord/claude-code-config.git && cd claude-code-config && bash install.sh自动备份现有配置 → 复制到 ~/.claude/ → 重启生效。
| 配置项 | 值 | 为什么 |
|---|---|---|
| defaultMode | bypassPermissions |
个人开发机,弹窗确认打断心流,全部放开 |
| allow | 全部 10 个工具 | bypassPermissions 下不需要,但切模式时兜底 |
| deny | 12 条不可逆操作 | rm -rf /、git push --force、git reset --hard、chmod 777、dd、mkfs |
| hooks | PreToolUse 拦截 | 二次防护,双保险拦截危险 rm 命令 |
| hooks | Stop + PostToolUse | cmux 桌面通知:会话暂停/Agent 子任务完成时推送 |
| attribution | 空字符串 | 关掉 commit 里的 Co-Authored-By 签名 |
核心思路:收益可以激进追求,风险必须有硬性止损。
这是 Claude Code 里 最重要的文件。Agent 每次启动都会读它,你写什么它就照做。
模板包含 11 个板块:
| 板块 | 作用 |
|---|---|
| 用户画像 | 告诉 Agent 你是谁,它会适配你的技术水平 |
| 语言偏好 | 不确定用什么语言时会问你,而不是猜 |
| 思维方式 | 第一性原理 + 不知道就说不知道,这两条极其重要 |
| 代码质量规则 | 单文件 500 行上限、禁止 any、禁止空 catch |
| 安全规则 | 禁止硬编码密钥、必须参数化查询 |
| Git 规则 | commit 格式、不加 Co-Authored-By |
| GitHub 规范 | 双语 README、shields.io badge |
| 写作任务 | 文风引用、生图 Skill 配置、默认 prompt 风格 |
| 推文 / Markdown 发布流转 | 区分初稿和定稿,final 版同步到 personal-site |
| 文风 | 指向 writing-style.md,README 写作例外规则 |
| 项目目录 | 常用项目路径,Agent 直接定位 |
安装后 必须改 <占位符> 里的个人信息。
用 Claude Code 写作的人才需要这个。把你的写作风格提炼成画像,需要时让 Agent 读取:
读一下 ~/.claude/writing-style.md,用我的风格写一篇关于 xxx 的文章
模板内置了 8 条 AI 痕迹禁忌,专门针对 AI 生成文本的常见特征:
| 禁忌 | AI 的坏习惯 |
|---|---|
| 转折句式 | "不是……而是……" |
| 引号强调 | 用""包词语做标注 |
| 括号注释 | 用()补充说明 |
| 破折号 | 用——串句子 |
| 三段排比 | "首先…其次…最后…"工整三件套 |
| 总结开头 | "总的来说"、"归根结底"起手 |
| 连接词滥用 | "然而"、"因此"、"与此同时"硬串段落 |
| 万能升华 | "在这个XX时代,我们更需要XX" |
另外限制了反问句频率:一篇文章最多 1-2 处,放在最有冲击力的位置。
为什么不塞进 CLAUDE.md?写作风格只有写作时有用,放 CLAUDE.md 每次对话都加载,白白烧 token。记忆分层,按需加载。
| 工具 | 干什么 |
|---|---|
| Playwright | 浏览器自动化,截图、填表、爬页面 |
| Context7 | 查第三方库最新文档,防止模型用过时 API |
| Sequential Thinking | 强制多步推理,适合复杂架构决策 |
examples/project-CLAUDE.md 提供了一份项目级配置模板。放在项目根目录,只对当前项目生效,团队共享。
包含项目信息、代码规范、测试要求、目录结构、部署命令。直接抄,改成你的项目信息就能用。
| Skill | 安装 | 内容 |
|---|---|---|
| baoyu-skills | gh repo clone JimLiu/baoyu-skills /tmp/bs && cp -r /tmp/bs/skills/* ~/.claude/skills/ |
翻译、发推、生图等 19 个 |
| follow-builders | gh repo clone zarazhangrui/follow-builders ~/.claude/skills/follow-builders |
AI builder 动态追踪 |
| frontend-design | gh repo clone anthropics/skills /tmp/as && cp -r /tmp/as/skills/frontend-design ~/.claude/skills/ |
Anthropic 官方前端设计 |
claude-code-config/
├── install.sh # 一键安装
├── settings.json # 权限 + Hooks + deny 规则
├── CLAUDE.md # 全局指令模板
├── writing-style.md # 写作风格模板
├── mcp_servers.json # MCP 工具配置
├── hooks/
│ ├── check-secrets.sh # 敏感信息写入拦截
│ └── cmux-notify.sh # cmux 桌面通知(会话暂停/任务完成)
├── examples/
│ └── project-CLAUDE.md # 项目级配置示例
├── README.md # 中文
└── README_EN.md # English
效率优先,安全兜底。 bypassPermissions 追求极致效率,12 条 deny + Hooks 双保险守住底线。
显式优于隐式。 你写得越清楚,Agent 表现越稳定。不要指望它猜你的偏好。
记忆分层,按需加载。 全局规则放 CLAUDE.md,写作风格放独立文件,项目规范放项目级 CLAUDE.md。不同层级不同加载策略,不浪费上下文。
适合: 个人开发机上追求效率的 Claude Code 用户。
不适合: 企业环境、共用机器、需要严格权限管控的场景。bypassPermissions 是给信任自己开发环境的人用的。
MIT