Claude APIの始め方|Anthropic Consoleでの登録から最初のリクエストまで

Claude APIは、Claude Console(platform.claude.com)でアカウントを作り、設定 > 請求(Settings > Billing)でクレジットを購入し、API keysでキーを発行して、Messages APIに1回リクエストを送ると始められます。料金は月額固定ではなく、処理したトークン数に応じて前払いのクレジットから引かれます。クレジットがない状態ではAPIを呼べないため、キーを作る前に購入を済ませておくと、最初のリクエストで止まりません。サンプルのモデルIDは claude-sonnet-5-5(入力$2、出力$10 / 100万トークン)です。日本はAnthropicの利用可能地域に含まれていて、支払いにはクレジットカードかデビットカードを使います。
Claude APIを始める前に、何を用意すればよいですか?
用意するのは、Consoleアカウント、購入済みのクレジット、APIキー、モデルIDの4つです。支払いを先に済ませておくと、キーを発行した直後からテストできます。
最初にそろえるもの
項目ごとに、見る場所が決まっています。クレジットがなければ、キーを作ってもリクエストは通りません。
| 項目 | 内容 | 確認する場所 |
|---|---|---|
| Consoleアカウント | 登録、請求、APIキーを管理する開発者向けのアカウント。Googleアカウント、メールアドレス、SSOでサインインできる | platform.claude.com |
| クレジット | 前払いで購入する。残高がなくなるとAPIを呼べない | ConsoleのSettings > Billing |
| APIキー | リクエストの認証に使う、sk-ant-で始まる文字列。作成時に一度だけ表示される |
ConsoleのAPI keys |
| モデルID | リクエストで指定するID。例は claude-sonnet-5-5 |
公式のモデル一覧 |
claude.ai・Claude Codeと何が違うか
チャットのclaude.aiで使っているアカウントと、Consoleのアカウントは別物です。ブラウザでClaudeと会話できていても、APIを使うにはConsoleでの登録とクレジットの購入が別に必要です。
Claude Codeは、ターミナルやIDEで動くコーディングエージェントです。Consoleアカウント経由で使う場合は、購入したクレジットがAPIやプレイグラウンドと同じようにClaude Codeにも充てられます。選び方は次のとおりです。
- 自分のプログラムの中からClaudeを呼びたいなら、Claude APIを使います。
- コーディング作業そのものを任せたいなら、Claude Codeを使います。
Anthropic Consoleでのアカウント作成は、どう進めますか?
platform.claude.comを開いてサインインし、組織とユースケースの情報を入力すると、支払い情報の入力に進めます。公式ドキュメントでは、この管理画面を「Claude Console」と呼んでいます。
- platform.claude.comを開き、「Continue with Google」「Continue with email」「Continue with SSO」のいずれかを選んでサインインします。Consoleの画面が開きます。
- 画面の案内に従って、組織とユースケースの情報を入力します。入力が終わると、支払い情報の入力に進めます。
- 支払い方法を登録してクレジットを購入します(次のセクションで手順を示します)。購入した分はすぐに残高へ反映されます。
- 残高が入ったら、API keysでキーを発行します。

メールアドレスで登録して認証メールが届かないときは、迷惑メールフォルダを見てから、数分待って再送します。会社のメールサーバーが外部からの自動送信メールを止めていることもあるため、Googleアカウントや別のアドレスで試すと、どこで止まっているかを切り分けられます。
登録の直後にAPIキーを作ることもできますが、クレジットがなければリクエストは成功しません。支払いを先に済ませてからキーを発行すると、最初のテスト呼び出しで迷いません。
支払いとチャージはどこで設定しますか?日本から使うときの確認ポイント
支払いはConsoleのSettings > Billing(日本語表示では「設定 > 請求」)で設定します。クレジットを購入する操作ができるのは、AdminまたはBillingロールのユーザーです。
- AdminまたはBillingロールでConsoleにログインします。
- 設定 > 請求を開きます。
- 「クレジットを購入」を選びます。
- 購入する金額を入力して確定します。購入したクレジットはすぐに使えるようになり、残高と使用量は同じ請求ページに表示されます。

