/context 深度核查 v2.1.195 · 已交叉核查 · Claude Code

本页目录11

Slash 命令看官方文档

可视化当前上下文使用情况和优化建议

Syntax

/context

深度使用指南

最近核查 2026-06-27

· 来源 5 个

code.claude.comCommands — Claude Code Docs
code.claude.comDebug your configuration — Claude Code Docs
code.claude.comExplore the context window — Claude Code Docs
wmedia.esClaude Code Context Window: Track Token Usage with /context — wmedia.es
thesciencetalk.comClaude Code Context Window Explained — thesciencetalk.com

· 含官方文档· v2.1.195已交叉核查

它到底是什么

/context 是 Claude Code 的会话内诊断命令，展示当前 session 中上下文窗口的完整占用情况，按类别分解：系统提示词、内存文件、skills、MCP tools 和对话消息。

官方文档将其定位为配置调试的第一步——当 Claude 未遵循某条指令或某个功能没有生效时，先运行 /context 确认相关文件是否已加载进上下文。

无平台或订阅计划限制说明（官方文档未提及）。

怎么触发 / 怎么使用

1. 基础调用

/context

输出当前 session 上下文窗口的分类占用明细。

2. 扩展参数

/context all

[all] 参数由用户提供为已知语法。截至本文撰写时，已访问的官方文档页面均未收录该参数的具体说明，此节内容暂省略，不作推测。

输出内容说明

根据官方 debug-your-config 文档，/context 按以下类别分解上下文占用：

类别	说明
`System prompt`	Claude Code 的核心行为指令，始终首先加载
`Memory files`	CLAUDE.md 及 auto-memory 文件
`Skills`	已注册 skill 的描述文本
`MCP tools`	已连接 MCP server 的 tool 定义（含 deferred 条目）
`System tools`	内置 tool（Read、Edit、Bash、Grep、Glob 等）
`Messages`	对话历史、prompt、响应及 tool 调用结果
`Autocompact buffer`	系统预留的自动压缩缓冲区
`Free space`	当前剩余可用 token 数

上方类别名称来自第三方实测截图（thesciencetalk.com），官方文档仅列举前五类的文字描述，未提供完整枚举。

官方明确：/context 给出的是"a live breakdown by category with optimization suggestions"——不只是数字，还会附带优化建议。

逐段怎么读（哪些是"启动就占"的固定成本）

会话还没开始打字，前几类就已经吃掉一块上下文了（官方 context-window 时间线给出代表性 token 数，你的实际值看 /context）：

段	它装的是什么 / 怎么解读
`System prompt`	Claude Code 核心行为指令 + 环境信息（cwd / 平台 / git 状态）。还包含你的 `--append-system-prompt` 和 output style——这两样也算进系统提示。你永远看不到正文，但它是固定开销
`Memory files`	项目根 `CLAUDE.md` + auto memory（MEMORY.md 的前 200 行或 25KB，取先到者）。这块异常大通常是 CLAUDE.md 写太长
`Skills`	每个 skill 的一行描述（不是正文）。skill 正文只在真正调用时才加载；`disable-model-invocation: true` 的 skill 连描述都不在这里
`MCP tools`	已连 MCP server 的工具——默认只列工具名（deferred），完整 schema 按需经 tool search 加载。这段占比异常大，往往是某个 MCP server 把全量 schema 都塞进来了（见下方裁剪建议）
`System tools`	内置工具（Read/Edit/Bash/Grep/Glob…）。基本恒定，无需优化
`Messages`	对话历史、你的 prompt、Claude 响应、工具调用结果。随会话增长——`/compact` 主要压的就是这块
`Autocompact buffer`	系统给自动压缩预留的缓冲，不可回收
`Free space`	当前剩余可用 token。盯这个判断要不要手动 `/compact`

诊断思路：固定成本（system prompt / memory / skills / system tools / MCP 名）在第一条消息前就定型，增长成本只有 Messages。所以如果新 session 刚开就所剩无几，问题在固定成本（多半是 CLAUDE.md 或 MCP）；如果是聊久了才满，那是 Messages，/compact 即可。

跟同类原语对比

命令	作用	是否修改上下文
`/context`	可视化当前上下文占用，只读	否
`/compact`	将对话历史压缩为摘要	是（不可逆）
`/clear`	清空全部对话历史	是（不可逆）
`/memory`	查看已加载的 CLAUDE.md 和规则文件	否
`/doctor`	检测配置文件语法错误和 schema 问题	否
`/mcp`	查看 MCP server 连接状态和 tool 列表	否

