1. 会话是什么以及为什么它决定你用好 Claude Code 的上限1.1 会话不只是聊天记录它是上下文边界先聊一个很常见的误区很多人以为 Claude Code 的会话就是“打了一段字AI 回复一段字”和网页聊天框里的“会话”没区别。实际上在命令行 agent 工具里会话是一个更大的容器它装着项目当前的任务背景、你已经改过的文件、你跑过的命令、你让 agent 记住的约束甚至还包括子 agent 的执行状态。我经常把会话比喻成“工位”。你在办公桌上摊开图纸、螺丝刀、芯片和测试脚本这些东西共同构成你当前的工作上下文。如果随手乱放下一个任务找起来就费劲如果把整个桌面换掉之前的工作就得重来。Claude Code 的会话管理本质上就是帮你在终端里管理这个工位什么时候开始新会话什么时候接着上一个会话干什么时候清空重来都是有讲究的。对于刚接触 Claude Code 的人来说会话管理可能就是“退出重进”这么简单。但真正进入项目开发状态后你会发现会话边界直接决定了两件事第一agent 能回忆起多少有效信息第二上下文窗口什么时候爆掉。省着用、按任务边界切会话能显著提高项目效率。这篇文章就从实际操作出发把会话怎么开、怎么续、怎么清、怎么存、怎么和多个模型配合这几点讲透。1.2 会话模型背后解决的问题Claude Code 的会话模型本质上解决的是这三个问题。第一个是上下文污染。如果你把“修复登录接口的 bug”和“重构支付模块”放在同一个会话里agent 很容易把支付模块里的变量名、依赖关系带到登录接口的修复逻辑中看起来每个改动都说得通实际上代码风格和选型已经乱掉了。按任务边界开新会话就是为了保证每次对话都从清晰的背景开始。第二个是中断恢复。命令行工具最大的好处是随时能停但停掉以后工作流失望特别明显。Claude Code 把会话写入本地历史文件你退出终端后重新执行恢复命令上一轮的任务背景、已经执行的命令、待办事项都能接着回来。这不是简单的聊天记录回放而是把 agent 的“脑内状态”尽量重建出来。第三个是上下文经济性。大模型的上下文窗口再大也有耗尽的时候。会话管理配合压缩、清理操作可以让你在同一个任务里尽可能多干活而不是改了几轮文件就撞上上下文长度限制。所以在往下看具体操作之前请先记住这句话会话管理不是给你增加额外负担的它是帮你节省 token 和脑力的。带着这个思路后面每个操作你都会觉得顺理成章。2. 创建、恢复、清理核心会话操作实战2.1 新会话的正确打开方式在 Claude Code 里创建新会话最直接的方式是进入你的项目目录然后执行claude命令。注意这里有个小小的细节Claude Code 会把“你当前所在目录”作为一个重要信号。你在~/work/project-a下面启动会话agent 就会把整个项目目录视为可读范围你做文件操作、搜索、运行测试的时候它不会跑去project-b的目录里乱翻。我自己习惯给常用项目做个别名比如alias cc-webcd ~/work/my-web claude alias cc-servicecd ~/work/api-service claude这样每次开工不用先把路径敲一遍直接cc-web就进入对应项目的会话。如果你想在启动时明确限制 agent 能用的工具也可以加参数claude --allowedTools Edit,Bash,Grep这个命令的意思是这个会话只允许 agent 使用文件编辑、命令执行、代码搜索三类工具。我不是让你每次都加这个参数而是在遇到“只希望 AI 改某个模块别碰别的工具”的场景时可以这样快速界定边界。还有一个值得养成的习惯启动新会话前先确认仓库是干净的至少git status里没有一堆你没提交的改动。否则 agent 在分析项目状态时会把工作区里的半成品也纳入考虑导致判断偏差。我踩过这个坑最后发现 agent 基于一段未完成的代码做了一堆错误推断。2.2 恢复旧会话别让工作流断掉Claude Code 提供了两种恢复方式一种是根据交互式列表选择一种是用--continue直接跳回最近一次会话。执行claude --continue是最高效的恢复方式。它会读取当前目录下最近一次的会话记录然后把上下文重新灌入 agent。你不需要告诉它“我们刚才在改哪个文件”它自己知道。如果你想从多个历史会话里挑一个恢复可以这样操作在交互界面中按CtrlR或在输入框使用/resumeClaude Code 会弹出一个会话列表按时间倒序排列。选择对应编号之后agent 会加载那个会话的上下文你就能继续上次中断的工作。这里分享一个实操技巧中断任务前在会话里留下一句明确的“状态总结”比如当前已完成支付回调接口的重试逻辑已写完。下一步补上超时场景的测试用例。然后用CtrlC退出。等你过段时间再--continue恢复时agent 能非常高效地接续任务。原因很简单恢复会话会尽量重建上下文但“尽量”不等于“完美”一句清晰的进度标记相当于给 agent 做了个路标能大幅减少它摸索的时间。2.3 清空与冷却什么时候该用 /clear会话不是越长越好。当你在同一个会话里反复切换子任务或者 agent 明显开始“前言不搭后语”说明上下文已经积累了太多噪声。这时候该做的是清空会话但保留项目状态。在交互面板里直接输入/clear可以清空当前会话的上下文但不会删除磁盘上的历史记录文件。也就是说/clear 之后 agent 的“短期记忆”被重置但你之前的所有操作仍然留在~/.claude的会话历史里之后想要翻查还能找到。我个人的使用习惯是当会话里已经讨论了超过 5 个独立子问题时我会先让 agent 写一段总结然后执行 /clear再跟一句“基于刚才总结的背景我们继续处理 X”。这相当于把“工作台”整理了一下把最有价值的信息提炼出来丢掉杂乱的过程性内容。还有一个容易被忽略的操作/compact。它与 /clear 不同/compact 会把当前会话的核心要点压缩成一份摘要然后在此基础上继续对话。这样 agent 不会突然忘记之前的决定又不会因为上下文太长而变迟钝。根据我的经验在长会话中每 20 到 30 分钟做一次 compact比一直硬扛着对话到上下文耗尽要稳定得多。3. 会话存储机制历史文件、项目状态与恢复原理3.1 会话历史存在哪里Claude Code 在本地会维护一套会话历史目录存放在用户主目录下面的.claude文件夹中。每个项目对应一个以项目路径编码后的子文件夹里面是若干 JSONL 格式的会话文件。每行 JSON 对应一个消息交换包含用户输入、模型输出、工具调用记录等结构化信息。刚开始我可以完全不关注这个目录直到有一次我想从历史会话里找回一段被覆盖的代码配置。我直接用grep搜索历史目录里的 JSONL 文件在对应文件里找到了模型当时生成的完整内容这非常实用。如果你想从崩溃或误删后找回上下文这个目录是最后的保险。需要说明的是这个目录内部结构比较原始文件名也不是直白的人类可读名称。建议不要手工去改这些文件但你可以用tail或搜索工具去查看最近一段时间的会话内容这在排查问题时会很有用。3.2 --resume 的交互选择逻辑除了--continue跳回最近会话之外claude --resume也能打开会话历史列表但它更强调“让你主动选”。我一般在需要找回一周前某个会话时用这个命令。有个细节很多人容易忽略恢复会话时Claude Code 会校验项目路径。如果你从一个完全不同的项目目录执行恢复命令历史会话列表可能显示不出来。这其实是设计上的保护每个项目的会话是隔离的避免你在project-a里误恢复project-b的上下文。在做代码评审或者复盘的时候我会刻意保留会话编号。比如claude --resume 42如果你从历史列表里看到某个会话的编号之后想再次跳入就可以直接指定编号。这个操作对深度复盘特别高效省得每次都在交互列表里来回翻。3.3 会话与磁盘操作的边界聊到会话存储就必须提醒一个常见认知偏差会话历史不等于项目状态。Claude Code 的会话文件保存的是“你们聊了什么、工具调用了什么”而不是说它把整个项目快照存了下来。你该提交的代码还是要提交该写的文档还是要写会话记录只是辅助你重建工作记忆不能替代版本控制。我也经常这样用在会话里让 agent 生成一段关键逻辑但后来需求变了我需要回看之前版本。比起去翻 git 提交记录直接在这个项目的历史会话里搜索当时的生成结果往往更快因为会话里还保留着 agent 当时的解释和取舍理由。这也是持续可视化会话记录的核心价值。4. 多模型路由与 API 配置会话如何绑定不同后端4.1 在同一台机器上配置 DeepSeek、GLM 等多种模型很多人会问Claude Code 能不能直接换模型其实取决于你如何配置 API 路由。Claude Code 在运行时会读取环境中与 Anthropic 兼容的变量通过修改ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN你可以把请求路由到不同的兼容服务上。我看到很多使用场景是既想用主流的 Anthropic 模型做复杂重构也想在跑批量测试时用更便宜的国产模型降低成本。这种情况下直接在同一个会话里切模型不是一个稳定做法比较好的方式是通过 shell 函数隔离不同后端的会话。先解释一下环境变量配置。在 bash 或 zsh 里可以这样定义一个函数function cc-deepseek() { ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic \ ANTHROPIC_AUTH_TOKEN$DEEPSEEK_KEY \ claude $ }这个函数的意思是每次执行cc-deepseek时它会临时把 API 地址切到 DeepSeek 的 Anthropic 兼容端点同时使用你预先设置好的DEEPSEEK_KEY作为认证凭证然后启动 Claude Code。这样你不需要修改全局配置只需要多一个命令入口。类似的方法也可以接 GLMfunction cc-glm() { ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic \ ANTHROPIC_AUTH_TOKEN$GLM_KEY \ claude $ }这个方法背后有个重要机制环境变量是“会话级”的你以cc-deepseek启动的会话与用cc-glm启动的会话从初始配置上就已经区分开了。它们分别写入不同的历史记录恢复时也互不干扰。如果你的项目经常需要在不同模型提供商之间来回切换我会强烈建议给每个后端都配一个独立函数。4.2 会话与配置、环境变量的隔离策略除了模型路由配置文件本身也可以做到项目级隔离。Claude Code 允许在项目根目录或者用户目录下使用配置文件来管理权限、工具、习惯设置。如果你在多个项目里工作不同项目需要的工具范围和上下文策略可能不同。我个人的策略是把“通用配置”放在全局把“项目特殊约定”写在项目目录下的配置里。这样做有个明显好处你进入不同项目的会话时agent 自动加载不同约定。比如在文档站项目里我限制它不要执行构建在服务端项目里允许它运行测试命令。如果你同时要管理多个身份或者多个账号还可以考虑给不同用途做独立的环境变量文件。比如~/.claude/env-work.env和~/.claude/env-personal.env启动时用set -a; source ...; set a的方式读入。这种方式本质上是把“会话的环境”与“用户的默认环境”分开让你在终端里的工作场景更干净。5. 常见问题与排查技巧实录5.1 会话恢复后丢失上下文有读者反馈过执行claude --continue之后agent 好像不认识之前的代码了。这种问题最常见的原因是你恢复会话后没有停留在原项目目录。Claude Code 恢复时会绑定项目上下文如果你换了目录它自然找不到对应的会话记录。排查思路也很简单先确认当前工作目录是否和原会话一致然后用/resume打开会话列表检查是否存在多条同名会话。如果发现历史会话文件损坏或 JSONL 异常可以备份~/.claude/projects下的相关目录然后清理异常文件。5.2 上下文长度提醒频繁出现上下文越长模型处理越慢也越容易报长度限制。这不一定是你任务太复杂更多时候是会话里堆积了大量工具输出。尤其是执行Grep、Bash这类命令时输出结果可能非常长但并非每一行都重要。我的处理方式是三步走先试试/compact让 agent 把当前讨论压缩成摘要如果还不行就手动把关键代码和决定整理进一个NOTES.md然后/clear开新会话最后如果任务模型本身实在太大就考虑换更便宜的模型来跑中间步骤只在关键推理时切回强模型。5.3 常见问题速查表症状可能原因推荐操作--continue后不记得上下文目录变化或历史记录异常回到原项目目录用/resume选择对应会话长任务中途总提示上下文不足会话中工具输出过多/compact压缩或提炼总结后/clear新建会话不同项目之间会话串了全局配置或固定别名导致使用独立项目目录并区分别名入口切换模型后行为不一致环境变量没有生效检查ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN是否当前有效找不到历史会话文件~/.claude路径被修改检查 HOME 目录设置确保历史目录权限正常6. 我的日常会话管理习惯长期稳定实践总结会话管理做得好不好不体现在某一次操作的骚技巧上而体现在你连续工作一周后能不能快速找回状态。我自己的日常习惯是这样的。每天开工前我会先想清楚今天要推进的 2 到 3 个核心任务然后为每个任务开一个独立会话。比如上午修登录接口的 bug下午补支付模块的测试我会分别启动两个会话中间保持项目目录一致。这样做的收益是切换到下午任务时agent 不会把上午的变量命名风格、错误排查思路带过来。每次任务收尾我会在会话里让 agent 用几句话总结当前完成内容、遗留问题和下一步建议。这不是为了让 AI 写作文而是为了以后恢复会话时能快速重建工作记忆。就算隔了一周再处理相关问题我continue恢复后也几乎不需要重新铺垫背景。会话不是越多越好但也不要有意回避新建会话。我发现一个很实用的原则当一个会话里已经出现超过 3 次“你刚才不是说了吗”“这部分我们讨论过了”的来回就该警惕上下文疲劳了。这种时候哪怕你觉得任务还没完成也值得提炼一个状态摘要开个干净的新会话继续。最后谈一点工具层面的小经验。我很少清空整个.claude历史目录因为那些 JSONL 日志在关键时刻能救命。如果你担心隐私可以定期把不需要的历史归档到其他目录但如果你经常要在多个任务、多个模型、多个项目之间横跳本地历史就是你最可靠的记忆外挂。把会话管理当成工作流的一部分而不是偶尔用一下的辅助功能你对 Claude Code 的掌控感会完全不一样。