購入前に知っておく点が3つあります。クレジットの有効期限は購入日から1年で、延長はできません。購入は返金不可です。成功したAPI呼び出しと完了したタスクだけが課金され、失敗したリクエストは課金されません。ただし、成功するはずだったリクエストの途中でクライアントが切断またはタイムアウトした場合は、そのリクエストも課金されます。最初は少額で試し、減り方を見てから追加するのが安全です。
新規ユーザーには、APIを試すための少額の無料クレジットが付与されると、Anthropicの料金ページに記載があります。付与額や有無はConsoleの請求ページで確認できます。
MaxまたはTeamプランの月次APIクレジット
Claude MaxまたはTeamプランには、Claude API用の月次クレジットが含まれています。ConsoleのOrganizationをプランにリンクすると請求でき、この分は支払い方法がなくても使えます。月次クレジットは購入したクレジットより先に消費され、未使用分は請求サイクルの終わりに失効します。請求ページの「Promotional credits」セクションに、金額と有効期限が表示されます。
前払いの残高と、使いすぎを防ぐ上限
残高が尽きるとリクエストは通らなくなるため、自動リロードか月額の上限のどちらか、できれば両方を最初に設定します。
自動リロードは、残高がしきい値を下回ったときに、設定した残高まで自動でクレジットを購入する機能です。
- 請求ページの「クレジット残高」セクションで、「自動リロードを設定」を選びます。
- 「クレジット残高が次に達したときに」に、購入のきっかけにする残高を入力します。
- 「クレジット残高を次まで戻す」に、リロード後の残高を入力します。
- 「オンにする」を選びます。
現在の残高がすでに設定した最小値以下だと、ボタンは「オンにして購入」と表示され、押した時点で目標残高までの金額(税金込み)が請求されます。
月額の上限は、請求ページの「Spend limits」セクションで、Adjust limit(未設定ならSet limit)から設定します。自分で決めた上限は、利用ティアの月額上限を超えて設定できません。ティアごとの月額上限は、Startが$500、Buildが$1,000、Scaleが$200,000です。新しい組織や利用実績の少ない組織は、これより低い制限のEvaluationティアから始まることがあります。
再試行や失敗したリクエストを無制限に繰り返すと、消費が読めなくなります。再試行は回数と待ち時間を先に決めておきます。
日本から使うときの判断表
地域の条件と、支払い方法や税金の扱いは、見る場所が別々です。
| 確認項目 | 見る場所 | 判断のポイント |
|---|---|---|
| 利用地域 | AnthropicのSupported Regions Policy | 日本はサポート対象の国・地域に含まれています。利用者の所在地に加えて、法人の設立国や本社所在地も条件になっています |
| 支払い方法 | ConsoleのBilling、Anthropicヘルプセンターのカード拒否の案内 | クレジットカードとデビットカードが使えます。PayPalなどの外部決済サービスは使えません。カードの請求先住所と国が対応地域であることが条件です |
| 3Dセキュア | カード会社の認証画面 | 決済に3D Secure(3DS)認証が求められたら、完了させます |
| 消費税 | Anthropicヘルプセンターの日本向け消費税(JCT)のお知らせ | 2026年4月1日から、日本の顧客には10%の消費税が別途加算されます。Anthropicは適格請求書発行事業者として登録済みで、法人は適格請求書で仕入税額控除を受けられます |
| 自動リロード | Consoleの請求ページ | しきい値と戻す残高を設定します |
| 利用上限 | Consoleの請求ページ(Spend limits) | 月額の上限を、ティアの上限以下で設定します |
請求書払い(月次請求)はAnthropicのセールスチームを通じた契約が前提で、クレジットの事前購入は不要になります。窓口を通して契約する場合は、所在地とプランに応じた支払い条件を先に確認しておくと、あとから前提が食い違いません。
Consoleでクレジット残高や使用量はどこで確認できますか?
クレジット残高と使用量は、Consoleの設定 > 請求(Settings > Billing)の同じページに表示されます。クレジットを購入した画面がそのまま確認画面です。
- 利用可能なクレジット残高とクレジット使用量: 請求ページ
- MaxまたはTeamプランの月次クレジット: 請求ページの「Promotional credits」セクション(金額と有効期限つき)
- 月額の上限(Spend limits): 請求ページ
- 利用ティアと現在のレート制限: ConsoleのRate limitsページ
- 購入履歴と請求書・領収書: 請求ページの「Invoice history」。失効したクレジットもここに表示されます
請求書と領収書をダウンロードできるのは、AdminまたはBillingロールのユーザーです(Anthropicヘルプセンターの請求書の案内)。Invoice historyの「Download」でそのまま保存し、「View」でStripeのページを開けます。購入のたびに、登録した請求先メールアドレスにも領収書が自動で届きます。件名は「Your receipt from Anthropic.」なので、受信トレイで検索すれば過去分も探せます。

