Claude Code 跨会话又“失忆”？TaoToken 供 Key 后 Memory 索引照旧跑

上午把 Claude Code 挂在一个跑了三年的老项目上，从表结构的字段约定聊到接口命名规范，中途还纠正了它对时区处理的两处误解。午饭回来手一抖重启了会话，第一句问它「刚才定的订单状态字段叫什么」，得到的却是一个礼貌又陌生的猜测。这不是 Memory 文件写得不对，多数时候是模型通道和 Key 先没跑稳：请求 401、模型 ID 对不上、会话半路断流，压缩和归档的钩子根本没机会触发。要先把这一层垫平，可以打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册并创建一把 API Key，TaoToken 在这里只做统一通道，把 Key 和 Base URL 交到你手上，Memory 索引怎么维护仍旧由 Claude Code 自己决定。

下面这套流程分成两半：一半是把通道接稳，让每次请求都能正常返回；另一半才是上下文工程本身——五层上下文模型、Memory 的五个落点、MEMORY.md 索引的写法、/status、/compact、/clear的分工，以及用 PreCompact Hook 在压缩前把关键决策自动存下来。两半都跑通，跨会话「失忆」才会真正缓解。

1. 一上午的决策，为什么重启会话就蒸发了

1.1 上下文窗口更像会议白板，不是硬盘

很多人对 Claude Code 的误解，是把它当成一个记得住所有事的助手。实际上每一次请求带过去的上下文，都是一块临时白板：这轮会话结束，白板擦干净，下一轮从零开始铺。你在会话里说过的「这个模块不要用 Lombok」「时间统一存 UTC」「列表接口分页参数叫 page_size」，这些内容如果没有落到磁盘上的记忆文件里，重启就等同于没说过。

白板还有一个容量上限，也就是 Context Window。会话越长，堆积的历史消息、文件读取结果、命令输出就越多，逼近上限时要么被迫压缩，要么被迫清空。压缩不是无损的，模型会用自己的话概括前面发生的事，概括过程里最先被牺牲的往往就是那些看起来很琐碎的约定——恰好这些约定又是项目里最容易踩坑的地方。所以「失忆」通常发生在两个时刻：会话重启，以及上下文压缩之后。

1.2 五层上下文模型：每次请求里到底带了什么

把 Claude Code 一次请求拆开看，大致可以分成五层，理解这五层有助于判断什么该写进记忆、什么不用管。

第一层是系统层，包含系统提示、工具定义、输出格式约束。这层由 Claude Code 自己组装，用户基本不参与，跨会话天然稳定。

第二层是记忆层，也就是CLAUDE.md、MEMORY.md以及它们索引指向的文件。这一层是唯一真正意义上的跨会话持久层，每次新会话都会重新读进来。你希望模型「永远记得」的东西，都该放在这一层。

第三层是会话层，本轮对话的消息历史。它随会话增长，也随会话消失，压缩时被概括的就是它。

第四层是工具层，模型调用工具（读文件、跑命令、查目录）得到的结果。这些结果同样占用上下文额度，而且是膨胀最快的部分，一次大文件读取可能顶得上几十轮对话。

第五层是任务层，当前这条指令和临时约束，比如「这次只改测试，不动生产代码」。它有效期极短，通常只覆盖当前任务，但优先级很高。

五层里只有第二层能扛住重启。所以上下文工程的本质，不是想办法让模型记住更多，而是把值得长期保留的内容从第三、四层搬运到第二层去。

1.3 通道不稳的时候，记忆根本没机会落盘

还有一个更靠前的坑：如果模型请求本身就失败，上面这些机制全都无从谈起。常见表现是会话跑到一半突然返回 401，或者换了个模型 ID 之后一直提示模型不存在，又或者长时间没有响应导致会话被中断。这类问题跟 Memory 写法无关，但会让人误以为是「AI 记性差」。

Claude Code 的压缩和归档动作大多依赖一次成功的模型调用，请求打不通，Hook 就不会触发，当天的决策就只留在那块被擦掉的白板上。所以正确的顺序是：先让通道能稳定收发，再谈记忆怎么组织。这也是为什么配置一节要放在 Memory 章节之前讲。

2. Memory 的五个落点：从企业级到会话级怎么摆

2.1 Claude Code 的五种 Memory 类型与加载顺序

Claude Code 的记忆不是一个文件，而是一组按优先级叠加的文件。按加载顺序从高到低大致是这样：

