DeepSeek V4 Flash 上线 · 我们的 GLM-5.2 价格本次下调至 5折
OmniaKey
登录
博客
指南

无需订阅使用 Claude Code API

Claude Code 本地终端可以不购买 Claude 月度套餐，改用 API 按量付费。模型调用仍然收费，变化的是鉴权和计费方式。

11 分钟阅读OmniaKey
Claude CodeAPI billingpay as you goAPI gateway

在本地终端里，选择按 API 用量计费的 provider，而不是登录付费 Claude.ai 套餐，就能无需订阅使用 Claude Code API。Anthropic 官方同时支持 Pro、Max、Team、Enterprise 订阅鉴权，以及 Claude Console API 计费、云 provider 和 LLM gateway。

通过 OmniaKey，这条路径就是：充值预付余额、创建 API Key，再给 Claude Code 配置一个 Anthropic 兼容 base URL 和 bearer token。它不收 Claude 月度订阅费，但每次模型请求仍会产生 API 用量。

无需订阅不等于免费或无限使用。 它只是把包含额度的周期性套餐换成按量 API 计费。你仍然必须使用已充值、经过授权的 API 或 gateway 账户。

Claude Code 必须订阅吗？

本地终端工作流不需要。Claude Code 支持几条正规的鉴权和计费路径：

路径鉴权方式付费方式更适合
Claude Pro、Max、Team 或 Enterprise通过 /login 使用订阅 OAuth周期性套餐和套餐内额度高频交互和 Claude 托管端
Claude ConsoleConsole 登录或 ANTHROPIC_API_KEYAnthropic API 用量希望直接走 Anthropic API 账单的团队
OmniaKey 等 LLM gatewayANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKENgateway 余额或合同按量付费、共享余额、集中查看用量
Bedrock、Google Cloud 或 Foundry云 provider 凭据云平台账单已经统一使用某家云平台的组织

Anthropic 的鉴权文档把 ANTHROPIC_AUTH_TOKEN 排在 ANTHROPIC_API_KEY 和本机已保存的订阅 OAuth 凭据之前。因此，只要 gateway 配置完整，会话就能独立于 Claude 订阅运行。

本文讨论本地 Claude Code CLI 以及沿用其凭据路径的工具。Claude Code on the Web 始终使用订阅凭据，环境变量中的 API Key 或 gateway token 无法覆盖这个托管端。

用 OmniaKey 按量付费运行 Claude Code

1. 安装 Claude Code

按照 Anthropic 最新的 Claude Code 安装说明操作，然后确认命令可用：

bash
claude --version

安装客户端不会自动获得模型额度。下一步选择的凭据决定请求由谁授权、由谁计费。

2. 充值 API 账户并创建 Key

先给 OmniaKey 账户充值，再到 API Keys 面板创建 Key。每台机器或每个自动化环境分别使用一把 Key，这样撤销其中一个时不会中断其它环境。

不要把 Key 提交到代码仓库、留在会共享的 shell history 里，或贴到公开 issue。把它当作密码处理。

3. 设置 base URL 和 bearer token

macOS 或 Linux：

bash
export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude

PowerShell：

powershell
$env:ANTHROPIC_BASE_URL = "https://api.omniakey.com"
$env:ANTHROPIC_AUTH_TOKEN = "your-omniakey-api-key"
claude

ANTHROPIC_AUTH_TOKEN 会作为 Authorization: Bearer 凭据发送。Anthropic 明确把这个变量用于采用 bearer token 鉴权的 gateway 和 proxy。

填写裸域名，不要加 /v1。 Claude Code 会自己补 /v1/messages。如果填写 https://api.omniakey.com/v1，最终会得到错误的 /v1/v1/messages 路径。

完整的 Claude Code API Key 指南还包括 Windows 配置、model id 和准确的 endpoint 约定。

如果只需要最短的产品接入步骤，配置这两个变量时可同时打开 OmniaKey Claude Code 接入指南。

4. 确认当前使用哪条计费路径

进入 Claude Code 后运行：

text
/status

然后执行一个很小的只读任务，并确认 OmniaKey dashboard 出现对应的用量。这个验证很重要，因为只设置 ANTHROPIC_BASE_URL 并不会替换本机保存的订阅凭据；gateway 的 URL 和凭据缺一不可。

如果同一个 shell 还设置了 ANTHROPIC_API_KEY，可以移除它，让预期路径更明确：

bash
unset ANTHROPIC_API_KEY

不要在共享自动化环境里盲目清除凭据。先确认 job 本来应该使用哪个 provider，再让它的 secret store 只保留那条计费路径需要的凭据。

Claude Code 按量付费要多少钱？

不存在一个诚实、通用的月费数字。Claude Code 是 agent loop：它会反复读取上下文、生成输出、调用工具、接收结果，还可能继续派生工作。模型选择、仓库大小、缓存上下文、thinking、重试、MCP 定义和并行会话都会改变账单。

下表是 2026 年 8 月 7 日核对的 OmniaKey 当前目录价，单位为美元/百万 token。价格可能变化，做预算前请核对实时模型目录。

