开工前先给结论Claude Code 确实值得用但如果不控制它的“探索欲”token 消耗会非常离谱。很多新手第一天装好工具第二三天看着账单上的 token 数字直线上升然后回来问“是不是我用法不对”。这篇文章就把“用法不对”这件事一次讲透。先说清楚Claude Code 不是简单地把 Prompt 发给 Claude它是让你的终端变成一个真正的编程 Agent。它能读项目、改文件、跑命令、看报错、自己重试理论上可以独立完成一个功能开发。这种能力很强但“自主”就意味着“费 token”——它会在你看不到的地方反复读文件、猜上下文、做无谓尝试。所以省 token 的核心不是找便宜渠道而是通过正确配置和用法减少无效计算。本文会从 Claude Code 的 token 消耗机制讲起带你完成安装、登录和基础配置然后给出六大经过验证的省 token 技巧CLAUDE.md 规则约束、ignore 黑名单、任务拆解、上下文清理、输出约束、会话管理。每个技巧都会给示例和配置最后附上常见报错排查包括很多人遇到的 token exchange failed 登录问题。如果你正在被 token 账单困扰或者准备入坑 Claude Code 但担心费用这篇文章值得收藏。1. 为什么 Claude Code 会烧掉大量 token很多第一次使用 Claude Code 的人都会有一个困惑我只是让它帮我改一个函数它回了一长串分析然后把整个文件重写了一遍token 就用掉一大部分。这背后的原因要从工具的工作方式说起。Claude Code 采用 agent 模式运行它不是一个“一次性问答”工具。它拿到你的需求后会经历这样的过程读取系统提示词和 CLAUDE.md 项目说明。扫描项目目录结构判断这是一个什么项目。读取相关源码文件理解现有逻辑。生成修改方案并对代码做局部或整体修改。自动执行测试或构建命令验证修改结果。如果验证失败读报错、排查、再次修改循环往复。每一步都会产生 token 消耗而且越到后面上下文窗口里积累的内容越多后续每轮请求的输入 token 都会持续膨胀。这个问题在长会话里特别明显对话到第 20 轮时即使你只是让它修一个小 bug它每次请求也要把之前所有对话历史、项目文件摘要、命令输出重新发送一遍。这是 Claude Code 省 token 的第一个认知基础你费的 token 中很大一部分不是“思考”费用而是“重新读上下文”的费用。第二个认知是Claude Code 默认倾向完整输出。你让它改一行代码它可能把“修改原因、修改步骤、完整 diff、验证建议”全部写出来。输出 token 同样要计费而且往往比输入 token 更贵。所以堵住“不必要的输出”和“不必要的上下文重复读取”才是省 token 的真正突破口。2. 基础概念token、上下文窗口与会话在继续实战之前先把三个基本概念理清。理解了它们后文的所有技巧才能成立。2.1 Token 是什么Token 是模型处理文本的最小单位可以简单理解为“半个词”或“几个字符”。在英文里一个单词通常对应 1 到 2 个 token在中文里一个汉字通常对应 1 到 2 个 token。模型按 token 数量计费所以“字数越少越省钱”在大多数情况下是对的。Claude 系列模型的计费方式是输入 token你发送给模型的全部内容包括系统提示词、历史对话、项目文件内容、工具返回结果。输出 token模型生成的所有内容包括分析过程、代码、结论。要特别注意的是输入 token 的计费单位是“往返次数”。在多轮对话中同一段历史会被重复发送每轮都重新计费。这就是为什么长会话会导致成本急剧上升。2.2 上下文窗口是什么上下文窗口是模型单次能处理的 token 总量。Claude 系列模型有不同档位有的支持 20 万 token 左右有的更小。窗口越大能一次性容纳的项目文件越多但单次请求的费用也越高。Claude Code 的任务就是把“足够重要”的内容装进窗口让你不需要人工逐段复制粘贴。但问题是模型并不总是能判断哪些内容值得读、哪些不值得读。于是它在你不设限的情况下倾向于多读、多存、多传。2.3 会话意味着什么在 Claude Code 里一次会话就是一次连续的交互过程从你执行 claude 命令开始到退出为止。会话期间所有历史都会被保留并参与后续计算。你可以在会话内继续提问、让工具做更多修改但这些都会持续占用上下文。理解会话机制后一个最简单的省 token 方法就出现了用完就退出别把会话一直挂着也别让它在无关话题上跑太久。3. Claude Code 环境准备与安装在谈论省 token 技巧之前先确保你能把 Claude Code 正常跑起来。下面是基于官方文档的常见安装流程以及我整理出的几个容易踩坑的点。3.1 安装前提Node.js 环境Claude Code 以 npm 包形式分发建议使用 Node.js 18 或更高版本。终端环境macOS、Linux、WindowsWSL 或原生终端均可。登录凭据需要 Anthropic 账号或 Claude 订阅并保证网络出口环境与账号政策一致。如果你在安装时发现 npm 下载慢可以临时切换 npm 镜像源但注意只在安装阶段使用。3.2 安装命令# 全局安装 npm install -g anthropic-ai/claude-code # 检查是否安装成功 claude --version终端里输入 claude 即可进入交互界面。首次运行时它会引导你完成登录授权。3.3 登录与授权正常情况下登录流程是claude终端会输出 https://claude.ai/login 这类链接浏览器打开后确认授权码然后回到终端确认。这个过程本身只消耗极少量 token。实际开发中登录环节最常见的问题是一类 token exchange failed 错误。这里先给一个速查报错关键字可能原因处理方向error code token_exchange_failed登录授权码过期、网络出口不稳定重新执行 claude 获取新授权码status 403 forbidden: country, region, or territory not supported网络出口区域与账号政策不匹配确认网络出口环境与账号支持地区一致token exchange failed: error sending request网络超时或代理异常检查网络连接确认代理规则是否把终端请求放行需要强调的是这里不做任何绕过平台限制的方案说明。如果你的账号和网络出口不符合服务条款正确做法是使用合规的网络环境而不是想办法“绕过”。3.4 使用入口Claude Code 主要有两种使用入口终端 CLI直接执行claude。IDE 集成VS Code 等编辑器插件可以在编辑器内直接唤起 Claude Code。两种入口底层都用同一个 CLI 核心配置规则和机制一致。这篇文章的示例以终端 CLI 为主。4. 核心流程拆解一次完整任务的 token 流向要真正省 token你需要“看见”一次任务里 token 都去了哪里。下面拆解一个典型任务的完整流程。假设你让它做一件事给现有项目新增一个用户注册接口。第一轮交互系统提示词固定值几万 token 级别按官方模型配置。CLAUDE.md 中的项目说明如果你配置了几百到几千 token。你的具体需求描述几十到几百 token。模型开始扫描目录读取后端入口文件、路由配置、数据库模型。这一轮结束可能已经消耗几千 token。如果你的项目结构很乱、入口文件被埋得很深模型会读更多文件来“定位”。第二轮交互模型给出一个实现方案。你要求修改一些细节。模型重新读取之前已经读过的文件结合新要求生成新代码。这个时候历史中第一轮的输入部分会继续保留下一轮请求会把“第一轮 第二轮”全部重复发送一遍。第三轮交互模型自动运行测试。测试失败报错信息被写入上下文。模型分析报错定位问题修改代码再次运行测试。此时上下文里已经累积了系统提示词、CLAUDE.md、你的需求、项目文件、模型的分析、报错输出、命令执行结果。只要不退出会话这些都会一直算钱。从上面对比可以看出真正烧 token 的场景有三个模型盲目扫描了大量无关文件。长会话历史持续重复累计。失败重试多次循环。所以我们的六大技巧全部围绕这三个场景来设计。5. 六大实用技巧把 token 成本降下来下面进入全文核心部分。每个技巧我都会讲清楚背后的原理、具体配置方法以及带来的效果。你可以按顺序操作也可以挑最戳中你痛点的先用起来。技巧一用 CLAUDE.md 约束项目上下文CLAUDE.md 是 Claude Code 的项目级指令文件。你可以把它理解成“给 AI 的入职手册”。很多人的 CLAUDE.md 只写了几行“这是某某项目”这远远不够。一段好的 CLAUDE.md 应该包含项目技术栈用什么框架、语言版本、包管理器。目录结构关键说明核心代码在哪里哪些目录不需要管。常用命令如何启动、如何测试、如何构建。编码规范命名风格、错误处理偏好、是否允许引入新依赖。明确禁令禁止修改哪些文件、禁止做什么操作。下面是示例# 项目用户中心服务 ## 技术栈 - Node.js 20Express 框架 - TypeScript 5.x使用 tsx 运行测试 - 数据库PostgreSQL通过 Prisma 访问 ## 目录结构 - src/api 存放路由定义 - src/service 存放业务逻辑 - src/model 存放数据模型定义 - prisma/schema.prisma 是唯一的数据库 schema 文件 ## 常用命令 - 启动开发环境npm run dev - 运行测试npm test - 类型检查npm run typecheck ## 编码规范 - 新接口必须写在 src/api 下并按照 feature 文件夹分组 - 错误处理统一使用 AppError不允许在 controller 层直接 throw 原生 Error - 不允许新增数据库字段时直接修改已存在的 migration 文件 - 公共类型放在 src/types 下 ## 禁止事项 - 不要修改 scripts/ 下任何文件 - 不要动 package-lock.json - 不要引入新的 HTTP 框架注意我用了“必须”“不允许”“禁止”这类强约束词它们对模型行为的限制效果比“尽量”“建议”好很多。有了这样的 CLAUDE.md模型在最初扫描项目时就会少读很多无关文件也不会在“是否需要测试”“代码放哪里”这种问题上反复纠结。你会发现它在第一轮交互中犯错的概率明显下降。预期收益一次会话中减少 20% 到 40% 的无效探索 token。技巧二用 .claudeignore 把无关文件挡在门外CLAUDE.md 是“告诉模型规则”.claudeignore则是“在文件层面直接挡掉”。很多项目里有大量模型不需要读的文件node_modules、dist、build、.git、package-lock.json、大型数据文件、Mock 数据、日志文件。如果不做限制模型在搜索代码时会扫描这些目录白白消耗输入 token。在没有 .claudeignore 时你可能会看到模型在读 package-lock.json 这种几千行的锁文件——它想在版本信息里找线索但实际上浪费了大量输入 token。在项目根目录创建.claudeignore# 依赖目录 node_modules/ vendor/ # 构建产物 dist/ build/ out/ *.min.js # 版本控制和元数据 .git/ .idea/ .vscode/ # 锁文件 package-lock.json pnpm-lock.yaml yarn.lock # 大型文件和测试数据 *.zip *.tar.gz *.sql test-fixtures/这个文件的作用是让 Claude Code 在文件搜索、目录扫描阶段就跳过这些内容。它不会出现在上下文窗口中。需要留意的是如果你有时确实需要 Claude 分析某些被忽略的文件可以临时在提示词里用明确路径引导它读取或者暂时把相关行注释掉。一般不会影响使用。预期收益对大项目尤其明显可能减少 30% 到 50% 的文件读取 token。技巧三任务拆解避免一次让 Agent 干太多事把一个大需求一次性丢给 Claude Code看似省事实际上是最费 token 的用法。原因很简单任务越大模型越容易中途出错出错后重试、上下文扩写、方案反复调整的成本会指数级上升。举一个常见的错误示范帮我写一个完整的用户系统包括注册、登录、JWT 鉴权、刷新 token、用户资料修改、头像上传、密码重置、邮件通知再写几个集成测试。如果这样提模型会尝试规划一个超大方案然后开始写。写到一半你发现它用的目录结构和你预期不符于是你得纠正它需要重新读上下文、重新设计。这种来回拉扯产生的 token 消耗远高于分步执行。更好的做法是把任务拆成多个小的、边界清晰的子任务先让 Claude 梳理现有代码结构输出摘要。再让它新增用户表定义和迁移文件。然后让它在 service 层写注册逻辑。接着让它在 controller 层增加注册接口。最后让它按给定测试用例编写单元测试。每个子任务执行完你确认无误后再进入下一个。这样模型不会迷茫上下文也不会因为“方案反复变化”而膨胀。这里有一个小技巧每次开始新子任务前如果你发现会话历史已经很长直接退出并重新打开一个新的会话让下一个任务从干净的上下文开始。新会话里只要告诉它“项目背景见 CLAUDE.md之前已完成 XXX 部分现在需要继续做 YYY”效果通常更好。预期收益减少失败重试和上下文反复累积整体节省 20% 到 50%。技巧四在提示词里写清“完成边界”和“不做什么”Claude Code 的模型默认有“尽力表现”的倾向它会在完成需求时自动补充“相关但你没有要求的东西”。例如你让它加一个接口它可能顺手帮你重构了同目录下的另一个文件还写了一大段 README 说明甚至还主动创建了测试。这些“额外动作”都会消耗输出 token而且输出的 token 通常比输入更贵对成本影响更大。解决办法是在提示词里明确“完成边界”。比如请新增一个用户注册接口要求如下 - 路由为 POST /api/register - 参数包含 username 和 password - 校验通过后调用 UserService.register() 保存数据 - 返回格式为 { code: 0, data: { userId } } 边界约束 - 只修改 src/api/auth.ts 和 src/service/user.ts 两个文件 - 不修改其他任何文件 - 不写 README - 不增加新依赖 - 不写单元测试 - 完成后不要输出分析总结只输出修改的文件列表和 diff 摘要注意“完成后不要输出分析总结”这句它直接把模型在结尾的“长篇大论”拦住了。模型喜欢在最后总结它做了什么、为什么这样做这些输出 token 其实没必要。如果你嫌每次敲这么多太啰嗦可以把常用边界约束放进 CLAUDE.md## 输出规范 - 完成代码修改后只输出修改文件列表和关键 diff不做大段总结 - 除了用户明确要求不新增无关文件 - 不主动重构已有代码 - 每次修改范围控制在用户指定的文件内预期收益输出 token 能减少 30% 到 50%这个技巧立竿见影。技巧五及时清理会话避免上下文无限膨胀前文提到多轮会话中旧内容会反复计费这是长会话成本高的核心原因。很多人在一个会话里连续工作一下午最后一轮请求的上下文包含了几万 token 的历史单次请求价格远远高于第一轮。省成本的做法是把会话当作“临时工作区”完成一个任务就清理一次。具体操作方式方式一完成任务后直接退出会话。# 保存并退出 Claude Code 交互 /exit方式二在新会话中重用关键背景不把旧历史带过来。# 新会话中用一句话描述项目背景 claude 项目是 Node.js Express数据库用 PostgreSQLCLAUDE.md 有完整说明。我已经完成了用户注册接口现在请继续做登录接口。除了手动退出还要关注会话内是否有需要清理的命令输出。Claude Code 执行命令后会把输出放入上下文但有些输出比如很长的 npm 日志对后续任务没有价值。如果你发现模型在后续对话里反复引用一段冗长的报错输出说明这些内容已经进入上下文此时可以考虑新开会话。需要澄清的是Claude Code 有上下文压缩能力会话很长时它可能会自动压缩历史。但压缩有代价模型可能丢失部分关键细节导致第 N 轮任务效果下降甚至引发二次返工。与其依赖压缩不如主动控制会话长度。预期收益长会话场景下单轮请求 token 可降低 60% 以上综合成本下降非常明显。技巧六利用配置和子代理为不同任务分配合适能力最后这个技巧来自 Claude Code 的模型配置和子代理机制。Claude Code 支持配置默认模型。如果你的任务比较简单比如改文案、改样式、写正则表达式不需要最强模型来处理可以配置更轻量的模型档位来执行成本会更低。如果你的任务是复杂的架构设计、代码审查再切换回更强的模型。这里我不列具体模型名称因为模型档位和可用性会随官方更新而变化。你可以在 Claude Code 内查看当前可用的模型/model这种“按任务分档”的思路对标的是大型团队里“资深工程师处理复杂任务、初级工程师处理日常任务”的分工逻辑。把简单任务交给合适的档位能有效降低成本。另一个机制是子代理subagent。Claude Code 可以将某些独立任务交给专用子代理去完成例如“重构一个工具函数”“生成一组测试用例”。子代理只在它自己的子上下文窗口内运行完成后把精简结果返回给主对话不会把子代理内部的详细推导历史全部塞进主上下文。这种“局部计算、局部丢弃”的设计本质上就是在控制 token 召回量。实际使用子代理时你不需要直接编写复杂配置。更常见的路径是把任务描述得足够独立、边界清楚Claude Code 会自动为其分配子代理执行。你只要注意不要在主对话里让代理同时处理多个互相纠缠的子任务把它们拆开交给独立执行即可。预期收益简单任务与复杂任务分流后整体 token 成本可再降 10% 到 30%。6. 综合示例一个省 token 的完整实践模板下面用一个小型 Node.js 项目演示如何把上面六种技巧组合成一套完整工作流。这个示例是通用的你可以替换成自己的技术栈。6.1 项目结构示例my-service/ ├── src/ │ ├── api/ │ │ └── user.ts │ ├── service/ │ │ └── user.service.ts │ └── index.ts ├── prisma/ │ └── schema.prisma ├── CLAUDE.md ├── .claudeignore └── package.json6.2 创建 CLAUDE.md# my-service 项目说明 ## 技术栈 - Node.js 20TypeScript - Express 框架 - Prisma ORM PostgreSQL ## 目录约定 - src/api 只放路由不写业务逻辑 - src/service 只放业务逻辑 - 新增表结构必须修改 prisma/schema.prisma ## 常用命令 - npm run dev 启动 - npm test 运行测试 - npm run typecheck 类型检查 ## 边界约束 - 不要修改 src/index.ts 的主进程代码 - 不要改 package-lock.json - 输出时只输出文件列表和 diff不要大段总结6.3 创建 .claudeignorenode_modules/ dist/ build/ .git/ package-lock.json npm-debug.log*6.4 启动新会话并提交一个子任务claude在交互界面中这样发起任务背景项目背景在 CLAUDE.md。 已有用户表 User 已存在包含 id、username、password。 任务在 src/service/user.service.ts 中新增 registerUser 方法接收 username 和 password对密码做 bcrypt 哈希后存入数据库。 约束只修改 src/service/user.service.ts 这一个文件。不写测试不加依赖完成后只输出 diff。6.5 验证输出正常情况下模型会先读取 CLAUDE.md 和 .claudeignore 之间没有被忽略的项目文件然后精确定位到目标文件生成修改。你会发现它不会去读 node_modules。它不会因为“想了解项目全貌”而读大量无关文件。它的输出被边界约束控制住不会长篇大论。如果在代码里出现关键错误你可以让它在当前会话做小范围修复运行 npm run typecheck 查看结果如果类型错误与本次修改相关请修复并继续。如果这个修复步骤涉及多轮而你发现上下文已经比较长建议退出会话重新用一句话描述当前进度再开新会话继续claude 项目是 my-service已完成 UserService.registerUser 方法现在运行类型检查并修复相关错误。项目背景在 CLAUDE.md。这个组合工作流是从新项目起步到日常功能迭代都比较通用的省 token 姿势。7. 常见问题与排查思路7.1 登录 token 相关错误问题现象可能原因排查方式解决方案sign-in could not be completed token exchange failed授权链接过期、网络连接不稳定回到终端重新执行 claude获取新授权码重新授权确保浏览器和终端网络环境一致token exchange failed: error sending request网络请求超时或网络出口异常检查终端能否正常访问外网修复网络连接检查代理规则是否拦截 claude 请求token endpoint returned status 403 forbidden: country, region, or territory not supported网络出口区域与账号支持区域不匹配确认当前网络环境的出口区域信息使用符合账号服务条款的网络出口环境your organization has disabled claude subscription access for Claude Code组织管理后台关闭了 Claude Code 权限查看组织的管理设置联系组织管理员开放 Claude Code 权限这里要特别提醒不要在登录阶段使用来路不明的第三方“token 中转”或“共享账号”服务。这类服务一方面可能泄露你的代码和对话内容另一方面容易触发账号风控最终导致更严格的限制。使用官方支持的订阅或 API 凭据才是稳妥路线。7.2 模型名与配置错误问题现象可能原因处理方式“xxx” is not a model this version recognizes当前 Claude Code 版本不支持你指定的模型名称升级 Claude Code或执行 /model 查看可用模型配置了外部模型但一直报错自定义模型接口路径或模型名不匹配核对接口路径、模型名和环境变量配置如果你通过配置环境变量接入第三方兼容接口例如社区常见的“Claude Code 接入 DeepSeek”做法要特别注意第三方接口是否与 Claude Code 的请求格式兼容。模型名称是否完全匹配第三方平台返回的模型 ID。接口延迟和速率限制是否够用。接入第三方接口可以帮助开发者在本地开发阶段体验不同模型但生产环境使用时必须评估合规性、稳定性和数据隐私风险不能盲目把内部代码发送到不受信任的端点。7.3 高额 token 消费的自我排查如果你已经跑了一段时间发现费用超出预期按下表逐项排查检查项判断标准优化动作CLAUDE.md 是否完善模型是否频繁问“这个项目怎么启动”“目录结构如何”补全 CLAUDE.md是否扫描了无关目录输出中是否出现 node_modules、lock 文件补全 .claudeignore是否单次任务过大模型是否多次中途改方案拆分任务提示词是否写明边界输出是否包含大段分析和额外修改增加边界约束会话是否过长同一会话是否持续数小时及时退出开新会话是否总用最强模型简单任务是否也用复杂模型执行按任务档位配置模型8. 工程最佳实践与安全边界省 token 不能以牺牲代码质量为代价。这里整理几条经过实践检验的工程建议。8.1 把 CLAUDE.md 纳入版本管理CLAUDE.md 和 .claudeignore 应该提交到 Git 仓库和代码一起管理。团队成员克隆项目后Claude Code 自动读取这些配置保证大家的 AI 使用体验和成本水平一致。如果项目有多个模块可以按模块建立更细的说明文件。8.2 在 CI 之外验证 Claude Code 的修改Claude Code 生成的代码进入仓库前必须经过人工审查和自动化测试。建议做法是让 Claude 在单独分支上完成修改。人工 review diff特别注意它改了哪些非目标文件。运行完整的测试和构建流程。确认无问题后再合入主分支。8.3 关注成本和密钥安全在实际项目中更推荐通过官方 API 方式使用 Claude Code这样消耗量、限流和费用都集中在可控的账号体系内。不要在代码仓库里提交任何密钥、token 或授权凭据Claude Code 配置中的敏感凭据应通过环境变量或本地配置管理工具注入。另外第三方中转 API 存在明显的安全风险你发给模型的代码、上下文和对话内容很可能被对方留作日志甚至被用于再训练或被泄露。内部项目和商业项目请谨慎评估。8.4 不同场景的成本控制优先级场景首要优化手段新项目探索用 CLAUDE.md 先定义清楚项目规则大型代码库维护.claudeignore 精准排除无关文件多轮调试每轮收敛上下文必要时新开会话日常小需求输出约束 轻量模型复杂架构任务任务拆解 先出方案再实施9. 总结与后续学习方向这六个技巧并不是孤立的小聪明它们的核心逻辑是统一的让 Claude Code 只做必要的事只看必要的文件只输出必要的内容。CLAUDE.md 减少探索成本。.claudeignore 减少无效读取。任务拆解减少失败重试。边界约束减少多余输出。会话管理减少历史累积。模型分流减少超额计算。如果你能把它们组合起来用token 成本下探的空间相当可观。尤其是长会话多轮调试的场景很多人的浪费不是来自“模型不够聪明”而是来自“让模型在一个越来越臃肿的上下文里做原本一次就能完成的事”。下一步的实践路径建议是先花十分钟写出你自己项目的 CLAUDE.md 和 .claudeignore这可能是投入产出比最高的一步。然后跑一个完整任务观察它读取了哪些文件、输出了哪些内容再根据观察结果调整边界约束。最后再针对会话管理和模型配置做优化。Claude Code 这类 Agent 工具正在快速迭代版本更新可能带来新的命令、新的配置项和新的模型能力。保持关注官方变更说明比收藏一堆过时教程更有价值。如果你在实际使用中遇到了其他坑欢迎在评论区补充我会持续更新这份排查清单。