Claude API 充值指南:额度、计费与按量付费(2026)
作者:CodeGateway 团队 | 最后更新:2026-11-13 本文费率与面额口径 as-of 2026-11-06,来源:CodeGateway 定价页、充值页、计费指南。费率、面额与收银台可用方式可能调整,下单前以结账页实时展示为准。
TL;DR
给 Claude API 充值有三条路径:Anthropic 第一方 API(需要支持的地区与国际支付方式)、云厂商市场(AWS Bedrock / Google Vertex AI,需要云账号)、第三方网关(如 CodeGateway,Stripe 收银台支持信用卡 / Stripe Link,另有银行转账)。
网关路线的充值口径:预设面额 $10 / $20 / $50 / $100,自定义 单笔 $5–$10,000;充值侧费用 = 2% 平台服务费 + Stripe 手续费(约 3.9% + $0.30/笔);消费侧按上游官方美元刊例价 × 1.07 计费,余额不过期。
不想手动盯余额:计费页可开自动充值,余额低于阈值自动扣款补足。
常见失败就四类:卡被拒、支付方式不显示、已付款未到账、余额不足 402——每类的处置见「失败排查」一节。
充值路径:三条路线怎么选
路径 | 支付方式 | 外卡门槛 | 适合谁 | 注意 |
|---|---|---|---|---|
Anthropic 第一方 API | 以官方结账页为准 | 通常需要 | 必须要第一方账号或发票 | 地区与支付方式限制 |
AWS Bedrock / Google Vertex AI | 云账号绑定的支付方式 | 通常需要 | 已有云合同、走云发票 | 配置与权限更重 |
CodeGateway 网关 | 信用卡(Visa / Mastercard / AmEx)、Stripe Link、银行转账 | 不需要 | 想按量付费、用支付宝或银行卡 | 独立第三方,与 Anthropic 无隶属关系 |
选择口径很简单:公司已有云合同走云市场;必须要 Anthropic 第一方发票走第一方;想按量付费、不想绑定支付方式,网关最直接。三条路径的支付门槛细节展开见《不想绑外卡怎么给 Claude API 充值》。
网关充值步骤(以 CodeGateway 为例)
注册并登录 CodeGateway Dashboard,进入工作区的「计费 / 充值」。
选择预设面额($10 / $20 / $50 / $100),或输入自定义金额(单笔 $5–$10,000)。
跳转 Stripe 收银台,选择支付宝或银行卡完成付款。
支付成功后 Stripe 通过 webhook 通知 CodeGateway 入账,可在「支付记录」查看状态。
在工作区创建 API key(
sk-cg-开头),把客户端指过来:
// ~/.claude/settings.json 的 env 字段(Claude Code)
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.codegateway.dev",
"ANTHROPIC_AUTH_TOKEN": "sk-cg-YOUR_KEY"
}
}注意 ANTHROPIC_BASE_URL 不要带 `/v1` 后缀——客户端会自己追加 /v1/messages。入账后先用一个最小请求验证链路,模型 ID 从模型目录复制:
curl https://api.codegateway.dev/v1/messages \
-H "Authorization: Bearer sk-cg-YOUR_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "<模型目录里的模型 ID>",
"max_tokens": 32,
"messages": [{"role": "user", "content": "ping"}]
}'限额:面额、费用与余额规则
单笔限额:自定义金额最低 $5、最高 $10,000;预设面额 $10 / $20 / $50 / $100。首充与预付费档位可能有赠额,以充值页实时展示为准。
充值侧费用:实付 = 面额 + 2% 平台服务费 + Stripe 手续费(约 3.9% + $0.30/笔)。以 $20 为例:$20.00 + $0.40 + 约 $1.08–$1.10 ≈ $21.48–$21.50,分项以 Stripe 结账页为准。两项费用不退还。
消费侧计费:按上游厂商官方美元刊例价 × 1.07 倍,按实际 token 用量扣费;没有月费或订阅费。
余额有效期:不过期,直到用完为止。钱包不单独区分本金与赠送额度。
币种:USD 计价。非 USD 卡由发卡行按其汇率换算,可能另收货币转换费(发卡行定价,CodeGateway 不参与)。
调用侧限额:接口有速率/并发上限(RPM / TPM),与钱包余额是两回事,算法见《Claude API 限流与并发:RPM / TPM 怎么算》。
自动充值:余额低于阈值自动补足
在计费页开启自动充值后,余额低于阈值时将自动按设定金额扣款充值,无需手动盯余额。三点注意:需要先绑定支付方式才能开启;扣款失败会进入暂停状态,按计费页指引更新支付方式后可恢复;适合跑长任务、CI 无人值守场景——手动充值的最大风险不是贵,是任务跑到一半余额见底。
失败排查:四类常见问题
1. 卡被拒(card declined)。 多数是发卡行风控或 3D 验证未通过,先换一张卡或改用支付宝重试;换卡仍失败,联系发卡行确认跨境/线上交易权限。Stripe 收银台的报错分项以结账页显示为准。
2. 收银台没有支付宝(或某支付方式)。 Stripe 按地区与商户类型决定开放哪些方式;你预期的方式没出现,说明当前不在你所在地区开放。换一种方式,或联系支持确认。
3. 已付款但余额未到账。 支付成功后 Stripe 需要通过 webhook 回调入账,多数订单很快;若「支付记录」显示 Stripe 已收款而余额未更新,通常是回调同步中,稍后刷新即可。超过合理时间仍未到账,保留支付记录截图联系支持,不要重复充值。
4. 调用 API 返回 402。 402 = 余额不足,不是模型或权限问题。处置顺序:查「支付记录」确认最近一笔充值状态 → 充值或开启自动充值 → 重试请求。402 的完整触发口径见计费指南。
发票与退款
每次充值成功后 Stripe 自动开具收据,发票在工作区账单页获取。未消耗余额可申请退款:金额不超过「该笔付款金额」与「钱包可用余额」中的较小者;平台服务费与 Stripe 手续费不退还;款项原路退回,通常 1–3 个工作日到账(以发卡行为准);同一笔充值只能退一次。
常见问题
充值后能直接在 Claude Code、Cursor 里用吗? 能。把工具的 Anthropic 端点指向 https://api.codegateway.dev,填入 sk-cg- key 即可,逐步配置见《没有 Anthropic Key,怎么用 Claude Code》。
用支付宝付款会更贵吗? 平台侧费用相同(2% + Stripe 手续费);不同支付方式在收银台的分项可能略有差异,以结账页为准。
CodeGateway 和 Anthropic 是什么关系? CodeGateway 是独立第三方服务,与 Anthropic 无隶属关系;Claude 是 Anthropic 的商标。模型能力由上游提供,计费与支持由 CodeGateway 负责。
会被限制或封号吗? 我们不承诺「不会被限制」。请遵守服务条款与上游模型供应商的使用政策;违规请求可能被上游拒绝、过滤或限速。
按量付费、余额不过期。 现在注册 CodeGateway,用支付宝或银行卡充值,按 token 使用 Claude、GPT、Gemini。