APIキーはどう作って、どう保存すればよいですか?
ConsoleのAPI keysページ(platform.claude.com/settings/keys)で、Create keyを選んで発行します。画面に表示されたキーはその場で安全な場所へ保存します。キーは作成時に一度しか表示されないため、コピーを忘れると作り直しです。
発行の手順
- ConsoleでAPI keysページを開きます。
- 「Create key」を選び、開発用や本番用など用途がわかる名前を付けます。
- 有効期限(Expiration)を選びます。3時間、1日、7日、30日のプリセット、カスタム、Neverから選べ、検証用のキーは短めにしておけます。
- 「Linked account」を自分自身に設定して作成します。複数人やCI、本番サービスで共有するキーは、サービスアカウントにリンクしたキー(service account key)にします。
- 表示された
sk-ant-で始まるキーをコピーし、パスワード管理ツールやシークレット管理サービスに保存します。

Create keyのボタンが押せないときは、ロールの権限が足りません。組織の管理者に、ロールの変更かサービスアカウントキーの作成を頼みます。使わなくなったキーは、API keysページで無効化(Disable)するか削除(Delete)します。Disableは元に戻せますが、Deleteは元に戻せません。
環境変数とシークレット管理で渡す
保存したキーはコードに直接書かず、環境変数として渡します。ANTHROPIC_API_KEY を設定しておくと、公式のSDKが自動で読み取ります。リポジトリで.envを使うなら、.gitignoreに追加しておきます。コミット対象に秘密情報が混ざっていないかは、シークレットスキャンで見つけられます。すでに公開してしまったキーは無効化します。
組織で使うなら、個人の端末にファイルを置くより、シークレット管理サービスに寄せたほうが、権限と履歴を追いやすくなります。
キーは開発用と本番用で分けておくと、漏れたときに止める範囲を狭められます。分け方やローテーションの進め方は、APIキーの分割とローテーションの進め方を確認するで整理しています。
漏えいに気づいたとき
該当するキーをすぐに無効化し、新しいキーを発行して差し替えます。公開リポジトリへのコミットに気づいた場合は、履歴の書き換えより先に無効化を済ませます。Consoleの使用状況も見ておくと、想定外の消費に気づけます。
最初のリクエストは、どう送ればよいですか?
Messages APIに、cURLかPython SDKのどちらかで1回リクエストを送ります。レスポンスのcontent配列にtype=textのブロックがあれば、リクエストはモデルまで届いています。stop_reasonがend_turnなら最後まで生成されていて、max_tokensなら出力の上限で打ち切られています。
モデルIDを選ぶ
サンプルでは、速度と知能のバランスがよく、価格も抑えめの claude-sonnet-5-5 を使います。Anthropicのクイックスタートは claude-opus-5-5 を例にしていて、ほとんどの用途ではOpus 5.5から試すよう案内しています。現行の4モデルは、いずれも1Mトークンのコンテキストと最大128Kトークンの出力に対応しています(2026年10月19日にAnthropicのモデル一覧で確認)。

モデルIDの最新は、公式のAPIドキュメントのクイックスタートとモデル一覧で確認できます。
cURLで疎通を確認する
Bashでキーを環境変数に入れます。read -s を使うと、キーが画面に表示されません。
read -r -s -p "API key: " ANTHROPIC_API_KEY
printf "\n"
export ANTHROPIC_API_KEYMessages APIにPOSTします。
curl https://api.anthropic.com/v1/messages \
-H "content-type: application/json" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1000,
"messages": [
{"role": "user", "content": "日本語で1文の自己紹介をしてください。"}
]
}'認証はx-api-keyヘッダーで渡します。anthropic-versionヘッダーは、API仕様のバージョンを指定するものです。
Python SDKで呼び出す
仮想環境を作り、SDKをインストールします。
python3 -m venv .venv && source .venv/bin/activate
pip install anthropicimport anthropic
client = anthropic.Anthropic() # 環境変数 ANTHROPIC_API_KEY を自動で読む
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1000,
messages=[
{"role": "user", "content": "日本語で1文の自己紹介をしてください。"}
],
)
for block in message.content:
if block.type == "text":
print(block.text)
print("stop_reason:", message.stop_reason)SDKを使っても、内部で送っているのは同じMessages APIのリクエストです。max_tokensは出力トークンの上限で、値を決めておくと1回あたりの出力の長さと消費の見当がつきます。モデルを変えるときは、model の文字列だけを差し替えます。
残高不足や認証エラーが起きたときは、どこを確認しますか?
返ってきたHTTPステータスとエラーの種類で、見る場所を分けます。キーの問題なら401、支払いの問題なら402、リクエスト量の問題なら429です。

