启动参数看官方文档在会话前运行维护Setup hooks(仅打印模式)Syntax--maintenance示例claude -p --maintenance "query"全网调研整理典型场景在 CI/CD 脚本中定期触发清理旧会话、轮换日志等维护任务,不进入交互模式在 cron job 中组合 -p 使用,定时执行依赖更新或缓存清理并自动生成报告在关键工作前用脚本调用,对环境进行健康检查,确认工具链状态正常再交给开发者与查询字符串配合(`claude -p --maintenance "总结本次维护内容"`),让 Claude 分析维护结果并输出摘要在多步骤自动化流水线中,用 `--init-only` 做初始化、`--maintenance` 做周期维护,职责分离实用技巧必须与 `-p`(print 模式)搭配才能触发 Setup hook:`claude -p --maintenance "query"`,单独 `--maintenance` 不生效在 `settings.json` 的 Setup hook 里用 `matcher: "maintenance"` 精确匹配,同一 Setup 块可同时配置 init 和 maintenance 两个 matcher维护脚本可读取 hook 输入中的 `trigger` 字段(值为 `"maintenance"`),使同一脚本兼容 init 和 maintenance 两种触发脚本写入 `$CLAUDE_ENV_FILE`(`export KEY=value >> $CLAUDE_ENV_FILE`)可将维护阶段设置的变量持久化到后续 Bash 命令hook JSON 输出中的 `additionalContext` 字段可向 Claude 注入维护结果摘要,使后续 print 模式回答更精准常见坑漏掉 `-p` 是最常见错误:没有 print 模式,`--maintenance` 不会触发任何 Setup hookmatcher 值区分大小写,必须写 `maintenance`(全小写),写成 `Maintenance` 或 `MAINTENANCE` 会导致 hook 静默跳过Setup hook 无法阻断执行,exit code 2 仅将 stderr 提示给用户,流程仍会继续,不可用于强制拦截来源Hooks reference - Claude Code DocsClaude Code Setup Hooks: Automate Onboarding and Maintenance[DOCS] Missing documentation for Setup hook event and associated CLI flags · Issue #18724 · anthropics/claude-codeClaude Code Hooks: Complete 2026 Production Reference — The Prompt Shelfclaude-code-best-practice: claude-cli-startup-flags.md创建于v2.1.10最近更新v2.1.10变化次数1新增 1变化时间线(按版本倒序)新增v2.1.10· 2026/01/17 · 2026/01/17添加 --maintenance flag 以触发维护操作上一个--json-schema回到命令字典下一个--max-budget-usd