跳转到主要内容

Claude Code 上下文、记忆、MCP 与 Context7:先修正确层级

长会话跑偏、跨会话丢规则和 Context7 查不到文档,需要修复不同环节。先确认窗口占用与规则加载,再按实际安装方式检查连接和认证。

LaoZhang AI Team发布于更新于 21 分钟阅读
文章目录
Claude Code 当前上下文、持久规则和 MCP 工具的排查路线示意。

Claude Code 开始“忘事”时,先看问题发生的时机。同一会话越聊越乱,先查当前上下文;新会话没有遵守项目规则,先查规则是否加载;Context7 连接失败或拿回错误文档,先查 MCP 配置与检索。 这三种问题都可能表现为回答不对,但修复动作不同。

Context7 的用途是获取库文档,memory MCP 的用途由具体服务器决定,两者都不会自动修好一个混乱的工作窗口。先用下面的入口定位,再修改对应环节:

你遇到的问题第一个检查接下来做什么怎样判断修复有效
长会话里混淆旧方案与当前任务/context 的占用分类缩小读取范围,带重点压缩;换任务时先交接再清空能准确复述当前目标,并接着完成下一步
新会话漏掉仓库规则/context 的 Memory files用 /memory 找到应编辑的位置;核对版本、文件与加载条件新会话显示所需文件,并在相关任务中按规则执行
MCP 没出现、待审批或连接失败claude mcp list、claude mcp get context7、/mcp检查作用域、启用状态、传输类型和认证状态正常,并有一次成功工具返回
Context7 连得上却查错文档实际工具调用的库 ID、版本和查询内容指定正确库与版本,缩小问题返回来源支持当前版本与所问 API

/context、/memory、/mcp 在 Claude Code 会话里输入;claude mcp ... 是终端命令。本文按 2026 年 10 月 6 日的公开文档说明操作,示例只做了离线语法与配置检查,没有在真实账号上安装插件、登录或调用 Context7。

长会话跑偏:先缩小当前工作窗口

按长会话、规则加载和 Context7 连接分别选择检查入口的示意。

当前上下文包含指令、读过的文件、对话和工具返回。/context 可以显示实时分类与优化建议;不要凭“已经聊了很久”猜测窗口,也不要把文档示意图里的 token 数当成自己的测量值。Claude Code 上下文说明

如果 Claude 把已经否决的方案重新拿出来,先让它复述当前目标、已决定事项和下一步。复述有误就明确纠正,随后再压缩,而不是把错误版本压进摘要。可以在会话中输入:

/compact 保留当前目标、已确认的方案、正在修改的文件、已完成的检查和未完成事项;明确标注已否决方案,不把它们写成下一步。

压缩后问一个具体问题,例如“接下来要改哪个文件,为什么?”检查答案是否保留了刚才确认的边界。若仍混淆多个任务,把当前状态写成简短交接记录,再用 /clear 切换到干净会话。交接记录应写清目标、文件、现状、尚未验证的事项和下一步,不能只留下“继续修 bug”。/clear 适合切换无关任务;清空前,尚未保存的重要信息要先留下来。压缩与清空的官方说明

如果刚压缩完,下一次工具调用又把窗口填满,重点查这次返回:是否读了整份日志、所有数据库行或完整网页?把请求改成“只给失败时间段的错误类型、数量和三条样例”,需要更多时再取。大量旁支文件也可交给独立子代理读取,让主会话接收结论与文件位置。

压缩会总结对话,并重新注入部分磁盘内容。根目录指令和无路径限制的规则会重新加载;子目录指令与按路径生效的规则则按需加载。只在聊天里说过的一次性细节可能在摘要中丢失,所以稳定规则应保存为指令,当前进度应保留为交接记录。压缩后哪些内容保留

新会话丢规则:分清持久指令和自动记忆

用 /context 确认文件加载,用 /memory 管理文件。 /memory 列出可编辑的位置,列表也可能包含尚未创建的文件;它出现了一个路径,并不证明该文件已加载。Claude Code 记忆文档

这两类持久内容也要分开:

内容适合保存什么不应指望它完成什么
人工维护的项目指令,如 CLAUDE.md 或满足条件的 AGENTS.md测试命令、代码约定、团队工作流程和必须持续遵守的边界代替权限配置,或保证模型绝不违反规则
自动记忆(auto memory)用户偏好、纠正反馈、无法直接从代码得知的项目背景、参考资料位置自动归档每轮聊天,或完整恢复所有历史会话

