启动参数看官方文档在会话前运行Setup hooks(仅打印模式)Syntax--init示例claude -p --init "query"全网调研整理典型场景CI/CD 流水线中用 --init-only 触发 Setup hook 安装依赖后直接退出,无需启动交互会话结合 -p 在脚本/自动化环境中触发 Setup hook 完成环境准备,再执行 query(claude -p --init "query")用 --maintenance 定期清理临时文件、刷新缓存等维护任务,与初始化逻辑解耦新成员 onboarding 时一条命令完成 npm/pip 依赖安装和 .env 配置,保证团队环境一致agentic 初始化模式:hook 执行后让 agent 分析安装日志并生成报告(claude -p --init "/install")实用技巧--init-only 的退出码可在 CI 脚本中判断 Setup hook 是否成功,非 0 表示失败在 hook 脚本里向 $CLAUDE_ENV_FILE 写入 export 语句,可将环境变量持久化到当次会话所有后续 Bash 命令Setup hook 的纯 stdout 只写入 debug log,要向 Claude 传递上下文必须用 JSON 格式的 additionalContext 字段同一 settings.json 可定义 matcher 为 init 和 maintenance 的两组 hook,分别响应不同 flag 触发不同逻辑hook 脚本可读取输入 JSON 的 trigger 字段(值为 "init" 或 "maintenance")实现条件分支,复用同一脚本文件常见坑--init 单独用于交互模式时不触发 Setup hook,必须配合 -p 或改用 --init-onlySetup hook 无法阻断后续执行流程,exit code 2 仅把 stderr 显示给用户,不会终止会话误将 --init(触发 Setup hook)与 /init slash 命令(生成 CLAUDE.md)混淆,两者功能完全不同来源Hooks reference - Claude Code DocsClaude Code Setup Hooks: Automate Onboarding and Maintenance[DOCS] Missing documentation for Setup hook and --init/--init-only/--maintenance flags · Issue #18724Claude Code Cheat Sheet 2026: Commands, Flags, Shortcuts创建于v2.1.10最近更新v2.1.10变化次数1新增 1变化时间线(按版本倒序)新增v2.1.10· 2026/01/17 · 2026/01/17添加 --init flag 以触发 Setup hook 进行初始化上一个--include-partial-messages回到命令字典下一个--init-only