用途：claude-runner 用于在无头打印模式下，通过本地已认证的 claude CLI 执行调用方限定的提示。仅当存在明确的 Claude CLI 请求，或所选 Claude 路由无法作为原生宿主执行时使用。
主要能力：先依据 shared/references/model-preview.md 选择分支；确定性检查无需选择模型。实际派发使用一个已批准的固定快照，嵌套调用直接消费该快照，不重新解析或增加额外工作进程。共享角色、信封键与结果处理见 shared/references/runner-common.md。需保持席位真实性：注明实际应答的提供方，如实报告不可用或未验证的席位。
原生路由：选择外部路由前先读 shared/references/host-model-execution.md。若当前宿主能以原生子代理或任务线程派发所选 Claude 模型，并满足所需 effort、隔离与回执策略，则使用该路由。agents/openai.yaml 是宿主 UI 元数据，不派发原生模型。
调用方式：在同一次 shell 调用中设置 SKILL_DIR，然后运行：
SKILL_DIR="<absolute path of this skill directory>";
python3 "$SKILL_DIR/scripts/run_claude.py" "<scoped prompt>"
--model <approved-model-id> --effort <approved-effort> --disable-fallback --json
从所选快照复制确切的 model 与 effort，并补充其角色、工具模式、回执策略与限制。仅对选定的运行时受控路由省略 effort 标志。嵌套调用使用已保存选项，不再解析默认值。示例不授予源码共享或工具权限。
运行时边界：使用本地已认证 claude CLI 的打印模式，权限检查保持启用。分析角色默认 repo_read_only：仅 Read、Glob、Grep，禁用自定义配置并使用空 MCP 配置。--restrict-tools 强制该配置；--tool-profile no_tools 移除所有工具；--allow-write 或 --tool-profile write 在调用方权限内保留正常写权限。提示与文件上下文可能发送给所配置的提供方。裸模式会改变认证行为，使用前请阅读运行时参考。包装器转发 model 与 effort。主助手事件可证明服务模型；请求标签、初始化标签、合成事件与用量标签不能。缺失证据保持未验证；主 ID 冲突或模型不匹配则结果失败。直接调用在 CLI 缺失且回退能保持约束时可回退一次；工具配置与原生预算限制阻止回退；已批准路由禁用回退；原生会话续接必须保留所选 runner。可用 --max-turns、--max-budget-usd、--timeout 设置原生轮次、报告成本与耗时限制，均须为正有限值；请求的响应长度仅为建议。
按需加载：references/command-reference.md 用于标志、示例、原生映射与返回码；references/runtime-reference.md 用于认证、回退条件、配置与扩展信封字段；references/continuation.md 仅在恢复会话或管理后台任务时使用。
结果：读取 agent_message 与包装器信封，检查 success、服务模型回执、生效 runner/provider 以及回退或畸形输出状态。进程完成本身不能证明使用了所请求的任务或模型。调用方授权编辑时报告涉及的文件。