CLAUDE.md：Claude Code 的 6 层无损配置

Claude.md 系统配置：6层架构确保代码上下文稳如磐石

Claude Code 每次会话都从零开始：没有项目知识、服务器细节或历史修复记录。这导致反复解释和风险——从误删生产数据到将密钥推送到仓库。582 行的 CLAUDE.md 系统通过 6 层架构解决此问题：从规则到自动化钩子。每层都源于真实事件演化而成。

塑造架构的三大事故

三起事故定义了这一方法：

• SNI 代理通过 localhost。 代理将 127.0.0.1 替换为真实 IP，导致上传失败。根因：未理解该特定值的重要性。
• Fail2ban 封锁。 一分钟内多次 SSH 登录被标记为暴力破解，停止了模型训练。
• 数据集清空。 “过滤”命令直接删除文件，而非仅移动。

经验教训：规则必须在变更前分析当前值、强制单一 SSH 隧道，并在删除前要求明确确认。

6层架构

第 1 层：规则（9 个文件）

按上下文加载：SSH 规则不会干扰文本任务，调试规则跳过风格指南。

第 2 层：记忆（78 个文件）

知识图谱，178 个 [[filename]] 交叉引用。核心文件始终在上下文中；特定主题文件按需加载。涵盖基础设施、修复方案和常见陷阱。

第 3 层：移交（Handoffs）

会话摘要：目标、成就、失败、下一步。例如：

## 会话目标
颜色检查器：CNN 扫描 + 扩散模型。

## 已完成
- CNN 基线：中位数 1.99 度（11M 参数）
- 扫描：crop128(3.17)、bs16(2.04)
- 扩散模型：第 5/50 轮，损失 0.827

## 失败项
- EfficientNet-B0：哈希不匹配
- lr=3e-4：无裁剪时出现 NaN

## 下一步
扩散模型推理 + 可视化表格。

4 天内 27 次移交，避免重复死胡同。跨订阅有效。

第 4 层：纪事（Chronicles）

决策时间线：每个里程碑 3-7 行。与移交互补，提供完整故事。

第 5 层：钩子（Hooks）

由事件触发的自动化 Python 脚本（SessionStart、Stop、PreToolUse）。独立于模型记忆。

示例移交钩子：

# remind_handoff.py (Stop hook)
age = session_age_minutes()
if age < 15 or fresh_handoff_exists():
    return
print(json.dumps({
    "decision": "block",
    "reason": f"会话 {int(age)} 分钟，无移交记录。"
}))

第 6 层：技能（16 个工具包）

基于触发器的指南：“GPU 卡住时用这个”，而非模糊指令。

钩子 vs 规则：执行有保障

长会话中，提示规则易被遗忘。钩子机械执行。启动钩子验证 CLAUDE.md 链接；关闭钩子提醒移交。

供应链防护：一行配置

在 .npmrc 中：

min-release-age=7

阻挡 7 天内的新包。救我们于 axios 1.14.1 攻击（Sapphire Sleet，2026 年 3 月 31 日，3 小时窗口）。Python 等效在 uv.toml 中：

exclude-newer = "7 days"

37 篇论文提炼的原则

浓缩为规则：

• 证明循环。 禁止自我确认：要求外部证明（新会话中的测试）。
• 结构化推理。 格式：事实 → 推理 → 结论 → 验证假设。补丁准确率：78% → 93%。
• 确定性编排。 固定任务（测试、linting）通过 shell 脚本。
• 红线禁令。 硬性禁止：“无确认不删除”，绑定具体事件。

其他：生成器-评估器、多代理分解、代理安全。

指标与自更新

• 78 个记忆文件，178 个链接。
• 4 天 27 次移交。
• 96.9% KV 缓存命中率（83 会话）。

配置自验证：SessionStart 钩子在编辑后检查链接。

关键要点：

• 移交和记忆防止跨会话上下文丢失。
• 钩子确保关键动作执行。
• 供应链防护：.npmrc / uv.toml 中 min-release-age=7。
• 结构化推理将调试准确率提升至 93%。
• 红线禁令大幅降低生产风险。

最小栈：确定性编排 + 结构化推理 + 供应链防护 + 移交。

仓库：github.com/AnastasiyaW/claude-code-config (MIT)。

— Editorial Team