対象と対象外
このガイドでは、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 キーを作成し、一度だけコピーする
- Console の API keys ページを開きます。
- Create key をクリックし、名前を付け、有効期限を選択して、Linked account を自分自身またはサービスアカウントに設定します。ワークスペースを選択することもできます。
- すぐにキーをコピーします。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 エラーリファレンスです。まずレスポンスのステータスコードとエラータイプを確認してください。
| ステータス | エラータイプ | 確認事項 |
|---|---|---|
| 401 | authentication_error | キーの形式が不正、失効、または期限切れの可能性があります。echo "${#ANTHROPIC_API_KEY}" を実行すると長さだけが表示されます。0 の場合、このシェルでは変数が空です。必要に応じて新しいキーを作成してください。 |
| 402 | billing_error | Billing ページで支払い情報を確認してください。 |
| 403 | permission_error | キーにそのリソースへのアクセス権がありません。組織のアクセスとワークスペースの設定を確認してください。キーがワークスペースに限定されていない場合は、認証ドキュメントに anthropic-workspace-id ヘッダーの説明があります。原因としての地域制限は、確認したソースでは UNKNOWN です。 認証ドキュメント |
| 404 | not_found_error | エンドポイントのパスとリソース ID を確認してください。 |
| 429 | rate_limit_error | レート制限または月次の利用上限のいずれかです。指数バックオフで待ってから再試行し、retry-after ヘッダーがあればそれに従ってください。利用上限による 429 には retry-after がなく、アクセスが回復するまで失敗し続けます。Spend limits ページを確認してください。 |
| 500 | api_error | 指数バックオフで再試行してください。続く場合は、リクエスト ID を添えてサポートに連絡してください。 |
| 504 | timeout_error | 長い Messages API リクエストでは、ストリーミングを使ってください。 |
| 529 | overloaded_error | API が全体的なトラフィックにより一時的に過負荷です。バックオフを使って後で再試行してください。 |
公式 SDK は一部の一時的な障害を自動で再試行します(既定では2回)。レート制限のリファレンスでは、上限が時間の経過とともにどう適用されるかを説明しています。
消費者向け Claude アカウントの停止は別のケース
停止または制限された消費者向け Claude アカウントは、API キーとは別に扱われます。API キーを作成しても、消費者向けアカウントの状態は変わりません。公式の Claude ヘルプ記事「安全保護の警告と異議申し立て」と、通知に記載された指示に従ってください。Cue はベンダーのアカウントを復元したり回避したりできず、審査の結果を約束することもできません。この場合の Cue のガイドは Cue の Claude アカウント停止ガイドをご覧ください。
日常業務のためのデスクトップ AI アシスタント。 Cue を使うと、メモ、文書、タスクを整理できます。Claude と GPT のモデルから選択できます。利用可能なモデルと枠は Cue アカウントで確認し、Cue の利用規約もお読みください。Cue は Anthropic の API キーを発行できず、Anthropic のアカウント、請求、キーに関する判断を変えることもできません。
Claude アカウントの停止でお困りですか? Cue の Claude アカウント停止ガイドをご覧ください。