本页把「上下文与记忆」这个主题下散在各区的内容拢到一处,共 34 条。
上手指南
CCAF 考点
技巧文章(14)
- Claude Code 会话降本指南:让每个 token 都花在刀刃上官方博文要点摘要:解析 Claude Code 的 token 计价机制与提示缓存原理,给出 /clear、/compact、@-mention 等实操技巧,帮开发者降低长会话的使用成本。
- Claude 智能体开发的三种设计范式摘要 Anthropic 官方文章:如何设计 Claude 智能体的“脚手架”——何时精简工具与上下文管理、何时保留边界与守卫,以平衡智能、延迟与成本。
- Claude 5 时代上下文工程新规则:少即是多解读 Anthropic 官方文章,讲述 Claude Code 如何删除 80% 系统提示词后性能不降反升,以及给 Claude 5 系代模型做上下文工程的新思路。
- 打造高效的人机协作团队:Claude Code 四课Anthropic 官方文章总结:随着 Claude 从单点助手变为团队成员,如何通过透明信息、清晰角色、北极星目标与渐进信任打造高效人-智能体协作团队。
- Claude Code 最佳实践:官方使用技巧中文整理Anthropic 官方《Best practices for Claude Code》要点中文摘要:围绕「上下文窗口」这一核心约束,讲清楚验证、探索-计划-编码、精确提示、环境配置、会话管理与并行扩展六大类技巧。
- 彻底搞懂 Claude Code 的上下文窗口:谁在占位、怎么省 Token上下文窗口是 Claude Code 最关键的资源。本文梳理会话启动时自动加载了什么、各占多少 token、文件读取为何是大头,以及用 /clear、/compact、子代理等手段控制上下文、降低成本的实操。
- Claude Code 官方谈 Context Engineering:上下文工程要点摘要摘要 Anthropic 官方文章:为何上下文工程正取代提示词工程,以及 system prompt、工具设计、agentic search 与长任务上下文管理的实践建议。
- Claude Code 成本管控指南:追踪用量、团队限额与 Token 节省技巧从 `/usage` 追踪 token 用量、为团队设置限额,到精简上下文、选对模型、用 Hooks 预处理数据,全面掌握 Claude Code 的成本管控方法。
- Claude Code Checkpointing:会话回退与上下文压缩实用指南Claude Code 内置检查点机制,每次 prompt 前自动记录文件状态;通过 /rewind 菜单可按需回退代码、对话或精准压缩指定区段的上下文,适合大规模重构和调试场景。
- Claude Code 自定义子代理(Subagent):隔离上下文、限定工具、控成本子代理是有独立上下文与工具权限的专职助手。本文讲清它解决什么问题、内置的 Explore/Plan/general-purpose、如何在 .claude/agents/ 用 YAML frontmatter 定义、各字段含义,以及自动委托与 @agent- 显式调用的准确语法。
- 用代码执行调用 MCP:让 Claude 代理更省 tokenAnthropic 官方博客提出用代码执行取代直接工具调用来使用 MCP,通过 TypeScript 文件树、渐进式加载和执行环境内过滤,大幅降低上下文消耗。
- Claude Code 自定义状态栏:实时盯住上下文用量、成本与 Git状态栏是底部一行可自定义的脚本输出,通过 stdin 收到 JSON 会话数据。本文讲 /statusline 一键生成、settings.json 的 statusLine 配置(type/command/padding)、stdin 里可用的 model/workspace/cost/context_window 字段,以及 jq 内联示例。
- Claude Code 大型代码库配置指南:聚焦上下文、减少 token 浪费官方指南摘要:通过分层 CLAUDE.md、claudeMdExcludes、Read deny 规则、代码智能插件、稀疏 worktree 和按目录 Skills,把 Claude 聚焦在当前任务涉及的代码上,避免上下文窗口被无关内容填满。
- Claude Code 提示词缓存:哪些操作会让缓存失效Claude Code 自动管理 prompt caching。本文讲清缓存按前缀匹配的原理、会让缓存失效的操作(切模型/换 effort/开 fast mode/compact/升级等)、5 分钟与 1 小时 TTL,以及如何看命中率。
参考手册(6)
- Claude 输出一致性提升技巧参考整理 Claude 官方指南:通过指定格式、预填回复、示例约束、检索接地等技巧,让 Claude 的输出更加一致、可控。
- 减少 Claude 幻觉的官方参考整理 Claude 官方指南中减少模型幻觉(hallucination)的基础与进阶技巧,包括允许不确定、引用溯源等方法。
- Claude API 引用(Citations)功能参考整理 Claude API 文档级引用功能:文档来源类型、引用对象字段、流式事件与限制,便于开发者查阅。
- Claude 扩展思维(Extended Thinking)参考整理 Claude 手动扩展思维模式的 budget_tokens 配置规则、交错思维、缓存交互及向自适应思维迁移的完整参考。
- Claude 批处理 API(Message Batches)参考Anthropic Message Batches API 官方参考的中文整理:端点、字段、状态枚举、限流与批处理定价一览。
- 定义成功标准与构建评估参考整理 Claude 官方「定义成功标准与构建评估」参考页,涵盖标准设计原则与六类示例评估的实现模式。
Agent SDK(11)
- Agent SDK 参考:Agent Loop(智能体循环)工作原理介绍 Claude Agent SDK 中智能体循环的消息生命周期、工具执行、上下文窗口管理与控制选项,附 TypeScript/Python 对照表与代码示例。
- Agent SDK 会话管理:continue、resume 与 fork介绍 Claude Agent SDK 中会话(session)的持久化机制,以及如何用 continue、resume、fork 在多轮对话、进程重启和跨主机场景中恢复或分支会话。
- Agent SDK 会话外部存储(SessionStore)参考介绍 Claude Agent SDK 的 SessionStore 接口,如何将会话转录镜像到 S3/Redis/数据库等外部存储以支持多主机恢复会话。
- Agent SDK 输入模式:流式 vs 单条消息对比 Claude Agent SDK 的流式输入模式与单条消息输入模式的能力、限制及 TypeScript/Python 实现示例。
- Agent SDK:处理批准请求与用户输入(canUseTool)介绍 Claude Agent SDK 中 canUseTool 回调如何处理工具批准请求和 AskUserQuestion 澄清性问题,并给出 Python/TypeScript 完整示例。
- Agent SDK 实时流式输出指南介绍如何在 Claude Agent SDK 中启用 include_partial_messages/includePartialMessages 以实时接收文本增量与工具调用事件。
- Agent SDK 结构化输出(Structured Outputs)参考介绍如何用 JSON Schema、Zod 或 Pydantic 让 Claude Agent SDK 在多轮工具调用后返回经校验的类型化 JSON 数据。
- Claude Agent SDK Todo 任务追踪指南介绍 Claude Agent SDK 内置的 TodoWrite 与 Task 系列工具(TaskCreate/TaskUpdate/TaskList/TaskGet),及在消息流中监控任务进度的方法。
- Agent SDK 文件检查点(File Checkpointing)指南介绍 Claude Agent SDK 的文件检查点机制:如何启用、捕获 checkpoint UUID、回退文件到历史状态,以及其限制与常见故障排查。
- Agent SDK 故障排查:常见错误与修复方法Claude Agent SDK 官方故障排查页中文整理,按报错信息定位 CLI 启动失败与结构化输出为空等问题的原因与修复方法。
- Agent SDK 中的 Claude Code 功能加载指南介绍如何在 Agent SDK 中通过 settingSources 加载 CLAUDE.md、技能(Skills)、钩子(Hooks)等文件系统级 Claude Code 功能,并说明各功能适用场景。