Anthropic APIキー(2026年):取得方法、キーの種類、Claude Code設定、エラー対処
Anthropic APIキーを取得するには、Claude ConsoleにサインインしてAPI keysを開き、Create keyをクリックして名前・有効期限・リンク先アカウント(自分またはサービスアカウント)を選び、sk-ant-で始まるキーをコピーします。Consoleでキーが表示されるのは一度だけです。 APIを呼び出す前に支払い方法を登録するかクレジットを追加してください。2026年10月22日時点のAnthropicの料金ページによると、利用はトークン単位の課金で、新規アカウントに付与されるのは少額の無料テストクレジットだけです。同じキーですべてのClaudeモデルを使えるので、「Claude APIキー」や「Sonnet用キー」を別に作る必要はありません。
このガイドは、スクリプト、Claude Codeのようなコーディングエージェント、本番サービスのためにキーが必要な開発者向けです。2026年のキーの種類(個人キー、サービスアカウントキー、旧来のワークスペースキー)、有効期限のルール、最初のリクエストでつまずきやすいanthropic-workspace-idヘッダー、動くコード、よくある401/400/429エラー、そして複数プロバイダーを1つのキーで扱うほうが合理的なケースを解説します。
60秒でわかるAnthropic APIキー
| ステップ | 場所 | 知っておくべきこと(2026年10月22日確認) |
|---|---|---|
| 1. サインイン | platform.claude.com | APIキーはclaude.aiのチャットアプリではなくClaude Consoleで管理します |
| 2. API keysを開く | Settings → API keys | Create keyがグレーアウトしている場合、あなたのロールにはキー作成権限がありません |
| 3. キーを作成 | 名前、有効期限、リンク先アカウント、任意でワークスペース | 有効期限のプリセット:3時間、1日、7日、30日、カスタム、Never |
| 4. 一度だけコピー | 作成時のみ表示 | sk-ant-で始まり、紛失したキーは再表示できません |
| 5. 請求設定 | Settings → Billing | 米ドルでの従量課金。ティアごとに月間の支出上限があります |
| 6. テスト | POST https://api.anthropic.com/v1/messages |
キーはAuthorization: Bearer(または旧来のx-api-key)で送信します |
出典:AnthropicのドキュメントGet your Claude API keyおよびAuthentication(2026年10月22日確認)。
手順:Anthropic APIキーを作成する
- platform.claude.comでConsoleアカウントを作成またはサインインします。 ClaudeのチャットサブスクリプションとAPIは別々に課金されますが、Maxプランには毎月のAPIクレジットが含まれます(詳細は後述およびAnthropic API料金ガイドを参照)。
- API keysページを開きます。 組織に複数のワークスペースがある場合は、ここで1つ選んでキーをそのワークスペースに限定できます。
- Create keyをクリックして3つの項目を入力します。わかりやすい名前(例:
ci-staging-claude)、有効期限、そしてLinked accountです。自分にリンクすると個人キー、サービスアカウントにリンクすると共有ワークロード用のキーになります。 - すぐにキーをコピーします。 Anthropicのドキュメントには、完全なキーは一度しか表示されないと書かれています。パスワードマネージャーやシークレットマネージャーに保存し、Gitリポジトリには絶対に入れないでください。
- Billingページでクレジットを追加するかカードを登録します。 残高がないと、有効なキーでも最初のリクエストは失敗します。
- 環境変数としてエクスポートしておくと、SDKが自動で読み込みます。
export ANTHROPIC_API_KEY="sk-ant-api03-..." # macOS/Linux, current shell only
# Windows PowerShell:
# setx ANTHROPIC_API_KEY "sk-ant-api03-..."
どのキーの種類を選ぶべきか
2026年のAnthropicには3種類のキーがあります。種類の選び間違いは、メンバーがチームを抜けたときにキーが「突然使えなくなる」最も多い原因です。
| キーの種類 | 誰として動作するか | 無効になるタイミング | 用途 |
|---|---|---|---|
| 個人キー | あなた自身(あなたのロール) | 組織を離れたとき、または単一ワークスペースのキーがそのワークスペースへのアクセスを失ったとき | ローカル開発、個人スクリプト、自分のClaude Code |
| サービスアカウントキー | サービスアカウント | サービスアカウントがアーカイブされたか、ワークスペースから外されたとき | CIパイプライン、本番サービス、共有エージェント |
| ワークスペースキー(旧来) | 誰でもない(ワークスペースに属する) | 期限切れ、無効化・削除、またはワークスペースのアーカイブ時 | 既存の連携のみ。移行を推奨 |
データはAnthropicのAuthenticationページ(2026年10月22日)によります。Anthropicは個人キーかサービスアカウントキーを推奨しています。どちらもIDに紐づくため、所有する人やワークロードより長く生き残ることがないからです。AWS、Google Cloud、Azure、GitHub Actions、Kubernetes上の本番環境では、同じページが静的キーを短期トークンに置き換えるWorkload Identity Federationを推奨しています。
知っておきたい有効期限のルール
- 有効期限は作成時に決め、後から変更できません。
- 有効期間が14日以上のキーは期限の7日前、7日以上のキーは1日前に作成者へメールが届きます。それより短いキーは通知なしで失効します。
- 失効後のリクエストは
401 authentication_errorを返し、失効したキーは再有効化できず削除するしかありません。 - Disableは元に戻せますが、Deleteは取り消せません。
実用的な運用例:ノートPCやコーディングエージェントには30日のキーを使い、サーバーにはシークレットマネージャーに保存したサービスアカウントキー(ローテーションあり)を使います。詳しくはAIプロダクトにおける安全なAPIキー管理とゲートウェイを使ったキーのローテーションをご覧ください。
キーをテストする:curl、Python、Node.jsで最初のリクエスト
以下で使うモデルID claude-sonnet-5-5は、2026年10月22日時点のAnthropicモデル概要に掲載されている現行のSonnetモデルです。
curl https://api.anthropic.com/v1/messages \
-H "Authorization: Bearer $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Reply with the word ok if this key works."}]
}'
# pip install anthropic
import anthropic
client = anthropic.Anthropic() # reads ANTHROPIC_API_KEY from the environment
msg = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=256,
messages=[{"role": "user", "content": "Reply with the word ok if this key works."}],
)
print(next(b.text for b in msg.content if b.type == "text"))
print("tokens:", msg.usage.input_tokens, "in /", msg.usage.output_tokens, "out")
// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic(); // reads ANTHROPIC_API_KEY
const msg = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 256,
messages: [{ role: "user", content: "Reply with the word ok if this key works." }],
});
console.log(msg.content.find((b) => b.type === "text")?.text);
このようなテストの費用は1セント未満です。Sonnet 5.5の公式価格は入力100万トークンあたり2ドル、出力100万トークンあたり10ドル(Anthropic料金、2026年10月22日)なので、入力30トークン・出力5トークンで約0.0001ドルです。
最初のリクエストを失敗させるワークスペースヘッダー
キーがワークスペースに限定されていない場合、すべてのリクエストにanthropic-workspace-idを含める必要があります。含めないと、APIは「This API key is not scoped to a workspace...」というメッセージとともに400 invalid_request_errorを返します。IDはConsoleのWorkspacesページで確認できます。Pythonでの対処法:
client = anthropic.Anthropic(
default_headers={"anthropic-workspace-id": "wrkspc_..."} # only for keys not scoped to a workspace
)
単一のワークスペース用に作成したキーならヘッダーは不要です。そのためAnthropicは作成時にワークスペースを指定することを勧めています(Authenticationドキュメント)。
Claude CodeでAnthropic APIキーを使う
Claude Codeは、claude.aiのサブスクリプション、Consoleログイン、クラウドプロバイダー、APIキーのいずれかで認証できます。2026年10月22日に確認したClaude Codeの認証ドキュメントによると:
ANTHROPIC_API_KEYが設定されていると、Claude Codeは初回起動時にそれを使うか尋ね、承認するとブラウザでのログインを省略します。ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、apiKeyHelper設定はCLI、VS Code拡張、Agent SDK、GitHub Actionsに適用されますが、Claude Desktopやクラウドセッションには適用されません。apiKeyHelperはキーを返すスクリプトを実行する仕組みで、Vaultから短期キーを取得するのに便利です。スクリプトが3回失敗するとリクエストは失敗します。- ConsoleユーザーはAPIキーを作成せずにサインインできるようになりました(Claude Code v2.1.242以降)。この場合は静的キーではなくOAuthプロファイルが保存されます。事前に
ANTHROPIC_API_KEYを解除してください。
export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude # approve the key when prompted
# inside Claude Code, /status shows which credential is active
Claude Codeでトークンやログインのエラーが出る場合は、Claude Codeの認証トークンエラーガイドを参照してください。Anthropicに直接ではなくルーター経由でClaude Codeを使うには、Claude Code APIルーター設定をご覧ください。
Anthropic APIキーは無料?
キーの作成は無料ですが、利用は有料です。Anthropicの料金FAQには、新規ユーザーは「APIをテストするための少額の無料クレジット」を受け取れるとあり、その後はすべてのリクエストがトークン単位で課金されます。知っておきたい例外が1つあります。2026年10月22日に確認したclaude.com/pricingでは、Max 5xプラン(月額100ドル)に月100ドル、Max 20xに月200ドルのClaude Platform向けAPIクレジットが含まれています。Pro(月払いで月額20ドル)には含まれません。Anthropicの料金ページに掲載された100万トークンあたりの現行定価(2026年10月22日):
| モデル | モデルID | 入力 | 出力 | キャッシュ読み取り |
|---|---|---|---|---|
| Claude Fable 5.1 | claude-fable-5-1 |
$10.00 | $50.00 | $0.25 |
| Claude Opus 5.5 | claude-opus-5-5 |
$4.00 | $20.00 | $0.20 |
| Claude Sonnet 5.5 | claude-sonnet-5-5 |
$2.00 | $10.00 | $0.10 |
| Claude Haiku 5.5(プロンプト100K以下) | claude-haiku-5-5 |
$0.10 | $0.50 | $0.01 |
Batch APIを使うと入力・出力の価格が半額になり、米国内限定推論(inference_geo: "us")では1.1倍の係数がかかります。ワークロードごとの試算は、Anthropic API料金ガイドをご覧ください。プロトタイプ用に本当に無料のモデルが必要なら、無料LLM API比較で実際の制限つきの選択肢を紹介しています。
キーには支出上限とレート制限が伴う
組織の利用ティアによって、レート制限と月間支出上限の両方が決まります。2026年10月22日に確認したAnthropicのレート制限ページによると、上限は月500ドル(Start)、1,000ドル(Build)、200,000ドル(Scale)で、新しい組織はより低いEvaluationティアから始まる場合があります。上限に達すると、上位ティアを申請しない限り、翌月1日の00:00 UTCまでAPIはHTTP 429を返します。Billingページで独自の低い支出上限を設定することもでき、自律エージェントに使わせるキーでは良い習慣です。
Anthropic APIキーのよくあるエラーと対処法
| エラー | 考えられる原因 | 対処法 |
|---|---|---|
401 authentication_error |
キーの入力ミス、取り消し、無効化、または失効 | 新しいキーを作成。失効したキーは再有効化できません |
ワークスペースに言及する400 invalid_request_error |
キーがワークスペースに限定されておらず、ヘッダーもない | anthropic-workspace-idを追加するか、ワークスペース限定のキーを作成 |
404 not_found_error「Workspace ... not found」 |
ワークスペースIDの誤り、またはキーのIDにアクセス権がない | WorkspacesページでIDを確認 |
429「reached your API usage limits」 |
ティアの月間支出上限に到達 | ティアの引き上げを申請するか、月次リセットを待つ |
retry-after付きの429 |
1分あたりのリクエスト数またはトークン数を超過 | 待ってから再試行。LLMのレート制限解説を参照 |
529 overloaded_error |
キーではなくAnthropic側の容量不足 | バックオフして再試行またはフェイルオーバー。APIエラー529を参照 |
| Create keyボタンが押せない | Consoleのロールにキー作成権限がない | 管理者にロール変更かサービスアカウントキーを依頼 |
出典:AnthropicのAuthentication、レート制限、エラードキュメント(2026年10月22日確認)。
キーを安全に保つ
- フロントエンドのコード、モバイルアプリ、公開ノートブックにキーを貼り付けないでください。Claudeを直接呼び出す必要があるiOS・macOSアプリ向けには、Anthropicが1時間で失効するデバイストークンを発行するApp Attestを提供しています。
- 環境ごと、エージェントごとに別のキーを使えば、1つを取り消しても他に影響しません。
- 長めでもよいので有効期限を設定し、漏えいしたキーに「賞味期限」を持たせましょう。
- CIでシークレットスキャンを実行しましょう。設定例はAI APIのシークレットスキャンガイドにあります。
- Consoleで利用状況を確認し、ティアの上限より低い支出上限を設定しましょう。
1つのキーで複数モデルを使うほうが簡単な場合
AnthropicのキーではClaudeしか使えません。プロダクトやコーディングエージェントがGPT、Gemini、DeepSeek、Qwen、Kimiも呼び出すなら、5つのキー、5つの残高、5種類のレート制限を管理することになります。Flatkeyのような統合APIなら、1つのキーですべてを利用できます。2026年10月22日時点のFlatkeyモデルページでは、Claude Sonnet 5.5が100万トークンあたり入力1.60ドル/出力8.00ドル、Claude Opus 5.5が3.20ドル/16.00ドルで、Anthropicの定価2ドル/10ドル、4ドル/20ドルを下回っていました。FlatkeyのAnthropic SDKガイドのとおり、base URLを変えるだけでAnthropic SDKが使えます。
import anthropic
client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=256,
messages=[{"role": "user", "content": "Summarize this changelog in 3 bullets."}],
)
print(next(b.text for b in msg.content if b.type == "text"))
Anthropic独自の機能をリリース当日から使いたい場合、Workload Identity Federation、データレジデンシー管理、エンタープライズ契約が必要な場合は、Anthropicの直接キーを使い続けましょう。より広い比較は、Flatkeyとプロバイダー直接契約の比較と1つのAPIキーで複数のAIモデルを使う方法をご覧ください。
FAQ
Anthropic APIキーはどうやって取得しますか?
platform.claude.comのClaude Consoleにサインインし、Settings → API keysでCreate keyをクリックし、名前・有効期限・リンク先アカウントを設定して、一度だけ表示されるsk-ant-キーをコピーします。リクエストを送る前にBillingページでクレジットを追加してください。
Anthropic APIキーは無料ですか?
キーの作成は無料で、新規アカウントには少額のテストクレジットがありますが、その後のAPI利用はトークン単位で課金されます。2026年10月22日時点で、Claude APIに恒久的な無料枠はありません。
Claude APIキーとAnthropic APIキーは同じものですか?
はい。Anthropicのドキュメントでは、Claude APIのキーはAnthropic APIキーとも呼ばれるとされています。1つのキーで、組織がアクセスできるすべてのClaudeモデルを使えます。
既存のAnthropic APIキーはどこで確認できますか?
platform.claude.com/settings/keysで各キーの名前、ヒント、有効期限は確認できますが、キー全体は表示されません。紛失した場合は新しいキーを作成し、古いキーを削除してください。
Claude ProやMaxのサブスクリプションにAPIクレジットは含まれますか?
Proには含まれません。2026年10月22日時点のclaude.com/pricingでは、Maxプランに毎月のAPIクレジット(Max 5xは月100ドル、Max 20xは月200ドル)が記載されています。それを超えるConsoleキーでのAPI利用は、チャットのサブスクリプションとは別にトークン単位で課金されます。
Anthropic APIキーが401を返すのはなぜですか?
キーの入力ミス、無効化、削除、または失効が原因です。失効したキーは再有効化できないので、新しく作成してください。エラーにワークスペースへの言及がある場合は、実際にはanthropic-workspace-idヘッダーの欠落による400エラーです。
Claude CodeでAnthropic APIキーを使うには?
シェルでANTHROPIC_API_KEYを設定してclaudeを起動し、確認が出たらキーを承認します。Claude Code内で/statusを実行すると、どの認証情報が有効か確認できます。
出典
- Anthropic:Get your Claude API key、Authentication、Pricing、Rate limits、Models overview(2026年10月22日確認)
- Claude Code:Authentication and IAM(2026年10月22日確認)
- Flatkey:モデル一覧、Anthropic SDKガイド(2026年10月22日確認)