/context 是这组命令中唯一给出全局 token 占用分布的命令；其他命令关注各自子系统的加载状态。

经典使用场景

调试配置不生效：CLAUDE.md 指令被忽略时，先跑 /context 确认文件是否出现在内存文件类别中，再用 /memory 深入查看具体路径。
决定是否 /compact：对话进行到一半时查看 Free space 余量，评估是否需要手动压缩，而不是等系统自动触发。
排查 MCP 占用过高：当 MCP tools 条目占比异常大时，用 /mcp 进一步确认每个 server 的开销（官方："Run /mcp to check per-server costs"），断开用不上的 server。MCP 工具 schema 默认就是 deferred 按需加载（只列工具名）；若你之前设过 ENABLE_TOOL_SEARCH=false（一次性加载全部 schema），把它去掉或改回 auto（仅当 schema 占比 < 上下文 10% 时才前置加载）能立刻省下一大块。
新 session 基线确认：session 启动后立即运行，了解在任何对话开始前上下文已被"静默占用"了多少。

「看 → 清 → 存」三步协作流（/context + /compact + /memory）

/context、/compact、/memory 是一组配合使用的诊断—治理工具，官方推荐的闭环：

看(/context)：先看哪一类在膨胀。Messages 大 → 该清对话；Memory files 大 → CLAUDE.md/MEMORY 太肥；MCP tools 大 → server 太多。
清(/compact 或 /clear)：Messages 撑爆时——继续同一任务用 /compact（必要时带 focus 指令保关键信息），切换任务用 /clear。
存(/memory)：发现"明明写过的规则 Claude 不遵守"，先 /memory 确认该 CLAUDE.md 是否真加载进来了（子目录 CLAUDE.md 启动时不加载、压缩后也会丢），再决定是否把规则上移到项目根 CLAUDE.md 让它跨压缩存活。

记忆法：/context 负责"看"，/compact+/clear 负责"清"，/memory+CLAUDE.md 负责"存"。

常见坑

把"加载了"误当成"有效果"：/context 能确认文件是否进入上下文，但无法判断 Claude 是否遵循其中的指令。文件出现在输出里但 Claude 仍然忽略某条规则，问题通常在指令的写法（过于模糊、互相冲突、文件过长）而非加载本身。
子目录 CLAUDE.md 不在输出中：子目录下的 CLAUDE.md 不在 session 启动时加载，只有当 Claude 用 Read tool 读取该目录下的文件时才按需加载，因此初次运行 /context 看不到它是正常现象，并非配置错误。

来源

全网调研整理

典型场景

长对话中途检查：会话运行较长时，确认哪个分类正在消耗大量 token，决定是否需要 /compact
MCP 优化前诊断：接入多个 MCP Server 后，确认工具定义实际占用的 token 比例，再按需断开
验证配置生效：启用 ENABLE_TOOL_SEARCH=auto 后，运行 /context 确认 MCP tools 已变为 deferred 状态
评估 CLAUDE.md 开销：检查 Memory files 分类占比，判断 CLAUDE.md 是否过于臃肿需要精简
判断是否需要开新会话：当 Free space 低于 30% 时，决定用 /compact 压缩历史还是直接 /clear

实用技巧

官方文档未单独说明 /context 的参数形式;早期资料提到的 /context all 展开 deferred 分类一说缺乏官方佐证,以 /context 无参数形式为准
可视化彩色方格随模型上下文大小自适应：200K 模型显示 10×10 方格，1M 模型显示 20×10 方格
autocompact buffer 约占 33k token（~16%）是系统预留不可用于对话，不要把它当做可用空间
MCP tools deferred 后该行会从 /context 输出中消失，这是验证 token 回收是否成功的最直接方法
将 CLAUDE.md 中的任务型流程拆分到 skill，skill 按需加载，可将 Memory files 基线开销显著降低
System prompt + System tools 合计约 15–20k token 属于固定开销，无法通过任何配置减少

常见坑

会话启动时系统已消耗约 20–25% 上下文，/context 显示的 Free space 并非全量可用空间
token 计数为近似值，与实际 API 计费可能有 1–2% 偏差，不应用于精确成本核算
上下文达到 60–70% 时模型性能已开始下降（重复输出、遗忘约束），而非等到 100% 才处理

来源

创建于

v1.0.86

变化时间线(按版本倒序)

