【Bug已解决】Output too large / Response truncated — Claude Code 响应截断解决方案1. 问题描述在 Claude Code 中请求生成大量代码或长文本时输出在未完成时突然中断终端显示# 输出在中间突然停止 ... function processAuth(token) { const decoded jwt.ve使用--debug模式查看 API 响应时可以看到{ stop_reason: max_tokens, content: [ {type: text, text: ...(被截断的内容)} ] }这个问题在以下场景中特别常见让 Claude Code 生成超过 4096 tokens 的长代码一次性请求生成多个文件让 Claude Code 编写长文档或报告上下文已经很大剩余输出空间不足max_tokens 设置过小# 典型复现过程 $ claude 生成一个完整的 Express.js 项目包含路由、中间件、数据库连接和错误处理 # Claude 开始生成代码... # 在写到第三个文件时突然停止 # stop_reason: max_tokens2. 原因分析核心原理拆解Claude Code 发送请求 → 指定 max_tokens 限制 ↓ Claude 模型生成输出 → 达到 max_tokens 上限 ↓ 输出被强制截断 → stop_reason: max_tokens ↓ 内容不完整原因分类表原因分类具体表现占比max_tokens 过小默认 4096 或 8192 不够约 40%上下文占用过大输入占用大部分窗口约 30%一次性请求过多生成多个文件约 20%模型输出窗口限制模型最大输出 Token约 10%3. 解决方案方案一使用 continue 继续生成最推荐# 步骤 1当输出被截断时 继续 # Claude Code 会从截断处继续生成 # 可能需要多次 继续 才能完成 # 步骤 2如果 继续 不生效 从刚才中断的地方继续生成代码 # 步骤 3使用 /compact 后继续 /compact 继续方案二增加 max_tokens 设置# 步骤 1通过环境变量增加 export CLAUDE_MAX_TOKENS16384 # 步骤 2或在 settings.json 中配置 cat ~/.claude/settings.json EOF { maxTokens: 16384 } EOF # 步骤 3永久生效 echo export CLAUDE_MAX_TOKENS16384 ~/.zshrc source ~/.zshrc # 步骤 4重启 Claude Code claude方案三分步请求生成# 不要一次性请求生成所有内容: 生成完整的 Express 项目5 个文件 # 分步请求: 步骤 1: 生成 app.js 主文件 # 完成后 步骤 2: 生成 routes/ 目录下的路由文件 # 完成后 步骤 3: 生成 middleware/ 目录下的中间件 # 逐步完成方案四压缩上下文后生成# 步骤 1压缩上下文释放空间 /compact # 这会减少输入 Token为输出留出更多空间 # 步骤 2重新请求 生成 Express 项目的错误处理中间件方案五指定输出长度限制# 在请求中明确限制范围: 生成一个简洁的 Express 服务器不超过 100 行 只生成核心路由逻辑不要包含配置和工具函数 先生成函数签名和注释后续再补充实现方案六使用 /clear 后重新请求# 如果上下文太大占满了窗口 /clear # 新会话中输入更简洁的请求 创建一个 Express.js 服务器包含 /api/users 路由 # 简洁的请求 空的上下文 更多的输出空间4. 各方案对比总结方案适用场景推荐指数难度方案一继续即时恢复⭐⭐⭐⭐⭐低方案二增加 max_tokens长输出需求⭐⭐⭐⭐⭐低方案三分步请求多文件生成⭐⭐⭐⭐⭐低方案四/compact上下文过大⭐⭐⭐⭐低方案五限制范围精简输出⭐⭐⭐⭐低方案六/clear上下文满⭐⭐⭐低5. 常见问题 FAQ5.1 max_tokens 默认值是多少Claude Code 默认 max_tokens 通常为 4096 或 8192。具体取决于版本和配置。可以通过 settings.json 或环境变量调整。5.2 stop_reasonmax_tokens 和 stop_reasonend_turn 的区别max_tokens输出达到了 Token 上限被强制截断内容不完整end_turn模型自然完成回答内容完整tool_use模型请求调用工具5.3 最大可以设置多少 max_tokens取决于模型Sonnet最大 8192 tokens部分版本支持 16384Opus最大 4096 tokensHaiku最大 8192 tokens超过模型限制的设置不会生效5.4 继续 不起作用怎么办可能上下文已满。使用/compact压缩后继续或/clear后重新请求。5.5 生成代码被截断后如何拼接# 步骤 1先保存已生成的部分 将已生成的代码保存到文件 # 步骤 2继续生成 继续 # 步骤 3将后续生成的内容追加到同一文件5.6 上下文窗口和 max_tokens 的关系上下文窗口 输入 Token 输出 Token。如果输入占用了 100K tokens200K 窗口输出最多只有 100K tokens。压缩上下文可以为输出释放空间。5.7 CI/CD 中如何避免截断在自动化流程中分步执行每步生成一个文件files [app.js, routes/users.js, middleware/auth.js] for f in files: response call_claude(f生成文件 {f} 的代码) save_to_file(f, response)5.8 流式响应下是否会被截断是的。即使是流式响应达到 max_tokens 后也会停止。流式只是逐步显示输出不增加总输出量。5.9 如何检测输出是否被截断检查 stop_reason# 使用 --debug 模式 claude --debug # 查看响应中的 stop_reason # 如果是 max_tokens说明被截断5.10 排查清单速查表□ 1. 检查 stop_reason 是否为 max_tokens □ 2. 输入 继续 从截断处恢复 □ 3. 增加 CLAUDE_MAX_TOKENS 到 16384 □ 4. 使用 /compact 压缩上下文释放空间 □ 5. 多文件任务分步请求 □ 6. 限制每次请求的输出范围 □ 7. /clear 后用简洁请求重新开始 □ 8. 注意模型的 max_tokens 上限 □ 9. CI/CD 中分步生成每个文件 □ 10. 流式响应也会被 max_tokens 截断6. 总结根本原因响应截断是因为输出达到了max_tokens上限stop_reasonmax_tokens最常见原因是默认 Token 限制过小40%和上下文占用过大30%最佳实践输出截断时输入继续从中断处恢复生成可能需要多次继续才能完成长输出预防措施在settings.json中设置maxTokens: 16384并使用/compact压缩上下文为输出释放空间分步策略将多文件生成任务拆分为单文件请求每次只生成一个文件避免单次输出过长最佳实践建议养成分步请求的习惯——先让 Claude Code 生成文件骨架和函数签名再逐步补充实现既能避免截断又能更好地控制代码质量故障排查流程图flowchart TD A[输出被截断] -- B[检查 stop_reason] B -- C{是 max_tokens?} C --|否| D[其他原因排查] C --|是| E[输入 继续 恢复] E -- F{输出完整?} F --|是| G[✅ 问题解决] F --|否| H{上下文是否过大?} H --|是| I[/compact 压缩上下文] H --|否| J[增加 maxTokens 设置] I -- E J -- K[settings.json: maxTokens 16384] K -- L[重启 Claude Code] L -- E F --|否, 多次截断| M[分步请求] M -- N[每次只生成一个文件/函数] N -- G D -- O{stop_reason?} O --|end_turn| P[输出已完整] O --|tool_use| Q[工具调用, 非截断] P -- G Q -- G