ARTICLE DETAIL

资讯详情

深耕商务建站与企业官网运营的一线实战洞察。

成本分组表,Anthropic API 的 Token 消耗按 TaoToken Key 归类

成本分组表,Anthropic API 的 Token 消耗按 TaoToken Key 归类 1. 成本负责人视角从 Anthropic 上市盈利讨论回到 Key 级成本归因成本负责人视角Anthropic 上市与盈利预期的讨论很热但多个内部项目调用 Anthropic API 时Token 到底算在哪个项目头上才是真问题。先到 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentcost-attr-intro拿 KeyBase URL 固定为 https://taotoken.net/api成本归因才能从“Key 维度”开始而不是月底按人头拍分摊。常见现场是Claude Code 的settings.json只写了ANTHROPIC_API_KEY没有写ANTHROPIC_BASE_URLCodex 的config.toml把 provider 指到默认地址搜索、数据标注、CI 机器人、个人脚本共用同一把 Key。于是 usage 里只有模型和时间没有项目和环境维度成本负责人只能看到总量却无法回答“谁该背这笔”。这篇把任务拆成四步设计成本分组表、到 TaoToken 创建按项目分组的 Key、分别配置 Claude Code 与 Codex、导出 usage 并生成按 Key 分组的成本表。这里先明确一个原则Token 消耗的最小归因单位不是模型而是 Key。模型决定单价Key 决定成本中心。只要多个内部项目共用一把 Key后面无论怎么做报表都只能做二次分摊无法做真实归因。所以成本分组表的第一列应该是 Key 别名而不是模型名或人员姓名。另一个容易被忽略的点是客户端差异。Claude Code 走的是 Anthropic 风格环境变量Codex 走的是config.toml的 provider 结构两者不能互相套用。把ANTHROPIC_*写进 Codex或者把 Codex 的model_provider配置塞给 Claude Code都会导致调用落到错误端点最终在 usage 里表现为“Key 没消耗但模型有量”或者“某个默认 Key 突然暴涨”。成本负责人要做的不是抓包而是先把配置纪律固化下来。2. 成本分组表长什么样Key、项目、环境、客户端四维模型一张能落地的成本表不建议直接从账单复制字段。账单字段是“平台视角”成本表要的是“组织视角”。建议先设计一张元数据表把 Key 和成本中心绑定再用 usage 导出做事实表。推荐字段如下字段含义填写规则cost_center成本中心例如搜索推荐组、代码助手组、数据平台组key_aliasTaoToken Key 别名必须唯一例如search-rag-prod-claude-01key_prefixKey 前缀从控制台导出或记录后四位便于核对client调用客户端Claude Code、Codex、本地脚本、CIenv环境prod、staging、devowner责任人成本负责人或项目负责人model模型 ID以 TaoToken 模型页展示为准input_tokens输入 Token从 usage 导出output_tokens输出 Token从 usage 导出cache_read_tokens缓存读 Token若导出包含则计入cache_write_tokens缓存写 Token若导出包含则计入estimated_cost折算成本单价以控制台或模型页为准Key 命名建议使用固定结构team-project-env-client-seq例如search-rag-prod-claude-01 search-rag-staging-claude-01>https://taotoken.net/apiClaude Code、Codex、CC Switch 中配置供应商时都使用这个 Base URL。不要额外拼接来源参数不要在不同客户端写不同地址。成本归因最怕的不是模型贵而是流量落到不同端点后usage 里出现多个相似但不可合并的 Key 标识。Key 创建完成后建议做一次最小验证。用模型对话入口确认 Key 可用再进入正式配置。模型对话入口放在文末 CTA 部分先不要急配置步骤还没结束。4. Claude Codesettings.json 中固定 ANTHROPIC_BASE_URL 与项目 KeyClaude Code 的配置核心是settings.json。成本负责人不需要改 Claude Code 源码只需要确保每个项目使用自己的 Key并且ANTHROPIC_BASE_URL指向 TaoToken。推荐把项目级配置放在项目目录的.claude/settings.json把默认配置放在用户目录的~/.claude/settings.json。项目级 Key 用于成本归因用户级配置用于兜底但不要让项目级 Key 被用户级 Key 覆盖。一个可复制的settings.json示例如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: YOUR_API_KEY, ANTHROPIC_MODEL: claude-sonnet-4-5-20250929, ANTHROPIC_SMALL_FAST_MODEL: claude-haiku-4-5-20251001 }, permissions: { allow: [] } }如果你在 macOS 或 Linux 下使用用户级配置路径通常是~/.claude/settings.jsonWindows 下通常是%USERPROFILE%\.claude\settings.json配置完成后不要在所有项目里复制同一个YOUR_API_KEY。正确做法是搜索项目使用search-rag-prod-claude-01对应的 Key。数据标注项目使用data-label-dev-claude-01对应的 Key。CI 机器人使用ci-bot-prod-claude-01对应的 Key。这样在 usage 导出里每个 Key 的 Token 消耗天然对应一个成本中心。Claude Code 的详细配置也可以参考 TaoToken 的 Claude Code 文档https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentcost-attr-claudecode常见错误是只设置了ANTHROPIC_API_KEY但没有设置ANTHROPIC_BASE_URL。这时请求可能仍然发往默认端点或者在本地环境变量与settings.json之间发生优先级冲突。排查时优先检查两个变量是否同时存在且 Base URL 是否精确为https://taotoken.net/api。如果出现 401先检查 Key 是否复制完整如果出现 404 或模型不存在先检查 Base URL 是否多写了路径以及模型 ID 是否与控制台展示一致。5. Codexconfig.toml 独立 provider不要混用 ANTHROPIC_*Codex 的配置与 Claude Code 完全不同。它使用config.toml通过model_provider指定供应商。这里严禁把ANTHROPIC_*环境变量套到 Codex 上否则配置层面就会混乱。Codex 应该使用自己的 provider 名称和环境变量例如TAOTOKEN_API_KEY。一个可复制的config.toml示例如下model gpt-5-codex model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api responses配置文件通常放在~/.codex/config.tomlWindows 下通常是%USERPROFILE%\.codex\config.toml然后在本地设置环境变量。macOS 或 Linuxexport TAOTOKEN_API_KEYYOUR_API_KEYWindows PowerShell$env:TAOTOKEN_API_KEYYOUR_API_KEY注意这里的YOUR_API_KEY应该换成 Codex 专属 Key而不是 Claude Code 的 Key。如果同一个成本中心既有 Claude Code 又有 Codex建议分别创建 Key例如search-rag-prod-claude-01 search-rag-prod-codex-01这样在成本表里可以进一步区分“Claude Code 消耗”和“Codex 消耗”。如果预算只到项目级也可以在成本表里把这两个 Key 合并到同一个cost_center如果预算要细到工具级就保留两个 Key不要合并。验证 Codex 配置时本地执行以下命令即可不需要连接任何生产库codex --version然后运行一次最小对话观察 TaoToken usage 导出中是否出现对应 Key。如果 usage 里没有出现该 Key优先检查env_key名称是否与环境变量一致以及model_provider是否写成了taotoken。6. CC Switch 三件套多项目、多客户端切换的最小配置当团队同时使用 Claude Code、Codex 和本地脚本时手工改配置文件容易出错。CC Switch 适合做多配置切换但成本负责人要抓住“三件套”供应商名称TaoTokenBase URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY每个成本中心独立在 CC Switch 中新增供应商时这三项必须完整。然后按客户端分别落盘Claude Code 对应~/.claude/settings.json写入ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY。Codex 对应~/.codex/config.toml写入model_provider、base_url、env_key。本地脚本对应环境变量例如TAOTOKEN_API_KEY或项目自己的变量名。这里再次强调不要把ANTHROPIC_*写进 Codex。CC Switch 切换的是配置档案不是协议。Claude Code 使用 Anthropic 风格变量Codex 使用config.tomlprovider 结构。两者可以共用同一个 Base URL但不能共用同一套变量名。推荐给 CC Switch 的配置档案也使用成本中心命名search-rag-prod-claude search-rag-prod-codex>jq .env.ANTHROPIC_BASE_URL, .env.ANTHROPIC_API_KEY ~/.claude/settings.json grep -n base_url\|env_key\|model_provider ~/.codex/config.tomlWindows PowerShell 可以用Get-Content $env:USERPROFILE\.claude\settings.json Get-Content $env:USERPROFILE\.codex\config.toml检查结果中Claude Code 的 Base URL 应为https://taotoken.net/apiCodex 的base_url也应为https://taotoken.net/api。如果发现 Claude Code 配置里出现 Codex 的model_provider或者 Codex 配置里出现ANTHROPIC_API_KEY说明配置档案串了必须马上修正。7. 从 usage CSV 到成本表本地 SQL 透视与分摊公式TaoToken 控制台导出的 usage CSV 是事实表成本分组表是维表。两者通过key_alias或 Key 前缀关联。成本负责人不需要把数据导入生产库建议在本地用 DuckDB、SQLite 或 Pandas 处理。下面给出本地 DuckDB 示例全部在读者本机执行不连接任何线上数据库。假设导出的 CSV 字段如下date,key_alias,key_prefix,model,input_tokens,output_tokens,cache_read_tokens,cache_write_tokens 2025-04-01,search-rag-prod-claude-01,sk-tt-***a1,claude-sonnet-4-5,120000,30000,20000,1000 2025-04-01,data-label-dev-codex-01,sk-tt-***b2,gpt-5-codex,80000,12000,0,0第一步把 CSV 读入本地表-- 在本地 DuckDB 中执行 CREATE TABLE usage_raw AS SELECT * FROM read_csv_auto(taotoken_usage_2025_04.csv);第二步按 Key 和模型聚合CREATE TABLE usage_by_key_model AS SELECT key_alias, model, SUM(input_tokens) AS input_tokens, SUM(output_tokens) AS output_tokens, SUM(cache_read_tokens) AS cache_read_tokens, SUM(cache_write_tokens) AS cache_write_tokens FROM usage_raw GROUP BY key_alias, model ORDER BY key_alias, model;第三步维护一张本地单价表。单价必须从 TaoToken 控制台或模型页抄录不要凭记忆写CREATE TABLE price ( model VARCHAR, input_per_million DECIMAL(18,6), output_per_million DECIMAL(18,6), cache_read_per_million DECIMAL(18,6), cache_write_per_million DECIMAL(18,6) );第四步计算每个 Key 的折算成本SELECT u.key_alias, SUM( u.input_tokens / 1000000.0 * p.input_per_million u.output_tokens / 1000000.0 * p.output_per_million u.cache_read_tokens / 1000000.0 * p.cache_read_per_million u.cache_write_tokens / 1000000.0 * p.cache_write_per_million ) AS estimated_cost FROM usage_by_key_model u JOIN price p ON p.model u.model GROUP BY u.key_alias ORDER BY estimated_cost DESC;如果控制台导出已经包含金额字段可以直接按 Key 汇总SELECT key_alias, SUM(cost) AS cost FROM usage_raw GROUP BY key_alias ORDER BY cost DESC;最后把结果与第 2 节的维表关联得到按成本中心分组的表SELECT d.cost_center, d.owner, u.key_alias, u.model, u.input_tokens, u.output_tokens, u.cache_read_tokens, u.cache_write_tokens, u.estimated_cost FROM cost_by_key u JOIN dim_key d ON d.key_alias u.key_alias ORDER BY d.cost_center, u.estimated_cost DESC;这张表可以直接贴进周报。成本负责人关注三个数总成本、按 Key 排名、异常增长。项目负责人关注自己的 Key 别名和 Token 结构。运维关注的是有没有未知 Key 出现。8. 对账与排障Token 消耗按 Key 归类的 5 个检查点成本归因不是一次性配置而是每周对账。建议固定检查下面五项。第一检查 Key 是否一人一项目。执行本地环境变量检查env | grep -E ANTHROPIC|TAOTOKEN如果发现多个项目共用同一个 Key立刻在 TaoToken API Keys 页面创建新 Key并逐步替换。旧 Key 不要直接删除先观察一周确认没有调用后再禁用。第二检查 Claude Code 是否缺少ANTHROPIC_BASE_URL。只设置 Key 不设置 Base URL可能导致请求没有按预期归类。检查settings.json中两个变量是否同时存在且 Base URL 为https://taotoken.net/api。第三检查 Codex 是否误用ANTHROPIC_*。Codex 的config.toml中应出现model_provider、base_url、env_key不应出现ANTHROPIC_API_KEY。如果出现说明配置串了。第四检查模型 ID 是否与控制台一致。模型 ID 写错时可能表现为 404、模型不可用或者调用落到默认模型。成本表里会出现“模型名为空”或“未知模型”的行影响单价匹配。第五检查缓存 Token 是否计入。很多团队只统计输入和输出忽略缓存读写。如果 TaoToken usage 导出包含cache_read_tokens和cache_write_tokens成本公式必须包含这两项否则会低估实际消耗。对账时还要关注异常模式某个 Key 突然出现大量输出 Token可能是自动化脚本失控。某个 Key 在非工作时间持续消耗可能是 CI 或定时任务没有配独立 Key。某个 Key 出现 401 激增可能是环境变量过期或本地配置被覆盖。某个 Key 的模型分布与项目预期不符可能是 CC Switch 配置档案选错。这些异常不需要连生产库排查先看本地配置和 TaoToken usage 导出即可定位。9. 周报落地与 CTA模型对话、Coding Plan、创建 Key、Claude Code 文档当成本分组表跑通后周报可以固定成三段第一段是按成本中心汇总的总成本第二段是按 Key 排名的 Top 10第三段是异常 Key 与处理动作。这样成本负责人不用再回答“为什么这个月 Anthropic API 花了这么多”而是直接指出“搜索项目的search-rag-prod-claude-01环比增长原因是某个批量任务输出 Token 增加”。如果你还没开始配置建议按下面路径走一遍先用模型对话验证模型和 Key 是否可用https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contentcost-attr-chat如果团队需要长期使用查看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcost-attr-plan为每个成本中心创建独立 Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentcost-attr-createkey按 Claude Code 文档完成settings.json配置https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentcost-attr-doc统一入口仍然是 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentcost-attr-final 。记住两个固定值Base URL 使用https://taotoken.net/apiKey 占位符使用YOUR_API_KEY。然后把 Claude Code 的ANTHROPIC_*、Codex 的config.toml、CC Switch 的三件套分别落盘。这样月底导出 usage 时你得到的不是一堆无法解释的 Token 总量而是一张按 TaoToken Key 归类、可以直接进入预算流程的成本表。
返回列表
PREV
查看更多资讯
NEXT
返回资讯列表