Token 优化指南¶

实用的设置和习惯，用于减少 Token 消耗、提升会话质量，并在每日限制内完成更多工作。

另请参阅：rules/common/performance.md 中的模型选择策略，以及 skills/strategic-compact/ 中的自动压缩建议。

推荐设置¶

这些是大多数用户的推荐默认值。高级用户可以根据工作负载进一步调整这些值——例如，简单任务可将 MAX_THINKING_TOKENS 设置得更低，复杂架构工作可设置得更高。

添加到你的 ~/.claude/settings.json：

{
  "model": "sonnet",
  "env": {
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
  }
}

每个设置的作用¶

关于自动压缩覆盖的社区说明¶

一些较新的 Claude Code 构建版本有社区报告称，CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 只能降低压缩阈值，这意味着低于默认值的设置可能会更早而不是更晚触发压缩。如果你的环境中出现这种情况，请移除该覆盖设置，并依赖手动 /compact 以及 ECC 的 strategic-compact 指南。参见 故障排除。

切换扩展思考¶

• Alt+T（Windows/Linux）或 Option+T（macOS）——切换开启/关闭
• Ctrl+O——查看思考输出（详细模式）

模型选择¶

为任务选择合适的模型：

在会话中切换模型：

/model sonnet     # default for most work
/model opus       # complex reasoning
/model haiku      # quick lookups

上下文管理¶

命令¶

API 速率成本估算警告¶

ECC 的上下文监控器可以根据本地钩子遥测数据发出 API 速率成本估算。如果你使用的是 Claude 订阅，并且这些估算不能反映你的实际账单，请仅禁用面向代理的成本警告：

export ECC_CONTEXT_MONITOR_COST_WARNINGS=off

Windows PowerShell：

[Environment]::SetEnvironmentVariable('ECC_CONTEXT_MONITOR_COST_WARNINGS', 'off', 'User')

这不会禁用上下文耗尽警告、范围警告、循环警告、/cost 或成本遥测文件。

策略性压缩¶

strategic-compact 技能（位于 skills/strategic-compact/）建议在逻辑间隔处使用 /compact，而不是依赖可能在任务中途触发的自动压缩。有关钩子设置说明，请参见该技能的 README。

何时压缩： - 探索之后、实现之前 - 完成一个里程碑之后 - 调试之后、继续新工作之前 - 重大上下文切换之前

何时不要压缩： - 相关更改实现过程中 - 正在调试活动问题时 - 多文件重构期间

子代理保护你的上下文¶

使用子代理（Task 工具）进行探索，而不是在主会话中读取许多文件。子代理读取 20 个文件但只返回摘要——你的主上下文保持干净。

MCP 服务器管理¶

每个启用的 MCP 服务器都会向你的上下文窗口添加工具定义。README 警告：每个项目启用数量保持在 10 个以下。

提示： - 运行 /mcp 查看活动服务器及其上下文成本 - 当你想要实时运行时更改时，使用 /mcp 禁用 Claude Code MCP 服务器。Claude Code 会将这些运行时禁用持久化到 ~/.claude.json。 - 在可用时优先使用 CLI 工具（使用 gh 而不是 GitHub MCP，使用 aws 而不是 AWS MCP） - 不要依赖 .claude/settings.json 或 .claude/settings.local.json 来禁用已加载的 Claude Code MCP 服务器；请使用 /mcp 执行此操作。 - ECC_DISABLED_MCPS 仅影响安装/同步流程中 ECC 生成的 MCP 配置输出，例如 install.sh、npx ecc-universal install 和 Codex MCP 合并。它不是实时的 Claude Code 切换开关。 - 默认配置了 memory MCP 服务器，但没有任何技能、代理或钩子使用它——考虑禁用它

Agent Teams 成本警告¶

Agent Teams（实验性）会生成多个独立的上下文窗口。每个队友单独消耗 Token。

• 仅用于并行能带来明确价值的任务（多模块工作、并行审查）
• 对于简单的顺序任务，子代理（Task 工具）的 Token 效率更高
• 在设置中启用：CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

未来：configure-ecc 集成¶

configure-ecc 安装向导可以在设置过程中提供设置这些环境变量的选项，并解释成本权衡。这将帮助新用户从一开始就进行优化，而不是在达到限制后才发现这些设置。

快速参考¶

# Daily workflow
/model sonnet              # Start here
/model opus                # Only for complex reasoning
/clear                     # Between unrelated tasks
/compact                   # At logical breakpoints
/cost                      # Check spending

# Environment variables (add to ~/.claude/settings.json "env" block)
MAX_THINKING_TOKENS=10000
CLAUDE_CODE_SUBAGENT_MODEL=haiku
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1