メインコンテンツへスキップ
AMPL/ dev
開発系講座一覧

API キーは、家の鍵

API の窓口は、API キーという鍵で、使ってよい相手かを見分けます。鍵を持っている人は、あなたの財布で Claude を使えます。だから、人に見せてはいけない秘密情報として扱います。

佐藤さん(会社員で、実家の和菓子店を手伝う、架空の人物)は、Claude API の説明を読み進めました。どのページにも「API キー」という言葉が出てきます。鍵と聞いて思い浮かぶのは、店の裏口の鍵くらいです。

問い

佐藤さんの疑問

作品から Claude を使うのに、なぜ鍵が要るんだろう。

白い札をひもで結んだ、古い形の鍵の挿絵。

前の回で、作品が API(作品と Claude をつなぐ受付窓口)にリクエスト(頼みごと)を送り、レスポンス(答え)を受け取る仕組みを見ました。

窓口には、世界中からリクエストが届きます。窓口は、どうやって「この人の利用分で受け付けてよい」と見分けているのでしょうか。この回では、そのための鍵を見ていきます。

API キー:使ってよい相手だと示す鍵

API に頼みごとを送るとき、作品は、リクエストと一緒に、長い英数字の並びを送ります。これを、API キーと呼びます。窓口は、このキーを見て、誰の利用分で受け付けるかを決めます。

Claude のヘルプセンターには、こう書かれています。

DOCUMENTATION

“Your API key is a digital key to your account. Much like a credit card number, if someone obtains and uses your API key, they incur charges on your behalf.”

API キーは、あなたのアカウントの、デジタルな鍵です。クレジットカードの番号と同じように、誰かがあなたの API キーを手に入れて使うと、あなたの代わりに料金が発生します。

AnthropicAPI key best practices(Claude ヘルプセンター)

家の鍵を落とせば、誰でも家に入れます。API キーが人に知られれば、誰でも、あなたの利用分で Claude を使えます。

鍵を持てば、誰でも使える

概念図

あなたの作品 鍵を正しく使う 鍵を写した人 漏れた鍵を使う API の窓口 鍵を見て受け付ける あなたの利用分 ここから払う 鍵つきで頼む 同じ鍵で頼む 請求 あなたの作品 鍵を正しく使う 鍵を写した人 漏れた鍵を使う API の窓口 鍵を見て受け付ける あなたの利用分 ここから払う 鍵つきで 頼む 同じ鍵で 頼む 請求
図1窓口は鍵を見て受け付けます。鍵を写した人の分も、あなたの利用分から払われます。

秘密情報:人に見せてはいけないもの

API キーやパスワードのように、人に知られると困る情報を、まとめて秘密情報と呼びます。英語では secret(シークレット)と書かれます。

同じヘルプセンターの記事には、鍵が漏れるよくある原因として、公開リポジトリ(誰でも見られる作品の置き場)に、鍵をそのまま書いて送ってしまうことが挙がっています。話し合いの場や、メール、問い合わせにも、たとえ Anthropic とのやり取りでも、鍵を書かないように、とあります。

この講座では、もう1つ決めておきます。Claude との会話にも、鍵そのものは貼りません。鍵の置き方は、第6部の第4回で見ます。

API キーを作る

API キーは、第2部の第10回で見た、Claude Console(API キーを作り、使った量を見る、開発者向けの管理画面)で作ります。Claude API の公式の説明と、ヘルプセンターの記事によると、手順は次のとおりです。画面の言葉は英語のことがあります。

  1. ブラウザで Claude Console にログインし、API キーのページ(platform.claude.com/settings/keys)を開く
  2. 「Create key」(キーを作る)を押す
  3. キーに名前を付け、使える期限を選ぶ
  4. 画面に出た鍵をコピーし、すぐに安全な場所にしまう

期限は、短めにしておきます。同じヘルプセンターの記事には、たとえば90日ごとのように、決まった間隔で新しい鍵を作り、古い鍵を止めるように、と書かれています。ハッカソンなら、大会が終わるころまでの期限で十分です。

安全な場所とは、鍵をしまうための場所のことです。パスワードを管理するアプリ(Mac の「パスワード」アプリなど)がよいでしょう。メモ帳のファイルや、画面の写真には残しません。作品で使う鍵は、第6部の第4回で、作品の外の置き場に入れます。

名前は、何に使う鍵かが分かるように付けます。佐藤さんは、urenokori-dev(売れ残り帳の、作っている途中用)にしました。同じヘルプセンターの記事には、作っている途中用と、本番用(人に使ってもらう用)で、できれば別の鍵を使うように、とも書かれています。

API キーは、あなたの利用分で Claude を使うための鍵です。人に見せてはいけない秘密情報として扱います。

注意

ただし、画面の写真にも写る

鍵は、文字で書き写したときだけ漏れるのではありません。Console の画面や、鍵を書いたファイルを開いた画面を写真に撮って、人に送ったり、デモ動画に映したりしても、漏れます。

第4部の第9回で、困ったら画面の写真を撮って Claude に見せる、と書きました。鍵が写っている画面は、撮らないでください。撮ってしまったら、送る前に消します。

次回の問い

佐藤さんの次の疑問です。作品の中の Claude を使うと、どのくらいお金がかかるのでしょうか。

参考

API キーのベストプラクティス(Claude ヘルプセンター)
API キーを安全に扱うための、公式の注意。日本語。
support.claude.com · support.claude.com
Vibe Coding 用語集:API キー
API キーの説明と、扱い方。
AMPL · Web

このレッスンは役に立ちましたか?