# Claude Code 上下文窗口：理解、监控、优化

> 上下文用完，Claude 就失忆。学会管理上下文，避免关键时刻掉链子。

---

上下文窗口（Context Window）是 Claude Code 的核心限制。理解它，才能用好它。

Claude Code 默认有 **200K token** 的上下文窗口，可以通过 `opus[1m]` 或 `sonnet[1m]` 扩展到 **1M token**。

```
用户对话历史 + CLAUDE.md + Skills + MCP工具定义 + 文件内容 = 上下文
```

---

## 一、什么是上下文窗口

### 定义

上下文窗口是 Claude 一次能"看到"的最大文本量。超出这个限制，Claude 就会"遗忘"早期的对话内容。

### 为什么重要

```
你：帮我重构这个模块
Claude：好的，我来...（读取了 50 个文件）
你：继续
Claude：刚才我们在做什么？（上下文溢出，忘记了）
```

### 与普通聊天的区别

| 普通聊天 | Claude Code |
|---------|-------------|
| 只有对话历史 | 对话 + 文件 + 配置 |
| 上下文增长慢 | 读取文件迅速消耗 |
| 容易管理 | 需要主动监控 |

---

## 二、上下文消耗来源

### 主要来源

| 来源 | 典型消耗 | 说明 |
|------|---------|------|
| 对话历史 | 1-50K | 随对话轮数增长 |
| CLAUDE.md | 1-10K | 每次请求都带 |
| Skills | 0.5-5K | 按需加载 |
| MCP 工具定义 | 1-20K | 每个 MCP 都有定义 |
| 读取的文件 | 1-100K+ | 最大消耗源 |
| 子 Agent 结果 | 1-10K | 返回给主会话 |

### 隐形消耗

```
# 这些都在消耗上下文，你可能没意识到

- 每次说"继续"，上一轮内容被重发
- CLAUDE.md 写太长，每个请求都背着
- Skills 的 reference 文件被加载
- MCP 服务的工具列表
- 子 Agent 返回的详细报告
```

---

## 三、监控上下文使用

### 实时查看

```
/context
```

显示当前上下文详细分类和使用情况，包括优化建议。

```
/cost
```

显示当前 token 用量和费用估算。

### 扩展上下文

如果 200K 不够用，可以使用 1M token 上下文：

```
# 启动时指定
claude --model opus[1m]
claude --model sonnet[1m]

# 会话中切换
/model opus[1m]
```

适用场景：
- 大型代码库分析
- 长时间会话
- 需要读取大量文件的任务

### 使用建议

| 上下文 % | 状态 | 建议 |
|---------|------|------|
| 0-50% | 充裕 | 自由工作 |
| 50-70% | 注意 | 准备压缩 |
| 70-90% | 警告 | 立即 `/compact` |
| 90%+ | 危险 | 必须 `/clear` |

### 上下文警告信号

```
Claude 开始问"我们之前在做什么？"
Claude 重复之前说过的话
Claude 忘记之前的决定
/context 显示接近上限
```

---

## 四、上下文压缩

### /compact 命令

```
/compact
```

压缩对话历史，保留关键信息。

**压缩前后对比**：

```
压缩前：50 轮对话，80K token
压缩后：摘要 + 关键决策，15K token
```

### 什么时候压缩

- 上下文超过 70%
- 对话超过 30 轮
- Claude 开始"失忆"
- 切换到新话题前

### 压缩会丢失什么

```
保留：关键决策、重要结论、当前任务状态
丢失：详细讨论过程、失败尝试、闲聊
```

---

## 五、上下文清空

### /clear 命令

```
/clear
```

完全清空上下文，重新开始。

**什么时候用**：

- 上下文超过 90%
- 要开始完全不相关的新任务
- Claude 行为异常，需要重置
- 压缩后仍然不够用

### 清空后怎么办

```
1. 重新说明任务背景
2. 重新加载必要的 CLAUDE.md
3. 重新读取关键文件
```

---

## 六、减少上下文消耗

### 精简 CLAUDE.md

```
# 差
50 行的 CLAUDE.md，包含大量注释和示例

# 好
20 行的 CLAUDE.md，只有核心规则
```

