サブスクなしで Claude Code API を使う
Claude Code のローカル terminal は月額 Claude plan ではなく API billing を使えます。無料になるのではなく、認証と支払い方法が変わります。
サブスクリプションなしで Claude Code API を使うには、Claude.ai の有料 plan に login する代わりに API billing の Provider を選びます。Anthropic は Claude Console API、cloud provider、LLM gateway と、Pro、Max、Team、Enterprise の subscription 認証を別々にサポートしています。
OmniaKey を使う場合は、prepaid balance を入金し、API key を作り、Anthropic-compatible Base URL と bearer token を Claude Code に渡します。この経路に月額 Claude subscription はありませんが、各 model request は有料です。
サブスクなしは無料・無制限という意味ではありません。 定額 plan と含まれる利用枠を、従量 API billing に置き換えるという意味です。残高があり、利用権限のある API または gateway account が必要です。
Claude Code に subscription は必要ですか？
Local terminal の workflow では必須ではありません。代表的な認証経路は次のとおりです。
| 経路 | 認証 | 支払い | 向いているケース |
|---|---|---|---|
| Claude Pro/Max/Team/Enterprise | /login の subscription OAuth | 利用枠付きの定額 plan | 日常の対話利用と hosted surface |
| Claude Console | Console login または ANTHROPIC_API_KEY | Anthropic API usage | 公式 API を直接請求したいチーム |
| OmniaKey などの LLM gateway | ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN | Gateway balance/contract | 従量課金、一つの残高、集中管理 |
| Bedrock、Google Cloud、Foundry | Cloud credentials | Cloud provider の請求 | Cloud platform に標準化した組織 |
Anthropic の認証ドキュメントでは ANTHROPIC_AUTH_TOKEN が ANTHROPIC_API_KEY と保存済み subscription OAuth より優先されます。正しく設定した gateway session は subscription から独立して動かせます。
このページは local Claude Code CLI の話です。Claude Code on the Web は subscription credentials を使い、環境変数の API key で hosted surface を上書きできません。
OmniaKey で Claude Code を従量課金にする
1. Claude Code をインストール
Anthropic の現在のセットアップ手順に従い、command を確認します。
claude --version
Client の install は model request の残高を用意しません。次に選ぶ credential が請求先を決めます。
2. 残高を入れて key を作る
OmniaKey に残高を追加し、API Keys dashboardで key を作成します。Machine や automation environment ごとに key を分けると、一つを revoke しても他を止めずに済みます。
3. Base URL と bearer token を設定
macOS/Linux:
export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude
PowerShell:
$env:ANTHROPIC_BASE_URL = "https://api.omniakey.com"
$env:ANTHROPIC_AUTH_TOKEN = "your-omniakey-api-key"
claude
ANTHROPIC_AUTH_TOKEN は Authorization: Bearer として送信されます。
Base URL は bare host にします。/v1 を付けません。 Claude Code が /v1/messages を追加します。設定値 https://api.omniakey.com/v1 は /v1/v1/messages になります。
Windows、model ID、endpoint 契約は Claude Code API key guide、製品固有の最短手順は OmniaKey Claude Code setupを参照してください。
4. 有効な billing 経路を確認
Claude Code 内で次を実行します。
/status
その後、小さな read-only request を一つ送り、OmniaKey dashboard に usage が出ることを確認します。ANTHROPIC_BASE_URL だけでは subscription credential は置き換わりません。Gateway には URL と credential の両方が必要です。
同じ shell で ANTHROPIC_API_KEY も設定しているなら、意図した経路を明確にするため削除します。
unset ANTHROPIC_API_KEY
共有 automation では credential を確認せず unset しないでください。
Pay-as-you-go Claude Code の料金
Claude Code は agent loop です。Context、repository、cache、thinking、retry、MCP、並列 session で請求が変わるため、月額の万能な数字はありません。
2026 年 9 月 18 日に確認した OmniaKey の 1M token あたり USD 料金です。
| Model | Input | Cache hit | Output | 例：1M input + 100K output |
|---|---|---|---|---|
| Claude Haiku 4.5 | $0.28 | $0.028 | $1.40 | $0.42 |
| Claude Sonnet 5 | $0.84 | $0.084 | $4.20 | $1.26 |
| Claude Opus 5 | $1.40 | $0.14 | $7.00 | $2.10 |
この例は uncached input で cache write、long-context modifier、retry、追加 tool turn を含みません。完成タスクの予測ではなく比較単位です。
API billing が向く場合
- Claude Code の利用が毎日ではなく bursty。
- 実際の request に紐づけて支払いたい。
- 複数ツールを一つの残高で管理したい。
- Local machine や CI 用に revoke 可能な key が必要。
- Routine は安い model、難しい task は明示的に escalation したい。
毎日重く使う、Web 版が必要、subscription-only 機能が必要なら subscription が合理的な場合もあります。自分の usage を測らずに安さを断定しないでください。
API spend を抑える
請求額の制限だけでなく usage 自体を減らすには Claude Code token 削減ガイドを使います。
Task に合う model から始める
Sonnet 5 は日常の均衡、Haiku 4.5 は狭く反復的な task、Opus 5 は曖昧さと error cost が高い task に向きます。詳しい routing は Claude Code model guideを参照してください。
無関係な task の前に context を消す
長い会話は context を再送します。必要な session を rename してから /clear で別 task を開始すると無駄を減らせます。
使わない tool を無効にする
Active integration は tool definition と result を context に追加します。MCP を絞り、大きな log をそのまま投入しないでください。
一つの response ではなく完成物を見る
安い token rate でも correction が多ければ不利です。Merge できた fix、受け入れた review、pass した feature の総額を retry と人の cleanup を含めて測ります。
よくあるミス
ANTHROPIC_BASE_URL だけ設定する
URL は destination を変えるだけです。対応する ANTHROPIC_AUTH_TOKEN を設定し、/status で確認します。
Base URL に /v1 を付ける
正しい値は https://api.omniakey.com, 誤った値は https://api.omniakey.com/v1. Claude Code が Messages API path を追加します。
Direct と gateway の credential を混ぜる
ANTHROPIC_AUTH_TOKEN が優先されますが、関係ない secret を同じ環境に置くと調査が難しくなります。
Hosted web product が API key を使うと思う
Claude Code on the Web は subscription credentials を使います。この設定は local CLI 用です。
No subscription を no payment と考える
API billing には残高が必要です。Zero balance、revoke 済み key、spending limit は request を止めます。
FAQ
Claude Pro/Max なしで使えますか？
はい。Local CLI は Console API、対応する cloud provider、LLM gateway で認証できます。選んだ Provider の有効な credential と残高が必要です。
Subscription なしの API usage は無料ですか？
いいえ。Model call は API または gateway account に従量課金されます。
API key は Claude subscription allowance を消費しますか？
意図した API/gateway credential が active なら消費しません。/status と Provider dashboard で確認してください。
Claude Code on the Web で使えますか？
いいえ。Hosted web product は subscription credentials を使います。
OmniaKey ではどの変数を使いますか？
ANTHROPIC_AUTH_TOKEN に bearer token、ANTHROPIC_BASE_URL=https://api.omniakey.com. 末尾に /v1 を付けません。
確認した情報源
- Anthropic: Claude Code authentication
- Anthropic: manage Claude Code costs
- Anthropic: connect Claude Code to an LLM gateway
- Anthropic: Claude API pricing
- OmniaKey Claude Code API key guide
ファクトチェック日: 2026 年 9 月 18 日。認証、モデル提供、料金は変わる可能性があります。本番前に一次資料と live catalog を再確認してください。
Related English references: Claude Sonnet 5 (English), Claude Haiku 4.5 (English), Claude Opus 5 (English), transparent billing (English), and model catalog (English).