my-claude-best-practices

my-claude-best-practices

🎨 我的 Claude Code 最佳实践配置 - 10 个实用技巧一键安装，让 Claude Code 发挥 100% 潜力

这是一份源自个人日常使用总结的 Claude Code 配置优化清单，通过 Claude Code 插件形式分发，支持一键自动配置所有推荐优化项。

🚀 功能特性

功能	状态	说明
📊 上下文压缩阈值优化	✅ 自动配置	设置为 75%，防止 AI 在长对话中"失忆"
📝 CLAUDE.md 规则指南	📖 文档	教你如何通过 CLAUDE.md 控制 AI 行为
🎨 代码自动格式化	✅ 内置脚本	支持多语言（JS/TS/Python/Go/Java/...）自动格式化
😄 自定义中文 Spinner	✅ 自动配置	用中文提示词替换默认英文，等待更有趣
🔔 任务完成自动通知	✅ 自动配置	AI 完成任务后发送桌面通知，支持异步工作流
🎯 设置 AI 输出风格	📖 文档	教你设置输出风格匹配工作节奏
🧹 去掉 Git 联合署名	✅ 自动配置	禁用 Co-authored-by，保持提交历史纯净
🖥️ Claude HUD 集成	✅ 自动安装	美观实用的状态仪表盘，显示上下文使用情况
🧠 Claude-Mem 记忆	✅ 自动安装	跨会话持久化记忆，AI 记得你们聊过什么
⚡ Code-Simplifier Agent	✅ 自动配置	官方代码简化专家，自动优化代码质量
📚 文档更新	✅ 已更新	增加通过环境变量禁用内置 Auto Memory 的说明（使用 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1）；setup 在检测到 claude-mem 时建议禁用（skills/setup/SKILL.md:14-20）。
🛠️ 脚本改进	✅ 优化	改进 scripts/format-code.sh 的 ensure_command 检查与多语言格式化支持。
🧭 CLAUDE.md: Karpathy 四大原则	📖 可选	setup 提供将 Karpathy 的“AI 编程四大原则”合并到全局 ~/.claude/CLAUDE.md 的选项。

📥 安装

从 GitHub 安装（推荐）

/plugin marketplace add xiaodizi/my-claude-best-practices
/plugin install my-claude-best-practices

从本地安装（开发）

git clone https://github.com/xiaodizi/my-claude-best-practices.git
cd my-claude-best-practices
/plugin install .

⚡ 快速开始

安装完成后，只需两步：

# 1. 一键自动配置所有推荐设置
/my-claude-best-practices:setup

# 2. 配置 Claude HUD
/claude-hud:setup

然后重启 Claude Code，所有优化就生效了！ 🎉

📖 文档

安装完成后，随时可以查看完整的最佳实践指南：

/my-claude-best-practices

指南包含了每个配置的原理说明，帮助你理解为什么要这么配置。

✨ 特性说明

自动安装依赖插件

安装 my-claude-best-practices 时，Claude Code 会自动安装：

• claude-hud - 美观的状态仪表盘
• claude-mem - 跨会话持久化记忆

自动配置项目

一键 setup 会自动帮你配置：

• 上下文压缩阈值设置为推荐值 75%
• 禁用 Git 提交的 Co-authored-by 自动署名
• 配置优雅的中文 Spinner 提示词
• 添加任务完成桌面通知（macOS）
• 配置 code-simplifier Agent

内置多语言格式化脚本

插件内置了文档推荐的 format-code.sh 智能调度脚本，支持多种编程语言自动格式化。你可以直接复制到你的项目中使用。

📝 手动配置可选

如果你不想自动配置，也可以按照文档中的指南，手动选择性应用你喜欢的配置。

👨‍💻 作者

lei.fu (@xiaodizi)

📄 许可证

MIT License - 详见 LICENSE 文件

🙏 致谢

• Claude HUD by @jarrodwatts
• Claude Mem by @thedotmack
• Claude Code 团队做出了这么棒的工具 👍

发布记录

v1.0.1 — 2026-05-12

• 文档: 增加通过环境变量禁用内置 Auto Memory 的说明（使用 CLAUDE_CODE_DISABLE_AUTO_MEMORY=1），并在 setup 中检测到 claude-mem 时建议禁用内置 Auto Memory（详见 skills/setup/SKILL.md:14-20）。
• 版本: 将 package.json 版本号更新为 1.0.1（package.json:3）。
• 改进: 优化 scripts/format-code.sh 的 ensure_command 检查与多语言格式化支持（scripts/format-code.sh:10-40, 42-85）。
• 修正: 更新 .gitignore 以忽略 .DS_Store 与 .claude 目录（.gitignore:1-4）。
• 其他: 准备发布的若干小幅文档和元数据调整（chore: 更新内容，准备发布 v1.0.1）。

更多细节请查看提交记录（git log）或仓库中的相应文件。