主题
EE-16 回复超出输出 token 上限
| 字段 | 内容 |
|---|---|
| 影响组件 | Claude Code 本体 |
| 系统环境 | Linux / macOS / Windows |
问题现象
API 返回：
API Error: response exceeded the 32000 token limit1
模型开始生成长回复后被强制中断。
根因分析
单次回复的输出 token 超过了客户端默认上限（32000）。这不是上下文窗口问题，而是单次响应的输出限制。
修复步骤
在 ~/.claude/settings.json 的 env 中追加：
json
{
"env": {
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "128000"
}
}1
2
3
4
5
2
3
4
5
保存后重启终端生效。
如果任务确实需要超长输出，改为让模型分段生成，每段控制在 8K–16K token 内。
预防措施
| 做法 | 避免的问题 |
|---|---|
| 大文件生成拆分为多次请求 | 单次输出超限 |
| 按需调高上限而非常驻最大值 | 无意义的长响应增加成本 |