优先级高的会覆盖优先级低的同名规则，子目录级则是在模型真正访问到那个目录时才加载，属于按需注入。把「团队都该知道」的内容放进项目级，把「只有我这台机器才有」的内容放进项目本地级，是最省事的划分方式。

2.2 MEMORY.md 当索引用，不要当日记写

MEMORY.md的定位容易被搞错。它不该是长篇流水账，而应该是一张索引：只写「有哪些决策、存在哪个文件、什么时候定的」，具体内容放在被索引的独立文件里。这样做的好处是每次新会话读进来的只是索引，上下文占用小，需要细节时模型再去读对应文件。

一个可用的索引结构长这样：

# 项目记忆索引 ## 关键决策 - [订单状态字段命名](memory/decisions/order-status-naming.md) —— 统一用 status_code，禁止 state - [时区策略](memory/decisions/timezone.md) —— 存储一律 UTC，展示层做转换 ## 编码约定 - [接口返回结构](memory/conventions/api-envelope.md) - [分页参数命名](memory/conventions/pagination.md) ## 待确认 - [灰度开关是否走配置中心](memory/pending/feature-flag.md)

「待确认」这一节很值得留，它让下一次会话知道哪些结论还没定，避免模型把半成品当成既定事实。每次会话结束前，让 Claude Code 自己把当天新增的决策追加到索引里，是比较省力的维护方式，前提是会话本身没有因为通道问题中断。

2.3 在 settings.json 的 env 里把 Claude Code 指向统一通道

现在处理通道这一半。先去 TaoToken 注册账号，在控制台里创建一把 API Key，后面所有配置里的YOUR_API_KEY都替换成它。创建完顺手看一眼模型广场，把要用的模型 ID 记下来——配置里的模型 ID 以 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 模型广场当时列出的为准，不要凭印象手写。

Claude Code 的接入有两种写法，选一种即可。第一种是直接写进~/.claude/settings.json：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_MODEL": "YOUR_MODEL_ID" } }

第二种是走环境变量，适合临时切换：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_MODEL="YOUR_MODEL_ID"

注意两点。Base URL 是https://taotoken.net/api，末尾不要加/v1，加了会拼出重复路径导致 404。另外这个地址和官网落地页是两个用途：落地页用来注册、创建 Key、看模型列表和用量，接口地址只填进工具里，两边不要混。

如果手边有 CLI 习惯，也可以用官方命令行一次带齐参数：

npm install -g @taotoken/taotoken taotoken cc -k YOUR_API_KEY -u https://taotoken.net/api -m YOUR_MODEL_ID

改完配置要重启 Claude Code 才会重新读取settings.json。启动后用/status看一眼当前模型和 Context 占用，能读到模型名就说明通道通了。

3. /status、/compact 与 PreCompact Hook 的配合

3.1 用 /status 判断什么时候该压缩

/status是会话里最该养成习惯的一个命令。它会显示当前使用的模型、上下文占用比例、会话的基本状态。占用到五六成时心里就该有数：接下来的大文件读取、长命令输出都可能把它推到上限。

这里有个实用判断法：如果这一轮任务还需要大量读文件、跑测试，就早点压缩；如果只剩几句话能收尾，就让它自然结束。压缩动作本身也要消耗一次模型调用，通道不稳的时候压缩失败，会话会更乱。

3.2 /compact 和 /clear 的分工

两个命令经常被混用，其实职责完全不同。

/compact是有损压缩：把前面的对话概括成一段摘要，保留在当前会话的上下文里。它适合「这轮任务还没做完，但历史太长了」的场景。压缩之后模型对早期的细节记忆会变模糊，所以压缩前要把重要决策落到文件里。

/clear是清空重来：当前上下文全部丢掉，只保留重新加载的记忆文件。它适合「换一个完全不相干的任务」的场景。清空之后如果还需要旧结论，就只能靠MEMORY.md索引把它们找回来。

一句经验：/compact之前先落盘，/clear之前先确认索引写得够全。两个命令都不是补救措施，而是配合记忆文件的日常动作。

3.3 用 PreCompact Hook 在压缩前自动归档

靠人记得在压缩前手动存一遍，长期一定漏。Claude Code 的 Hook 机制可以在这件事上兜底：PreCompact钩子在压缩动作发生前触发，把当时的会话数据交给一个本地脚本处理。