修复v2.1.196· 2026/06/30 · 11 天前

修复在 Bedrock 上显示 0 tokens 的问题

改进v2.1.139· 2026/05/12 · 2026/05/12

现在显示 per-skill token 估计值和插件源信息

修复v2.1.133· 2026/05/08 · 2026/05/08

修复渲染的 ASCII 可视化网格浪费约 1.6k token

改进v2.1.121· 2026/04/28 · 2026/04/28

在 VSCode 中现在打开原生 token 使用对话框

修复v2.1.111· 2026/04/16 · 2026/04/16

修复网格渲染显示多余空行的问题

改进v2.1.110· 2026/04/16 · 2026/04/16

现在支持从 Remote Control 客户端调用

修复v2.1.101· 2026/04/11 · 2026/04/11

修复 `/context` 的释放空间和消息分解显示与标题百分比不一致的问题

改进v2.1.74· 2026/03/12 · 2026/03/12

新增actionable suggestions用于识别context-heavy工具、memory bloat和capacity warnings并给出优化建议

修复v2.1.69· 2026/03/05 · 2026/03/05

修复了 `/context` 为同一服务器中所有 MCP 工具显示相同 token counts 的问题。

修复v2.1.27· 2026/01/31 · 2026/01/31

修复彩色输出不显示的问题

修复v2.1.20· 2026/01/27 · 2026/01/27

修复某些命令（如 /context）的重复输出问题

修复v2.1.14· 2026/01/21 · 2026/01/21

修复 /context 命令在 verbose 模式下显示 token 计数和百分比不正确的问题

修复v2.1.14· 2026/01/21 · 2026/01/21

修复 /context 命令覆盖层意外关闭的问题

修复v2.1.0· 2026/01/07 · 2026/01/07

修复了 /context 命令在非交互模式下不尊重自定义系统提示，及修复了技能 token 估计

改进v2.0.74· 2025/12/20 · 2025/12/20

改进了命令可视化，通过来源分组技能和 agents，并按 token 数排序

修复v2.0.72· 2025/12/18 · 2025/12/18

修复了命令在非交互模式下不尊重自定义系统提示的问题

修复v2.0.30· 2025/10/31 · 2025/10/31

修复了因 thinking.budget_tokens 导致 max_tokens 检验失败的问题

改进v1.0.126· 2025/09/26 · 2025/09/26

在 Bedrock 和 Vertex 上启用了 /context 命令

新增v1.0.86· 2025/08/21 · 2025/08/21

新增 /context 命令帮助用户自助调试上下文问题。

本页目录11

Slash 命令看官方文档

可视化当前上下文使用情况和优化建议

Syntax

/context

深度使用指南

最近核查 2026-06-27

· 来源 5 个

code.claude.comCommands — Claude Code Docs
code.claude.comDebug your configuration — Claude Code Docs
code.claude.comExplore the context window — Claude Code Docs
wmedia.esClaude Code Context Window: Track Token Usage with /context — wmedia.es
thesciencetalk.comClaude Code Context Window Explained — thesciencetalk.com

· 含官方文档· v2.1.195已交叉核查

它到底是什么

官方文档将其定位为配置调试的第一步——当 Claude 未遵循某条指令或某个功能没有生效时，先运行 /context 确认相关文件是否已加载进上下文。

无平台或订阅计划限制说明（官方文档未提及）。

怎么触发 / 怎么使用

1. 基础调用

/context

输出当前 session 上下文窗口的分类占用明细。

2. 扩展参数

/context all

[all] 参数由用户提供为已知语法。截至本文撰写时，已访问的官方文档页面均未收录该参数的具体说明，此节内容暂省略，不作推测。

输出内容说明

根据官方 debug-your-config 文档，/context 按以下类别分解上下文占用：

类别	说明
`System prompt`	Claude Code 的核心行为指令，始终首先加载
`Memory files`	CLAUDE.md 及 auto-memory 文件
`Skills`	已注册 skill 的描述文本
`MCP tools`	已连接 MCP server 的 tool 定义（含 deferred 条目）
`System tools`	内置 tool（Read、Edit、Bash、Grep、Glob 等）
`Messages`	对话历史、prompt、响应及 tool 调用结果
`Autocompact buffer`	系统预留的自动压缩缓冲区
`Free space`	当前剩余可用 token 数

上方类别名称来自第三方实测截图（thesciencetalk.com），官方文档仅列举前五类的文字描述，未提供完整枚举。

