APIキーはどこで発行する？Claude Consoleの登録から
Claude APIキー（Anthropic APIキーとも呼ぶ）はClaude Consoleで管理する
室谷代表取締役Claude APIキー、Anthropic APIキーとも呼ばれるんですけど、これclaude.aiのチャット画面の設定には出てこないんですよね。管理する場所はClaude Console、platform.claude.comの側なんです。
テキトー教師DotAI 認定講師そこ、最初に戸惑う人が多いんですよ。チャットのアカウント設定を開いてキーを探して「ないぞ」となる。
別プロダクトくらいに思っておいた方がいいです。
別プロダクトくらいに思っておいた方がいいです。
室谷代表取締役既存のキーが生きてるか確認したいときも同じで、API keysページ、platform.claude.com/settings/keys が入口なんですよね。組織で誰がどのキーを持ってるか見えないまま回ってると、だいたい事故ります。
テキトー教師DotAI 認定講師個人で触ってる分には見えなくても平気なんですけど、人が増えた瞬間に効いてくるやつですね。
個人利用ならIndividual、会社やチームならOrganizationを選ぶ
テキトー教師DotAI 認定講師で、登録のときに最初の分かれ道があるんですよ。個人利用なら「Individual」、会社やチームで使うなら「Organization」を選ぶ。
ここで手が止まる人はけっこういます。
ここで手が止まる人はけっこういます。
室谷代表取締役経営目線で言うと、会社で使う予定があるなら最初からOrganizationで作った方がいいんですよね。請求も権限も、あとから紐づけ直すより楽なので。
個人の検証と会社の案件が同じ財布で混ざると、誰の何のコストか説明できなくなるんですよ。
個人の検証と会社の案件が同じ財布で混ざると、誰の何のコストか説明できなくなるんですよ。
テキトー教師DotAI 認定講師たしかに。あとから「これ会社の案件で使ったやつです」って言いにくい状態になりますもんね。
室谷代表取締役そう。あとUIの英語名って変わりうるので、実際の画面表示を優先で。
細かい文言は公式ヘルプで確認してほしいところです。
細かい文言は公式ヘルプで確認してほしいところです。
メールアドレスかGoogleアカウントでSign Upする
- Claude Console（platform.claude.com）を開く
- 「Sign Up」を選ぶ
- メールアドレスかGoogleアカウントで登録する
- 個人利用なら「Individual」、会社やチームなら「Organization」を選ぶ
- サインイン後、API keysページ（platform.claude.com/settings/keys）を開く
テキトー教師DotAI 認定講師登録自体は重くなくて、メールアドレスかGoogleアカウントのどちらかでSign Upすれば終わりです。Googleで入るとパスワード管理が減るので、現場感覚だとそっちを選ぶ人が多いですね。
室谷代表取締役で、サインインしたあとにAPI keysページを開いて、次はキーを作る作業になるんですよ。ここから先の方が大事で、Create keyを押した後の扱いで事故るかどうかが決まる・・・
テキトー教師DotAI 認定講師そこが最初の山場ですね。発行画面は一度閉じると二度と見れないので、次の手順は気を抜かない方がいいです。
APIキーを新規作成する手順 — Create keyを押してからやること
API keysページを開いて「Create key」を押すまで
APIキー新規作成の流れ
- 01Claude Consoleにサインインplatform.claude.com にサインインする
- 02API keysページを開くplatform.claude.com/settings/keys を開く(ブックマーク推奨)
- 03「Create key」を押す押せない場合はロールの作成権限を確認
- 04名前・有効期限・Linked accountを設定必要ならワークスペースも選択
- 05sk-ant-で始まる文字列をコピーして保管表示は一度きり。閉じると復元不可。シークレットマネージャー等へ貼るまでを1手順に
まずは入口の確認です。キーの新規作成はこの順番で進みます。
- Claude Console（platform.claude.com）にサインインする
- API keysページ（platform.claude.com/settings/keys）を開く
- 「Create key」を押す
室谷代表取締役キー作成の入口はシンプルで、ConsoleにサインインしてAPI keysページを開き、そこで「Create key」を押す。ここまでは迷わないと思うんですよね。
テキトー教師DotAI 認定講師入口自体は迷わないんですけど、初めて触る人は「設定画面のどこにあるんだろう」で止まりがちで。URLが分かっていれば一発なので、ブックマークしておくと楽です。
室谷代表取締役あ、それは効きますね。設定画面を毎回探すの、地味に時間を食うので。
テキトー教師DotAI 認定講師そして押した後の画面が本番なので、そこから何を決めるかが大事になってきます。
名前・有効期限・Linked accountの3つを決める
室谷代表取締役「Create key」を押すと、名前・有効期限・Linked accountの3つを設定する画面になるんですよ。必要ならワークスペースも選ぶ。
テキトー教師DotAI 認定講師名前は後から見て分かるものにしておくのが大事で。現場でよく聞くのは「どのキーがどれだか分からなくなった」という声なんですよ。
室谷代表取締役有効期限、ここは判断が要るところで。無期限は楽なんですけど、漏れたときに使われ続ける期間も無期限になる。
テキトー教師DotAI 認定講師Linked accountは、自分自身にするかサービスアカウントにするかで、その後の扱いが変わってきます。この選び分けは次の章でじっくり、という形で。
sk-ant-で始まる文字列は一度しか表示されない
室谷代表取締役作成するとsk-ant-で始まる文字列が表示されるんですけど、これその場でしか見られないんですよね。閉じたら終わり。
テキトー教師DotAI 認定講師ここ、ハマる人多いんですよ。「あとで管理画面から見返せるだろう」と思って閉じてしまうパターンで。
室谷代表取締役で、復元はできない。同じキーを取り戻すことはできなくて、新しいのを作り直すしかない。
MYUUUの現場だと、生成直後にシークレットマネージャーへ入れるまでを1手順として固定してます。
MYUUUの現場だと、生成直後にシークレットマネージャーへ入れるまでを1手順として固定してます。
テキトー教師DotAI 認定講師コピーして保管先に貼る、までをセットの動作にしておくといいですね。表示された瞬間が唯一のチャンスなので。
「Create key」が押せないときはロールの権限を確認する
室谷代表取締役ちなみに「Create key」が押せない、グレーになっている、という相談も来るんですけど。
テキトー教師DotAI 認定講師それは自分のロールに作成権限がないパターンですね。組織に入ったばかりの人が最初に戸惑うのがここで。
室谷代表取締役組織の管理者にロール変更を頼むか、サービスアカウントキーの作成をお願いする。ここは自分だけでは解決できないので、早めに確認したほうがいいんですよね。
テキトー教師DotAI 認定講師あとAdmin APIでキーの一覧や情報は取れても、値そのものは返ってこないんですよ。部分的に伏せられたヒントだけ、という点は覚えておくと誤解が減ります。
personal key・service account key・workspace keyはどう選ぶ？
personal keyは自分自身として動き、組織を離れると失効する
室谷代表取締役キー作成の画面で、名前と有効期限の下に「Linked account」って項目があるんですよ。ここで自分自身を選ぶかサービスアカウントを選ぶかで、キーの性格がまるっきり変わるんですよね。
テキトー教師DotAI 認定講師初めて触る人はそこを一番見落としますね。名前をつけて期限を決めて、はい次へ、みたいな流れで流しちゃう。
実はそこが本体なんですよ。
実はそこが本体なんですよ。
室谷代表取締役自分自身を選ぶと personal key で、その人が自分として動くキーになる。だから組織を離れると失効するんですよ。
個人で試す分にはこれで何も困らないんですけど、業務で使うとなると話が変わってくる・・・
個人で試す分にはこれで何も困らないんですけど、業務で使うとなると話が変わってくる・・・
テキトー教師DotAI 認定講師たしかに。個人の検証用と、会社の仕組みに組み込む用は、そもそも別物として考えたほうがいいですね。
service account keyは本番・CI・エージェントなどの共有ワークロード向け
テキトー教師DotAI 認定講師じゃあ共有側はどう考えるのがいいんでしょう。
室谷代表取締役本番サービス、CIパイプライン、エージェントみたいな、誰か一人に紐づかない働きをさせる場所はサービスアカウントのキーにする。これが公式の推奨でもあるんですよね。
経営目線で言うと、担当者が辞めるたびに本番が止まる設計は普通に怖いので、そこは最初から分けておきたい。
経営目線で言うと、担当者が辞めるたびに本番が止まる設計は普通に怖いので、そこは最初から分けておきたい。
テキトー教師DotAI 認定講師現場でよく聞くのは、自分のキーをそのままサーバーに置いちゃったパターンです。動いてしまうので、しばらく誰も気づかないんですよ。
室谷代表取締役外部のツールにつなぐ場合も同じで、自動化の側に置くキーは共有ワークロードとして扱う。n8n みたいなところと繋ぐときの考え方はAPI・MCP・Claude Codeの使い分けと実践事例でも触れているので、そっちと合わせて見ると整理しやすいと思います。
作成者が離れても残り続けるworkspace keyが非推奨な理由
キーの種類と選び方
personal key
- 自分自身として動くキー
- 作成者本人に紐づく
- 組織を離れると失効する
- 個人の検証用には困らない
service account key
- 誰か一人に紐づかない共有ワークロード向け
- 本番サービス・CIパイプライン・エージェントに使う
- 公式の推奨
- 外部ツール連携の自動化側にも使う
- 担当者が辞めても本番が止まらない設計にできる
室谷代表取締役で、最後に workspace key なんですけど、これは所有者を持たないレガシーなキーなんですよ。作成者が離れても残り続ける。
一見便利そうに見えるんですが、公式は personal key か service account key を使うようにと言っている。
一見便利そうに見えるんですが、公式は personal key か service account key を使うようにと言っている。
テキトー教師DotAI 認定講師残り続けるって聞くと安心に聞こえますけど、逆なんですよね。誰の責任範囲か分からないキーが生きてる状態は、管理する側からすると一番厄介です。
室谷代表取締役作成時に Console でワークスペースを選べるので、そこから workspace key と混同しちゃう人がいるんですけど、新しく作る場面でわざわざそっちを選ぶ理由はほぼないかなと。迷ったら personal か service account、この二択で考えれば大丈夫です。
テキトー教師DotAI 認定講師なるほど。選択肢が三つあると思うと悩みますけど、実質二択だと分かれば気が楽ですね。
取得したキーを設定して呼び出す — 環境変数とSDK・curl
環境変数ANTHROPIC_API_KEYにキーを設定する
- ターミナルを開く
export ANTHROPIC_API_KEY="sk-ant-api03-..."を実行する（値は作成時にコピーしたキー）- 常用する場合は、シェルの設定ファイルにも同じ1行を書いておく（ターミナルを閉じると2の設定は消える）
- 新しいターミナルを開き、
echo $ANTHROPIC_API_KEYで値が返るか確認する
室谷代表取締役まず大原則として、キーはコードに直書きしない。環境変数に入れておけば、手元でも本番でも同じコードがそのまま動くんですよね。
テキトー教師DotAI 認定講師最初に戸惑うのが、exportしたのにターミナルを閉じたら消えているところで。「さっきまで動いてたのに」の正体はほぼこれなんですよ。
室谷代表取締役MYUUU だと、どのキーが誰のものか分からなくなりがちで。名前と用途を決めてから作る、くらいの運用にしておくと後で楽です。
テキトー教師DotAI 認定講師あと設定ファイルに書きっぱなしのキーが残るのも怖いところですね。使わないものは消す、をセットで習慣にしたいです。
Python・TypeScriptのSDKは環境変数を自動で読み取る
室谷代表取締役ここが楽な部分で。公式SDKはANTHROPIC_API_KEYを勝手に読んでくれるので、コード側でキーを渡す必要がないんですよ。
code
pip install anthropiccode
import anthropic
client = anthropic.Anthropic() # 引数なしでOK
client.messages.create(model=..., max_tokens=..., messages=[...])逆に「コードにキーを書かないと動かない」と思い込んでいる人が多いんですよ。初期化が引数なしで通るかどうかが、環境変数の設定が正しいかのテストにもなります。
室谷代表取締役TypeScriptでも同じ仕組みなので、開発と本番でキーだけ差し替える形にできる。ここを直書きすると、リポジトリに上がった瞬間に漏れるので、そこだけは徹底したいですね。
curlで直接リクエストして動くか確かめる
室谷代表取締役code
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: <version>" \
-H "content-type: application/json" \
-d '{"model":"...","max_tokens":...,"messages":[{"role":"user","content":"Hello"}]}'ヘッダーはキーとバージョンの2つ、と覚えると楽ですね。本文はJSONで渡すので、ここが崩れていると弾かれます。
室谷代表取締役なお公式の案内は Authorization: Bearer
テキトー教師DotAI 認定講師キーをワークスペースに紐づけていない場合は、ワークスペースIDのヘッダーが必要になる場合もあります。エラーが返るなら、まずキーとヘッダーの綴りを疑ってみてください。
ConsoleのPlaygroundで先に挙動を試す
室谷代表取締役コードを書き始める前に、ConsoleのPlaygroundで同じキーが生きているか見るのが一番早い。ブラウザで完結しますから。
テキトー教師DotAI 認定講師現場でよく聞くのは「キーは作ったけど、どこで試せばいいか分からない」なんですよ。Playgroundならプロンプトを打つだけで返ってくるので、設定ミスかどうかの切り分けが一発でできます。
室谷代表取締役MaxやTeamのプランなら、毎月のAPIクレジットがPlaygroundにも使えます。Console側に支払い方法を足さなくても試せるのは大きいところですね。
テキトー教師DotAI 認定講師料金はかかる？無料クレジットとカード登録の実際
キーの発行自体は無料、呼び出した分だけ従量課金
室谷代表取締役まず先に安心しておきたいのが、キーを発行する行為そのものは無料なんですよね。Consoleで「Create key」を押してお金が動くことはない。
課金が始まるのは、そのキーでAPIを実際に呼び出した瞬間からです。
課金が始まるのは、そのキーでAPIを実際に呼び出した瞬間からです。
テキトー教師DotAI 認定講師たしかに。初めて触る人は「キーを作った時点で月額が発生するのか」と身構える方が多いんですよ。
そこは全然別の話なんですけど、混ざってしまうみたいで。
そこは全然別の話なんですけど、混ざってしまうみたいで。
室谷代表取締役従量課金なので、モデルごとに単価が違います。100万トークンあたりの米ドルで、Sonnet 5.5が入力2ドル・出力10ドル、Opus 5.5が入力4ドル・出力20ドル。
動作確認で数回叩く程度なら、誤差みたいな金額で収まります。
動作確認で数回叩く程度なら、誤差みたいな金額で収まります。
テキトー教師DotAI 認定講師現場感覚で言うと、小さいプロンプトで1回動かして、そのあと請求を確認する、の順番が安心ですね。モデルの選び方で迷うならAnthropic、最強エージェントモデル「Claude Sonnet 5」発表 性能はOpus 4.8に迫る低価格も参考になります。
新規ユーザー向けの無料クレジットと、カード登録を求められたという報告
テキトー教師DotAI 認定講師ここが一番聞かれるところなんですけど、初回にカードを登録させられた、という話。
室谷代表取締役公式のFAQには、新規ユーザーにはAPIをテストするための少額の無料クレジットが付くと書かれているんですよね。一方で、初回のキー発行時にクレジットカード登録と少額のクレジット購入を求められた、という報告も出ています。
テキトー教師DotAI 認定講師つまり人によって画面が違う、と。そこで「無料って聞いたのに」と戸惑う人が出るんですよ。
時期や地域で案内は変わりうるので、Consoleに出ている内容がそのまま正解、と考えるのが確実です。
時期や地域で案内は変わりうるので、Consoleに出ている内容がそのまま正解、と考えるのが確実です。
室谷代表取締役無料クレジットが付くならそれで試せばいいし、購入を求められたら最小額で入れる。判断はそれだけなんですけど、会社で使うなら先に誰のカードで払うか決めておいたほうがいいですね。
あとから経費の押し付け合いになるので。
あとから経費の押し付け合いになるので。
請求とクレジット購入はBillingページで管理する
室谷代表取締役支払い方法の登録・変更とクレジットの購入は、ConsoleのBillingページにまとまっています。キーを作る画面とは別なので、最初に一度開いて場所を押さえておくのがいいんですよね。
テキトー教師DotAI 認定講師最初に戸惑うのがまさにそこなんですよ。キーを作る画面と、お金の画面が分かれている。
作ったあと一度もBillingを見ていない、という状態が実はいちばん怖いんです。
作ったあと一度もBillingを見ていない、という状態が実はいちばん怖いんです。
室谷代表取締役そこは運用の話で。使った分がそのまま積み上がる世界なので、月に一度は開く、を習慣にしたほうがいい。
キーを増やすことより、金額が見えていることのほうが経営的には効いてきます。
キーを増やすことより、金額が見えていることのほうが経営的には効いてきます。
Max/Teamプランなら毎月APIクレジットが付く — 追加のカード登録なしで試す方法
毎月いくら分ついてくるのか
室谷代表取締役MaxやTeamを契約してる人、実は毎月Claude Platform向けのクレジットが付いてくるんですよ。金額はこうなってます。
| プラン | 毎月のクレジット |
|---|---|
| Max 5x | $100 |
| Max 20x | $200 |
| Team Standard | シートあたり$20 |
| Team Premium | シートあたり$100（組織全体でプール・上限$500） |
テキトー教師DotAI 認定講師これは知らない人、多そうです。「サブスクは払ってるけどAPIは別料金」で止まってる現場、けっこうありますよね。
室谷代表取締役Teamは組織全体にプールされる形なので、まずこの枠で検証を回して、足りない分だけ従量に乗せる設計ができる。人数が多い会社ほど効きます。
テキトー教師DotAI 認定講師カードを追加しに行く前に、一度Billing設定を見る価値ありですね。
クレジットが使える範囲と、使えない範囲
テキトー教師DotAI 認定講師ここで注意したいのが対象範囲です。Claude API、Claude Managed Agents、Claude Agent SDK、Console内のPlayground。
このあたりは枠内で動きます。
このあたりは枠内で動きます。
室谷代表取締役逆にClaude CodeやClaudeアプリの追加利用分は対象外なんですよね。ここを混同すると「クレジットあるのに請求が来てる」になる。
テキトー教師DotAI 認定講師現場でよく聞くのがまさにそれで、Playgroundで試してる分とアプリ側の利用を同じ財布だと思ってるケースです。別物として分けて考える必要があります。
室谷代表取締役クレジットはあくまでClaude Platform側の財布、と覚えるのが一番早いですね。
受け取りはConsole組織をリンクするだけ
室谷代表取締役受け取り方も拍子抜けするくらい簡単で。claude.aiのBilling設定から、Claude Consoleの組織をプランにリンクする。
それだけで、Claude Platform側に支払い方法を足す必要はないんですよ。
それだけで、Claude Platform側に支払い方法を足す必要はないんですよ。
テキトー教師DotAI 認定講師カード登録が先に必要だと思い込んで、そこで止まってる人は多そうですね。
室谷代表取締役テキトー教師DotAI 認定講師ここまで来ると、試すまでのハードルが一気に下がります。
使い切れなかった分は繰り越されない
プラン別の毎月付与APIクレジットと対象範囲
| 項目 | Max 5x | Max 20x | Team Standard | Team Premium |
|---|---|---|---|---|
| 毎月のクレジット | $100 | $200 | シートあたり$20 | シートあたり$100 |
| プール/上限 | — | — | — | 組織全体でプール・上限$500 |
| Claude API | ○ | ○ | ○ | ○ |
| Managed Agents / Agent SDK | ○ | ○ | ○ | ○ |
| Console内Playground | ○ | ○ | ○ | ○ |
| Claude Code・アプリ追加利用 | × | × | × | × |
| 翌月への繰り越し | × | × | × | × |
テキトー教師DotAI 認定講師一つ落とし穴があって。このクレジット、請求サイクルごとに失効して、次の月に繰り越されないんですよ。
室谷代表取締役経営目線で言うと、完全に「使い切る前提の枠」なんですね。寝かせたら消えるだけなので、検証したいタスクは月初に寄せた方がいい。
テキトー教師DotAI 認定講師現場感覚で言うと、月末に慌ててPlaygroundを触るより、小さなバッチを回し続ける方が身になります。
室谷代表取締役そうですね。額が大きいプランほど、使わないとただの寄付になる。
サブスクなのに課金された？二重課金を防ぐ確認と対処
ANTHROPIC_API_KEYがあるとサブスク認証より先に使われる
室谷代表取締役ここが一番の落とし穴なんですよ。環境変数にキーが残っていると、Claude CodeはProやMaxのサブスク認証より先に、そっちのキーを使うんですよね。
テキトー教師DotAI 認定講師え、じゃあサブスクを払っているのに別で従量課金が乗るってことですよね。初めて触る人がまず事故るのがここなんですよ。
室谷代表取締役しかも、自分で設定したこと自体を忘れてるパターンが多くて。シェルの設定ファイルに古いキーが残ったままMaxを使い続けて、気づいたら1か月で300ドル近い追加請求が来た、という報告も上がってます。
テキトー教師DotAI 認定講師それは効きますね・・・。設定した本人は「入れた記憶がない」んですよ、半年前の自分が犯人っていう。
/statusで「Claude API Account」になっていないか確認する
室谷代表取締役確認はシンプルで、ターミナルで
/status を打つだけなんです。テキトー教師DotAI 認定講師そこで見るのは「Plan」の表示ですね。MaxとかProと出ていればサブスクで動いてる。
逆に「Claude API Account」になっていたら、その時点ではキー経由で課金されている状態です。
逆に「Claude API Account」になっていたら、その時点ではキー経由で課金されている状態です。
室谷代表取締役一度見ておくだけで事故確率が変わるやつです。設定した直後と、しばらく使ってない期間の後、この2回は必ず見るようにしてます。
テキトー教師DotAI 認定講師現場でよく聞くのは「入れた覚えがないのにAPI Accountになってた」なんですよ。別のツール用にキーをexportしたまま、って流れが多いですね。
不要な環境変数を消し、auto-reloadをオフにする
二重課金を防ぐ確認と対処の手順
- 01ANTHROPIC_API_KEYの行を削除シェルの設定ファイルから ANTHROPIC_API_KEY の行を消す
- 02ターミナルを開き直して /status を再確認開き直さないと古い環境変数が残ったままになる。「Plan」がMax/Proならサブスク、「Claude API Account」ならキー経由で課金中
- 03auto-reloadをオフにするClaude ConsoleのBillingページ（platform.claude.com/settings/billing）で設定。残高が減ると自動チャージされ続けるため
やることはこの3つです。
- シェルの設定ファイルから
ANTHROPIC_API_KEYの行を消す - ターミナルを開き直して
/statusを再確認する - Claude ConsoleのBillingページ（platform.claude.com/settings/billing）でauto-reloadをオフにする
室谷代表取締役2番を飛ばす人が多いんですけど、開き直さないと古い環境変数が残ったままなので。
テキトー教師DotAI 認定講師auto-reloadは「残高が減ったら自動でチャージ」なので、放置すると止まらないんですよ。使う予定がないなら切っておくのが安心ですね。
室谷代表取締役サブスク側の枠で足りるなら、そもそもキーを常駐させないのが正解なんですよね。Claude Codeの利用制限そのものの話は週間制限の延長の記事でも触れているので、そちらと合わせて考えると整理しやすいです。
テキトー教師DotAI 認定講師たしかに。サブスクで回す分には追加請求は出ないので、まずそこを土台にするのが大事ですね。
キーを安全に保つ管理と、漏れた・失くしたときの対処
コードに直書きせず環境変数とシークレットマネージャーで持つ
室谷代表取締役ここからはキーを「配るもの」じゃなく「管理するもの」として扱う話なんですよね。コードに直書きしたキーがGitHubに上がる、あれが一番よくある事故で、対応コストは時給換算とかのレベルじゃ済まないんですよ。
テキトー教師DotAI 認定講師現場でよく聞くのも同じで、サンプルコードをそのまま貼ったらキーが本文に残ってた、というパターンです。まず環境変数に入れる、これだけで大半は防げます。
室谷代表取締役公式が案内してるのは ANTHROPIC_API_KEY を環境変数として置く形で、SDK側が自動で読むんですよね。ローカルなら .env、本番ならシークレットマネージャーに分けるのが素直です。
テキトー教師DotAI 認定講師ローカルの .env をそのままサーバーに置いちゃうのが、最初に戸惑うところで。環境ごとにキーを分けておくと、漏れたときに差し替える範囲が小さくて済みます。
有効期限と権限を絞り、定期的に作り直す
室谷代表取締役キーを作るときに有効期限を切れるのは地味に効くんですよ。無期限で作って放置されるのが一番怖いので。
テキトー教師DotAI 認定講師Create key の画面で名前・有効期限・Linked account を設定しますからね。期限を決めておけば、作り直すタイミングが自然に来るんですよ。
室谷代表取締役権限も絞る。Create key が押せない場合はロール的に作成権限がないので、管理者にロール変更かサービスアカウントキーの作成を頼む形になります。
定期的に古いキーを消して新しいのに差し替える、これを運用にしておくのが結局いちばん安いんですよね。
定期的に古いキーを消して新しいのに差し替える、これを運用にしておくのが結局いちばん安いんですよね。
テキトー教師DotAI 認定講師使ってないキーを消すだけでも、社内の「これ誰のキーだろう」問題が減りますからね。
紛失したキーは復元できないので新規作成で差し替える
テキトー教師DotAI 認定講師ここ、初めて触る人が一番焦るポイントで。sk-ant- で始まるキーは作成時に一度だけ表示されて、画面を閉じると二度と見られないんですよ。
室谷代表取締役復元はできないんですよね。だから失くしたら同じキーを取り戻そうとせず、新しく作って差し替える。
考えることはそれだけです。
考えることはそれだけです。
テキトー教師DotAI 認定講師差し替え先を探すのが大変なので、どこで使っているかをメモしておくといいですね。環境変数で持っていれば1か所直せば済みます。
Admin APIで一覧と情報は取れるが、値はpartial_key_hintしか返らない
室谷代表取締役組織で運用してると「今どのキーが生きてるか」を一覧で見たくなるんですけど、Admin API でキーの一覧と情報は取れるものの、値そのものは返らないんですよね。
テキトー教師DotAI 認定講師返ってくるのは partial_key_hint のように伏せられたヒントだけ、と。どのキーかを識別するためのもので、取り出すためのものではないわけです。
室谷代表取締役つまり管理はできても救出はできない。値が要るなら Console の API keys ページで新規作成するしかない、という整理になります。
この線引きは最初に知っておくと無駄に探さずに済みます。
この線引きは最初に知っておくと無駄に探さずに済みます。
よくある質問
Q1. サブスクでログインしてるのに、APIキーって別に必要なの？
室谷代表取締役ここ混ざりやすいんですけど、Claude Code にサブスクでログインするのと、APIキーで呼び出すのは別の財布なんですよね。前者は月額、後者は使った分だけ。
テキトー教師DotAI 認定講師初めて触る人は「契約してるからAPIもそのまま使えるはず」と思い込むケース、現場でよく見ます。財布が違うので、そこは分けて考えた方がいいんですよ。
室谷代表取締役だから「契約してるのに請求が来た」で焦るんですよ。逆にAPIを一度も呼ばなければ、API側の請求は動かない仕組みですし。
Q2. APIキーは1本を使い回すのと、用途ごとに分けるのと、どっちがいい？
テキトー教師DotAI 認定講師現場でよく聞くのは「1本を全部の用途で使い回してます」という状態ですね。動くは動くんですけど、後から原因を追えなくなります。
室谷代表取締役経理目線だと、キーが分かれてないと「どの案件がいくら使ったか」が追えないんですよね。按分できないまま請求だけ膨らむ。
テキトー教師DotAI 認定講師分けておけば、止めたいときにそのキーだけ切れますし。使い回しは最初は楽で、後で高くつくタイプです。
Q3. 呼び出しで認証エラーになるんですが、まず何を疑えばいい？
室谷代表取締役弾かれたとき、まず疑うのはキーの中身より「読み込ませ方」なんですよね。環境変数に入れたつもりが、シェルを変えたら消えてた、みたいな。
テキトー教師DotAI 認定講師これ、ハマる人多いんですよ。コードは合ってるのに、実行してる場所にキーが届いていない。
最初に見るのは渡し方のほうです。
最初に見るのは渡し方のほうです。
室谷代表取締役あとはキーを作り直したのに古い値が残ってるパターン。設定ファイルのあちこちに散ってると、そこが厄介なんですよ。
Q4. 外部のツールや拡張機能にAPIキーを貼るのはアリ？
テキトー教師DotAI 認定講師便利だから貼っちゃう人が多いんですけど、貼った時点でそのツールに使わせているのと同じなんですよね。
室谷代表取締役判断基準はシンプルで、そのツールが止まったとき自分のキーがどうなるか想像できるかどうか。想像できないなら貼らない方がいい。
テキトー教師DotAI 認定講師どうしても試すなら、その用途専用のキーを1本作って、捨てる前提で。使い回してるキーを渡すのは避けたいところです。
Q5. Anthropic APIキーとClaude APIキーって別物ですか？
室谷代表取締役呼び方が2通りあるだけで、指してるものは同じなんですよ。Anthropic の API キー＝Claude を呼ぶためのキー、という理解で問題ないです。
テキトー教師DotAI 認定講師初めて触る人は別々に登録が要ると思い込んで、二重に探してしまうんですよね。発行する場所は1か所です。
室谷代表取締役用語が揺れると検索でも迷うんですけど、辿り着く先は同じ管理画面。そこだけ押さえておけば十分です。
まとめ
室谷代表取締役結局、キーって「発行して終わり」じゃなくて、財布と紐づいた権限なんですよね。
テキトー教師DotAI 認定講師たしかに。発行の手順自体はすぐ終わるのに、事故るのはだいたいその後なんですよ。
室谷代表取締役だから最初に用途ごとにキーを分けて、どれが何に効いてるか説明できる状態にしておく。それだけで請求書を見たときの景色が変わります。
テキトー教師DotAI 認定講師まずは1本作って、小さく呼び出してみるのがおすすめです。慣れてから分けていく、で十分間に合いますよ。
室谷代表取締役あと、サブスクで付くクレジットの範囲で試せるなら、いったんそこで止めるのも手です。使い方の輪郭が見えてから広げればいい。
