Claude Codeのapikeyの取得と設定はじめての安全な扱い方

「Claude CodeでAPIキーが要るって聞いたんですけど、どこで取るんですか」 — 研修の現場でいちばん多い質問のひとつです。プランで動かす人にはそもそも要らない話なのですが、API課金で使うなら避けて通れません。

この記事は、APIキーの取得・設定・安全な扱いまでを、はじめての人向けに整理したものです。

APIキーが要る場面・要らない場面

最初に整理しておきます。Claude Codeを動かす形は、大きく分けて2通りです。

ProプランやMaxプランで使う場合、APIキーは要りません。プランの認証で動きます。これがいちばん簡単。

API従量課金で使う場合、APIキーが要ります。使った分だけ請求が来る代わりに、月額の枠縛りがありません。重い作業をたまにこなす人や、複数人で按分したい組織に向く形です。料金プランそのものの整理は別記事に書きました。

Claude Codeの料金プランの比較

この記事は、後者の「API課金で使いたい」場面に絞った話です。

APIキーは、Anthropicの管理画面で発行します。手順は次のとおりです。

Claude Platform

Build with the Claude API

ここで大事な注意。表示されたキーは、その画面を閉じると二度と確認できません。コピーし忘れたら、新しいキーを作り直すしかない。最初の1回は緊張する作業です。

新規アカウントには少額の無料クレジットが付与されている場合があります。最初の感触をつかむ程度なら、これでカバーできることが多いです。

Claude Codeは、ANTHROPIC_API_KEY という名前の環境変数を読みに行きます。コピーしたキーをこの変数に入れておけば、Claude Codeが起動時に拾ってくれます。

設定の仕方はOSによって違いますが、いちばんよく使うのは、ターミナルの起動ファイル(~/.zshrc など)に次のような行を足す方法です。

export ANTHROPIC_API_KEY=sk-ant-...

ターミナルを開き直すと、変数が読み込まれた状態になります。echo $ANTHROPIC_API_KEY で先頭が見えれば成功。設定ファイル全般の話は別記事にあります。

Claude Codeのsettings.jsonのおすすめ設定

ここからは扱いの話です。APIキーは、ふだん使っているIDとパスワードに近い扱いをしてください。

具体的には、Slackやチャットに貼らない、リポジトリにコミットしない、スクリーンショットの中にも映さない。誰かに見せた瞬間、その人があなたの請求でClaude Codeを動かせる状態になります。これは思っているより危ない。

.env.local のような環境変数ファイルに書く場合は、必ず .gitignore で除外されていることを確認します。1回コミットしてしまったキーは、後から消しても履歴には残ります。

それでも漏れた、と気づいた時の動きは1つです。Anthropicのコンソールで、そのキーを即座に無効化(Revoke)してください。

無効化したキーは、その瞬間から使えなくなります。請求の被害を最小にする手段はこれだけ。「あとで対処する」は無理です。気づいた1分以内にコンソールを開く、と覚えておいてください。

無効化したあと、新しいキーを発行して環境変数を入れ替えれば、自分の作業は続けられます。

正直に書きます。私自身、過去に1度、検証用のリポジトリにAPIキーを混入させたことがあります。

幸い、コミットを途中で気づいて、その日のうちにキーを無効化しました。プッシュ前でも、ファイルとしては書かれた瞬間にバックアップに残ることがあります。ほんとうに安心するには「無効化してから新しいキーに入れ替え」がいちばん早い。

この出来事のあと、新しい習慣をひとつ追加しました。新しいプロジェクトを作ったら、いちばん最初に .gitignore を整える。これだけで、似た事故はだいぶ起きにくくなります。