導入文
「ClaudeCodeを動かすときに『APIキーを設定してください』と表示されたけれど、APIキーって何?どこで取るの?」――この悩みは、非エンジニアの方がClaudeCodeに最初に詰まるポイントの代表例です。APIキーは「あなたがAnthropicにお金を払って使うための鍵」のようなものですが、扱いを間違えると数万円〜数十万円の請求事故に繋がる怖い存在でもあります。本記事では、APIキーの取得手順を画面の流れに沿って、安全な保管方法、トラブル時の対処、料金の関係性まで、初心者でも安心して進められるよう日本語で網羅的に解説します。
結論ファースト
ClaudeCodeでAPIキーを使い始めるためのベスト手順は次の3ステップです。
- Anthropic Console(console.anthropic.com)にログインし、
API Keysメニューから「Create Key」をクリック。 - 発行されたキー(
sk-ant-で始まる文字列)を一度だけコピーし、すぐにパスワードマネージャや.envファイルに保存。再表示できないため、紛失したら作り直しになります。 - 環境変数
ANTHROPIC_API_KEYに設定し、ClaudeCodeでclaudeコマンドを実行する。
最重要ポイントは「APIキーは絶対にGitHubに上げない」「他人に教えない」「使わなくなったら必ずRevoke(失効)する」の3点です。本記事の本文では、Mac / Windows それぞれの環境変数の設定方法、ClaudeCodeでの使い方、料金確認方法、再発行手順、よくあるエラーまで一通り押さえます。なお、Claude.aiのProプランでログインする方式(OAuth方式)を使うなら、APIキーは不要です。「APIキーが必要かどうか分からない」方は、まず アカウント登録ガイド を読んで方式を決めるとスムーズです。
h2見出し: そもそもAPIキーとは何か
h3: APIキーは「あなた専用の入館証」
APIキーとは、AnthropicのAIサーバに「私は正規のお客様です」と証明するための、本人専用の長いパスワードのような文字列です。sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxx のような形をしており、このキーが漏れると第三者があなたの口座を使ってAIを呼び出せてしまうため、現金カードと同じ感覚で扱う必要があります。
h3: なぜClaudeCodeにAPIキーが必要なのか
ClaudeCodeはあなたのPCで動きますが、AIの「考える部分」はAnthropicのクラウド上のサーバで動いています。コードを書く指示が出るたびに、PC→Anthropicサーバ→PCと通信が往復します。このときAPIキーが「これは正規のお客様からのリクエストですよ、課金はこの口座で」と知らせる役割を果たしているのです。
h3: APIキー方式とサブスクリプション方式の違い
ClaudeCodeへの認証は2系統あります。
| 認証方式 | 必要なもの | 課金 | おすすめ用途 |
|---|---|---|---|
| Claude.aiログイン(OAuth) | Pro/Maxプランの契約 | 月額固定 | 個人開発・学習 |
| APIキー(Console) | Anthropic ConsoleのAPIキー | 使用量に応じた従量課金 | 業務利用・自動化・チーム |
「とにかく安くお試ししたい」「普段あまり使わない」方はAPIキー方式の方が安く済むこともあります。逆に「毎日3時間以上使う」方はProプランの方がお得です。
h2見出し: APIキー取得の事前準備
h3: Anthropic Consoleのアカウント
APIキーはAnthropic Console(https://console.anthropic.com)で発行します。Claude.aiと同じメールアドレスでサインアップすれば、両方を統合管理できます。アカウントの作り方は アカウント登録ガイド を参照してください。
h3: 支払い手段の登録
APIキーを発行するだけなら無料ですが、実際にAIを呼び出すには支払い手段の登録が必要です。新規アカウントには5ドル相当の無料クレジットが付与されることが多く、まずはこれで挙動を確認できます。クレジットカード(VISA / Mastercard / AMEX)が必要です。
h3: 用途と利用上限を決めておく
「個人の学習用」「社内ツール用」「特定プロジェクト専用」など、APIキーごとに用途を決めて発行する習慣をつけると、後で管理が格段に楽になります。
h2見出し: APIキーの取得手順【画面の流れ】
h3: ステップ1 ConsoleにログインしてAPI Keysメニューへ
ブラウザで https://console.anthropic.com にアクセスし、ログインします。画面左サイドバーから API Keys をクリックします。すでに発行済みのキーが一覧で表示されます(初回は空っぽです)。
h3: ステップ2 「Create Key」をクリック
画面右上の Create Key ボタンをクリックすると、ダイアログが開きます。次の3項目を入力します。
| 項目 | 例 | 説明 |
|---|---|---|
| Name | claude-code-personal |
キーの用途が分かる名前。後から変更可 |
| Workspace | Default |
組織内のワークスペース。個人なら Default のまま |
| Permissions | All |
通常は全権限でOK |
名前は後から見て分かるようにしましょう。test などの曖昧な名前にすると、3ヶ月後に「これ何のキーだっけ?」と分からなくなります。
h3: ステップ3 発行されたキーをコピー
「Create Key」を押すと、sk-ant-api03-xxxxxxxxxx... のような文字列が表示されます。このキーは「Copy」ボタンを押した直後にしか全文を確認できません。 画面を閉じると二度と表示されないので、必ずコピーしてから次のステップへ進みます。
h3: ステップ4 安全な場所に保存
コピーしたキーは、次のいずれかの場所に保存します。
- パスワードマネージャ(1Password / Bitwarden / iCloudキーチェーンなど)
.envファイル(プロジェクトフォルダ内、ただし.gitignoreで除外必須)- OSの環境変数(次セクションで解説)
絶対にやってはいけないのは、メモ帳やSlackの個人メモ欄、GitHubのコードコメント欄に貼り付けることです。
h2見出し: 環境変数への設定方法(OS別)
h3: macOSの場合
ターミナルを開き、自分が使っているシェルを確認します。
echo $SHELL
/bin/zsh と表示された方は ~/.zshrc、/bin/bash と表示された方は ~/.bash_profile を編集します。次のコマンドで末尾に追記しましょう(sk-ant-... の部分はコピーしたキーに置き換えてください)。
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc
設定できたか確認するコマンド:
echo $ANTHROPIC_API_KEY
キーの先頭が表示されれば成功です。
h3: Windows(PowerShell)の場合
PowerShellを管理者権限で起動し、次のコマンドを実行します。
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-api03-xxxxxxxxxx', 'User')
設定後、PowerShellを一度閉じて開き直し、確認します。
echo $env:ANTHROPIC_API_KEY
h3: WSL(Linux)の場合
~/.bashrc に追記します。
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc
h3: プロジェクトごとに `.env` で管理する方法
複数のプロジェクトで違うキーを使い分けたい場合は、プロジェクトのルートに .env ファイルを作る運用が便利です。
ANTHROPIC_API_KEY=sk-ant-api03-xxxxxxxxxx
そして必ず .gitignore に .env を追加します。
.env
.env.local
これを忘れるとGitHubにキーが漏れる事故に直結するため、最初の1行として書く習慣をつけましょう。
h2見出し: ClaudeCodeでAPIキーを使う
h3: 起動時にキーが自動で読み込まれる
環境変数を設定したあとに claude コマンドを実行すると、ClaudeCodeが自動的に ANTHROPIC_API_KEY を読み込みます。特別な設定は不要です。
cd ~/your-project
claude
起動時に「Authenticated via API key」のような表示が出れば成功です。
h3: モデルを指定して呼び出す
ClaudeCodeはデフォルトでClaude Opus(最上位モデル)を使いますが、料金を抑えたい場合はSonnetに切り替えることもできます。
claude --model claude-sonnet-4-5
ただし、本ブログ運用ルールでは社内アプリ開発時は基本Opusを推奨しています。詳しくは 料金プラン解説 を参照してください。
h3: チームで共有するときの注意
業務でチームで使う場合、APIキーを共有してはいけません。各メンバーが個別のキーを発行し、Anthropic Consoleの「Workspace」機能で課金集計するのが正しい運用です。
h2見出し: セキュリティ対策【絶対に守ること】
h3: キーをGitHubに絶対に上げない
最も多い事故が「うっかりGitHubの公開リポジトリにAPIキーをpushしてしまう」ケースです。GitHubは公開キーを自動検知してAnthropicに通報する仕組みを持っており、Anthropic側でも自動で該当キーをRevokeしてくれますが、それより早くbotがキーを使ってAIを呼び出し、数千ドルの請求が来ることがあります。
防止策:
.gitignoreに.envを必ず記載git secretsなどのコミット前チェックツールを導入- コミット前に
git diffで変更内容を必ず確認
h3: キーをハードコードしない
# 絶対NG
client = Anthropic(api_key="sk-ant-api03-xxxxx")
# OK
import os
client = Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])
h3: 利用上限(Spend Limit)を設定する
Console → Settings → Limits で「月100ドルを超えたら停止」のような上限を設定できます。事故時の被害を最小化する保険として必ず設定しましょう。
h3: 不要なキーは即Revoke
「あの古いプロジェクト用のキー、もう使ってないな」というキーは、放置せずConsoleの一覧から「Revoke」を押して失効させます。Revoke済みのキーで呼び出すとエラーになるので、漏れても被害ゼロです。
h2見出し: APIキーの再発行と失効
h3: 紛失したときの再発行手順
「コピーし忘れた」「PCが壊れた」場合、紛失したキーは復元できません。次の手順で新しいキーを発行します。
- Console → API Keys
- 紛失したキーの「⋯」メニュー → Revoke
- 「Create Key」で新しいキーを発行
- 環境変数
ANTHROPIC_API_KEYを更新
h3: 漏洩が疑われるときの緊急対応
GitHubのpush履歴を確認したり、不審な請求が来た場合は次の順で対処します。
- Consoleで該当キーを 即Revoke
- 新しいキーを発行
- すべての環境変数・
.envを更新 - Anthropicサポート(support@anthropic.com)に状況を連絡
- クレジットカード会社にも連絡(場合により)
h3: 退職者のキーを残さない
社員が退職する際は、その人が発行したAPIキーをすべてRevokeすることを退職プロセスに組み込みましょう。
h2見出し: 料金とAPIキーの関係
h3: 料金は「キー単位」ではなく「ワークスペース単位」
APIキーを何本発行しても、課金は所属するワークスペース全体で合算されます。キーごとに料金が分かれるわけではありません。
h3: 1リクエストの料金イメージ(2026年5月時点)
| モデル | 入力(100万トークンあたり) | 出力(100万トークンあたり) |
|---|---|---|
| Claude Opus 4.x | 約15ドル | 約75ドル |
| Claude Sonnet 4.x | 約3ドル | 約15ドル |
| Claude Haiku | 約0.25ドル | 約1.25ドル |
「100万トークン」とは日本語でだいたい60万〜70万文字に相当します。一般的な開発で1日中ClaudeCodeを使っても数百円〜数千円のレンジに収まることが多いです。
h3: 使用量の確認方法
Console → Usage で日次・月次のグラフが見られます。Workspaceごと、Modelごと、API Keyごとに絞り込みもできます。
h2見出し: よくあるトラブルと対処法
h3: 「Invalid API Key」と表示される
- キーの先頭・末尾に余計な空白が入っていないか確認
- 環境変数が正しく設定されているか
echo $ANTHROPIC_API_KEYで確認 - すでにRevokeされていないかConsoleで確認
h3: 「Rate limit exceeded」と表示される
短時間に大量のリクエストを送ると一時的に制限がかかります。30秒〜1分待って再実行してください。頻発する場合はConsoleでTier(利用枠)の引き上げを申請できます。エラー全般は ClaudeCodeのエラー対処集 を参照してください。
h3: 「Insufficient credits」と表示される
無料クレジットを使い切ったか、支払い設定が完了していません。Console → Billing でクレジットを購入するか、自動チャージ(Auto-reload)を設定しましょう。
h3: 環境変数を設定したのに反映されない
ターミナルを一度すべて閉じて開き直してください。source ~/.zshrc だけでは新しいタブに反映されないことがあります。
よくある質問(FAQ)
Q1. APIキーとClaude.aiのパスワードは違うものですか? A. 別物です。Claude.aiのパスワードはチャットUIにログインするためのもの、APIキーはClaudeCodeなどの外部ツールがAIを呼び出すための鍵です。2つを混同しないようにしましょう。
Q2. APIキーは何本まで発行できますか? A. 無料アカウントでも複数本発行できます(実質上限なし)。プロジェクトごとに分けて発行するのが管理上のベストプラクティスです。
Q3. APIキーがあれば月額プランはいらないですか? A. はい、APIキー方式だけで完結できます。ただし重い使い方をする方はProプラン(月20ドル)の方がトータルで安くなる場合もあります。詳しくは 料金プラン徹底比較 を参照してください。
Q4. APIキーを共有PCに保存しても大丈夫ですか? A. 推奨しません。共有PCは退職者や来訪者がアクセスできる可能性があり、漏洩リスクが高いためです。個人PCの環境変数で管理しましょう。
Q5. キーが漏れたら自動でAnthropicが止めてくれますか? A. GitHub等の公開リポジトリに上げた場合は自動検知で止まりますが、SlackのDMやメールで漏れた場合は検知されません。自分でRevokeする必要があります。
Q6. 法人で利用する場合の請求はどうなりますか? A. クレジットカード払いのほか、Enterpriseプランでは請求書払いにも対応しています。月次まとめ請求が可能なので経理処理が楽です。
Q7. APIキーの有効期限はありますか? A. デフォルトでは無期限ですが、Console上で有効期限を設定することもできます。セキュリティ重視のチームでは「3ヶ月で自動失効」運用がおすすめです。
まとめ
- APIキーは「Anthropicに支払う鍵」、現金カードと同じ感覚で扱う
- Anthropic Consoleで発行 → 一度だけコピー可能 → 環境変数に保存
ANTHROPIC_API_KEY環境変数に入れれば ClaudeCode が自動で読み込む- GitHubに絶対上げない、
.gitignoreで.envを除外 - Spend Limit を設定して事故時の被害を最小化
- 紛失・漏洩時は即Revoke → 新キー発行
- 業務利用ではメンバーごとに個別キー、退職時にRevokeを徹底