「Claude APIキー 設定」で検索したものの、AnthropicのConsole画面が英語で戸惑ったり、環境変数の設定方法がよくわからず詰まってしまった、という方は多いのではないでしょうか。この記事では、APIキーの取得からPythonでの実装、そして意外と見落とされがちなセキュリティ面の注意点まで、実際の手順に沿って解説します。
結論から言うと、APIキーはコード内に直接書き込まず、環境変数として管理するのが基本です。この理由も含めて順番に見ていきましょう。
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」画面で消費状況を確認する習慣をつけておくと安心です。
💡 この記事のポイントまとめ
- APIキーはAnthropic Consoleの「API Keys」画面から発行し、表示時に必ず控えておく
- キーはコードに直書きせず、環境変数または.envファイルで管理する
- .envを使う場合は.gitignoreへの追加を忘れずに行う
- 動作しない場合はターミナルの再起動忘れやキーの余分な空白を確認する
- 無料クレジットには上限があるため、Console上の「Usage」で消費量を定期的にチェックする


コメント