Claude Code Templates 入门：配置目录不是模型运行时
动手做模板配置清单：记录来源与变化
不执行文件中的指令，只追踪组件产物以支持审阅和恢复。
动手做模板配置清单：记录来源与变化知识学习CN编辑简报更新 2026-09-23
你将学会
- 先做被动登记
- 检查漂移与歧义
- 连接监督式试用
开始前需要
- 基本 npm 与 Git 知识
- 独立项目及已保存的原配置
不执行文件中的指令，只追踪组件产物以支持审阅和恢复。
先看结论
- 清单是建议的扩展。
- 哈希证明字节而非安全。
- 安装成功不表示审阅通过。
先做被动登记
建立本地清单，包含组件 ID、安装器版本、源码提交、文件路径与内容哈希。先用合成文件，绝不把文件内容解释成可执行命令。
这是建议的学习项目，不声称固定源码已有完全相同功能。目标是让配置审阅和回滚依据可检查，而不是另建一个自动执行工具。
检查漂移与歧义
检测文件变化、未知来源和两个组件写向同一目标的情况。把这些情况显示为需要审阅，不悄悄选择其中一个并覆盖其他内容。
清单中不保存秘密，仅按需要保留脱敏元数据和哈希。哈希能证明字节一致，不能证明指令安全，仍需人工理解其行为。
连接监督式试用
清单测试通过后比较一次独立安装与已审阅基线，展示准确的变化路径。在宿主使用这些文件之前，要求明确人工批准。
验收场景是安装器成功退出，但未审阅更新仍保持待处理。自动升级、宿主执行和远程面板都不属于第一版练习范围。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
登记合成配置文件。
- 2
测试漂移、未知来源和冲突。
- 3
宿主消费前要求审阅。
可复制示例
json
{"component":"fixture-agent","installer":"1.29.6","source_revision":"unknown","review":"required","host_execution":false}常见问题
练习必须调用 Claude 吗？
不需要，被动文件样例足以开始。
演示应证明什么？
安装成功之后，未审阅变化仍保持待批准。
资料来源
- Claude Code Templates / README.md来源核查 2026-09-23
- Claude Code Templates / cli-tool/package.json来源核查 2026-09-23
- Claude Code Templates / cli-tool/src/index.js来源核查 2026-09-23