我们正在看的这段 Claude Code 升级说明，其实讲的不是一个简单的版本更新问题，而是一个非常典型的 Agent 工程问题，版本变了，system prompt 或 tool definitions 也跟着变，原来热着的 prompt cache 就不能照旧复用了。Anthropic 的 Claude Code 文档明确把Upgrading Claude Code放在会触发 cache invalidation 的动作里，并说明新版本通常会更新 system prompt 或工具定义，所以升级后的第一轮请求会从头重建缓存。(Claude)Claude Code 的特别之处在于，它不是一个只接收一句 prompt 的聊天壳子。每次我们在终端里发出一条新指令，它背后都会组装一个完整请求，把 system prompt、项目上下文、历史消息、工具结果、当前新消息一起发给模型。模型本身不会跨请求记住上一轮内容，所以 Claude Code 要不断把完整上下文重新提交，只是借助 prompt caching，把前面不变的部分交给服务端缓存复用。Anthropic 文档里讲得很直白，Claude Code 每次发送消息都会发起新的 API request，新内容追加在末尾，大部分请求内容和上一轮相同，prompt caching 正是为了避免重复处理这些没变的前缀。(