### 使用子 Agent 隔离

```
# 差：主会话读取 50 个文件分析
你：分析整个项目的架构

# 好：子 Agent 分析，返回摘要
你：用子 Agent 分析项目架构，返回关键发现
```

### Skills 延迟加载

```yaml
# SKILL.md
---
disable-model-invocation: true
---
```

设置 `disable-model-invocation: true`，Skills 只在手动调用时加载。

### 分阶段工作

```
# 差：一次性读完所有文件
你：重构整个项目

# 好：分阶段，每阶段清空
你：重构认证模块（完成后 /clear）
你：重构支付模块（完成后 /clear）
```

---

## 七、高级技巧

### 上下文预算分配

```
默认（200K）：

CLAUDE.md：5K
Skills：5K
MCP 工具：10K
对话历史：30K
文件内容：150K

扩展模式（1M）：

CLAUDE.md：5K
Skills：5K
MCP 工具：10K
对话历史：100K
文件内容：880K
```

### 文件选择策略

```
# 差：读取整个目录
你：读取 src/ 下所有文件

# 好：指定关键文件
你：读取 src/auth/*.ts
```

### 对话精简

```
# 差：长篇大论
你：我昨天遇到了一个问题，当时我在做...然后我发现...所以我想...

# 好：直接说事
你：认证模块报错 401，帮我查原因
```

### 利用 Memory

Memory 不占用上下文，适合存储：

- 项目关键决策
- 个人偏好设置
- 重要的背景知识

---

## 八、常见问题

### Q: 为什么 /compact 后上下文还是很高？

A: 文件内容不会被压缩。只有对话历史会被压缩。

### Q: 子 Agent 会消耗主会话上下文吗？

A: 不会。子 Agent 有独立的上下文窗口。但子 Agent 返回的结果会消耗主会话上下文。

### Q: MCP 工具定义占用多少？

A: 每个 MCP 服务约 1-5K token，取决于工具数量。

### Q: 如何知道具体什么占用了上下文？

A: 目前没有官方工具。可以用 `/cost` 看总量，靠经验判断。

### Q: 200K 不够用怎么办？

A:
1. 使用 `--model opus[1m]` 或 `--model sonnet[1m]` 扩展到 1M token
2. 更频繁地 `/compact`
3. 分阶段完成任务
4. 使用子 Agent
5. 精简 CLAUDE.md

---

## 九、总结

### 核心原则

```
1. 监控：定期 /cost 检查上下文使用
2. 压缩：70% 时 /compact
3. 清空：90% 时 /clear
4. 预防：精简配置，分阶段工作
```

### 最佳实践

```
CLAUDE.md 保持精简（<200 行）
用子 Agent 处理大文件分析
对话直接，不啰嗦
切换任务前主动 /clear
Skills 设置延迟加载
```

### 上下文管理检查清单

```
□ CLAUDE.md 是否超过 200 行？
□ 是否有不必要的 Skills 自动加载？
□ 对话是否超过 30 轮？
□ 是否在读大文件前检查过上下文？
□ 是否在切换任务前压缩/清空？
```

---

## 参考

- Claude Code 上下文窗口文档 — https://code.claude.com/docs/en/context-window
- Claude Code 模型配置 — https://code.claude.com/docs/en/model-config
- Claude Code 官方文档 — https://code.claude.com/docs

上下文窗口（Context Window）是 Claude Code 的核心限制。理解它，才能用好它。

Claude Code 上下文窗口：理解、监控、优化

软件研发

人工智能

后端

开发工具

ClaudeCode上下文窗口管理指南：掌握200K-1M token容量限制，通过/compact压缩、/clear清空优化使用。监控/cost消耗，精简CLAUDE.md文件，利用子Agent隔离大文件处理。合理分配上下文预算，避免Claude"失忆"，提升AI协作效率。

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Claude Code 上下文窗口：理解、监控、优化-腾讯云开发者社区-腾讯云

Claude Code 上下文窗口：理解、监控、优化

Claude Code 上下文窗口：理解、监控、优化

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