性能优化¶

模型选择策略¶

Haiku 4.5（具备 Sonnet 90% 的功能，成本为三分之一）： - 频繁调用的轻量级代理 - 结对编程和代码生成 - 多代理系统中的工作代理

Sonnet 5（最佳编码模型）： - 主要开发工作 - 多代理工作流的编排 - 复杂编码任务

Opus 5（最深入的推理）： - 复杂架构决策 - 最高推理需求 - 调研和分析任务

上下文窗口管理¶

在以下情况下，应避免使用上下文窗口的最后 20%： - 大规模重构 - 跨多个文件的功能实现 - 复杂交互的调试

对上下文不敏感的任务： - 单文件编辑 - 创建独立工具 - 更新文档 - 简单 bug 修复

扩展思考 + 计划模式¶

扩展思考默认启用，并为内部推理预留最多 31,999 个 token。

控制扩展思考： - 切换：Option+T（macOS）/ Alt+T（Windows/Linux） - 设置：在 ~/.claude/settings.json 中设置 alwaysThinkingEnabled - 预算上限：export MAX_THINKING_TOKENS=10000（bash）或 $env:MAX_THINKING_TOKENS = "10000"（PowerShell） - 详细模式：按 Ctrl+O 显示思考输出

对于需要深入推理的复杂任务： 1. 确认扩展思考已启用（默认启用） 2. 为采用结构化方法启用 计划模式 3. 使用多个评审轮次进行彻底分析 4. 使用分工明确的子代理以获得多样化视角

构建故障排除¶

如果构建失败： 1. 使用 build-error-resolver 代理 2. 分析错误消息 3. 逐步修复 4. 每次修复后验证