化實戰(zhàn)指南：模型選擇、上下文窗口管理與擴展思維調(diào)優(yōu))
ECC 性能優(yōu)化實戰(zhàn)指南模型選擇、上下文窗口管理與擴展思維調(diào)優(yōu)【免費下載鏈接】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導(dǎo)讀本文基于 docs/ja-JP/rules/common/performance.md 整理而成面向使用 ECCThe agent harness performance optimization system的開發(fā)者講解在 Claude Code、Codex 等 Harness 環(huán)境中降低 Token 成本、提升多 Agent 協(xié)作效率的完整方案。你將掌握三層能力按任務(wù)類型選擇 Haiku/Sonnet/Opus 的模型分層策略、通過上下文窗口管理與MAX_THINKING_TOKENS等環(huán)境變量控制隱性成本以及使用build-error-resolverAgent 快速修復(fù)構(gòu)建失敗的標準流程。一、模型選擇策略讓每個任務(wù)跑在最合適的模型上原文檔給出的核心原則是按任務(wù)復(fù)雜度分層選模型避免為簡單任務(wù)支付過高推理成本也避免讓輕量模型承擔(dān)深度推理任務(wù)。Haiku 4.5高頻輕量任務(wù)的成本擔(dān)當定位約具備 Sonnet 功能的 90%但成本僅為三分之一3 倍成本節(jié)省原文表述為 コスト 3 分の 1。適用場景頻繁調(diào)用的輕量 Agent結(jié)對編程與代碼生成快速生成、快速校驗多 Agent 系統(tǒng)中的 Worker Agent只做有限、明確的子任務(wù)。Sonnet 5日常編碼的主力模型定位最佳編碼模型最高のコーディングモデル。適用場景主開發(fā)工作日常 CRUD、業(yè)務(wù)邏輯實現(xiàn)多 Agent 工作流的編排Orchestration復(fù)雜編碼任務(wù)需要理解多文件關(guān)聯(lián)但不需極端推理深度。Opus 5深度推理的保留席位定位推理深度最強最も深い推論。適用場景復(fù)雜架構(gòu)決策最大推理需求的任務(wù)研究與分析類任務(wù)。倉庫源碼印證模型分層在 ECC 中的落地ECC 在src/llm/providers/claude.py中定義了各模型的規(guī)格與能力這正是文檔所述策略的底層實現(xiàn)依據(jù)模型 ID上下文窗口最大輸出備注claude-opus-4-81,000,00064,000使用thinking: {type: adaptive}自適應(yīng)思維見 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標記為僅自適應(yīng)思維_uses_adaptive_thinking_only即這類模型不再手動控制 temperature而是由模型自行決定思維深度。Agent 級模型分配的實際證據(jù)在 agents/ 目錄下每個 Agent 的 frontmatter 都顯式聲明model字段Opus 級深度推理architect、planner、spec-miner、healthcare-reviewerSonnet 級日常編碼code-reviewer、build-error-resolver、a11y-architect等絕大多數(shù) AgentHaiku 級輕量查找/文檔docs-lookup、comment-analyzer、conversation-analyzer、doc-updater、opensource-forker。這種Agent 元數(shù)據(jù)直接綁定模型的設(shè)計讓多 Agent 系統(tǒng)在編排時天然實現(xiàn)文檔所述的模型分層無需每次手動切換。二、上下文窗口管理避免在最后 20%窗口內(nèi)執(zhí)行高敏感任務(wù)大語言模型的輸出質(zhì)量在上下文窗口尾部會顯著衰減。文檔給出的經(jīng)驗法則是當上下文填充接近窗口末尾的 20% 時避免執(zhí)行對上下文敏感的任務(wù)。高上下文敏感任務(wù)應(yīng)避免在尾部 20% 執(zhí)行大規(guī)模重構(gòu)需同時理解多個文件的調(diào)用關(guān)系跨多文件的 Feature 實現(xiàn)復(fù)雜交互的 Debug錯誤可能由早期上下文中的某段代碼引發(fā)。低上下文敏感任務(wù)可在尾部執(zhí)行單文件編輯獨立工具函數(shù)創(chuàng)建文檔更新簡單 Bug 修復(fù)。配套的上下文管理實操來自倉庫指南README.md 的 Token Optimization 一節(jié)給出了日常會話命令命令使用時機/model sonnet大多數(shù)任務(wù)默認起點/model opus復(fù)雜架構(gòu)、調(diào)試、深度推理/clear無關(guān)任務(wù)之間免費、即時重置/compact邏輯斷點處調(diào)研完成、里程碑達成/cost會話期間監(jiān)控 Token 花費配合 docs/token-optimization.md 的戰(zhàn)略壓縮建議在探索之后、實現(xiàn)之前在調(diào)試完成之后、開啟新工作之前主動/compact而在多文件重構(gòu)進行中、活躍問題調(diào)試中則不要壓縮。另一個保護主上下文的有效手段是子 Agent 隔離用子 AgentTask 工具去讀取大量文件子 Agent 讀完 20 個文件后只向主會話返回摘要主上下文保持干凈——這正是文檔多 Agent 系統(tǒng)策略的延伸。三、擴展思維Extended Thinking 計劃模式Plan Mode什么是擴展思維擴展思維默認啟用為內(nèi)部推理預(yù)留最多31,999 個輸出 Token。這些 Token 不直接出現(xiàn)在最終回答中但對復(fù)雜任務(wù)的正確性至關(guān)重要。控制擴展思維的四種方式控制手段操作開關(guān)切換OptionTmacOS/AltTWindows/Linux配置文件在~/.claude/settings.json中設(shè)置alwaysThinkingEnabled預(yù)算上限bashexport MAX_THINKING_TOKENS10000PowerShell$env:MAX_THINKING_TOKENS 10000詳細模式CtrlO顯示思考輸出深度推理任務(wù)的推薦流程確認擴展思維已啟用默認啟用啟用**計劃模式Plan Mode**以獲得結(jié)構(gòu)化方法使用多輪批評Critique進行徹底分析使用角色分工的子 Agent 獲得多樣視角。預(yù)算調(diào)優(yōu)隱性成本可削減約 70%擴展思維雖默認預(yù)留學(xué)生思維 Token 高達 31,999但很多日常任務(wù)并不需要這么深的推理。倉庫文檔與 README 一致推薦將其下調(diào){ model: sonnet, env: { MAX_THINKING_TOKENS: 10000, CLAUDE_CODE_SUBAGENT_MODEL: haiku } }配置項默認值推薦值影響modelopussonnet約 60% 成本削減可處理 80% 編碼任務(wù)MAX_THINKING_TOKENS31,99910,000單次請求隱性思維成本降低約 70%CLAUDE_CODE_SUBAGENT_MODEL繼承主模型haiku子 Agent 用于探索、讀文件、跑測試Haiku 便宜約 80%CLAUDE_AUTOCOMPACT_PCT_OVERRIDE9550更早觸發(fā)壓縮長會話質(zhì)量更好依據(jù) README.md 與 docs/token-optimization.md。需要說明MAX_THINKING_TOKENS設(shè)為0可對瑣碎任務(wù)完全禁用擴展思維CLAUDE_AUTOCOMPACT_PCT_OVERRIDE存在社區(qū)反饋——某些 Claude Code 版本中它只能降低閾值即比默認更早壓縮而非更晚若遇到該問題建議移除覆蓋并依賴手動/compact詳見 docs/TROUBLESHOOTING.md 與 docs/token-optimization.md。會話中途切換模型/model sonnet # 大多數(shù)工作默認 /model opus # 復(fù)雜推理 /model haiku # 快速查找四、構(gòu)建故障排查Build Troubleshooting當構(gòu)建失敗時文檔給出的標準流程是使用build-error-resolverAgent分析錯誤信息分步修正每次修正后驗證。Agent 定義與職責(zé)邊界agents/build-error-resolver.md 明確定義了該 Agentfrontmattermodel: sonnet、工具集Read, Write, Edit, Bash, Grep, Glob核心使命以最小改動讓構(gòu)建通過——No refactoring, no architecture changes, no improvements職責(zé)范圍TypeScript 類型錯誤、編譯失敗、模塊解析、依賴問題導(dǎo)入錯誤、缺失包、版本沖突、配置錯誤tsconfig、webpack、Next.js最小 Diff 原則禁止重構(gòu)無關(guān)代碼、禁止改動架構(gòu)、禁止新增功能改動行數(shù)控制在受影響文件的 5% 以內(nèi)。診斷命令與常見修復(fù)npx tsc --noEmit --pretty npx tsc --noEmit --pretty --incremental false # 顯示全部錯誤 npm run build npx eslint . --ext .ts,.tsx,.js,.jsx常見錯誤對照表摘自 Agent 文檔錯誤修復(fù)implicitly has any type添加類型注解Object is possibly undefined可選鏈?.或空值檢查Property does not exist加入 interface 或使用可選?Cannot find module檢查 tsconfig paths、安裝包或修正導(dǎo)入路徑Type X not assignable to Y類型轉(zhuǎn)換或修正類型Generic constraint添加extends { ... }Hook called conditionally將 Hook 移到頂層await outside async添加async關(guān)鍵字錯誤優(yōu)先級與快速恢復(fù)級別癥狀行動CRITICAL構(gòu)建完全損壞、無 Dev Server立即修復(fù)HIGH單文件失敗、新代碼類型錯誤盡快修復(fù)MEDIUMLinter 警告、棄用 API條件允許時修復(fù)快速恢復(fù)手段清空緩存.next、node_modules/.cache后重建重裝依賴用npx eslint . --fix處理可自動修復(fù)項。與其他 Agent 的交接邊界構(gòu)建問題交給build-error-resolver但當問題性質(zhì)變化時應(yīng)換人需要重構(gòu) →refactor-cleaner需要架構(gòu)變更 →architect需要新功能 →planner測試失敗 →tdd-guide安全問題 →security-reviewer。在 AGENTS.md 的 Build troubleshooting 一節(jié)中也固化了同一流程Use build-error-resolver agent → analyze errors → fix incrementally → verify after each fix說明這一排查流程已內(nèi)化為 ECC 的整體 Agent 工作約定。五、成本與性能監(jiān)控速查將上述策略整合為日常運維清單# 日常工作流 /model sonnet # 大多數(shù)任務(wù)起點 /model opus # 僅在復(fù)雜推理時切換 /clear # 無關(guān)任務(wù)之間 /compact # 邏輯斷點處 /cost # 監(jiān)控花費 # 環(huán)境變量寫入 ~/.claude/settings.json 的 env 塊 MAX_THINKING_TOKENS10000 CLAUDE_CODE_SUBAGENT_MODELhaiku訂閱用戶若覺得上下文監(jiān)控器的 API 費用估算與真實賬單不符可僅關(guān)閉面向 Agent 的費用警告保留上下文耗盡、范圍、循環(huán)警告export ECC_CONTEXT_MONITOR_COST_WARNINGSoffWindows PowerShell[Environment]::SetEnvironmentVariable(ECC_CONTEXT_MONITOR_COST_WARNINGS, off, User)延伸閱讀docs/token-optimization.mdToken 優(yōu)化完整指南設(shè)置、壓縮策略、MCP 管理README.mdREADME 中的 Token Optimization 推薦設(shè)置agents/build-error-resolver.md構(gòu)建錯誤排查 Agent 完整定義src/llm/providers/claude.py模型規(guī)格與自適應(yīng)思維實現(xiàn)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創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 ECC 性能優(yōu)化實戰(zhàn)指南：模型選擇、上下文窗口管理與擴展思維調(diào)優(yōu)
ECC 性能優(yōu)化實戰(zhàn)指南模型選擇、上下文窗口管理與擴展思維調(diào)優(yōu)【免費下載鏈接】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導(dǎo)讀本文基于 docs/ja-JP/rules/common/performance.md 整理而成面向使用 ECCThe agent harness performance optimization system的開發(fā)者講解在 Claude Code、Codex 等 Harness 環(huán)境中降低 Token 成本、提升多 Agent 協(xié)作效率的完整方案。你將掌握三層能力按任務(wù)類型選擇 Haiku/Sonnet/Opus 的模型分層策略、通過上下文窗口管理與MAX_THINKING_TOKENS等環(huán)境變量控制隱性成本以及使用build-error-resolverAgent 快速修復(fù)構(gòu)建失敗的標準流程。一、模型選擇策略讓每個任務(wù)跑在最合適的模型上原文檔給出的核心原則是按任務(wù)復(fù)雜度分層選模型避免為簡單任務(wù)支付過高推理成本也避免讓輕量模型承擔(dān)深度推理任務(wù)。Haiku 4.5高頻輕量任務(wù)的成本擔(dān)當定位約具備 Sonnet 功能的 90%但成本僅為三分之一3 倍成本節(jié)省原文表述為 コスト 3 分の 1。適用場景頻繁調(diào)用的輕量 Agent結(jié)對編程與代碼生成快速生成、快速校驗多 Agent 系統(tǒng)中的 Worker Agent只做有限、明確的子任務(wù)。Sonnet 5日常編碼的主力模型定位最佳編碼模型最高のコーディングモデル。適用場景主開發(fā)工作日常 CRUD、業(yè)務(wù)邏輯實現(xiàn)多 Agent 工作流的編排Orchestration復(fù)雜編碼任務(wù)需要理解多文件關(guān)聯(lián)但不需極端推理深度。Opus 5深度推理的保留席位定位推理深度最強最も深い推論。適用場景復(fù)雜架構(gòu)決策最大推理需求的任務(wù)研究與分析類任務(wù)。倉庫源碼印證模型分層在 ECC 中的落地ECC 在src/llm/providers/claude.py中定義了各模型的規(guī)格與能力這正是文檔所述策略的底層實現(xiàn)依據(jù)模型 ID上下文窗口最大輸出備注claude-opus-4-81,000,00064,000使用thinking: {type: adaptive}自適應(yīng)思維見 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標記為僅自適應(yīng)思維_uses_adaptive_thinking_only即這類模型不再手動控制 temperature而是由模型自行決定思維深度。Agent 級模型分配的實際證據(jù)在 agents/ 目錄下每個 Agent 的 frontmatter 都顯式聲明model字段Opus 級深度推理architect、planner、spec-miner、healthcare-reviewerSonnet 級日常編碼code-reviewer、build-error-resolver、a11y-architect等絕大多數(shù) AgentHaiku 級輕量查找/文檔docs-lookup、comment-analyzer、conversation-analyzer、doc-updater、opensource-forker。這種Agent 元數(shù)據(jù)直接綁定模型的設(shè)計讓多 Agent 系統(tǒng)在編排時天然實現(xiàn)文檔所述的模型分層無需每次手動切換。二、上下文窗口管理避免在最后 20%窗口內(nèi)執(zhí)行高敏感任務(wù)大語言模型的輸出質(zhì)量在上下文窗口尾部會顯著衰減。文檔給出的經(jīng)驗法則是當上下文填充接近窗口末尾的 20% 時避免執(zhí)行對上下文敏感的任務(wù)。高上下文敏感任務(wù)應(yīng)避免在尾部 20% 執(zhí)行大規(guī)模重構(gòu)需同時理解多個文件的調(diào)用關(guān)系跨多文件的 Feature 實現(xiàn)復(fù)雜交互的 Debug錯誤可能由早期上下文中的某段代碼引發(fā)。低上下文敏感任務(wù)可在尾部執(zhí)行單文件編輯獨立工具函數(shù)創(chuàng)建文檔更新簡單 Bug 修復(fù)。配套的上下文管理實操來自倉庫指南README.md 的 Token Optimization 一節(jié)給出了日常會話命令命令使用時機/model sonnet大多數(shù)任務(wù)默認起點/model opus復(fù)雜架構(gòu)、調(diào)試、深度推理/clear無關(guān)任務(wù)之間免費、即時重置/compact邏輯斷點處調(diào)研完成、里程碑達成/cost會話期間監(jiān)控 Token 花費配合 docs/token-optimization.md 的戰(zhàn)略壓縮建議在探索之后、實現(xiàn)之前在調(diào)試完成之后、開啟新工作之前主動/compact而在多文件重構(gòu)進行中、活躍問題調(diào)試中則不要壓縮。另一個保護主上下文的有效手段是子 Agent 隔離用子 AgentTask 工具去讀取大量文件子 Agent 讀完 20 個文件后只向主會話返回摘要主上下文保持干凈——這正是文檔多 Agent 系統(tǒng)策略的延伸。三、擴展思維Extended Thinking 計劃模式Plan Mode什么是擴展思維擴展思維默認啟用為內(nèi)部推理預(yù)留最多31,999 個輸出 Token。這些 Token 不直接出現(xiàn)在最終回答中但對復(fù)雜任務(wù)的正確性至關(guān)重要。控制擴展思維的四種方式控制手段操作開關(guān)切換OptionTmacOS/AltTWindows/Linux配置文件在~/.claude/settings.json中設(shè)置alwaysThinkingEnabled預(yù)算上限bashexport MAX_THINKING_TOKENS10000PowerShell$env:MAX_THINKING_TOKENS 10000詳細模式CtrlO顯示思考輸出深度推理任務(wù)的推薦流程確認擴展思維已啟用默認啟用啟用**計劃模式Plan Mode**以獲得結(jié)構(gòu)化方法使用多輪批評Critique進行徹底分析使用角色分工的子 Agent 獲得多樣視角。預(yù)算調(diào)優(yōu)隱性成本可削減約 70%擴展思維雖默認預(yù)留學(xué)生思維 Token 高達 31,999但很多日常任務(wù)并不需要這么深的推理。倉庫文檔與 README 一致推薦將其下調(diào){ model: sonnet, env: { MAX_THINKING_TOKENS: 10000, CLAUDE_CODE_SUBAGENT_MODEL: haiku } }配置項默認值推薦值影響modelopussonnet約 60% 成本削減可處理 80% 編碼任務(wù)MAX_THINKING_TOKENS31,99910,000單次請求隱性思維成本降低約 70%CLAUDE_CODE_SUBAGENT_MODEL繼承主模型haiku子 Agent 用于探索、讀文件、跑測試Haiku 便宜約 80%CLAUDE_AUTOCOMPACT_PCT_OVERRIDE9550更早觸發(fā)壓縮長會話質(zhì)量更好依據(jù) README.md 與 docs/token-optimization.md。需要說明MAX_THINKING_TOKENS設(shè)為0可對瑣碎任務(wù)完全禁用擴展思維CLAUDE_AUTOCOMPACT_PCT_OVERRIDE存在社區(qū)反饋——某些 Claude Code 版本中它只能降低閾值即比默認更早壓縮而非更晚若遇到該問題建議移除覆蓋并依賴手動/compact詳見 docs/TROUBLESHOOTING.md 與 docs/token-optimization.md。會話中途切換模型/model sonnet # 大多數(shù)工作默認 /model opus # 復(fù)雜推理 /model haiku # 快速查找四、構(gòu)建故障排查Build Troubleshooting當構(gòu)建失敗時文檔給出的標準流程是使用build-error-resolverAgent分析錯誤信息分步修正每次修正后驗證。Agent 定義與職責(zé)邊界agents/build-error-resolver.md 明確定義了該 Agentfrontmattermodel: sonnet、工具集Read, Write, Edit, Bash, Grep, Glob核心使命以最小改動讓構(gòu)建通過——No refactoring, no architecture changes, no improvements職責(zé)范圍TypeScript 類型錯誤、編譯失敗、模塊解析、依賴問題導(dǎo)入錯誤、缺失包、版本沖突、配置錯誤tsconfig、webpack、Next.js最小 Diff 原則禁止重構(gòu)無關(guān)代碼、禁止改動架構(gòu)、禁止新增功能改動行數(shù)控制在受影響文件的 5% 以內(nèi)。診斷命令與常見修復(fù)npx tsc --noEmit --pretty npx tsc --noEmit --pretty --incremental false # 顯示全部錯誤 npm run build npx eslint . --ext .ts,.tsx,.js,.jsx常見錯誤對照表摘自 Agent 文檔錯誤修復(fù)implicitly has any type添加類型注解Object is possibly undefined可選鏈?.或空值檢查Property does not exist加入 interface 或使用可選?Cannot find module檢查 tsconfig paths、安裝包或修正導(dǎo)入路徑Type X not assignable to Y類型轉(zhuǎn)換或修正類型Generic constraint添加extends { ... }Hook called conditionally將 Hook 移到頂層await outside async添加async關(guān)鍵字錯誤優(yōu)先級與快速恢復(fù)級別癥狀行動CRITICAL構(gòu)建完全損壞、無 Dev Server立即修復(fù)HIGH單文件失敗、新代碼類型錯誤盡快修復(fù)MEDIUMLinter 警告、棄用 API條件允許時修復(fù)快速恢復(fù)手段清空緩存.next、node_modules/.cache后重建重裝依賴用npx eslint . --fix處理可自動修復(fù)項。與其他 Agent 的交接邊界構(gòu)建問題交給build-error-resolver但當問題性質(zhì)變化時應(yīng)換人需要重構(gòu) →refactor-cleaner需要架構(gòu)變更 →architect需要新功能 →planner測試失敗 →tdd-guide安全問題 →security-reviewer。在 AGENTS.md 的 Build troubleshooting 一節(jié)中也固化了同一流程Use build-error-resolver agent → analyze errors → fix incrementally → verify after each fix說明這一排查流程已內(nèi)化為 ECC 的整體 Agent 工作約定。五、成本與性能監(jiān)控速查將上述策略整合為日常運維清單# 日常工作流 /model sonnet # 大多數(shù)任務(wù)起點 /model opus # 僅在復(fù)雜推理時切換 /clear # 無關(guān)任務(wù)之間 /compact # 邏輯斷點處 /cost # 監(jiān)控花費 # 環(huán)境變量寫入 ~/.claude/settings.json 的 env 塊 MAX_THINKING_TOKENS10000 CLAUDE_CODE_SUBAGENT_MODELhaiku訂閱用戶若覺得上下文監(jiān)控器的 API 費用估算與真實賬單不符可僅關(guān)閉面向 Agent 的費用警告保留上下文耗盡、范圍、循環(huán)警告export ECC_CONTEXT_MONITOR_COST_WARNINGSoffWindows PowerShell[Environment]::SetEnvironmentVariable(ECC_CONTEXT_MONITOR_COST_WARNINGS, off, User)延伸閱讀docs/token-optimization.mdToken 優(yōu)化完整指南設(shè)置、壓縮策略、MCP 管理README.mdREADME 中的 Token Optimization 推薦設(shè)置agents/build-error-resolver.md構(gòu)建錯誤排查 Agent 完整定義src/llm/providers/claude.py模型規(guī)格與自適應(yīng)思維實現(xiàn)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創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考