# 无需订阅使用 Claude Code API

> 无需订阅使用 Claude Code API：用 API Key 按量付费即可运行。设置 ANTHROPIC_API_KEY，或 ANTHROPIC_BASE_URL 加 ANTHROPIC_AUTH_TOKEN 两个环境变量。

- Canonical HTML: https://omniakey.com/zh/blog/claude-code-api-without-subscription
- Markdown: https://omniakey.com/zh/blog/claude-code-api-without-subscription.md
- Published: 2026-08-07 (updated 2026-10-24)
- Author: Kiki, COO at OmniaKey
- Language: zh
- Category: Guide
- Reading time: 11 min
- All posts: https://omniakey.com/blog/llms.txt

---

**先说结论：**截至 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 Console|Console 登录或 `ANTHROPIC_API_KEY`|Anthropic API 用量|希望直接走 Anthropic API 账单的团队|
|OmniaKey 等 LLM gateway|`ANTHROPIC_BASE_URL` + `ANTHROPIC_AUTH_TOKEN`|gateway 余额或合同|按量付费、共享余额、集中查看用量|
|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 安装说明](https://code.claude.com/docs/en/setup)操作，然后确认命令可用：

```bash
claude --version
```

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

### 2. 充值 API 账户并创建 Key

先给 OmniaKey 账户充值，再到 [API Keys 面板](https://omniakey.com/zh/dashboard/tokens)创建 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 指南](https://docs.omniakey.com/cn/guides/claude-code-api-key)还包括 Windows 配置、model id 和准确的 endpoint 约定。

如果只需要最短的产品接入步骤，配置这两个变量时可同时打开 [OmniaKey Claude Code 接入指南](https://omniakey.com/zh/blog/claude-code-setup)。

### 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。价格可能变化，做预算前请核对实时[模型目录](https://omniakey.com/zh/models)。

|模型|输入|缓存读取|输出|10 万输入 + 2 万输出|
|-|-:|-:|-:|-:|
|[Claude Haiku 5.5](https://omniakey.com/zh/claude-haiku-5-5)|起价 $0.10|$0.01|起价 $0.50|**$0.02**|
|[Claude Sonnet 5.5](https://omniakey.com/zh/claude-sonnet-5-5)|$2|$0.10|$10|**$0.40**|
|[Claude Opus 5.5](https://omniakey.com/zh/claude-opus-5-5)|$4|$0.20|$20|**$0.80**|
|[Claude Fable 5.1](https://omniakey.com/zh/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 消耗指南](https://omniakey.com/zh/blog/reduce-claude-code-token-usage)检查上下文、工具输出、effort 和已完成任务成本。

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

日常均衡任务可从 [Claude Sonnet 5.5](https://omniakey.com/zh/claude-sonnet-5-5) 开始，用 `/model claude-sonnet-5-5` 固定模型，`/model sonnet` 则跟随别名；范围窄、流程可重复的任务用 [Claude Haiku 5.5](https://omniakey.com/zh/claude-haiku-5-5)；任务模糊或错误代价足够高时再升级到 [Claude Opus 5.5](https://omniakey.com/zh/claude-opus-5-5)。要跑几个小时的 agent 会话，可以用 [Claude Fable 5.1](https://omniakey.com/zh/claude-fable-5-1)。[Claude Code 模型指南](https://omniakey.com/zh/blog/best-model-for-claude-code)给出了更完整的选择方法。

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

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

### 关闭不用的工具

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

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

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

更广义的计量原则可阅读[透明 API 计费应该如何工作](https://omniakey.com/zh/blog/transparent-billing)。

## 常见错误

### 只设置 `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`。

## 资料来源

- [Anthropic：Claude Code 鉴权](https://code.claude.com/docs/en/authentication)
- [Anthropic：管理 Claude Code 成本](https://code.claude.com/docs/en/costs)
- [Anthropic：把 Claude Code 接到 LLM gateway](https://code.claude.com/docs/en/llm-gateway-connect)
- [Anthropic：Claude API 定价](https://platform.claude.com/docs/en/about-claude/pricing)
- [OmniaKey Claude Code API Key 指南](https://docs.omniakey.com/cn/guides/claude-code-api-key)

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