サブスクなしで Claude Code API を使う

サブスクリプションなしで 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 は有料です。

Claude Code に subscription は必要ですか？

Local terminal の workflow では必須ではありません。代表的な認証経路は次のとおりです。

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 として送信されます。

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 料金です。

この例は 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).