Claude Codeの料金体系 - API課金の仕組みと費用感

Claude CodeはAnthropicが提供するエージェント型コーディングツールで、ターミナル上で動作する。利用にはAPIキーによる従量課金か、サブスクリプションプランのいずれかを選択する。

2つの利用方法

Claude Codeには大きく分けて2つの課金形態がある。

項目	APIキー課金	サブスクリプション
課金方式	従量課金（トークン単位）	月額固定
支払い先	Anthropic API（コンソール）	claude.ai（Pro / Max / Team）
費用の予測	使用量に依存（変動）	月額固定（上限あり）
向いている用途	CI/CD自動化、大量処理、チーム開発	個人開発、日常的なコーディング支援
セットアップ	ANTHROPIC_API_KEY 環境変数を設定	claude login でブラウザ認証

# APIキー方式のセットアップ
export ANTHROPIC_API_KEY="sk-ant-api03-..."

# サブスクリプション方式のセットアップ
claude login

---

APIキー利用時の料金

APIキー方式では、使用したトークン数に応じて従量課金される。料金はモデルごとに異なる。

モデル別トークン単価（100万トークンあたり）

モデル	入力（Input）	出力（Output）	コンテキスト長	特徴
Claude Opus 4	$15.00	$75.00	200K	最高性能。複雑なタスク向き
Claude Sonnet 4	$3.00	$15.00	200K	バランス型。日常利用に最適
Claude Haiku 3.5	$0.80	$4.00	200K	高速・低コスト。単純タスク向き

補足: 上記は標準価格。キャッシュヒット時の入力トークンは割引される（Prompt Caching）。

拡張コンテキスト（1Mトークン）

Claude Opus 4.6およびClaude Sonnet 4.6は100万トークンのコンテキストウィンドウに対応している。

# 1Mコンテキストの有効化
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-6[1m]'

• 1Mコンテキストウィンドウは標準のモデル料金で利用可能（200K超のトークンに追加料金はない）
• Max / Team / Enterpriseプランでは、Opusは自動的に1Mコンテキストにアップグレードされる

料金計算の例

例: Sonnet 4でコードリファクタリングを依頼

入力トークン: 50,000（ソースコード + CLAUDE.md + コンテキスト）
出力トークン: 10,000（修正コード + 説明）

コスト = (50,000 / 1,000,000 × $3.00) + (10,000 / 1,000,000 × $15.00)
       = $0.15 + $0.15
       = $0.30

---

サブスクリプションプラン比較

claude.aiのサブスクリプションに加入すると、Claude Codeを月額固定で利用できる。

プラン一覧

プラン	月額	Claude Code利用	主な制限
Free	無料	不可	-
Pro	$20	可（制限あり）	使用量の上限あり
Max 5x	$100	可	Proの5倍の使用量
Max 20x	$200	可	Proの20倍の使用量
Team	$25〜30/人	可	チーム管理機能付き
Enterprise	要問合せ	可	SSO・監査ログ等

各プランの詳細

Pro（$20/月）

• Claude Codeの基本的な利用が可能
• 使用量に上限があり、大量のコード生成を行うと制限に達する場合がある
• 個人の軽い利用に向く

Max 5x（$100/月）

• Proの5倍の使用量
• Opus 4の1Mコンテキストが自動有効化
• 日常的にClaude Codeを使う開発者向け

Max 20x（$200/月）

• Proの20倍の使用量
• 大規模なリファクタリングや複数プロジェクトの並行作業に対応
• ヘビーユーザー向け

Team（$25〜30/人/月）

• Team Standard / Team Premium の2段階
• チーム管理機能（メンバー管理、使用量モニタリング）
• Opusは自動的に1Mコンテキストにアップグレード

APIキー vs サブスクリプション：コスト比較

Anthropicの公式データによると、Claude Codeの平均的なコストは以下の通り。

指標	値
開発者あたりの平均日額	約$6
90%のユーザーの日額上限	$12未満
Sonnet 4.6での月額目安	$100〜200/開発者

この数値を基準にすると、以下のように判断できる。