エラー別の確認先
| 症状 | 主な原因 | 確認する場所 |
|---|---|---|
| 401 authentication_error | APIキーが誤っている、無効化された、または有効期限が切れた | 環境変数 ANTHROPIC_API_KEY の値と、ConsoleのAPI keysの状態。期限切れのキーは復活できないので、新しく作ります |
| 402 billing_error | 請求または支払い情報の問題 | ConsoleのBillingで、残高、支払い方法、自動リロードの設定 |
| 400 invalid_request_error | リクエストの形式や内容の誤り。自分で設定したSpend limitに達したときも400になる | リクエスト本文の model、max_tokens、messages。メッセージが「You have reached your specified API usage limits」で始まる場合は、Billingの上限を引き上げるか外す |
| 403 permission_error | APIキーに、指定したリソースを使う権限がない | Consoleの組織とワークスペースの設定 |
| 429 rate_limit_error | レート制限の超過、またはティアの月額上限への到達 | retry-afterヘッダーがあればその秒数だけ待ちます。ヘッダーがなく enforced_spend_limit_reached が返る場合は、翌月1日の0時(UTC)まで復帰しないため、上限の引き上げを依頼します |
| 500 api_error / 529 overloaded_error | Anthropic側の内部エラー、または一時的な過負荷 | 間隔を空けて再試行します。続く場合は、レスポンスのリクエストIDを添えてサポートに連絡します |
公式SDKは、接続エラー、レート制限、5xxなどの一時的な失敗を、デフォルトで2回まで自動で再試行します。残高が尽きているときの再試行は成功しないので、まずBillingの残高とカードの状態を見ます。自動リロードが無効なら、残高が尽きる前に手動で追加します。
公式直販とMixRouteは、どこが違いますか?支払い・APIキー・エンドポイントの比較
違うのは、キーの発行元、接続先、支払いの窓口です。Anthropicの公式直販は、Consoleで発行したキーでMessages APIに送ります。MixRouteは自社のAPIキーを発行し、OpenAI互換のエンドポイント https://api.mixroute.ai/v1 と、Anthropic互換のMessages API(POST https://api.mixroute.ai/v1/messages)の両方に接続できます。OpenAI SDKで書いたコードはbase URLを向け直すだけで動き、Anthropic SDKなら、base URLを https://api.mixroute.ai にして同じclientと client.messages.create を使えます。

