GPT-Image 2.6 Flare、Sunburst 已上线低至 $0.025 一张图

无需订阅使用 Claude Code API

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

Kiki, OmniaKey COO11 分钟阅读更新于 2026年10月24日
本页内容

先说结论:截至 2026 年 10 月 24 日,只要给 Claude Code 一个 API Key,它就不需要 Pro 或 Max 套餐也能运行。用 Anthropic Console 的 Key 时设置 ANTHROPIC_API_KEY,在确认页面批准 Key 后就跳过登录。用 OmniaKey 的 Key 时设置 ANTHROPIC_BASE_URL=https://api.omniakey.com 和 ANTHROPIC_AUTH_TOKEN,然后在同一个终端启动 Claude Code。按 Anthropic 官方价,Sonnet 5.5 每百万输入 token $2,输出 $10。

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

2026 年 10 月 24 日更新:模型名称和价格已同步 Anthropic 当前目录(Sonnet 5.5、Opus 5.5、Haiku 5.5、Fable 5.1),费用算例按 10 月 24 日的价格重算。

在本地终端里,选择按 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 年 10 月 24 日在 Anthropic 官方定价页核对的价格,单位为美元/百万 token。价格可能变化,做预算前请核对实时模型目录。

模型输入缓存读取输出10 万输入 + 2 万输出
Claude Haiku 5.5起价 $0.10$0.01起价 $0.50$0.02
Claude Sonnet 5.5$2$0.10$10$0.40
Claude Opus 5.5$4$0.20$20$0.80
Claude Fable 5.1$10$0.25$50$2.00

以 Sonnet 5.5 计算:10 万输入 × 每百万 $2 = $0.20,加上 2 万输出 × 每百万 $10 = $0.20,单次请求 $0.40。Opus 5.5 为 $0.40 + $0.40 = $0.80,Fable 5.1 为 $1.00 + $1.00 = $2.00,Haiku 5.5 按 10 万 token 以内的输入价算,$0.01 + $0.01 = $0.02。

这个示例按未缓存输入计算,不含 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.5 开始,用 /model claude-sonnet-5-5 固定模型,/model sonnet 则跟随别名;范围窄、流程可重复的任务用 Claude Haiku 5.5;任务模糊或错误代价足够高时再升级到 Claude Opus 5.5。要跑几个小时的 agent 会话,可以用 Claude Fable 5.1。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 年 10 月 24 日。鉴权行为、模型可用性和价格都可能变化;实际使用前请核对以上一手资料和实时目录。

Claude CodeAPI billingpay as you goAPI gateway

相关文章

最新文章

热门指南