本文へスキップ

API アクセスガイド

Claude API キーの取得方法

参照確認日:2026年11月18日。Cue による独立ガイド。アカウント、API キー、請求、アカウントに関する判断は Anthropic が行います。

このチュートリアルでは、Claude Console で API キーを作成し、最初の Messages API リクエストを送信し、使用量を確認し、よくあるエラーに対処する方法を説明します。料金と上限は変わるため、構築を始める前に下記の公式ページで確認してください。

公開日 · Cue編集チーム

対象と対象外

このガイドでは、Claude Console で Anthropic の API キーを作成し、最初の Messages API リクエストを送り、使用量を確認し、よくあるエラーに対処する方法を扱います。

このガイドは消費者向け Claude プランは対象外です。消費者向けプランでログインしても API キーは得られません。API の利用料金は Console で別途請求されます。プランの詳細は Claude の料金ページをご覧ください。

前提条件

  • 受信可能なメールアドレスと、API 利用料金の支払い方法(ステップ2を参照)
  • curl がインストールされたターミナル
  • パスワードマネージャーやシークレット管理サービスなど、キーを安全に保管できる場所
  • 組織で利用する場合は、キーを作成する権限。「Create key」ボタンが無効な場合は、ロールにその権限がない可能性があります。組織の管理者に確認してください。

ステップ1:Console アカウントを作成する

platform.claude.com にアクセスし、サインアップまたはサインインします。API の概要では、Claude Console アカウントが API の最初の要件として挙げられています。

ステップ2:請求を設定し、従量課金を理解する

API リクエストはトークン数に応じて、モデルごとのレートで課金されます。料金ページには、各モデルのレートが百万トークン(MTok)あたりの USD で示されています。レートは変わるため、このガイドでは数値を繰り返しません。プロジェクトを計画する前に、必ずページで確認してください。

Console の Billing ページで、クレジットの購入や支払い方法の管理を行います。標準アカウントでは主要なクレジットカードが利用できます。

各利用ティアには月次の利用上限(spend cap)があります。Spend limits ページで、その上限より低い独自の上限を設定できます。利用上限とリクエストのレート制限の違いは、レート制限のリファレンスに説明されています。

ステップ3:API キーを作成し、一度だけコピーする

  1. Console の API keys ページを開きます。
  2. Create key をクリックし、名前を付け、有効期限を選択して、Linked account を自分自身またはサービスアカウントに設定します。ワークスペースを選択することもできます。
  3. すぐにキーをコピーします。Console に完全なキーが表示されるのは作成時の一度だけで、先頭は sk-ant- です。紛失した場合は再表示できないため、新しいキーを作成してください。

個人キーは自分の開発に、サービスアカウントキーは CI パイプラインや本番サービスなど共有する用途に使います。キーはシークレット管理サービスに保存し、プロジェクトファイルには保存しないでください。

ステップ4:最初の Messages API 呼び出し

キーはシェルセッションで設定し、スクリプトやファイルには書き込まないでください。次のリクエストを実行します。

# Set ANTHROPIC_API_KEY in this shell first, for example from your secrets manager.
# Never paste the key itself into a file, script or chat.
curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1000,
    "messages": [
      {
        "role": "user",
        "content": "Say hello in one sentence."
      }
    ]
  }'

例のモデル ID は公式のはじめ方の例に由来します。モデル ID は変わるため、依存する前に Console または公式のモデルドキュメントに掲載されている ID に置き換えてください。成功すると、msg_ で始まる id と、テキストを含む content 配列を持つ JSON が返ります。

ステップ5:Console で使用量を確認する

Claude Console では使用量を追跡できます。テストリクエストの後、使用量の表示を開き、リクエストが想定したワークスペースに記録されているかを確認します。あわせて Spend limits と Billing のページも確認してください。使用量の表示の正確なメニュー位置は、確認したソースでは UNKNOWN です。Console のナビゲーションで使用量の項目を探してください。

キーの安全性

  • キーをコミットしない。 Git、チケット、チャット、スクリーンショット、ソースコードに入れないでください。環境変数またはシークレット管理サービスから読み込みます。
  • 漏えいしたキーはローテーションする。 新しいキーを作成し、アプリケーションを更新してから、API keys ページで古いキーを削除します。
  • プロジェクトまたはサービスごとにキーを1つ使う。 キーを分けておくと、1つを入れ替えても他に影響しません。共有ワークロードにはサービスアカウントキーを使います。
  • ブラウザ側でキーを使わない。 直接のブラウザ呼び出しを制限している組織では、ブラウザからのリクエストが 401 を返すことがあります。API リクエストは自分のバックエンドから送信してください。

トラブルシューティング

エラータイプの正式な情報源は、公式の Claude API エラーリファレンスです。まずレスポンスのステータスコードとエラータイプを確認してください。

ステータスエラータイプ確認事項
401authentication_errorキーの形式が不正、失効、または期限切れの可能性があります。echo "${#ANTHROPIC_API_KEY}" を実行すると長さだけが表示されます。0 の場合、このシェルでは変数が空です。必要に応じて新しいキーを作成してください。
402billing_errorBilling ページで支払い情報を確認してください。
403permission_errorキーにそのリソースへのアクセス権がありません。組織のアクセスとワークスペースの設定を確認してください。キーがワークスペースに限定されていない場合は、認証ドキュメントに anthropic-workspace-id ヘッダーの説明があります。原因としての地域制限は、確認したソースでは UNKNOWN です。 認証ドキュメント
404not_found_errorエンドポイントのパスとリソース ID を確認してください。
429rate_limit_errorレート制限または月次の利用上限のいずれかです。指数バックオフで待ってから再試行し、retry-after ヘッダーがあればそれに従ってください。利用上限による 429 には retry-after がなく、アクセスが回復するまで失敗し続けます。Spend limits ページを確認してください。
500api_error指数バックオフで再試行してください。続く場合は、リクエスト ID を添えてサポートに連絡してください。
504timeout_error長い Messages API リクエストでは、ストリーミングを使ってください。
529overloaded_errorAPI が全体的なトラフィックにより一時的に過負荷です。バックオフを使って後で再試行してください。

公式 SDK は一部の一時的な障害を自動で再試行します(既定では2回)。レート制限のリファレンスでは、上限が時間の経過とともにどう適用されるかを説明しています。

消費者向け Claude アカウントの停止は別のケース

停止または制限された消費者向け Claude アカウントは、API キーとは別に扱われます。API キーを作成しても、消費者向けアカウントの状態は変わりません。公式の Claude ヘルプ記事「安全保護の警告と異議申し立て」と、通知に記載された指示に従ってください。Cue はベンダーのアカウントを復元したり回避したりできず、審査の結果を約束することもできません。この場合の Cue のガイドは Cue の Claude アカウント停止ガイドをご覧ください。

日常業務のためのデスクトップ AI アシスタント。 Cue を使うと、メモ、文書、タスクを整理できます。Claude と GPT のモデルから選択できます。利用可能なモデルと枠は Cue アカウントで確認し、Cue の利用規約もお読みください。Cue は Anthropic の API キーを発行できず、Anthropic のアカウント、請求、キーに関する判断を変えることもできません。

Claude アカウントの停止でお困りですか? Cue の Claude アカウント停止ガイドをご覧ください。