支払い・キー・エンドポイントの3軸で比べる
| 項目 | MixRoute | Anthropic公式直販 |
|---|---|---|
| APIキーの発行元 | MixRouteのコンソール | Anthropic ConsoleのAPI keys |
| 接続先 | https://api.mixroute.ai/v1(OpenAI互換)。Messages APIは /v1/messages | AnthropicのMessages API |
| モデルの指定 | モデルIDは同じ claude-sonnet-5-5。MixRouteのモデルページで確認 |
リクエストごとにモデルIDを指定 |
| 料金の考え方 | チャージしたクレジットから利用分を差し引く従量課金。プラットフォーム手数料の上乗せはありません。 | モデルとトークン数に応じた従量課金。クレジットは事前購入 |
| 請求書・支払い条件 | 所在地とプランによって異なる | Consoleの請求ページとヘルプセンターで確認 |
どちらに寄せるかを決める
複数プロバイダのモデルを1つのエンドポイントにまとめたい、既存のOpenAI互換コードをあまり変えずに別のモデルも試したい、という場合は、MixRoute側のキーとエンドポイントに寄せる判断が出てきます。MixRouteはプラットフォーム手数料を上乗せせず、1つの接続先から250以上のモデルを扱えます。claude-sonnet-5-5 は、入力$2、出力$10 / 100万トークンで、1Mトークンのコンテキストと最大128Kトークンの出力に対応しています(MixRouteのモデルページ、2026年10月19日確認)。料金は現在USDで表示されています。
前半のPythonコードは、キーとbase URLを差し替えるだけでMixRouteに向けられます。
import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["MIXROUTE_API_KEY"],
base_url="https://api.mixroute.ai", # /v1 は付けない
)
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1000,
messages=[
{"role": "user", "content": "日本語で1文の自己紹介をしてください。"}
],
)日本の請求書・適格請求書の条件は、所在地とプランによって異なります。契約前にMixRouteまたは販売窓口へ確認します。MixRouteの料金と対応モデルを公式直販と比べて選ぶ
MixRouteのドキュメントには、OpenAI SDK互換の呼び出し例とMessagesエンドポイントの手順が用意されています。既存のOpenAI互換コードをそのまま向け直す進め方は、OpenAI互換エンドポイントへの接続手順で確認できます。
FAQ
Claude APIは無料で使えますか?
いいえ、基本は従量課金で、前払いで購入したクレジットから使った分が引かれます。Anthropicの料金ページには、新規ユーザーに少額の無料クレジットが付与されると記載があります。ただし、続けて使うにはクレジットの購入が必要です。検証の最初は、価格の低いモデルから始めるのが現実的です。Claude Haiku 5.5は入力$0.10から、Sonnet 5.5は入力$2、出力$10(100万トークンあたり)です。
日本からClaude APIを利用できますか?
はい、日本はAnthropicのSupported Regions Policyのサポート対象に含まれています。地域の条件と支払い方法は別の確認項目です。カードの請求先住所と国が対応地域であること、3D Secure認証が求められたら完了させることも、決済が通る条件になります。登録後に片方で止まると、原因が地域なのか支払いなのかが分かりにくくなるため、先に両方を確認します。
Claude CodeとClaude APIはどう違いますか?
別のものです。Claude Codeはターミナルやコードエディタで動くコーディングエージェント、Claude APIは自分のプログラムからモデルを呼び出すためのインターフェースです。APIを使うときは、Consoleでの登録とクレジットの購入が起点になります。Consoleアカウントで購入したクレジットは、Claude Codeの利用にも充てられます。社内のコーディング作業を任せたいのか、自社のシステムにClaudeを組み込みたいのかで、最初に用意するものが変わります。
APIキーはどこで発行して、どう保存すればよいですか?
ConsoleのAPI keysページ(platform.claude.com/settings/keys)で発行します。Create keyを選び、用途がわかる名前と有効期限を設定して作成します。表示される sk-ant- で始まるキーは一度しか見られないので、その場で安全な場所へ保存します。コードには直接書かず、環境変数かシークレット管理サービスから渡します。開発用と本番用を別のキーにしておくと、停止や差し替えの範囲を狭められます。
APIキーが漏えいしたらどうすればよいですか?
まず該当するキーを無効化し、新しいキーを発行して差し替えます。公開リポジトリへコミットしてしまった場合は、履歴を書き換えるより先にキーを止めます。API keysページのDisableは元に戻せ、Deleteは元に戻せないので、漏えいが確実なキーはDeleteにします。Consoleの使用状況も見て、想定外の消費がないかを確認します。.gitignoreに.envを追加し、シークレットスキャンを入れておくと、再発を減らせます。
支払い(カード登録・チャージ)はどこで設定しますか?
ConsoleのSettings > Billing(日本語表示では設定 > 請求)です。クレジットカードまたはデビットカードを登録し、「クレジットを購入」から金額を入力します。購入したクレジットはすぐに使え、残高と使用量も同じページに表示されます。クレジットは購入日から1年で失効し、返金はできません。残高が尽きる前に自動で補充したいときは、「自動リロードを設定」でしきい値と戻す残高を決めます。
日本の請求書や適格請求書は発行されますか?
はい、Anthropicは2026年4月1日から日本の顧客に10%の消費税(JCT)を別途加算していて、適格請求書発行事業者として登録済みと案内しています。API請求書・領収書は、AdminまたはBilling権限で、ConsoleのSettings → Billing → Invoice historyから取得できます。手順は公式の請求書案内にあります。適格請求書に関する質問はAnthropicのサポートへ問い合わせます。MixRoute経由で契約する場合は、所在地とプランを添えてMixRouteのSalesへ発行条件を確認します。