ECC 性能优化实战指南：模型选择、上下文窗口管理与扩展思维调优

ECC 性能优化实战指南模型选择、上下文窗口管理与扩展思维调优【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC导读本文基于 docs/ja-JP/rules/common/performance.md 整理而成面向使用 ECCThe agent harness performance optimization system的开发者讲解在 Claude Code、Codex 等 Harness 环境中降低 Token 成本、提升多 Agent 协作效率的完整方案。你将掌握三层能力按任务类型选择 Haiku/Sonnet/Opus 的模型分层策略、通过上下文窗口管理与MAX_THINKING_TOKENS等环境变量控制隐性成本以及使用build-error-resolverAgent 快速修复构建失败的标准流程。一、模型选择策略让每个任务跑在最合适的模型上原文档给出的核心原则是按任务复杂度分层选模型避免为简单任务支付过高推理成本也避免让轻量模型承担深度推理任务。Haiku 4.5高频轻量任务的成本担当定位约具备 Sonnet 功能的 90%但成本仅为三分之一3 倍成本节省原文表述为 コスト 3 分の 1。适用场景频繁调用的轻量 Agent结对编程与代码生成快速生成、快速校验多 Agent 系统中的 Worker Agent只做有限、明确的子任务。Sonnet 5日常编码的主力模型定位最佳编码模型最高のコーディングモデル。适用场景主开发工作日常 CRUD、业务逻辑实现多 Agent 工作流的编排Orchestration复杂编码任务需要理解多文件关联但不需极端推理深度。Opus 5深度推理的保留席位定位推理深度最强最も深い推論。适用场景复杂架构决策最大推理需求的任务研究与分析类任务。仓库源码印证模型分层在 ECC 中的落地ECC 在src/llm/providers/claude.py中定义了各模型的规格与能力这正是文档所述策略的底层实现依据模型 ID上下文窗口最大输出备注claude-opus-4-81,000,00064,000使用thinking: {type: adaptive}自适应思维见 src/llm/providers/claude.pyclaude-sonnet-4-61,000,00064,000源码中_DEFAULT_MODEL默认值即 ECC 的默认模型claude-haiku-4-5200,00016,000轻量快速适合 Worker 场景注意当前仓库实际注册的模型为 Opus 4.8 / Sonnet 4.6 / Haiku 4.5见 src/llm/cli/selector.py与文档中的 4.5/5/5 世代命名略有差异本文以仓库实际模型为准。仓库同时将 Opus 系列claude-opus-4-7、claude-opus-4-8标记为仅自适应思维_uses_adaptive_thinking_only即这类模型不再手动控制 temperature而是由模型自行决定思维深度。Agent 级模型分配的实际证据在 agents/ 目录下每个 Agent 的 frontmatter 都显式声明model字段Opus 级深度推理architect、planner、spec-miner、healthcare-reviewerSonnet 级日常编码code-reviewer、build-error-resolver、a11y-architect等绝大多数 AgentHaiku 级轻量查找/文档docs-lookup、comment-analyzer、conversation-analyzer、doc-updater、opensource-forker。这种Agent 元数据直接绑定模型的设计让多 Agent 系统在编排时天然实现文档所述的模型分层无需每次手动切换。二、上下文窗口管理避免在最后 20%窗口内执行高敏感任务大语言模型的输出质量在上下文窗口尾部会显著衰减。文档给出的经验法则是当上下文填充接近窗口末尾的 20% 时避免执行对上下文敏感的任务。高上下文敏感任务应避免在尾部 20% 执行大规模重构需同时理解多个文件的调用关系跨多文件的 Feature 实现复杂交互的 Debug错误可能由早期上下文中的某段代码引发。低上下文敏感任务可在尾部执行单文件编辑独立工具函数创建文档更新简单 Bug 修复。配套的上下文管理实操来自仓库指南README.md 的 Token Optimization 一节给出了日常会话命令命令使用时机/model sonnet大多数任务默认起点/model opus复杂架构、调试、深度推理/clear无关任务之间免费、即时重置/compact逻辑断点处调研完成、里程碑达成/cost会话期间监控 Token 花费配合 docs/token-optimization.md 的战略压缩建议在探索之后、实现之前在调试完成之后、开启新工作之前主动/compact而在多文件重构进行中、活跃问题调试中则不要压缩。另一个保护主上下文的有效手段是子 Agent 隔离用子 AgentTask 工具去读取大量文件子 Agent 读完 20 个文件后只向主会话返回摘要主上下文保持干净——这正是文档多 Agent 系统策略的延伸。三、扩展思维Extended Thinking 计划模式Plan Mode什么是扩展思维扩展思维默认启用为内部推理预留最多31,999 个输出 Token。这些 Token 不直接出现在最终回答中但对复杂任务的正确性至关重要。控制扩展思维的四种方式控制手段操作开关切换OptionTmacOS/AltTWindows/Linux配置文件在~/.claude/settings.json中设置alwaysThinkingEnabled预算上限bashexport MAX_THINKING_TOKENS10000PowerShell$env:MAX_THINKING_TOKENS 10000详细模式CtrlO显示思考输出深度推理任务的推荐流程确认扩展思维已启用默认启用启用**计划模式Plan Mode**以获得结构化方法使用多轮批评Critique进行彻底分析使用角色分工的子 Agent 获得多样视角。预算调优隐性成本可削减约 70%扩展思维虽默认预留学生思维 Token 高达 31,999但很多日常任务并不需要这么深的推理。仓库文档与 README 一致推荐将其下调{ model: sonnet, env: { MAX_THINKING_TOKENS: 10000, CLAUDE_CODE_SUBAGENT_MODEL: haiku } }配置项默认值推荐值影响modelopussonnet约 60% 成本削减可处理 80% 编码任务MAX_THINKING_TOKENS31,99910,000单次请求隐性思维成本降低约 70%CLAUDE_CODE_SUBAGENT_MODEL继承主模型haiku子 Agent 用于探索、读文件、跑测试Haiku 便宜约 80%CLAUDE_AUTOCOMPACT_PCT_OVERRIDE9550更早触发压缩长会话质量更好依据 README.md 与 docs/token-optimization.md。需要说明MAX_THINKING_TOKENS设为0可对琐碎任务完全禁用扩展思维CLAUDE_AUTOCOMPACT_PCT_OVERRIDE存在社区反馈——某些 Claude Code 版本中它只能降低阈值即比默认更早压缩而非更晚若遇到该问题建议移除覆盖并依赖手动/compact详见 docs/TROUBLESHOOTING.md 与 docs/token-optimization.md。会话中途切换模型/model sonnet # 大多数工作默认 /model opus # 复杂推理 /model haiku # 快速查找四、构建故障排查Build Troubleshooting当构建失败时文档给出的标准流程是使用build-error-resolverAgent分析错误信息分步修正每次修正后验证。Agent 定义与职责边界agents/build-error-resolver.md 明确定义了该 Agentfrontmattermodel: sonnet、工具集Read, Write, Edit, Bash, Grep, Glob核心使命以最小改动让构建通过——No refactoring, no architecture changes, no improvements职责范围TypeScript 类型错误、编译失败、模块解析、依赖问题导入错误、缺失包、版本冲突、配置错误tsconfig、webpack、Next.js最小 Diff 原则禁止重构无关代码、禁止改动架构、禁止新增功能改动行数控制在受影响文件的 5% 以内。诊断命令与常见修复npx tsc --noEmit --pretty npx tsc --noEmit --pretty --incremental false # 显示全部错误 npm run build npx eslint . --ext .ts,.tsx,.js,.jsx常见错误对照表摘自 Agent 文档错误修复implicitly has any type添加类型注解Object is possibly undefined可选链?.或空值检查Property does not exist加入 interface 或使用可选?Cannot find module检查 tsconfig paths、安装包或修正导入路径Type X not assignable to Y类型转换或修正类型Generic constraint添加extends { ... }Hook called conditionally将 Hook 移到顶层await outside async添加async关键字错误优先级与快速恢复级别症状行动CRITICAL构建完全损坏、无 Dev Server立即修复HIGH单文件失败、新代码类型错误尽快修复MEDIUMLinter 警告、弃用 API条件允许时修复快速恢复手段清空缓存.next、node_modules/.cache后重建重装依赖用npx eslint . --fix处理可自动修复项。与其他 Agent 的交接边界构建问题交给build-error-resolver但当问题性质变化时应换人需要重构 →refactor-cleaner需要架构变更 →architect需要新功能 →planner测试失败 →tdd-guide安全问题 →security-reviewer。在 AGENTS.md 的 Build troubleshooting 一节中也固化了同一流程Use build-error-resolver agent → analyze errors → fix incrementally → verify after each fix说明这一排查流程已内化为 ECC 的整体 Agent 工作约定。五、成本与性能监控速查将上述策略整合为日常运维清单# 日常工作流 /model sonnet # 大多数任务起点 /model opus # 仅在复杂推理时切换 /clear # 无关任务之间 /compact # 逻辑断点处 /cost # 监控花费 # 环境变量写入 ~/.claude/settings.json 的 env 块 MAX_THINKING_TOKENS10000 CLAUDE_CODE_SUBAGENT_MODELhaiku订阅用户若觉得上下文监控器的 API 费用估算与真实账单不符可仅关闭面向 Agent 的费用警告保留上下文耗尽、范围、循环警告export ECC_CONTEXT_MONITOR_COST_WARNINGSoffWindows PowerShell[Environment]::SetEnvironmentVariable(ECC_CONTEXT_MONITOR_COST_WARNINGS, off, User)延伸阅读docs/token-optimization.mdToken 优化完整指南设置、压缩策略、MCP 管理README.mdREADME 中的 Token Optimization 推荐设置agents/build-error-resolver.md构建错误排查 Agent 完整定义src/llm/providers/claude.py模型规格与自适应思维实现src/llm/cli/selector.py交互式模型选择 CLI。【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考