官方明确：/context 给出的是"a live breakdown by category with optimization suggestions"——不只是数字，还会附带优化建议。

逐段怎么读（哪些是"启动就占"的固定成本）

会话还没开始打字，前几类就已经吃掉一块上下文了（官方 context-window 时间线给出代表性 token 数，你的实际值看 /context）：

段	它装的是什么 / 怎么解读
`System prompt`	Claude Code 核心行为指令 + 环境信息（cwd / 平台 / git 状态）。还包含你的 `--append-system-prompt` 和 output style——这两样也算进系统提示。你永远看不到正文，但它是固定开销
`Memory files`	项目根 `CLAUDE.md` + auto memory（MEMORY.md 的前 200 行或 25KB，取先到者）。这块异常大通常是 CLAUDE.md 写太长
`Skills`	每个 skill 的一行描述（不是正文）。skill 正文只在真正调用时才加载；`disable-model-invocation: true` 的 skill 连描述都不在这里
`MCP tools`	已连 MCP server 的工具——默认只列工具名（deferred），完整 schema 按需经 tool search 加载。这段占比异常大，往往是某个 MCP server 把全量 schema 都塞进来了（见下方裁剪建议）
`System tools`	内置工具（Read/Edit/Bash/Grep/Glob…）。基本恒定，无需优化
`Messages`	对话历史、你的 prompt、Claude 响应、工具调用结果。随会话增长——`/compact` 主要压的就是这块
`Autocompact buffer`	系统给自动压缩预留的缓冲，不可回收
`Free space`	当前剩余可用 token。盯这个判断要不要手动 `/compact`

跟同类原语对比

命令	作用	是否修改上下文
`/context`	可视化当前上下文占用，只读	否
`/compact`	将对话历史压缩为摘要	是（不可逆）
`/clear`	清空全部对话历史	是（不可逆）
`/memory`	查看已加载的 CLAUDE.md 和规则文件	否
`/doctor`	检测配置文件语法错误和 schema 问题	否
`/mcp`	查看 MCP server 连接状态和 tool 列表	否

/context 是这组命令中唯一给出全局 token 占用分布的命令；其他命令关注各自子系统的加载状态。

经典使用场景

调试配置不生效：CLAUDE.md 指令被忽略时，先跑 /context 确认文件是否出现在内存文件类别中，再用 /memory 深入查看具体路径。
决定是否 /compact：对话进行到一半时查看 Free space 余量，评估是否需要手动压缩，而不是等系统自动触发。
排查 MCP 占用过高：当 MCP tools 条目占比异常大时，用 /mcp 进一步确认每个 server 的开销（官方："Run /mcp to check per-server costs"），断开用不上的 server。MCP 工具 schema 默认就是 deferred 按需加载（只列工具名）；若你之前设过 ENABLE_TOOL_SEARCH=false（一次性加载全部 schema），把它去掉或改回 auto（仅当 schema 占比 < 上下文 10% 时才前置加载）能立刻省下一大块。
新 session 基线确认：session 启动后立即运行，了解在任何对话开始前上下文已被"静默占用"了多少。

「看 → 清 → 存」三步协作流（/context + /compact + /memory）

/context、/compact、/memory 是一组配合使用的诊断—治理工具，官方推荐的闭环：

看(/context)：先看哪一类在膨胀。Messages 大 → 该清对话；Memory files 大 → CLAUDE.md/MEMORY 太肥；MCP tools 大 → server 太多。
清(/compact 或 /clear)：Messages 撑爆时——继续同一任务用 /compact（必要时带 focus 指令保关键信息），切换任务用 /clear。
存(/memory)：发现"明明写过的规则 Claude 不遵守"，先 /memory 确认该 CLAUDE.md 是否真加载进来了（子目录 CLAUDE.md 启动时不加载、压缩后也会丢），再决定是否把规则上移到项目根 CLAUDE.md 让它跨压缩存活。

记忆法：/context 负责"看"，/compact+/clear 负责"清"，/memory+CLAUDE.md 负责"存"。

常见坑

把"加载了"误当成"有效果"：/context 能确认文件是否进入上下文，但无法判断 Claude 是否遵循其中的指令。文件出现在输出里但 Claude 仍然忽略某条规则，问题通常在指令的写法（过于模糊、互相冲突、文件过长）而非加载本身。
子目录 CLAUDE.md 不在输出中：子目录下的 CLAUDE.md 不在 session 启动时加载，只有当 Claude 用 Read tool 读取该目录下的文件时才按需加载，因此初次运行 /context 看不到它是正常现象，并非配置错误。