月間利用額（APIキー換算）	推奨プラン
〜$20程度	Pro ($20/月)
$20〜$100程度	Max 5x ($100/月)
$100〜$200程度	Max 20x ($200/月)またはAPIキー
$200超	APIキー（従量課金）

---

トークン消費の仕組み

Claude Codeのトークン消費を理解することで、費用の最適化が可能になる。

コンテキストウィンドウの構造

┌─────────────────────────────────────────────────┐
│                コンテキストウィンドウ               │
│  ┌─────────────────────────────────────────────┐ │
│  │ システムプロンプト（固定）                      │ │
│  │  - Claude Codeの基本指示                     │ │
│  │  - ツール定義                                │ │
│  ├─────────────────────────────────────────────┤ │
│  │ CLAUDE.md の内容（固定）                      │ │
│  │  - グローバル設定                             │ │
│  │  - プロジェクト設定                           │ │
│  ├─────────────────────────────────────────────┤ │
│  │ 会話履歴（累積）                              │ │
│  │  - ユーザーの質問                             │ │
│  │  - ツール呼び出し結果（ファイル内容等）          │ │
│  │  - Claudeの回答                              │ │
│  └─────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘

トークン消費が増える要因

要因	説明	影響度
会話の長さ	ターンが増えるほどコンテキストが累積	大
読み込むファイル数	Readツールで読んだファイル内容がコンテキストに入る	大
ファイルサイズ	大きなファイルほどトークン消費が増加	中
CLAUDE.mdの分量	毎回のリクエストに含まれる	中
検索結果	GrepやGlobの結果がコンテキストに入る	中

コンパクション（自動要約）

コンテキストウィンドウの使用率が一定値を超えると、Claude Codeは自動的にコンパクション（会話履歴の要約圧縮）を実行する。

• コンパクションにより、過去の会話が要約され、トークン使用量が削減される
• ただし、コンパクション自体にもトークンが消費される
• コンパクション後は以前の会話の細部が失われる可能性がある

コンテキスト使用率は /cost コマンドで確認可能。

# セッション中にコストとコンテキスト使用率を確認
> /cost

# 手動でコンパクション（要約圧縮）を実行
> /compact

---

費用を抑えるコツ

1. /compact の活用

長い会話セッションでは、手動で /compact を実行してコンテキストを圧縮する。自動コンパクションを待つより、適切なタイミングで手動実行する方が効率的。

# コンテキスト使用率が50〜70%になったら手動コンパクション
> /compact

2. モデルの使い分け

タスクの複雑さに応じてモデルを切り替える。

# デフォルトモデルの設定
export ANTHROPIC_MODEL=sonnet  # 日常的な作業

# セッション中のモデル切り替え
> /model

タスク	推奨モデル	理由
コードレビュー	Sonnet	バランスの良い分析力
単純なファイル操作	Haiku	高速・低コストで十分
アーキテクチャ設計	Opus	複雑な推論が必要
バグ修正	Sonnet	十分な能力でコスト効率が良い
大規模リファクタリング	Opus	広範なコード理解が必要
テストコード生成	Sonnet / Haiku	パターン的な作業

カスタムコマンドのfrontmatterでもモデルを指定できる。

---
model: haiku  # 軽量タスクにはHaikuを指定
---
コマンドの内容...

3. CLAUDE.md の最適化

CLAUDE.mdの内容は毎回のリクエストに含まれるため、簡潔に保つことがコスト削減に直結する。

# 良い例：簡潔で必要な情報のみ
## コーディング規約
- TypeScript + React
- Prettierで自動整形
- テストはVitest

# 悪い例：冗長な説明
## コーディング規約
このプロジェクトではTypeScriptとReactを使用しています。
コードの整形にはPrettierを使用しており、設定ファイルは
.prettierrcに記載されています。テストフレームワークには
Vitestを採用しており、テストファイルは...（以下長文）

4. 質問の具体性を上げる

曖昧な質問は追加のファイル読み込みや確認を誘発し、トークン消費が増える。

# コスト高：曖昧な指示 → 多数のファイルを読み込んで探索
「認証周りのバグを直して」