自动记忆当前区分 user、feedback、project、reference 四类内容。它会选择性保存有用经验,而不是把每次读取、每个修复和现有项目指令都再存一份。规则与经验别搞混:团队要求应由团队明确维护,不能只等 Claude 自行记住。自动记忆说明

规则文件存在,为什么仍没生效?

先从你实际启动 Claude Code 的目录检查:

  1. 在新会话运行 /context,查看 Memory files 是否包含预期指令文件。
  2. 用 /memory 找到对应位置,核对规则确实保存在那里,而不是只出现在旧聊天中。若是只对某个子目录生效的规则,先打开相关文件,再检查是否按预期加载。
  3. 文件已加载时,检查是否有互相矛盾的指令,以及规则是否足够具体。“代码写好一点”无法核验;“修改计费接口后运行 npm test”才有明确动作。
  4. 用一次相关任务验证行为。文件加载是必要证据,实际遵守是另一项结果;前者不能保证后者。

若项目用 AGENTS.md,还要看版本和配置。直接读取要求 Claude Code v2.1.277 或更高版本;默认只有启动目录及其上级没有项目级 CLAUDE.md 或 CLAUDE.local.md 时,才走 AGENTS.md。用户全局文件不属于这个阻挡条件。需要同时读两者时,在 /config 的 Project instructions 中选 claude-md-and-agents-md。AGENTS.md 加载条件

旧版本、相关内置插件被禁用,或部分升级后的首个会话可能不支持直接读取。旧环境需要兼容时,可以在项目 CLAUDE.md 中用以下导入,保留 AGENTS.md 作为同一份规则:

@AGENTS.md

这是放在指令文件中的内容,不是终端命令。修改后在新会话查看加载情况;不要把“请自行读取 AGENTS.md”这样的普通句子当成等价的自动导入。官方兼容方式

200 行限制到底限制哪个文件?

自动记忆的入口 MEMORY.md 在启动时读取前 200 行或 25 KB,以先达到者为准;专题文件按需读取。这不是所有记忆文件的统一上限,也不是 CLAUDE.md 超过 200 行就不加载。人工指令保持简短有助于减少窗口占用;自动记忆入口则应像索引,简要说明有哪些经验、何时读取对应文件。自动记忆的加载方式

同一台机器、同一 Git 仓库的子目录与 worktree 共享自动记忆目录,所以切换 worktree 不等于获得一份全新的自动记忆。它也不会自动同步到另一台机器。若换电脑后规则丢失,先区分团队随仓库保存的指令和机器本地的自动记忆,再决定需要同步哪一种。

MCP 异常:检查当前生效的配置,而非反复重装

MCP 提供外部工具与数据访问。工具名称、说明和返回结果都会影响 Claude 能看到什么,但 MCP 本身不是持久记忆开关。Context7 不在列表里、待审批和认证失败,应该分别处理。

在目标项目目录运行:

bash
claude mcp list
claude mcp get context7

然后在 Claude Code 中运行 /mcp。若服务器实际名称不同,把 context7 替换为列表中的名称。Added ... 只表示配置写入成功;列表和详情给出的状态才帮助判断下一步。当前版本还可能展示缓存的工具发现信息,显示工具数量并不等于当前查询已成功。MCP 管理与状态说明

状态或现象下一步
没有该服务器确认启动目录和安装方式;检查是否只配置在另一项目
Pending approval在交互会话审阅项目服务器配置,再决定是否批准
Rejected 或 Disabled for this project查看拒绝或禁用原因;需要使用时再在相应设置或 /mcp 中启用
Needs authentication按当前接入方式完成认证,不混用插件登录与手动 API key
Failed to connect查看详情中的原因,区分远程 HTTP 连接与本地 stdio 进程启动问题
not configured、URL 为空补上该接入方式要求的地址;这时客户端并未尝试连接

作用域也会改变你实际使用的配置:local 只针对当前项目且保存在用户本地,project 写入可共享的 .mcp.json,user 面向该机器上的所有项目。同名服务器通常按 local > project > user > plugin > claude.ai 选择整条配置;组织托管配置还有更高优先级。它不会把一个作用域的 URL 与另一个作用域的认证头合并。作用域与优先级

因此,“全局 key 已改好,但当前项目仍失败”可能是本地同名条目遮住了它。先看实际条目和来源,只修改有问题的那份。已经安装 Context7 插件时,也不必再添加一套手动服务器来碰运气。先确认需要保留的连接方式;删除远程服务器还会删除该条目保存的 OAuth 信息,不能把删除重加当成第一步。