来源

全网调研整理

典型场景

长对话中途检查：会话运行较长时，确认哪个分类正在消耗大量 token，决定是否需要 /compact
MCP 优化前诊断：接入多个 MCP Server 后，确认工具定义实际占用的 token 比例，再按需断开
验证配置生效：启用 ENABLE_TOOL_SEARCH=auto 后，运行 /context 确认 MCP tools 已变为 deferred 状态
评估 CLAUDE.md 开销：检查 Memory files 分类占比，判断 CLAUDE.md 是否过于臃肿需要精简
判断是否需要开新会话：当 Free space 低于 30% 时，决定用 /compact 压缩历史还是直接 /clear

实用技巧

官方文档未单独说明 /context 的参数形式;早期资料提到的 /context all 展开 deferred 分类一说缺乏官方佐证,以 /context 无参数形式为准
可视化彩色方格随模型上下文大小自适应：200K 模型显示 10×10 方格，1M 模型显示 20×10 方格
autocompact buffer 约占 33k token（~16%）是系统预留不可用于对话，不要把它当做可用空间
MCP tools deferred 后该行会从 /context 输出中消失，这是验证 token 回收是否成功的最直接方法
将 CLAUDE.md 中的任务型流程拆分到 skill，skill 按需加载，可将 Memory files 基线开销显著降低
System prompt + System tools 合计约 15–20k token 属于固定开销，无法通过任何配置减少

常见坑

会话启动时系统已消耗约 20–25% 上下文，/context 显示的 Free space 并非全量可用空间
token 计数为近似值，与实际 API 计费可能有 1–2% 偏差，不应用于精确成本核算
上下文达到 60–70% 时模型性能已开始下降（重复输出、遗忘约束），而非等到 100% 才处理

来源

创建于

v1.0.86

变化时间线(按版本倒序)

修复v2.1.196· 2026/06/30 · 11 天前

修复在 Bedrock 上显示 0 tokens 的问题

改进v2.1.139· 2026/05/12 · 2026/05/12

现在显示 per-skill token 估计值和插件源信息

修复v2.1.133· 2026/05/08 · 2026/05/08

修复渲染的 ASCII 可视化网格浪费约 1.6k token

改进v2.1.121· 2026/04/28 · 2026/04/28

在 VSCode 中现在打开原生 token 使用对话框

修复v2.1.111· 2026/04/16 · 2026/04/16

修复网格渲染显示多余空行的问题

改进v2.1.110· 2026/04/16 · 2026/04/16

现在支持从 Remote Control 客户端调用

修复v2.1.101· 2026/04/11 · 2026/04/11

修复 `/context` 的释放空间和消息分解显示与标题百分比不一致的问题

改进v2.1.74· 2026/03/12 · 2026/03/12

新增actionable suggestions用于识别context-heavy工具、memory bloat和capacity warnings并给出优化建议

修复v2.1.69· 2026/03/05 · 2026/03/05

修复了 `/context` 为同一服务器中所有 MCP 工具显示相同 token counts 的问题。

修复v2.1.27· 2026/01/31 · 2026/01/31

修复彩色输出不显示的问题

修复v2.1.20· 2026/01/27 · 2026/01/27

修复某些命令（如 /context）的重复输出问题

修复v2.1.14· 2026/01/21 · 2026/01/21

修复 /context 命令在 verbose 模式下显示 token 计数和百分比不正确的问题

修复v2.1.14· 2026/01/21 · 2026/01/21

修复 /context 命令覆盖层意外关闭的问题

修复v2.1.0· 2026/01/07 · 2026/01/07

修复了 /context 命令在非交互模式下不尊重自定义系统提示，及修复了技能 token 估计

改进v2.0.74· 2025/12/20 · 2025/12/20

改进了命令可视化，通过来源分组技能和 agents，并按 token 数排序

修复v2.0.72· 2025/12/18 · 2025/12/18

修复了命令在非交互模式下不尊重自定义系统提示的问题

修复v2.0.30· 2025/10/31 · 2025/10/31

修复了因 thinking.budget_tokens 导致 max_tokens 检验失败的问题

改进v1.0.126· 2025/09/26 · 2025/09/26

在 Bedrock 和 Vertex 上启用了 /context 命令

新增v1.0.86· 2025/08/21 · 2025/08/21

新增 /context 命令帮助用户自助调试上下文问题。