使用ガイド
HiAPI で Claude Code を接続：月額 $100 のサブスク料金を節約する完全設定ガイド
Claude Code は Anthropic が提供するターミナル向けプログラミングツールで、コード理解やリファクタリング能力は同種ツールの中でもトップクラスです。しかし、多くの人がためらうハードルがあります：Claude Code を使うには、月額 $200 の Max サブスクを支払うか、月額 $100 で限定量を含むプランを支払うかのどちらかが必要です。 一日中コードを書くわけではない人にとって、この固定月額は負担になりがちです。
良いニュースは、Claude Code が BYOK（Bring Your Own Key）をサポートしており、2 行の環境変数を設定するだけでサードパーティ API に接続できることです。この記事では、HiAPI の Claude モデルで Claude Code を動かし、固定月額を従量課金に変える方法を説明します。
Claude Code ユーザーがサードパーティ API Key を探す理由
Max サブスクの月額体系は、2 種類の人にとって不利です：
中軽度ユーザー。 1 日に 1〜2 時間しか Claude Code を使わない場合、token 消費量は Max の価値を埋め尽くすには程遠いです。月額 $100 を支払うのは、毎日 $3 払って、おそらく $0.5 分しか使わない枠を買うようなものです。
すでに API 利用習慣があるユーザー。 多くの人はもともと API Key 管理のワークフローを持っており、サブスク制はむしろ余計な管理負担になります。彼らは「1 つの Key ですべてのツールをカバー」したいと考え、Claude Code のためだけに別途サブスクを買いたくありません。
従量課金のメリットは明白です：使った分だけ支払い、使わなければ費用はかかりません。月額料金で節約した分を、他のモデルやツールに充てられます。
Claude Code の BYOK の仕組みと使い方
Claude Code は起動時に 2 つの環境変数を読み取ります（HiAPI の Anthropic Messages エンドポイントはツール呼び出し、ストリーミング応答、拡張思考を実装済みですが、Claude Code + HiAPI のエンドツーエンドの組み合わせはまだ実測されていません。設定後はまず簡単なタスクで検証することをお勧めします）：
ANTHROPIC_BASE_URL：API エンドポイントのアドレス。デフォルトでは Anthropic 公式を指し、サードパーティプロバイダーのアドレスに変更すればカスタムエンドポイントに切り替えられます。ANTHROPIC_API_KEY：認証 Key。サードパーティプロバイダーが生成する API Key で、形式は通常sk-で始まります。
仕組みは複雑ではありません：Claude Code のすべてのリクエストは Anthropic Messages API プロトコルに従います。カスタムエンドポイントがこのプロトコルを実装していれば、Claude Code は正常に動作します。HiAPI の /v1/messages エンドポイントは Anthropic Messages API を完全にサポートし、ツール呼び出し、ストリーミング応答、拡張思考を含みます。
設定方法は、この 2 つの変数をターミナル環境に書き込み、その後は通常どおり claude コマンドを起動するだけです。以下に完全な設定手順を示します。
Claude Code に HiAPI を選ぶ理由
HiAPI は現在 4 つの Claude モデルを提供しており（価格は 2026-10 時点）、さまざまなシナリオと予算に対応します：
| モデル | 入力 $/M | 出力 $/M | コンテキスト |
|---|---|---|---|
| claude-opus-5-5 | $2.02 | $10.08 | 1M |
| claude-opus-4-8 | $2.29 | $11.47 | 200K |
| claude-sonnet-4-6 | $3.00 | $15.00 | 200K |
| claude-opus-4-8@aws | $5.74 | $28.70 | 1M |
ポイントを挙げます：
Opus 5.5 が最大のハイライトです。 入力 $2.02/M、出力 $10.08/M で、典型的な Opus 級モデルの価格（$15/$75）より約 87% 安いです。Opus 級の能力で複雑なリファクタリングタスクを処理でき、コストは予想を大幅に下回ります。
Sonnet 4.6 の価格は公式と同等です。 $3/$15 の価格設定により、日常的なコーディングシーンで割高になることはなく、必要なものをそのまま使えます。
4 つのモデルにはそれぞれ役割があります。 「安いものを使う」のではなく、タスクの複雑さに応じてモデルを選びます。次のセクションで具体的な選び方を説明します。
また、HiAPI のこれらの Claude モデルは Anthropic Messages と OpenAI Chat の両プロトコルをサポートしています。Claude Code は Messages プロトコルを使いますが、OpenAI 互換インターフェースをサポートする他のツール（Cursor、Codex CLI など）も接続でき、1 つの Key で複数のプログラミング環境をカバーできます。
設定手順（5 分で完了）
1. HiAPI API Key を取得
HiAPI にログインし、コンソールの「API Key」ページで新しい Key を作成します。Key の形式は sk- で始まり、作成後すぐにコピーして保存してください。
アカウントがない場合は、まず登録して基本設定を完了してください。
2. 環境変数を設定
ターミナルで実行：
export ANTHROPIC_BASE_URL=https://api.hiapi.ai
export ANTHROPIC_API_KEY=sk-<あなたの HiAPI Key>
<あなたの HiAPI Key> を前の手順で取得した Key に置き換えてください。
この 2 行をシェル設定ファイル（~/.zshrc または ~/.bashrc）に書き込むことをお勧めします。ターミナルを開くたびに入力し直す必要がなくなります：
echo 'export ANTHROPIC_BASE_URL=https://api.hiapi.ai' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=sk-<あなたの HiAPI Key>' >> ~/.zshrc
source ~/.zshrc
3. Claude Code を起動
claude
Claude Code は起動後にこの 2 つの環境変数を自動的に読み取り、リクエストを HiAPI に送信します。すべて正常であれば、普段どおりに Claude Code を使えます。違いはバックエンドが HiAPI に変わっただけです。
4. 検証
起動後に簡単なタスクを入力してテストします。たとえば「現在のディレクトリのファイルを一覧表示」などで、応答が正常でストリーミング出力がスムーズであることを確認します。問題があれば、環境変数が正しく設定されているか確認してください：
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
モデルの選び方：Sonnet vs Opus
初心者が最も陥りやすい間違いは「Opus があるなら Opus を使う」という考えです。実際には価格でモデルを選ぶよりも、タスクでモデルを選ぶことの方が重要です。以下にシナリオ別の推奨を示します：
日常的なコーディング → claude-sonnet-4-6。 コードを書き、バグを修正し、機能を追加し、プロジェクト構造を理解します。Sonnet の応答速度は十分に速く、能力はほとんどの日常的なプログラミングニーズをカバーします。価格は公式と同等ですが、月額 $100 のハードルがないため、実際のコストは大幅に少なくなります。
複雑なリファクタリング / ファイル横断的な変更 → claude-opus-5-5。 複数ファイルにまたがるアーキテクチャ調整や、コードロジックの深い理解が必要なタスク。Opus 5.5 は能力が最も高く、価格はわずか $2.02/$10.08 で、現在最もコストパフォーマンスの高い Opus オプションです。1M コンテキストは大規模プロジェクトの処理にも十分です。
一般的な複雑タスク → claude-opus-4-8。 Sonnet と Opus 5.5 の中間に位置します。価格 $2.29/$11.47 も魅力的です。モデル選択で悩みたくないときの「デフォルト強化版」として適しています。
1M コンテキストが必要だが Opus 5.5 が使えない → claude-opus-4-8@aws。 これは Opus 4.8 の大コンテキスト版で、価格は高め（$5.74/$28.70）で、特大コードベースの全体分析に適しています。一般的なシーンでは Opus 5.5 を優先してください。
一言でまとめると：日常は Sonnet、複雑なタスクは Opus 5.5 に切り替え。 日割りでコストを計算すると、中程度の使用でおよそ $1〜3/日で、月額 $100 のサブスクよりはるかに柔軟です。
コストについて：Claude Code は会話ごとの token 消費量の差が非常に大きいです。簡単な Q&A では数百 token、複雑なリファクタリングでは数万 token に達することもあります。サブスクより得かどうかは、価格表だけでなく 1 週間の実際の使用量で評価することをお勧めします。HiAPI コンソールは使用量統計を提供しており、実際の消費を追跡できます。
FAQ
Claude Code は本当にサードパーティ API Key を使えますか？
使えます。Anthropic 公式は Claude Code で ANTHROPIC_BASE_URL 環境変数を提供しており、これはカスタムエンドポイントをサポートするためのものです。これはクラックや非公式な使い方ではありません。
設定後、Claude Code の機能に欠落はありますか？
コア機能（コードの読み書き、ターミナル実行、ツール呼び出し、対話）はすべて Anthropic Messages API プロトコルに従うため、影響はありません。HiAPI エンドポイントはこのプロトコルを完全に実装しています。異常な動作が発生した場合は、まず API Key が有効か、環境変数が正しいかを確認してください。
設定後に Claude Code がエラーを出したらどうすればよいですか？
最もよくある問題は環境変数が有効になっていないことです。現在のターミナルセッションで echo $ANTHROPIC_BASE_URL に出力があることを確認してください。Claude Code のデスクトップアプリをターミナル版の代わりに使っている場合、環境変数の有効化方法が異なるため、Claude Code の該当プラットフォームの環境変数設定方法を確認する必要があります。
1 か月でいくら節約できますか？
毎日 2〜3 時間 Claude Code でコーディングすると仮定し、Sonnet 4.6 の価格で計算すると、1 日あたりの token 消費はおよそ $1〜3 程度で、月額コストは約 $30〜90 になります。月額 $100 の Max サブスクと比較して、中軽度ユーザーは 40〜70% 節約できます。
ヘビーユーザー（終日コーディング、大量のリファクタリング）の場合は実測が必要です：$100/月 が分岐点で、実際の API 費用がこれを超えるなら、Max サブスクの方がかえってお得です。まずサードパーティ Key を 1 週間試して、実際の token 費用と Max サブスク価格を比較してから決めることをお勧めします。
HiAPI の他のモデル（GPT、DeepSeek など）は Claude Code に使えますか？
使えません。Claude Code は Anthropic のツールであり、Claude シリーズのモデルのみ使用できます。ただし、HiAPI の非 Claude モデルは OpenAI 互換インターフェースをサポートする他のプログラミングツール（Codex CLI、Cursor など）で使用でき、同じ Key で複数のツールをカバーできます。
HiAPI の Claude モデルにレート制限はありますか？
HiAPI は API Key にレート制限を設けており、具体的な数値はコンソールで確認できます。一般的なプログラミングシーンでは制限に達することはありません。長時間連続して高強度で使用する場合は、事前にコンソールで現在の制限値を確認してください。
HiAPI を選んで Claude Code に接続する最大の変化は、節約そのものではなく、1 つのツールのために別途月額料金を払う必要がなくなることです。1 つの Key で Claude Code を管理でき、他のプログラミング環境も管理でき、使用量に応じて支払うというシンプルなロジックに戻ります。
