1. 长会话被截断先别急着换模型Claude Code 用久了你大概率会遇到这个场景前面聊得好好的突然它开始忘事——刚说过的文件路径记不住改过的函数又改回去甚至直接提示上下文超限。这不是模型变笨了而是上下文窗口被塞满了。Claude Code 的上下文窗口是有限的以 Claude Sonnet 4 为例大约 200K tokens听起来很多但一个 5000 行的文件就能吃掉 15K tokens再加上对话历史、系统提示、工具调用输出很快就会逼近上限。这个问题在长会话里特别明显。很多人习惯一个 Claude Code 窗口从早开到晚中间混着三四个不相关的任务上下文里堆满了已经完成的讨论。等到真正需要它处理新问题时可用的上下文空间已经被历史垃圾占满了。所以治理截断的核心思路不是换更大的模型而是控制进入上下文的内容量让每一轮对话都只携带必要信息。这篇内容面向正在用 Claude Code 做日常开发、遇到过长会话截断或响应变慢的开发者。我会先讲怎么定位截断触发点再给出/compact的使用时机、.claudeignore的排除规则、CLAUDE.md的精简骨架最后说明如何通过 TaoToken 统一 Key 接入让配置一次生效、多端共享。整套流程都可以直接复制粘贴跟做。2. TaoToken 前置统一 Key 与 API 通道在动手改配置之前先把接入层理顺。Claude Code 支持通过环境变量指定 API 通道这样你不需要在每个项目里重复配置也不会因为 Key 散落在多个地方而混乱。TaoToken 提供统一的 API 入口官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。你需要先拿到一个 API Key。登录后进入控制台在 API Keys 页面创建一个新 Key复制保存好。这个 Key 后面会写进 Claude Code 的环境变量里。如果你还没创建过可以直接访问 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 创建。拿到 Key 之后在终端里设置环境变量。macOS/Linux 用户编辑~/.zshrc或~/.bashrcWindows 用户在系统环境变量里添加export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的_TaoToken_API_Key设置完执行source ~/.zshrc让配置生效。这样 Claude Code 在启动时会自动读取这两个变量走 TaoToken 的通道。如果你同时用 CLI 和 IDE 插件它们共享同一份环境变量配一次就够了。注意不要把 Key 直接写进项目里的.claude/settings.json并提交到 Git。环境变量是更安全的做法项目配置文件只放与项目相关的行为设置。3. 可复制配置settings.json、.claudeignore 与 CLAUDE.md配置分三层全局行为、项目排除规则、项目指令骨架。三层配合才能把上下文占用压下来。3.1 settings.json 控制行为在项目根目录创建.claude/settings.json写入以下内容{ permissions: { allow: [ Read, Glob, Grep ], deny: [ Read(node_modules/**), Read(dist/**), Read(coverage/**), Read(*.lock), Read(*.min.js) ] }, env: { CLAUDE_CODE_MAX_OUTPUT_TOKENS: 8192 } }这里做了两件事一是用deny规则阻止 Claude Code 读取大体积的构建产物和依赖目录二是限制单次输出 token 数避免它一次性吐出过长内容把上下文撑爆。allow里保留Read、Glob、Grep三个基础读取能力够日常排查用。3.2 .claudeignore 排除大文件.claudeignore的语法和.gitignore一致放在项目根目录。一个前端项目的典型配置node_modules/ dist/ build/ coverage/ *.lock package-lock.json yarn.lock pnpm-lock.yaml *.min.js *.min.css test/fixtures/ __snapshots__/ *.log我试过在一个中型前端项目里加完这份配置Claude Code 的初始扫描从 8 秒降到 2 秒左右上下文占用少了将近 40%。原因是它不再去读node_modules里成千上万的小文件也不会把 lock 文件那几万行塞进上下文。3.3 CLAUDE.md 精简骨架CLAUDE.md放在项目根目录Claude Code 每次启动会自动读取。它的作用是减少你重复交代项目规范的次数。但很多人把CLAUDE.md写成了一本手册反而增加了上下文负担。精简骨架如下# 项目约定 ## 技术栈 - 语言TypeScript 5.x - 框架React 18 Vite - 测试Vitest ## 编码规范 - 使用 async/await不用 callback - 函数必须写 JSDoc 注释 - 提交信息用 conventional commits 格式 ## 目录说明 - src/services/ 业务逻辑 - src/models/ 数据模型 - src/api/ 接口封装 ## 禁止事项 - 不要修改 dist/ 和 node_modules/ - 不要引入新的全局状态库控制在 30 行以内。只写每次都要交代的内容项目结构细节让它自己用Glob去扫。如果你不确定怎么写可以让 Claude Code 自己生成初版claude 分析这个项目的代码结构、技术栈和编码规范生成一份精简的 CLAUDE.md控制在 30 行以内生成后你人工删掉冗余部分比从零写快得多。4. 验证请求上下文是否回落、截断是否消失配置改完得验证效果。分三步走。第一步确认环境变量生效。在终端执行echo $ANTHROPIC_BASE_URL应该输出https://taotoken.net/api。如果为空说明环境变量没加载检查~/.zshrc是否 source 过。第二步启动 Claude Code 并观察初始扫描。进入项目目录执行claude看它启动时读取了多少文件。加了.claudeignore之后它应该跳过node_modules和dist。你可以直接问它你刚才扫描了哪些目录有没有读取 node_modules如果它回答没有读取node_modules说明排除规则生效。第三步测试长会话截断。开一个新会话连续让它处理三四个文件然后执行/compact。观察压缩后的响应速度。如果之前响应要等 10 秒以上压缩后应该回落到 3 秒以内。再继续追问一个之前聊过的细节看它是否还记得。如果记得说明压缩保留了关键信息如果忘了说明压缩策略需要调整可以手动在/compact后补一句保留刚才关于 order.ts 的讨论。提示/compact不是越早用越好。它的触发时机是感觉响应变慢或开始遗漏之前信息的时候。如果对话还很短就压缩反而会丢失刚建立的上下文。5. 本篇常见错排查报错一ANTHROPIC_API_KEY未设置。Claude Code 启动时提示找不到 Key。检查环境变量是否写对注意变量名是ANTHROPIC_API_KEY不是ANTHROPIC_KEY。Windows 用户设置完要重启终端。报错二.claudeignore不生效。确认文件名是.claudeignore而不是.claudeIgnore且放在项目根目录。如果项目有多个子目录每个子目录的规则是独立的根目录的规则会向下继承。报错三/compact后上下文反而更乱。这是因为压缩时把关键信息也压掉了。解决办法是在压缩前手动把重要结论写进CLAUDE.md或一个临时笔记文件压缩后再让它读回来。报错四settings.json格式错误导致 Claude Code 启动失败。JSON 不允许尾随逗号检查每个键值对后面是否有多余的逗号。可以用cat .claude/settings.json | python -m json.tool验证格式。报错五IDE 插件和 CLI 配置不一致。两者共享工作目录下的.claude/settings.json但环境变量是各自读取的。如果你在 IDE 里配了 Key 但终端没配终端里就会报错。统一用环境变量最省事。6. 接入文档与后续动作配置骨架搭好之后日常使用还有几个习惯能进一步减少截断改完一个 bug 就/clear开新话题不要让不相关的讨论堆在同一个会话里提问时精确指定文件路径别说帮我看看这个项目而是说帮我看看 src/services/order.ts 里的错误处理复杂任务拆成指令链一次只让它做一件事。如果你在接入过程中遇到 Key 或通道相关的问题可以查阅接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。需要验证模型对话效果可以直接在模型对话页面测试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。长期做编码和 Agent 任务的话Coding Plan 更适合按量使用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。最后说一个我踩过的坑一开始我把CLAUDE.md写成了 200 行的项目百科结果每次启动上下文就被吃掉一大块反而更容易截断。后来砍到 25 行只留每次都要交代的规范截断频率明显下降。配置这东西少即是多。