# コスト低：具体的な指示 → 必要最小限のファイルアクセス
「src/auth/login.tsの42行目でトークン検証が失敗する問題を修正して」

5. セッション管理

1つのセッションで多くのタスクをこなすと、コンテキストが膨らみコストが増大する。タスクの区切りで新しいセッションを開始する。

# タスク完了後、新しいセッションで次のタスクを開始
claude  # 新しいセッション

# 前のセッションを再開する場合
claude --resume

6. コスト監視のカスタマイズ

ステータスラインをカスタマイズして、常にコストを可視化できる。

# ~/.claude/settings.jsonでステータスラインスクリプトを設定
{
  "status_line_script": "~/.claude/scripts/status.sh"
}

#!/bin/bash
# status.sh - コストと使用率を表示
input=$(cat)
COST=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)
COST_FMT=$(printf '$%.2f' "$COST")
echo "Cost: ${COST_FMT} | Context: ${PCT}%"

---

利用シナリオ別の費用目安

以下は典型的な利用パターンにおける費用の目安。APIキー（Sonnet 4基準）での概算。

日常的なコーディング支援

作業内容	想定トークン	概算コスト
関数の実装依頼（1件）	入力30K + 出力5K	$0.17
バグ修正（ファイル特定済み）	入力20K + 出力3K	$0.11
コードレビュー（1ファイル）	入力40K + 出力5K	$0.20
テストコード生成	入力30K + 出力10K	$0.24
Git操作（コミット作成等）	入力15K + 出力2K	$0.08

中規模タスク

作業内容	想定トークン	概算コスト
新機能の実装（複数ファイル）	入力100K + 出力30K	$0.75
リファクタリング（モジュール単位）	入力150K + 出力40K	$1.05
ドキュメント生成	入力50K + 出力20K	$0.45
設定ファイルの整備	入力40K + 出力10K	$0.27

大規模タスク

作業内容	想定トークン	概算コスト
アーキテクチャ変更の相談と実装	入力300K + 出力80K	$2.10
大規模リファクタリング（Opus使用）	入力200K + 出力50K	$6.75
プロジェクト全体のコード分析	入力500K + 出力30K	$1.95

1日の利用パターン例

朝:  バグ修正2件 + コードレビュー1件        → 約$0.50
昼:  新機能実装1件                         → 約$0.75
午後: リファクタリング + テスト生成           → 約$1.30
夕方: ドキュメント更新 + Git操作             → 約$0.50
─────────────────────────────────────────
合計:                                     → 約$3.05/日

上記は比較的軽い利用パターン。Anthropicの公式データでは平均$6/日、90%のユーザーが$12/日未満とされている。

月間コストの目安

利用頻度	月間コスト（APIキー・Sonnet）	推奨プラン
軽い利用（週2〜3日）	$30〜60	Max 5x ($100)
日常的な利用（平日毎日）	$60〜120	Max 5x ($100)
ヘビー利用（毎日・複数PJ）	$120〜250	Max 20x ($200)
CI/CD + 複数人利用	$200〜	APIキー

---

CI/CD での利用コスト

Claude CodeをCI/CDパイプラインで使用する場合の追加的なコスト考慮点。

コスト項目	説明
APIトークン	プロンプトとレスポンスのサイズに依存
ランナー実行時間	GitHub Actions / GitLab Runnerの計算時間
並列実行	複数のPR同時レビュー等でコストが倍増

CI/CDでのコスト最適化。

# GitHub Actionsの例：コスト制御の設定
- name: Claude Code Review
  env:
    ANTHROPIC_MODEL: haiku  # CI/CDにはHaikuで十分な場合が多い
    CLAUDE_CODE_MAX_TURNS: 5  # ターン数を制限
  timeout-minutes: 10  # タイムアウトを設定

---

参考リンク

• Claude Code 公式ドキュメント - Costs - トークン消費と費用管理の公式ガイド
• Anthropic API Pricing - モデル別のAPI料金一覧
• Claude Code 公式ドキュメント - Model Configuration - モデル選択と1Mコンテキストの設定
• Claude Plans - Pro / Max / Team プランの詳細
• Anthropic Console - APIキーの管理と使用量の確認