Claude Code Templates 入门：配置目录不是模型运行时
阅读 dry-run 分支：为什么无写入承诺要按路径验证
检查通用模板复制预览之前，已选择代理可能先被安装的调用顺序。
阅读 dry-run 分支：为什么无写入承诺要按路径验证知识学习CN编辑简报更新 2026-09-23
你将学会
- 定位真实顺序
- 还要检查提前返回
- 设计安全回归用例
开始前需要
- 基本 npm 与 Git 知识
- 独立项目及已保存的原配置
不执行文件中的指令，只追踪组件产物以支持审阅和恢复。
先看结论
- 预览只保护特定复制步骤。
- 之前动作仍需要审阅。
- 没有实测安装副作用。
定位真实顺序
通用设置路径先构建模板配置并附加钩子与 MCP。如果 config.agents 非空，会先等待 installAgents，然后才检查 options.dryRun。
dry-run 随后打印源文件和目标位置，在 copyTemplateFiles 前返回。这个位置只支持关于该复制步骤的有限结论，不能证明此前没有写入动作。
还要检查提前返回
--agent、--command 等具体组件参数会更早进入 installMultipleComponents，正常分发下不会到达这个通用 dry-run 分支，不能用一处判断覆盖所有入口。
本系列没有执行或穷尽审计这些安装器，因此不把它说成已经复现的破坏事件。源码只说明不能相信一个笼统的完全无副作用假设。
设计安全回归用例
使用独立目录，替换外部下载，逐种参数组合比较执行前后文件。通用模板、已选代理和直接组件参数应该分开测试，而不是只测一条命令。
未来可以明确各路径写入约定，并让 dry-run 检查先于修改。这是建议的改进，不声称已经在固定版本中修复，也没有向上游提交补丁。
如何选择
| 比较维度 | 方案 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
用独立目录逐组合测试。
可复制示例
text
通用设置 -> 已选代理安装
-> dry-run 检查 -> 预览并返回
-> 否则 copyTemplateFiles常见问题
这证明所有 dry-run 都写文件吗？
不是，只说明该分支无法建立全局不写入保证。
已经修复上游了吗？
没有，本篇提出可验证约定，没有修改上游实现。
资料来源
- Claude Code Templates / cli-tool/src/index.js来源核查 2026-09-23
- Claude Code Templates / cli-tool/bin/create-claude-config.js来源核查 2026-09-23