启动参数看官方文档为当前会话设置处理难度级别（low/medium/high/xhigh/max）Syntax--effort <level>示例claude --effort high全网调研整理典型场景批量重命名、简单 grep、单行修复等低风险操作时用 `--effort low` 节省 token 和延迟开启长时 session 前希望统一推理深度（如全程 high）时在启动命令中设定跨文件重构、复杂 debug、安全审计等高风险任务用 `--effort high` 确保模型充分思考CI/CD 自动化脚本或高吞吐 subagent 场景用 `--effort low/medium` 控制成本使用 Opus 4.7/4.8 做编程或 agent 任务时推荐 `--effort xhigh` 作为起点实用技巧在 prompt 中输入 `ultrathink` 可触发单次深度推理，无需改变整个 session 的 effort 设置环境变量 `CLAUDE_CODE_EFFORT_LEVEL=max` 是让 `max` 持久化的唯一方法，否则关闭 session 即重置在 settings.json 中写入 `effortLevel` 字段可跨 session 固化默认值（支持 low/medium/high/xhigh，不支持 max）skill 和 subagent 的 markdown frontmatter 可单独指定 `effort` 字段，仅对该 skill/subagent 生效并覆盖 session 级别`/effort auto` 命令可一键重置为当前模型的内置默认值（Opus 4.8 默认 high，Opus 4.7 默认 xhigh）常见坑`max` 仅对当前 session 有效，session 结束后自动重置，需通过环境变量才能持久化模型不支持指定 level 时会静默 fallback（如 Opus 4.6 遇到 xhigh 会降级为 high），不抛出错误低 effort 下 Claude 会主动减少 tool call 次数，可能跳过依赖检查导致重构破坏关联代码来源CLI reference - Claude Code DocsModel configuration (Adjust effort level) - Claude Code DocsEffort - Claude API DocsClaude Code's effort parameter: when to go full send and when to chill最早记录ⓘ≤v2.1.72最近更新v2.1.186变化次数2修复 2变化时间线(按版本倒序)修复v2.1.186· 2026/06/23 · 19 天前修复了 teammates 通过 tmux/pane 后端时不继承 leader 的 effort 级别的问题修复v2.1.72· 2026/03/10 · 2026/03/10修复了 CLI flag `--effort` 在启动时被无关的 settings 写入重置的问题。上一个--disallowedTools回到命令字典下一个--enable-auto-mode