【Bug已解决】Claude: "context window exceeded" / Conversation too long — Claude 上下文窗口超限解决方案

1. 问题描述

Claude 对话过程中上下文窗口超限，无法继续对话：

# 上下文超限 $ claude --continue Error: context_window_exceeded Conversation has grown beyond the 200K token limit. # 或长对话中断 $ claude > "分析代码" > "修改这个" > "再修改那个" > ...（100 轮后） Error: Context limit reached. Please start a new conversation. # 或文件+对话超限 $ claude "分析 $(cat large_file.py) 然后修复" Error: Combined input exceeds 200000 tokens. # 或系统提示+对话超限 $ claude --system-prompt "$(cat large_prompt.txt)" --continue Error: Total context exceeds maximum.

这个问题在以下场景中特别常见：

• 长对话累积（--continue）
• 大文件分析
• 系统提示过长
• 多文件同时分析
• 代码生成累积
• 历史记录过大

2. 原因分析

原因分类表

3. 解决方案

方案一：开新会话（最推荐）

# 步骤 1：不用 --continue，开新会话 claude # 新会话 # 步骤 2：保存之前的讨论 claude "将之前的讨论总结保存到 docs/summary.md" # 步骤 3：新会话引用总结 claude "参考 docs/summary.md 继续" # 步骤 4：验证 claude --print "hello"

方案二：清除会话历史

# 步骤 1：清除当前会话 claude /clear # 步骤 2：或清除所有会话 rm -rf ~/.claude/sessions/* # 步骤 3：重新开始 claude "task" # 步骤 4：验证 claude --print "hello"

方案三：分块处理大文件

# 步骤 1：使用 head/tail 分块 claude "分析 $(head -n 200 src/large_file.js)" # 步骤 2：使用 grep 过滤 claude "分析 $(grep 'function' src/large_file.js | head -20)" # 步骤 3：使用 sed 提取 claude "分析 $(sed -n '1,200p' src/large_file.js)" # 步骤 4：分步分析 claude "第一步: 列出 src/large_file.js 的函数" claude "第二步: 分析第一个函数" # 新会话

方案四：精简系统提示

# 步骤 1：检查系统提示大小 wc -c system-prompt.txt # 步骤 2：精简到 < 4000 tokens # 只保留核心指令 # 步骤 3：使用简短提示 claude --system-prompt "代码助手" "task" # 步骤 4：或移除系统提示 claude "task" # 不使用 --system-prompt

方案五：使用更大窗口的模型

# 步骤 1：使用 200K 窗口 claude --model claude-sonnet-4-20250514 "task" # 步骤 2：或 Opus claude --model claude-opus-4-20250514 "task" # 步骤 3：减少 --max-turns 避免累积 claude --print "task" --max-turns 5 # 步骤 4：验证 claude --model claude-sonnet-4-20250514 --print "hello"

方案六：使用文件引用

# 步骤 1：不用 $(cat) 粘贴 # 错误: claude "分析 $(cat large_file.js)" # 正确: claude "分析 src/large_file.js 的前 200 行" # 步骤 2：让 Claude 自己读取 claude "读取 src/index.js 第 1-50 行并分析" # 步骤 3：分步引用 claude "分析 src/auth.js" claude "分析 src/api.js" # 新会话 # 步骤 4：验证 claude --print "读取 src/index.js" --max-turns 5

4. 各方案对比总结

5. 常见问题 FAQ

5.1 上下文窗口多大

• Sonnet/Opus/Haiku: 200K tokens

5.2 200K tokens 多少

约 150,000 英文单词，约 5,000-8,000 行代码。

5.3 --continue 为什么容易超限

每次 --continue 加载之前的全部对话历史，历史越长累积 Token 越多。

5.4 如何开新会话

claude # 不使用 --continue

5.5 如何清除会话

claude /clear # 清除当前 rm -rf ~/.claude/sessions/* # 清除所有

5.6 如何分块处理

使用head -n 200、grep、sed -n '1,200p'提取文件的一部分。

5.7 系统提示占多少

通常 500-5000 tokens。过长会挤占对话空间。

5.8 如何保存讨论

claude "将讨论总结保存到 docs/summary.md"

5.9 $(cat) 有什么问题

将整个文件作为命令行参数，可能导致上下文超限。

5.10 排查清单速查表

□ 1. claude 开新会话 □ 2. claude /clear 清除历史 □ 3. 保存总结到文件 □ 4. head -n 200 分块 □ 5. grep 过滤大文件 □ 6. 精简系统提示 < 4000 tokens □ 7. --model sonnet 200K 窗口 □ 8. --max-turns 5 减少累积 □ 9. 不用 $(cat) 粘贴大文件 □ 10. claude "读取文件" 让 Claude 自己读

6. 总结

1. 根本原因：上下文超限最常见原因是长对话累积（40%）和大文件分析（25%）
2. 最佳实践：开新会话（不 --continue），将讨论总结保存到文件
3. 分块处理：使用head -n 200、grep、sed提取文件部分
4. 精简提示：系统提示保持在 4000 tokens 以内
5. 最佳实践建议：让 Claude 自己读取文件（claude "读取 src/index.js"），不用$(cat)粘贴

故障排查流程图

flowchart TD A[上下文超限] --> B{是 --continue?} B -->|是| C[开新会话] B -->|否| D{是大文件?} C --> E[claude 新会话] E --> F[保存总结到文件] F --> G[claude 验证] D -->|是| H[分块处理] D -->|否| I{系统提示长?} H --> j[head -n 200 分块] j --> K[或 grep 过滤] K --> G I -->|是| L[精简提示 < 4000 tokens] I -->|否| M[使用大窗口模型] L --> G M --> N[--model sonnet 200K] N --> G G --> O{成功?} O -->|是| P[✅ 问题解决] O -->|否| Q[清除会话历史] Q --> R[claude /clear] R --> S[或 rm sessions/*] S --> G O -->|否| T[不用 $(cat)] T --> U[claude "读取文件"] U --> V[让 Claude 自己读] V --> G G --> W{成功?} W -->|是| P W -->|否| X[分步分析] X --> Y[每步新会话] Y --> P P --> Z[长期: 新会话 + 分块 + 文件引用] Z --> AA[✅ 长期方案]