Claude APIキーの取得方法と設定手順を徹底解説【環境変数・コード実装まで】

「Claude APIキー設定」で検索したものの、AnthropicのConsole画面が英語で戸惑ったり、環境変数の設定方法がよくわからず詰まってしまった、という方は多いのではないでしょうか。この記事では、APIキーの取得からPythonでの実装、そして意外と見落とされがちなセキュリティ面の注意点まで、実際の手順に沿って解説します。

結論から言うと、APIキーはコード内に直接書き込まず、環境変数として管理するのが基本です。この理由も含めて順番に見ていきましょう。

Claude APIキーを取得する手順
環境変数としてAPIキーを設定する方法
Pythonでの実装例と動作確認
料金と利用制限で誤解しやすい点
1. 💡 この記事のポイントまとめ

Claude APIキーを取得する手順

APIキーはAnthropic社が提供する「Anthropic Console」というWebサイトから取得します。手順は以下の通りです。

Anthropic Consoleにアクセスし、メールアドレスまたはGoogleアカウントでサインアップ・ログインする
左メニューから「API Keys」を選択する
「Create Key」ボタンを押し、キーに名前（例：test-key、production-keyなど）を付ける
表示された「sk-ant-」から始まる文字列をコピーする

ここで注意すべきなのは、このキーは発行時にしか全文表示されないという点です。ページを閉じた後に「もう一度見たい」と思っても、途中の一部分しか表示されず、再取得（新規作成）するしかありません。取得したら、まずパスワード管理ツールやメモアプリなど、安全な場所に一時保存しておくことをおすすめします。

環境変数としてAPIキーを設定する方法

コードに直接キーを書き込むと、GitHubなどに誤ってアップロードしてしまうリスクがあります。実際、公開リポジトリにAPIキーを含めたコミットが残ってしまい、第三者に不正利用された事例は珍しくありません。これを避けるため、OSごとに以下の方法で環境変数に設定します。

Macの場合

ターミナルで以下を実行し、.zshrcや.bash_profileに追記します。

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxx"
ファイルを保存後、source ~/.zshrcで反映

Windowsの場合

コマンドプロンプトでsetx ANTHROPIC_API_KEY "sk-ant-xxxxxxxx"を実行
設定後は一度コマンドプロンプトを再起動する必要がある

.envファイルを使う場合（開発時に便利）

プロジェクトフォルダに.envファイルを作成し、ANTHROPIC_API_KEY=sk-ant-xxxxxxxxと記述します。Pythonであればpython-dotenvライブラリを使って読み込みます。この方法のメリットは、プロジェクトごとにキーを分けて管理できる点です。ただし.envは必ず.gitignoreに追加し、Gitの管理対象から外してください。

Pythonでの実装例と動作確認

環境変数の設定が終わったら、以下のコードで実際に呼び出せるか確認します。

pip install anthropicでライブラリをインストール
コード内でimport anthropicとclient = anthropic.Anthropic()と記述するだけで、環境変数のキーが自動的に読み込まれる
明示的に指定したい場合はanthropic.Anthropic(api_key="sk-ant-xxxxxxxx")と書くこともできるが、前述の理由からこの方法は推奨されない

実行してエラーが出る場合、多くは「環境変数が反映されていない（ターミナルの再起動忘れ）」か「キーの前後に余分なスペースや改行が入っている」ケースです。特にコピペ時に改行コードが混ざることがあるため、うまく動かない時はキーをテキストエディタで一度貼り直して確認すると解決することが多いです。

料金と利用制限で誤解しやすい点

Claude APIは従量課金制で、入力トークンと出力トークンで料金が異なります。モデルによって単価が大きく変わるため、Sonnet系とOpus系を同じ感覚で使うとコストが想定以上に膨らむことがあります。また、初回登録時には少額の無料クレジットが付与される場合がありますが、これは期間限定・上限ありで永続的なものではないため、本番運用前には必ずConsoleの「Usage」画面で消費状況を確認する習慣をつけておくと安心です。