Claude Max契約者の盲点:外部アプリのAPI利用はサブスク枠外、従量課金キー別途必須

Claude Maxに加入済みなのにAPIが403になる、その理由
「Claude Maxを契約してるのに、自作ツールでAnthropicのAPIを叩いたら invalid_api_key になった」
このパターンで詰まる個人開発者は意外と多いです。筆者もそのひとりでした。
masatoman.net の Lab ツール実装中に、Anthropic の Messages API を呼び出そうとしてはまりました。Claude Code(CLI)は Max プランで普通に動いているのに、自分で書いた TypeScript コードから API を叩くと認証エラー。「Max 契約してるのに?」と数分混乱してから、そもそも Max サブスクと API キーは 別の課金体系 だと気づきました。masatoman.net の開発環境は Next.js + Supabase + Stripe で、Lab tools に Anthropic API を組み込む段階でこの問題を踏みました。
この記事でわかること:
- Claude Pro/Max サブスクが使えるサービスと使えないサービスの境界線
- なぜ2つの課金体系が分かれているのか
- API キーを最小コストで取得する手順
- 個人開発ツールへの組み込みでかかるコストの試算方法
結論:Pro/Max はフロントエンド製品専用、API は別会社扱い
ひとことで言うと、Claude Pro/Max のサブスクリプションと Anthropic API は別製品です。
| 利用形態 | Claude Pro/Max で使えるか |
|---|---|
| claude.ai のチャット | ✅ 使える |
| Claude Code(CLI・VS Code拡張) | ✅ 使える |
Messages API(anthropic.messages.create) | ❌ 使えない |
Agent SDK(claude-code SDK) | ❌ 使えない |
| 自作アプリに埋め込む API 呼び出し | ❌ 使えない |
Anthropic は2024年から、claude.ai(チャット)と API(開発者向けプラットフォーム)を完全に独立した課金系として運用しています。Anthropic Console(platform.anthropic.com)で別途 API キーを発行し、使った分だけ従量課金する仕組みです。
さらに、2026年4月4日以降は第三者ツールがサブスクリプション枠を利用することも公式に禁止されました。以前は非公式の抜け道(OAuth 経由でサブスク枠を使う CLIProxy 系ツール)が存在しましたが、現在は Anthropic が明示的にブロックしています。
なぜこの勘違いが生まれるのか
原因1: Claude Code が Max 契約で「普通に動く」から
Claude Code を使い始めると、ターミナルで claude コマンドを叩くだけで Sonnet/Opus が動きます。このとき内部では claude.ai と同じ OAuth トークンが使われており、Max プランのクオータが消費されています。
コードが書けて、コードを読んで、git も叩いてくれる——これで「API も同じ枠で使えるはず」と思い込むのは自然な流れです。
原因2: ANTHROPIC_API_KEY 環境変数の挙動が紛らわしい
ドキュメントには「API を使うには ANTHROPIC_API_KEY を設定してください」と書いてあります。でも「じゃあ Claude Code のときはどこから認証してるの?」という疑問が生まれます。
Claude Code は ANTHROPIC_API_KEY 環境変数が設定されていれば API キーを優先し、設定されていなければ claude.ai の OAuth セッションを使います。つまり Claude Code 自体は両方の認証方式に対応していますが、自分でコードを書いて API を呼ぶ場合はキーが必須です。
原因3: 公式ドキュメントが分かれすぎている
claude.ai のヘルプと platform.anthropic.com のドキュメントは別サイトで、両者を行き来して読まないと全体像が見えません。「よくある質問」ページに「有料サブスクリプションとAPIは別」という説明がありますが、気づかずに API のクイックスタートを読み始めるとキー設定の話から始まるので混乱します。
確認方法:自分が今どの認証で動いているか
Claude Code の場合
# 現在の認証状態を確認
claude config show
# ANTHROPIC_API_KEY が設定されていれば API 従量、なければ OAuth(サブスク)
echo $ANTHROPIC_API_KEY
ANTHROPIC_API_KEY が空なら Claude Code はサブスクのクオータを使っています。値が入っているなら API 従量課金です。
自作コードの場合
TypeScript/JavaScript で Anthropic SDK を使っているなら:
import Anthropic from "@anthropic-ai/sdk";
// これは必ず ANTHROPIC_API_KEY の環境変数 or 引数が必要
const client = new Anthropic({
apiKey: process.env.ANTHROPIC_API_KEY, // ここが空だと AuthenticationError
});
Python でも同様です:
import anthropic
# Max サブスクのクオータは使えない。API キーが必須
client = anthropic.Anthropic(api_key="sk-ant-...")
API キー取得の最小手順(5分)
- platform.anthropic.com にアクセス(claude.ai とは別アカウント or 同じメールで登録)
- 左メニュー「API Keys」→「Create Key」
- キー名を入力(例:
personal-dev-2026-05)してコピー - 「Billing」→「Add credit」で最小 $5 をチャージ
.env.localにANTHROPIC_API_KEY=sk-ant-...を追記
以上で anthropic.messages.create() が動くようになります。
注意点:
ANTHROPIC_API_KEYを.env.localに入れると、Claude Code もこのキーで動き始めます(Max サブスクのクオータが消費されなくなる)- Claude Code は Max プランで使い、自作アプリは API キー従量にしたい場合は、Claude Code の実行環境と自作アプリの実行環境で環境変数を分けてください
コスト感の掴み方(業界ベンチマーク試算)
API キーを取得したとして、どれくらいのコストになるのかを試算する方法を示します。
Anthropic API 単価(2026年5月時点)
| モデル | 入力($/MTok) | 出力($/MTok) |
|---|---|---|
| Claude Opus 4.7 | $5.00 | $25.00 |
| Claude Sonnet 4.6 | $3.00 | $15.00 |
| Claude Haiku 4.5 | $0.80 | $4.00 |
MTok = 100万トークン。Sonnet 4.6 の場合、1回の往復で入力 1,000 トークン・出力 500 トークンと仮定すると 1回 ≈ $0.0105(約¥1.6) です(業界ベンチマーク試算)。
用途別の試算例
ブログ記事の自動要約ツール(記事1本あたり 2,000入力 + 500出力トークン):
- Sonnet 4.6 で 1記事 ≈ $0.0135(約¥2)
- 月100記事処理 → 月 $1.35(約¥200)
チャット系 Bot(往復平均 3,000入力 + 1,000出力トークン):
- Sonnet 4.6 で 1往復 ≈ $0.024(約¥3.6)
- 月500往復 → 月 $12(約¥1,800)
重いエージェント処理(ツール呼び出し込みで 10,000入力 + 3,000出力トークン):
- Sonnet 4.6 で 1タスク ≈ $0.075(約¥11)
- 月200タスク → 月 $15(約¥2,250)
個人開発ツールの初期フェーズなら、最初の $5 チャージで数週間は動くというのが現実的な感覚値です。
コスト削減の選択肢
| 手法 | 効果 |
|---|---|
| プロンプトキャッシング | キャッシュ読み込みは通常入力価格の 90% 引き(Sonnet 4.6: $0.30/MTok) |
| Batch API | 非同期で 50% 割引。24時間以内に結果が返れば OK な処理向け |
| モデルを Haiku に | Sonnet の約 4 分の 1 のコスト。シンプルな分類・要約に |
で、どう稼ぐ?
Anthropic API を使う個人開発ツールの「コスト回収」設計を考える
API キーを取得した段階で、月 $3〜$15 程度のランニングコストが発生します。このコストをどう回収するかが個人開発の最初の問いです。
パターン1: 自分用ツール → コスト削減で回収
たとえば毎月 2 時間の繰り返し作業を自動化できるなら、時給換算でコスト回収できます。自動化ツールの API 代が月 $5(¥750)で、2 時間の作業が月 3 回消えるなら、時給¥1,000 換算で 月 ¥6,000 相当の時間削減です。
パターン2: SaaS に組み込む → ユーザー課金で転嫁
AI 機能付き SaaS を作って月額 ¥980〜¥1,980 で販売する場合、API コストをユーザー 1 人あたりに配賦します。月 10 人のユーザーがいれば売上 ¥9,800〜¥19,800 に対し API コストが月 ¥1,500 程度(SaaS の典型的な AI コスト比率は売上の 10〜20%)なら、粗利は十分確保できます。
パターン3: 有料記事 / Lab コンテンツ → 実装ログとして売る
今回の「API キーを別途取得してツールに組み込む」という体験自体が記事ネタです。「詰まった → 原因を調べた → 解決した → コスト試算した」という実装ログは、同じ問題を抱える読者にとって価値があります。
masatoman.net では 有料記事(¥1,000) と Claude Crew Lab Free 登録 への導線を記事末尾に設置しています。自分の実装体験を文章化して収益にする、というのがこのブログの基本戦略です。
まとめ:今日やること3つ
- claude.ai と platform.anthropic.com の使い分けを確認する — どちらのアカウントを使っているか、API キーは発行済みか
- API を使う予定があれば $5 チャージしてキーを取得する — 5 分で完了、最初のチャージは小額で十分
ANTHROPIC_API_KEY環境変数が Claude Code に影響しないか確認する — 意図せず Max クオータではなく API 従量課金に切り替わっていないか
Next Step
次に読むならこの導線です
【第12回】夜寝てる間に Claude Code が記事を書き上げる構成 — 月 ¥5K で動く全コード
Claude Codeラボ全12話の集大成。Skills/MCP/サブエージェント/Hooks/リモート運用を統合した「自走する Claude 自動化」を、月 ¥5K の実コストで動かす全構成を公開。寝てる間に競合調査・記事下書き・PR まで自動化する 6 層アーキテクチャの完成版。
【第12回】夜寝てる間に Claude Code が記事を書き上げる構成 — 月 ¥5K で動く全コード
Claude Codeラボ全12話の集大成。Skills/MCP/サブエージェント/Hooks/リモート運用を統合した「自走する Claude 自動化」を、月 ¥5K の実コストで動かす全構成を公開。寝てる間に競合調査・記事下書き・PR まで自動化する 6 層アーキテクチャの完成版。
Claude Code で 0→MVP を1日で作る全記録 — recipe-ai Build in Public
Claude Codeを使い、YouTube料理動画からレシピを自動抽出するAIアプリ「recipe-ai」を0からMVPまで1日で構築した全記録。CLAUDE.md設計、API実装、Supabase連携、Vercelデプロイ、Stripe課金導入までの工程を時系列で公開。
【第1回】Claude Code Skills 入門 — 自作スキルで開発効率を2倍にする実装ガイド
Claude Code の Skills 機能を自作する手順を、masatoman.net 周辺の自動化を Claude Code で回している立場で実コード付きで解説。1 スキル 15 分の投資で月 10 時間の作業を削減する実装ガイドです。
次の実験記録も追う
Claude Code × 個人開発の実験ログ、失敗、判断変更をまとめて追いたい人向けに、月次でLab Freeを届けます。
masatoman のメルマガ — 毎週月曜の朝に 1 通
masatoman.net で今週公開した記事の中から 1 本を、読者目線で深掘りした手紙が届きます。「自分も同じことやってる」「ここで詰まってた」が見つかる予告編。
この記事が役に立ったらシェア