1. 为什么你的 Claude Code 账单会失控如果你正在用 Claude Code 写代码大概率遇到过这种情况月初还觉得额度够用月中就开始收到用量告警月底一看账单 200 多美元。更让人困惑的是明明每天写的代码量没变为什么费用会越滚越高核心原因在于 Claude Code 的计费模型和普通聊天不一样。它不是按你说了多少字收费而是每次请求都要把 System Prompt、CLAUDE.md、历史对话、工具调用返回内容全部重新发一遍。也就是说第 10 轮对话的输入 Token可能是第 1 轮的十几倍。一个 30 轮的调试会话光历史上下文就能吃掉几十万 Token。我实测过一个典型场景一个中型 Node.js 项目不做任何上下文管理开发一个 REST API 功能模块单次会话消耗约 200K Token。按 Sonnet 定价折算接近 0.6 美元。如果一天做 10 个类似任务一个月就是 180 美元起步加上调试和重构250 美元非常正常。这篇内容聚焦三件事用 CLAUDE.md 控制固定开销、用 Prompt Cache 拿到缓存折扣、用/compact和/clear控制历史膨胀。目标是把月账单从 250 美元压到 50 美元量级同时不降低实际开发效率。适合个人开发者和小型团队尤其是那些每天都要和 Claude Code 打交道的人。2. TaoToken 前置把 API 入口和 Key 准备好在开始优化之前先确认你的 Claude Code 是通过什么方式接入模型的。如果你用的是官方订阅账单是固定的但如果你走 API 按量计费那上下文管理的收益会直接体现在账单上。TaoToken 提供统一的 API 入口Claude Code 可以通过配置ANTHROPIC_BASE_URL指向它来调用模型。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。你需要先拿到一个 API Key。进入控制台创建 Key 的路径是https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建后复制保存后面配置环境变量会用到。如果你还没决定用哪种接入方式可以先在模型对话页面测试一下模型响应是否正常https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。确认能正常对话后再配置到 Claude Code 里。对于长期编码和 Agent 场景Coding Plan 会更划算适合每天都有大量编码任务的开发者https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有 Claude Code 的完整配置说明。配置环境变量的方式很简单在~/.zshrc或~/.bashrc里加上export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的_API_Key然后source ~/.zshrc让配置生效。这一步做完Claude Code 的请求就会走 TaoToken 的入口后续所有 Token 消耗都能在控制台看到明细。3. 可复制配置CLAUDE.md 骨架与 settings.json3.1 CLAUDE.md 骨架控制在 150 行以内CLAUDE.md 是每次会话开始时都会加载的固定内容。写得越长每次请求的固定开销越大。黄金法则是控制在 150 到 200 行以内详细文档用引用按需加载。下面是我在用的骨架你可以直接复制修改# 项目上下文 ## 项目概览 - 技术栈Node.js 20 TypeScript Fastify - 包管理pnpm - 测试Vitest - 目录结构src/ 源码tests/ 测试docs/ 文档 ## 编码规范 - 使用 ES Module不用 CommonJS - 函数优先使用箭头函数除非需要 this - 错误处理统一用 Result 类型不抛异常 - 所有导出函数必须有 JSDoc 注释 ## 常用命令 - 开发pnpm dev - 测试pnpm test - 类型检查pnpm typecheck - 构建pnpm build ## 上下文管理规范 - 每次会话开始先运行 /context 检查上下文大小 - 上下文超过 50% 时完成当前任务后立即 /compact - 上下文超过 80% 时立即 /compact 或 /clear - 不要在一个会话里处理多个不相关的任务 ## 详细文档按需引用 - API 设计规范docs/api-standards.md - 数据库 Schemadocs/db-schema.md - 部署流程docs/deploy.md关键点详细文档不要直接写进 CLAUDE.md而是用docs/xxx.md的方式引用。Claude 只在你明确要求时才会去读这些文件平时不占用上下文。3.2 settings.json 中 Prompt Cache 相关配置Prompt Cache 的机制是如果请求的前缀和最近的请求完全相同这部分 Token 只收 10% 的读取费。这意味着 System Prompt 和 CLAUDE.md 越稳定缓存命中率越高省钱效果越明显。Claude Code 的配置文件在~/.claude/settings.json下面是我用的配置片段{ model: claude-sonnet-4-20250514, maxTokens: 8192, temperature: 0.3, cacheControl: { enabled: true, ttl: 5m, minTokens: 1024 }, contextManagement: { autoCompact: true, compactThreshold: 0.6, preserveRecentMessages: 5 }, ignorePatterns: [ node_modules/**, dist/**, build/**, .next/**, coverage/**, *.log, .env*, *.png, *.jpg, *.pdf ] }几个参数说明cacheControl.enabled开启 Prompt Cachettl设为 5 分钟适合连续编码场景。minTokens设为 1024低于这个长度的前缀不缓存避免小请求浪费缓存写入费。contextManagement.autoCompact开启自动压缩compactThreshold设为 0.6上下文用到 60% 时自动触发/compact。preserveRecentMessages保留最近 5 条消息确保当前任务的上下文不丢失。ignorePatterns等价于.claudeignore把依赖目录、构建产物、日志、环境文件全部排除。这一项对中大型项目能减少 50% 到 80% 的上下文消耗。3.3 .claudeignore 文件除了 settings.json 里的 ignorePatterns建议在项目根目录再放一个.claudeignore双保险# 依赖目录 node_modules/ .pnpm-store/ # 构建产物 dist/ build/ .next/ out/ # 缓存 .cache/ .turbo/ # 日志 *.log logs/ # 测试覆盖率 coverage/ # 环境文件 .env .env.local .env.*.local # 二进制和媒体 *.png *.jpg *.gif *.pdf *.zip # IDE .idea/ .vscode/Python 项目把依赖目录换成venv/、.venv/、__pycache__/、*.pyc即可。4. 验证请求与成功结果配置完成后需要验证两件事请求是否正常走通以及 Token 消耗是否真的下降。4.1 验证 API 接入在终端里用 curl 测试一下 TaoToken 的 API 是否可达curl -X POST https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: $ANTHROPIC_API_KEY \ -H anthropic-version: 2023-06-01 \ -d { model: claude-sonnet-4-20250514, max_tokens: 100, messages: [{role: user, content: 回复 OK 两个字母}] }如果返回里有content: [{type: text, text: OK}]类似的字段说明接入正常。4.2 用 /cost 对比优化前后在 Claude Code 会话里/cost会显示当前会话的 Token 消耗和估算费用。我实测的对比数据优化前不用 .claudeignore不压缩30 轮对话Input tokens: 187,432 Output tokens: 12,847 Cache hit: 0 tokens Estimated cost: $0.58优化后.claudeignore Prompt Cache /compactInput tokens: 42,180 Output tokens: 11,203 Cache hit: 35,600 tokens Estimated cost: $0.14单次任务从 0.58 美元降到 0.14 美元降幅约 76%。如果一天 10 个任务一个月按 22 个工作日算优化前约 127 美元优化后约 31 美元。加上调试和重构的额外消耗从 250 美元压到 50 美元量级是可达的。4.3 用 /context 监控上下文使用率/context会显示当前上下文的 Token 量和使用率。建议养成习惯每次会话开始先跑一次/context看到使用率超过 50% 就准备/compact超过 80% 立即/compact或/clear。# 查看当前上下文 /context # 输出示例 # Context usage: 62,340 / 200,000 tokens (31%) # Messages: 18 # Files in context: 74.4 用 /compact 压缩历史一个任务完成后历史对话就变成了沉默成本。/compact会把历史压缩成摘要通常能从 100K Token 压到 2K 到 5K。# 基础用法 /compact # 指定保留重点 /compact 保留已完成的功能列表、待处理的 bug#123、用户认证模块的设计决策注意/compact会丢失细节。如果还需要引用之前的具体代码先用/export导出备份再执行压缩。4.5 用 /clear 开启全新上下文切换到完全不相关的任务时用/clear清空所有历史/clear和/compact的区别/compact保留摘要适合同一任务的延续/clear完全清空适合切换到不同任务。5. 本篇常见错排查5.1 Prompt Cache 命中率低如果你发现/cost里 Cache hit 一直是 0通常是两个原因一是 CLAUDE.md 频繁修改每次修改都会让缓存失效二是请求间隔超过 TTL默认 5 分钟缓存过期。解决办法把 CLAUDE.md 的修改集中到会话开始前会话进行中不要改。如果任务间隔较长可以把ttl调到1h但要注意缓存写入费也会相应增加。5.2 /compact 后 Claude 忘记了关键信息/compact默认只保留 Claude 认为重要的内容可能丢掉你关心的细节。解决办法是在/compact后面明确指定保留重点/compact 保留数据库表结构变更、API 接口签名、未完成的 TODO 列表如果还是丢信息先用/export导出完整对话再压缩。5.3 .claudeignore 没生效检查两点一是文件是否在项目根目录二是 settings.json 里的ignorePatterns是否和.claudeignore冲突。Claude Code 会合并两处的规则但 settings.json 优先级更高。另外.claudeignore只影响 Claude 主动扫描文件的行为。如果你手动用引用了一个被忽略的文件Claude 还是会读它。5.4 模型切换后费用反而上升/model切换模型时要注意Opus 的单价比 Sonnet 高约 3 倍比 Haiku 高约 15 倍。如果你在简单任务上用了 Opus费用会飙升。建议80% 的日常编码用 Sonnet简单补全和重命名用 Haiku只有复杂架构设计才切 Opus。/model claude-haiku-4-20250514 # 简单任务 /model claude-sonnet-4-20250514 # 日常编码默认推荐 /model claude-opus-4-20250514 # 复杂架构5.5 /cost 显示的费用和实际账单对不上/cost显示的是当前会话的估算费用不含缓存写入费和一些工具调用的额外开销。实际账单以控制台为准。建议每周去控制台核对一次路径是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。5.6 上下文压缩后响应变慢/compact本身需要一次模型调用来生成摘要会消耗额外 Token。如果频繁压缩反而增加开销。建议在任务边界处压缩而不是每几轮就压一次。6. 把优化落到日常流程里配置只是第一步真正省钱的是日常习惯。我自己的流程是这样的每天开始工作前先/context看一眼上下文状态每个任务开始前明确告诉 Claude 本次任务范围任务完成后立即/compact保留关键信息切换到不相关任务时/clear清空。如果你还在用官方订阅建议先切到 API 按量计费这样每一分优化都能直接体现在账单上。接入方式参考 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有 Claude Code 的完整配置步骤。对于每天编码超过 4 小时的开发者Coding Plan 的性价比更高适合长期使用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。如果你还在犹豫用哪个模型可以先去模型对话页面测试一下响应质量https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。最后提醒一句不要为了省钱而删除.claudeignore让 Claude 看到更多文件。大多数时候更多信息不等于更好结果反而更贵。上下文管理的本质是让 Claude 只看到它真正需要的内容。
【Claude】Claude Code 上下文管理与 Token 省钱指南：用 CLAUDE.md 与 Prompt Cache 把月账单从 250 美元压到 50 美元
1. 为什么你的 Claude Code 账单会失控如果你正在用 Claude Code 写代码大概率遇到过这种情况月初还觉得额度够用月中就开始收到用量告警月底一看账单 200 多美元。更让人困惑的是明明每天写的代码量没变为什么费用会越滚越高核心原因在于 Claude Code 的计费模型和普通聊天不一样。它不是按你说了多少字收费而是每次请求都要把 System Prompt、CLAUDE.md、历史对话、工具调用返回内容全部重新发一遍。也就是说第 10 轮对话的输入 Token可能是第 1 轮的十几倍。一个 30 轮的调试会话光历史上下文就能吃掉几十万 Token。我实测过一个典型场景一个中型 Node.js 项目不做任何上下文管理开发一个 REST API 功能模块单次会话消耗约 200K Token。按 Sonnet 定价折算接近 0.6 美元。如果一天做 10 个类似任务一个月就是 180 美元起步加上调试和重构250 美元非常正常。这篇内容聚焦三件事用 CLAUDE.md 控制固定开销、用 Prompt Cache 拿到缓存折扣、用/compact和/clear控制历史膨胀。目标是把月账单从 250 美元压到 50 美元量级同时不降低实际开发效率。适合个人开发者和小型团队尤其是那些每天都要和 Claude Code 打交道的人。2. TaoToken 前置把 API 入口和 Key 准备好在开始优化之前先确认你的 Claude Code 是通过什么方式接入模型的。如果你用的是官方订阅账单是固定的但如果你走 API 按量计费那上下文管理的收益会直接体现在账单上。TaoToken 提供统一的 API 入口Claude Code 可以通过配置ANTHROPIC_BASE_URL指向它来调用模型。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点是 https://taotoken.net/api 。你需要先拿到一个 API Key。进入控制台创建 Key 的路径是https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建后复制保存后面配置环境变量会用到。如果你还没决定用哪种接入方式可以先在模型对话页面测试一下模型响应是否正常https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。确认能正常对话后再配置到 Claude Code 里。对于长期编码和 Agent 场景Coding Plan 会更划算适合每天都有大量编码任务的开发者https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有 Claude Code 的完整配置说明。配置环境变量的方式很简单在~/.zshrc或~/.bashrc里加上export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的_API_Key然后source ~/.zshrc让配置生效。这一步做完Claude Code 的请求就会走 TaoToken 的入口后续所有 Token 消耗都能在控制台看到明细。3. 可复制配置CLAUDE.md 骨架与 settings.json3.1 CLAUDE.md 骨架控制在 150 行以内CLAUDE.md 是每次会话开始时都会加载的固定内容。写得越长每次请求的固定开销越大。黄金法则是控制在 150 到 200 行以内详细文档用引用按需加载。下面是我在用的骨架你可以直接复制修改# 项目上下文 ## 项目概览 - 技术栈Node.js 20 TypeScript Fastify - 包管理pnpm - 测试Vitest - 目录结构src/ 源码tests/ 测试docs/ 文档 ## 编码规范 - 使用 ES Module不用 CommonJS - 函数优先使用箭头函数除非需要 this - 错误处理统一用 Result 类型不抛异常 - 所有导出函数必须有 JSDoc 注释 ## 常用命令 - 开发pnpm dev - 测试pnpm test - 类型检查pnpm typecheck - 构建pnpm build ## 上下文管理规范 - 每次会话开始先运行 /context 检查上下文大小 - 上下文超过 50% 时完成当前任务后立即 /compact - 上下文超过 80% 时立即 /compact 或 /clear - 不要在一个会话里处理多个不相关的任务 ## 详细文档按需引用 - API 设计规范docs/api-standards.md - 数据库 Schemadocs/db-schema.md - 部署流程docs/deploy.md关键点详细文档不要直接写进 CLAUDE.md而是用docs/xxx.md的方式引用。Claude 只在你明确要求时才会去读这些文件平时不占用上下文。3.2 settings.json 中 Prompt Cache 相关配置Prompt Cache 的机制是如果请求的前缀和最近的请求完全相同这部分 Token 只收 10% 的读取费。这意味着 System Prompt 和 CLAUDE.md 越稳定缓存命中率越高省钱效果越明显。Claude Code 的配置文件在~/.claude/settings.json下面是我用的配置片段{ model: claude-sonnet-4-20250514, maxTokens: 8192, temperature: 0.3, cacheControl: { enabled: true, ttl: 5m, minTokens: 1024 }, contextManagement: { autoCompact: true, compactThreshold: 0.6, preserveRecentMessages: 5 }, ignorePatterns: [ node_modules/**, dist/**, build/**, .next/**, coverage/**, *.log, .env*, *.png, *.jpg, *.pdf ] }几个参数说明cacheControl.enabled开启 Prompt Cachettl设为 5 分钟适合连续编码场景。minTokens设为 1024低于这个长度的前缀不缓存避免小请求浪费缓存写入费。contextManagement.autoCompact开启自动压缩compactThreshold设为 0.6上下文用到 60% 时自动触发/compact。preserveRecentMessages保留最近 5 条消息确保当前任务的上下文不丢失。ignorePatterns等价于.claudeignore把依赖目录、构建产物、日志、环境文件全部排除。这一项对中大型项目能减少 50% 到 80% 的上下文消耗。3.3 .claudeignore 文件除了 settings.json 里的 ignorePatterns建议在项目根目录再放一个.claudeignore双保险# 依赖目录 node_modules/ .pnpm-store/ # 构建产物 dist/ build/ .next/ out/ # 缓存 .cache/ .turbo/ # 日志 *.log logs/ # 测试覆盖率 coverage/ # 环境文件 .env .env.local .env.*.local # 二进制和媒体 *.png *.jpg *.gif *.pdf *.zip # IDE .idea/ .vscode/Python 项目把依赖目录换成venv/、.venv/、__pycache__/、*.pyc即可。4. 验证请求与成功结果配置完成后需要验证两件事请求是否正常走通以及 Token 消耗是否真的下降。4.1 验证 API 接入在终端里用 curl 测试一下 TaoToken 的 API 是否可达curl -X POST https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: $ANTHROPIC_API_KEY \ -H anthropic-version: 2023-06-01 \ -d { model: claude-sonnet-4-20250514, max_tokens: 100, messages: [{role: user, content: 回复 OK 两个字母}] }如果返回里有content: [{type: text, text: OK}]类似的字段说明接入正常。4.2 用 /cost 对比优化前后在 Claude Code 会话里/cost会显示当前会话的 Token 消耗和估算费用。我实测的对比数据优化前不用 .claudeignore不压缩30 轮对话Input tokens: 187,432 Output tokens: 12,847 Cache hit: 0 tokens Estimated cost: $0.58优化后.claudeignore Prompt Cache /compactInput tokens: 42,180 Output tokens: 11,203 Cache hit: 35,600 tokens Estimated cost: $0.14单次任务从 0.58 美元降到 0.14 美元降幅约 76%。如果一天 10 个任务一个月按 22 个工作日算优化前约 127 美元优化后约 31 美元。加上调试和重构的额外消耗从 250 美元压到 50 美元量级是可达的。4.3 用 /context 监控上下文使用率/context会显示当前上下文的 Token 量和使用率。建议养成习惯每次会话开始先跑一次/context看到使用率超过 50% 就准备/compact超过 80% 立即/compact或/clear。# 查看当前上下文 /context # 输出示例 # Context usage: 62,340 / 200,000 tokens (31%) # Messages: 18 # Files in context: 74.4 用 /compact 压缩历史一个任务完成后历史对话就变成了沉默成本。/compact会把历史压缩成摘要通常能从 100K Token 压到 2K 到 5K。# 基础用法 /compact # 指定保留重点 /compact 保留已完成的功能列表、待处理的 bug#123、用户认证模块的设计决策注意/compact会丢失细节。如果还需要引用之前的具体代码先用/export导出备份再执行压缩。4.5 用 /clear 开启全新上下文切换到完全不相关的任务时用/clear清空所有历史/clear和/compact的区别/compact保留摘要适合同一任务的延续/clear完全清空适合切换到不同任务。5. 本篇常见错排查5.1 Prompt Cache 命中率低如果你发现/cost里 Cache hit 一直是 0通常是两个原因一是 CLAUDE.md 频繁修改每次修改都会让缓存失效二是请求间隔超过 TTL默认 5 分钟缓存过期。解决办法把 CLAUDE.md 的修改集中到会话开始前会话进行中不要改。如果任务间隔较长可以把ttl调到1h但要注意缓存写入费也会相应增加。5.2 /compact 后 Claude 忘记了关键信息/compact默认只保留 Claude 认为重要的内容可能丢掉你关心的细节。解决办法是在/compact后面明确指定保留重点/compact 保留数据库表结构变更、API 接口签名、未完成的 TODO 列表如果还是丢信息先用/export导出完整对话再压缩。5.3 .claudeignore 没生效检查两点一是文件是否在项目根目录二是 settings.json 里的ignorePatterns是否和.claudeignore冲突。Claude Code 会合并两处的规则但 settings.json 优先级更高。另外.claudeignore只影响 Claude 主动扫描文件的行为。如果你手动用引用了一个被忽略的文件Claude 还是会读它。5.4 模型切换后费用反而上升/model切换模型时要注意Opus 的单价比 Sonnet 高约 3 倍比 Haiku 高约 15 倍。如果你在简单任务上用了 Opus费用会飙升。建议80% 的日常编码用 Sonnet简单补全和重命名用 Haiku只有复杂架构设计才切 Opus。/model claude-haiku-4-20250514 # 简单任务 /model claude-sonnet-4-20250514 # 日常编码默认推荐 /model claude-opus-4-20250514 # 复杂架构5.5 /cost 显示的费用和实际账单对不上/cost显示的是当前会话的估算费用不含缓存写入费和一些工具调用的额外开销。实际账单以控制台为准。建议每周去控制台核对一次路径是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。5.6 上下文压缩后响应变慢/compact本身需要一次模型调用来生成摘要会消耗额外 Token。如果频繁压缩反而增加开销。建议在任务边界处压缩而不是每几轮就压一次。6. 把优化落到日常流程里配置只是第一步真正省钱的是日常习惯。我自己的流程是这样的每天开始工作前先/context看一眼上下文状态每个任务开始前明确告诉 Claude 本次任务范围任务完成后立即/compact保留关键信息切换到不相关任务时/clear清空。如果你还在用官方订阅建议先切到 API 按量计费这样每一分优化都能直接体现在账单上。接入方式参考 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有 Claude Code 的完整配置步骤。对于每天编码超过 4 小时的开发者Coding Plan 的性价比更高适合长期使用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。如果你还在犹豫用哪个模型可以先去模型对话页面测试一下响应质量https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。最后提醒一句不要为了省钱而删除.claudeignore让 Claude 看到更多文件。大多数时候更多信息不等于更好结果反而更贵。上下文管理的本质是让 Claude 只看到它真正需要的内容。