在~/.claude/settings.json里加上 Hook 配置：

{ "hooks": { "PreCompact": [ { "matcher": "*", "hooks": [ { "type": "command", "command": "bash ~/.claude/hooks/archive-decisions.sh" } ] } ] } }

本地脚本负责把传入的数据原样存到归档目录，脚本本身不调用任何外部服务：

#!/usr/bin/env bash set -euo pipefail ARCHIVE_DIR="$HOME/.claude/memory/archive" mkdir -p "$ARCHIVE_DIR" STAMP="$(date +%Y%m%d-%H%M%S)" tee "$ARCHIVE_DIR/precompact-$STAMP.json" >/dev/null echo "archived to $ARCHIVE_DIR/precompact-$STAMP.json"

记得给它执行权限：chmod +x ~/.claude/hooks/archive-decisions.sh。归档下来的是原始数据，真正要写进MEMORY.md索引的，还是让 Claude Code 在下一次会话里读这些归档、提炼成条目。归档脚本只是保证「压缩前那一瞬间的信息不会凭空消失」。

注意 Hook 只在模型调用链正常时才会触发。Key 失效或者模型 ID 写错，压缩动作本身就跑不起来，更谈不上归档。所以每次调整完配置，先用/status确认通道，再依赖 Hook。

4. 验证跨会话：让新会话真的引用昨天的决策

4.1 一次可复现的验证流程

配好之后不要只看配置文件，跑一遍完整流程才算数。

第一步，在项目里新建一个约定明确的小任务，比如把某个接口的分页参数统一成page_size，让 Claude Code 做完，并明确要求它把这条约定追加进MEMORY.md索引、细节写进memory/conventions/pagination.md。

第二步，用/status确认 Context 占用和模型信息正常，然后退出会话，完全重启 Claude Code。

第三步，新会话第一句不要提任何背景，直接问：「我们这个项目列表接口的分页参数叫什么，为什么这么定？」如果它答出page_size并能指出索引里的文件位置，说明跨会话引用链路是通的。

第四步，故意触发一次压缩，比如让它读几个大文件后执行/compact，再去归档目录看precompact-*.json有没有新增文件。有文件，说明 Hook 生效。

4.2 排障：三类最常遇到的报错

401 / 鉴权失败。先确认ANTHROPIC_AUTH_TOKEN里填的是完整 Key，没有多余空格或者引号。如果是写进settings.json的，改完要重启 Claude Code；如果是环境变量，确认当前终端会话确实 export 了。Key 可以在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 的控制台里重新创建一把来对照。

模型不存在或模型 ID 无效。大概率是模型 ID 写错了。别按记忆手写，去 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 的模型广场复制当时的准确 ID。换模型之后 Context 表现可能有差异，压缩时机也要跟着调整。

404 或路径异常。检查ANTHROPIC_BASE_URL是不是被写成了https://taotoken.net/api/v1。正确写法是https://taotoken.net/api，末尾不带/v1，工具自己会拼后半段。

记忆不加载。先确认文件名大小写正确，项目级是项目根目录下的CLAUDE.md，本地私有的是CLAUDE.local.md。再看是否放在子目录里——子目录级记忆只在模型访问到那个路径时才加载，放在根目录的会话一开始读不到它。

5. 跑通之后回控制台对一下这次调用

通道和记忆都验证完，做两件收尾的事。先在 TaoToken 模型对话 里用同一把 Key 发一条测试消息，确认模型 ID 和 Base URL 的组合没问题——这一步能快速区分「是配置错了」还是「是 Claude Code 那边的问题」。然后回到 控制台 API Keys 看这次会话的调用有没有正常记上账，顺便核对用量，避免带着一把快耗尽的 Key 去跑长任务。

如果打算把 Claude Code 长期挂在日常项目上，压缩和归档会反复触发，调用量比偶尔问几句高不少，可以顺手看看 Coding Plan 的额度是否够用。环境变量和settings.json的完整字段说明在 Claude Code 接入文档 里，换成别的工具接同一把 Key 时对照着改就行。

最后提醒一句顺序问题：记忆文件写得多漂亮，都建立在请求能顺利返回的前提上。每次调整完通道配置，先用/status确认一遍，再让 Claude Code 去维护MEMORY.md索引。这样即使哪天会话被压缩、被清空、被重启，项目里那几条关键决策依然躺在文件里等着下一次会话读回来。