模型输入缓存命中输出示例：100 万输入 + 10 万输出
Claude Haiku 4.5$0.20$0.02$1.00$0.30
Claude Sonnet 5$0.60$0.06$3.00$0.90
Claude Opus 5$1.00$0.10$5.00$1.50

这个示例按未缓存输入计算，不含 cache write、长上下文附加费、特殊加速模式、重试和工具引发的后续轮次。它只是便于横向比较的计量单位，不是完整编程任务的费用预测。

Anthropic 自己的成本指南也强调 API 支出差异很大，建议先跑小规模 pilot，而不是拿平均数套自己的工作负载。任何 gateway 都应遵循同一原则：在自己的仓库里测量“完成一个任务”的总成本。

哪些情况适合 API 按量付费？

这些场景通常更适合：

  • Claude Code 使用偶发或集中爆发，而不是每天高频使用；
  • 希望费用跟实际请求绑定，不想再买一个 seat；
  • 多个编程工具需要共享一份预付余额；
  • 本地机器或 CI 需要可单独撤销的 Key；
  • 日常任务想用便宜模型，必要时再显式升级。

如果你每天重度使用 Claude Code、需要 Claude Code on the Web、依赖订阅专属功能，或者更愿意买一个可预测的 seat 而不是看用量，订阅仍可能更合适。在测量自己的使用量之前，不要预设哪条路径一定更便宜。

控制 API 支出

如果目标是不只给账单设上限，而是真正减少用量，可以按降低 Claude Code Token 消耗指南检查上下文、工具输出、effort 和已验收任务成本。

让日常任务从合适的模型开始

日常均衡任务可从 Claude Sonnet 5 开始；范围窄、流程可重复的任务用 Claude Haiku 4.5；只有任务模糊或错误代价足够高时才升级到 Claude Opus 5。Claude Code 模型指南给出了更完整的路由策略。

切换无关任务时清理旧上下文

长会话会反复发送更多上下文。可能还要回看的会话先重命名，再用 /clear 开始无关的新任务，既减少浪费，也不会丢掉已保存的会话。

关闭不用的工具

每个启用的集成都可能给上下文增加工具定义和返回结果。只保留当前需要的 MCP，别把整份日志灌进会话，命令输出很大时先过滤再交给 Claude。

计算完成工作的成本，而不是单次回复

更低的 token 单价可能被反复返工抵消。应统计一个真正合入的修复、被接受的 review 或通过测试的功能总共花了多少，包括重试和人工清理。

更广义的计量原则可阅读透明 API 计费应该如何工作。

常见错误

只设置 ANTHROPIC_BASE_URL

URL 改变网络目的地，但不一定改变生效的凭据。必须同时提供匹配的 ANTHROPIC_AUTH_TOKEN 并验证结果。

给 base URL 加 /v1

Claude Code 会补 Messages API 路径。应该填写 https://api.omniakey.com，不是 https://api.omniakey.com/v1。

把直连和 gateway 凭据混在一起

ANTHROPIC_AUTH_TOKEN 的优先级高于 ANTHROPIC_API_KEY，但同一个环境里留下无关 secret 会让排障更困难。每个 shell 或 job 只保留一条有意选择的计费路径。

以为托管 Web 产品也会使用 API Key

Claude Code on the Web 使用订阅凭据。这套按量配置面向本地 CLI 相关 surface，不能解锁托管端的订阅功能。

把“不订阅”理解成“不付费”

API 计费仍需要余额。余额为零、Key 被撤销或触发支出限制，都会像套餐额度耗尽一样让请求停止。

常见问题

没有 Claude Pro 或 Max 能用 Claude Code 吗？

可以。本地 CLI 可以通过 Claude Console API、受支持的云 provider 或 LLM gateway 鉴权。无论选哪条路径，都需要有效凭据和已充值的计费账户。

不订阅时 Claude Code API 是免费的吗？

不是。模型调用会计入 API 或 gateway 账户。“按量付费”描述的是计费方式，不是免费访问。

API Key 会消耗 Claude 订阅额度吗？

只要预期的 API 或 gateway 凭据确实生效，就不会。Anthropic 的鉴权优先级把 API 和 gateway 凭据排在已保存的订阅 OAuth 之前。请用 /status 和 provider 的用量面板确认，不要靠猜。

这套配置能用于 Claude Code on the Web 吗？

不能。Anthropic 明确说明，托管 Web 产品始终使用订阅凭据，环境变量中的 API Key 无法覆盖。

Claude Code 应该使用哪个 OmniaKey 变量？

用 ANTHROPIC_AUTH_TOKEN 保存 OmniaKey bearer token，并设置 ANTHROPIC_BASE_URL=https://api.omniakey.com。URL 末尾不要加 /v1。

资料来源

事实核对日期：2026 年 8 月 7 日。鉴权行为、模型可用性和价格都可能变化；实际使用前请核对以上一手资料和实时目录。

获取 OmniaKey API Key打开 Claude Code 指南