上午把 Claude Code 挂在一个跑了三年的老项目上从表结构的字段约定聊到接口命名规范中途还纠正了它对时区处理的两处误解。午饭回来手一抖重启了会话第一句问它「刚才定的订单状态字段叫什么」得到的却是一个礼貌又陌生的猜测。这不是 Memory 文件写得不对多数时候是模型通道和 Key 先没跑稳请求 401、模型 ID 对不上、会话半路断流压缩和归档的钩子根本没机会触发。要先把这一层垫平可以打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册并创建一把 API KeyTaoToken 在这里只做统一通道把 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 的记忆不是一个文件而是一组按优先级叠加的文件。按加载顺序从高到低大致是这样层级典型位置是否进 Git适合放什么企业/托管策略系统级托管目录否组织级安全与合规红线用户级~/.claude/CLAUDE.md否个人偏好、通用工作习惯项目级project/CLAUDE.md是架构约定、目录说明、构建命令项目本地project/CLAUDE.local.md否本机路径、私有环境变量说明子目录级子目录内的CLAUDE.md视情况模块专属规则按访问路径加载优先级高的会覆盖优先级低的同名规则子目录级则是在模型真正访问到那个目录时才加载属于按需注入。把「团队都该知道」的内容放进项目级把「只有我这台机器才有」的内容放进项目本地级是最省事的划分方式。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_sourcetaotoken_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_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELYOUR_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_sourcetaotoken_aicg_blog_end 的控制台里重新创建一把来对照。模型不存在或模型 ID 无效。大概率是模型 ID 写错了。别按记忆手写去 https://taotoken.net/?utm_sourcetaotoken_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索引。这样即使哪天会话被压缩、被清空、被重启项目里那几条关键决策依然躺在文件里等着下一次会话读回来。