Context7 怎么安装、登录并确认文档可用?

Context7 查询当前库文档,不负责保存你的项目规则。接入时先选一种方式;如果已经装过,先查清现有方式再修复。

插件:连接托管服务,用浏览器登录

在 Claude Code 中分别输入:

/plugin marketplace add upstash/context7
/plugin install context7@context7-marketplace

安装后重启 Claude Code,运行 /mcp,选择 Context7 并完成浏览器登录。插件连接 https://mcp.context7.com/mcp,提供 resolve-library-id 和 query-docs,不要求本地 Node.js、npm 或 npx,也不要求你填写 API key。Context7 的 Claude Code 插件说明

当前插件不读取 CONTEXT7_API_KEY。 因此,为插件反复导出这个变量再重启,不会把插件切换成 API key 接入。若登录或使用账户不对,应检查插件的认证状态;如果确实需要 API key,应使用下述 setup 或手动配置路径。

setup:设备授权后选择 CLI 或 MCP

需要自动配置时,在终端执行:

bash
npx ctx7 setup --claude

这条路径通过 OAuth 设备授权,显示验证链接和短码,生成 API key,并安装相应 skill;过程中可选择 CLI 或 MCP 模式。验证链接可在其他设备打开,所以远程或 SSH 主机并不必然意味着不能完成这类授权。Context7 setup 说明

setup 安装的 skill 会在库文档问题中自动触发,不要求每次都写 use context7。不过,在排查“到底有没有调用”时,明确要求使用 Context7 有助于观察过程。CLI 模式和 MCP 模式不同:选了 CLI 后,不要只因为 /mcp 里没有对应条目就认定 setup 失败,应检查实际查询过程。Context7 使用说明

手动 MCP:明确 HTTP、API key 与作用域

已有 API key 且希望手动管理连接时,可以使用远程 HTTP。以下是公开文档命令的项目本地作用域示例,YOUR_API_KEY 是待替换占位符;不要把真实密钥提交到仓库或贴进共享日志:

bash
claude mcp add --scope local --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  context7 https://mcp.context7.com/mcp

local 不会写入团队共享的 .mcp.json。命令参数中的真实密钥还可能进入 shell 历史;团队共享配置更适合只保存环境变量引用。下面是合成的 .mcp.json 示例,合并进已有 mcpServers 时要保留其他条目:

json
{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer ${CONTEXT7_API_KEY}"
      }
    }
  }
}

这个示例要求启动 Claude Code 的进程已取得 CONTEXT7_API_KEY,变量值应由你的私有凭据管理方式提供。新建的项目配置还需在 Claude Code 中审阅批准。type: "http" 不能省略:只有 URL 的条目不等于有效的 Claude Code HTTP 配置。这里的环境变量是手动配置主动引用,与插件不读取同名变量并不矛盾。Context7 手动连接、Claude Code 环境变量展开

若需要手动 OAuth 连接,Context7 为支持 MCP OAuth 的 HTTP 客户端提供 https://mcp.context7.com/mcp/oauth;本地 stdio 则用 API key,不走这个 OAuth 地址。插件自带的登录流程无需照搬手动地址。已有 stdio 配置遇到进程启动错误时,检查本地可执行文件与参数;切换为官方远程方式可以避开本地 Node.js 启动依赖,但仍需正确认证。Context7 认证与传输说明

连上以后,用一次文档查询验收

安装成功、工具出现和文档被正确使用,是三个不同结果。先提出一个足够具体的问题,例如:

使用 Context7 的 /vercel/next.js 文档,核对 Next.js 15 App Router 的路由处理函数如何读取 cookies。先确认返回文档适用的版本,再给一个最小示例和来源;若无法确认版本,明确指出,不套用其他版本的接口。

这是验证用提示,不是一次已完成的在线测试。已知 library ID 时可以跳过 resolve-library-id;不知道时先确认 resolver 选中了预期库,再看 query-docs 的实际请求与返回。Context7 查询方式

验收时依次核对:

  • 请求是不是发给 Context7 的工具,而非只靠模型记忆回答。
  • 选中的库是否正确,返回材料能否确认所需版本。
  • 查询是否聚焦当前 API,返回的来源是否支持最终代码。

如果连接正常却选错库,修检索条件;如果版本无法确认,继续缩小范围或核对该版本的官方文档;如果工具返回认证或服务错误,回到连接与认证检查。回答里一句“已使用 Context7”不能代替工具结果。取回文档也不代表示例已在你的项目里运行过。

仍无法定位连接问题时,可用当前 CLI 的调试入口:

bash
claude --debug='mcp,startup' --debug-file /tmp/claude-context7-debug.log

类别过滤使用 = 形式。日志用于检查启动与 MCP 过程,分享前应删去凭据、私有路径和内容。当前文档给出的是 --debug 和 --debug-file;不要依赖旧教程中的 claude mcp logs context7 作为本流程必需步骤。CLI 调试参数

什么情况才需要外部 memory MCP?

如果需求只是“下一次会话也要遵守测试规则”,持久指令就能承担;如果是“不要再犯我纠正过的偏好错误”,先检查自动记忆;如果是“查库的当前 API”,用文档检索。重复执行的方法可以写成 skill,大范围调查可以交给独立子代理。它们承担的任务不同,没必要都交给一个记忆服务器。

当你需要多台机器、多种工具或多人检索同一批持续变化的事实,而现有文件与同步方式无法满足时,外部 memory MCP 才值得评估。例如,让团队查询某项决策的出处和当前状态,而不是让每个人各自维护一份本地笔记。是否采用,还要看具体服务器保存什么、谁能读取、如何修改和删除,以及返回内容是否足够小。

可以先限定一种事实做试点:保存决策及来源,不保存密钥或整段原始对话;用几个明确查询检查能否拿回正确记录,修改后能否得到新内容,删除后能否停止返回。这个验收验证的是所选服务器,不是 MCP 协议自动提供的能力。单纯增加检索量,并不能证明上下文更清楚。

留下排查记录也有助于下一次判断:

记录问题时机、窗口占用、记忆文件、MCP 状态与工具返回的清单示意。

记录必须分清的结果
/context 分类与 Memory files当前窗口占用、指令加载与实际遵守是不同证据
/memory 中的编辑位置文件存在、适用范围与是否加载分别确认
MCP 名称、作用域、状态、错误摘要写入配置不等于连接成功
Context7 库 ID、版本、请求与返回来源工具可用不等于文档正确,也不等于代码已运行
压缩前后的当前目标与下一步摘要保留了什么,尚有哪项信息需要重读

常见问题

Claude Code context 和 memory 是一回事吗?

context 是当前会话能处理的工作材料,持久指令和自动记忆加载后会成为其中一部分。当前窗口并不会自动转成完整的长期存储。判断“忘了”时,先区分同一会话跑偏与新会话没有加载所需内容。

/memory 列出了文件,就说明规则已加载吗?

不能。/memory 用于查看和编辑位置,其中可能包含尚未创建的文件。启动加载情况看 /context 的 Memory files;若是按路径生效的内容,还要在相关文件被读取时验证。记忆文件的官方说明

Claude Code 不读取 AGENTS.md 吗?

当前版本可以直接读取,但有条件:v2.1.277 起支持,默认会检查启动目录及上级是否已有项目级 CLAUDE.md 或 CLAUDE.local.md。需要同时加载时可在 /config 选择相应 Project instructions;不支持直接加载的环境可用 @AGENTS.md 导入。加载条件与兼容方式

Context7 插件的 API key 为什么没生效?

当前插件不读取 CONTEXT7_API_KEY,它在重启后通过 /mcp 的浏览器流程登录。需要 API key 时使用 npx ctx7 setup --claude 或手动 MCP 配置;先查实际接入方式,再检查对应认证。Context7 登录说明

Tool Search 能消除 MCP 的上下文占用吗?

不能。支持的模型和连接路径可以延后加载部分工具定义,但工具名称与说明仍可能占用启动上下文,调用结果也会继续进入窗口。使用代理或自定义模型路径时,是否支持延后工具发现需另行核对;大返回仍应靠过滤和分页处理。MCP Tool Search

每次跨会话忘记事情,都要装 memory MCP 吗?

不必。先确认内容是否保存、保存在哪种文件、是否在新会话加载。外部记忆适合现有本地机制无法满足的共享检索需求;安装新服务器之前,应能说清它要保存哪类事实,以及怎样检验取回、更新和删除。

参考来源6

本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月7日。

  1. 1.Claude Code 上下文说明code.claude.com/docs/en/context-window
  2. 2.Claude Code 记忆文档code.claude.com/docs/en/memory
  3. 3.MCP 管理与状态说明code.claude.com/docs/en/mcp
  4. 4.Context7 的 Claude Code 插件说明context7.com/docs/clients/claude-code
  5. 5.Context7 手动连接context7.com/docs/resources/all-clients
  6. 6.CLI 调试参数code.claude.com/docs/en/cli-reference
更多 Claude Code