Claude CodeでInvalid API Keyの対処法をお探しですね。

広告

Claude CodeのAPIキーエラーを解決する方法｜キーの再発行から設定まで完全ガイド

Claude Codeを使おうとしたら、突然「API Key Invalid」とか「401 Unauthorized」って表示されて困っていませんか？昨日まで普通に動いていたのに急に使えなくなったり、初めて設定するときにつまずいたりすると、どこを直せばいいのか分からなくて焦りますよね。

実は、このエラーが出る原因の多くは、APIキーの期限切れや設定ミスなんです。

パソコンの中に古い認証情報が残っていたり、環境変数の設定が間違っていたりすることがほとんどです。

この記事では、Claude CodeでAPIキーのエラーが出たときの直し方を、原因の見つけ方から順番に説明していきます。

APIキーの作り直し方はもちろん、Mac・Windows それぞれでの環境変数の正しい設定方法、見落としがちな設定ファイルのチェックポイントまで、全部まとめました。

開発環境のトラブルはエンジニアなら誰でも経験するものですが、この記事を読めば迷わず最短で復旧できるはずです。

まずは落ち着いて、今の設定を確認するところから始めましょう。

API Key Invalidエラーが出る原因を見つけよう

エラーを直すには、まず「なぜ無効だと判定されたのか」を理解することが大切です。

単純にキーをコピペするときにミスしただけかもしれないし、パソコンが読み込んでいるキーが古いままになっているのかもしれません。

特にClaude Codeは、ブラウザでのログイン（OAuth）とAPIキーの両方が使えるので、どっちの認証情報が優先されているのか分かりにくいことがあります。

エラーの原因は、だいたい次の3つのどれかです。

– APIキー自体が無効になっている、または入力ミス（コピーするときにスペースが入ったなど）
– 環境変数（`ANTHROPIC_API_KEY`）が正しく読み込まれていない、または古い値のまま
– 設定ファイル（`settings.json`）や保存された認証情報が邪魔をしている

まず疑うべきは、APIキーそのものの状態です。

Anthropicの管理画面でキーを削除してしまったか、セキュリティ上の理由で自動的に無効化された可能性があります。

次に考えられるのが、環境変数の設定ミスです。

ターミナルで新しいキーを設定したつもりでも、ターミナルを再起動していなかったり、設定ファイルへの書き方が間違っていたりすると、パソコンは古い無効なキーを使い続けてしまいます。

また、Claude Code特有の問題として、プロジェクトごとの設定とグローバル設定が複雑に絡み合っている点にも注意が必要です。

例えば、ホームディレクトリの設定ファイルでは正しいキーを指定していても、プロジェクトフォルダ内のローカル設定ファイルに古い情報が残っているとエラーが消えません。

まずは「キーが生きているか」を確認して、次に「正しいキーが読み込まれているか」をチェックする順番で対処していきましょう。

Anthropic Consoleで新しいAPIキーを作ろう

原因を探るより、いっそのこと新しいAPIキーを作り直したほうが早いです。

「もしかしたらまだ使えるかも」と古いキーにこだわるより、新品のキーで環境を上書きしたほうが結果的に時間の節約になります。

まずはブラウザでAnthropic Console（https://console.anthropic.com/）にログインしてください。

ダッシュボードにアクセスしたら、「Get API Keys」か「Settings」のメニューに進みます。

ここで今使えるAPIキーの一覧が表示されますが、セキュリティのため、キーの一部しか見えません。

なので、手元のキーと照らし合わせるより、新しく作ったほうが確実です。

「Create Key」ボタンをクリックして、分かりやすい名前（例：`claude-code-cli-2025`など）を付けてキーを作ります。

作られたAPIキーは `sk-ant-` から始まる長い文字列です。

**このキーは一度しか完全に表示されないので、必ずこのタイミングでコピーして、パスワード管理アプリなどに保存しておいてください。

**もしコピーに失敗したら、遠慮なくそのキーを削除して作り直せばOKです。

ここで大事なのは、キーの前後に余計な空白が入っていないかを確認することです。

特にマウスでドラッグしてコピーすると、うっかりスペースも一緒にコピーしてしまうことがあるので、クリップボードへのコピーボタンを使うのがおすすめです。

新しいキーを手に入れたら、次はこのキーをパソコンに正しく設定していきます。

環境変数を更新しよう｜Mac・Windows別の設定方法

新しいAPIキーを取得しても、それをパソコンが認識できるように設定しないと意味がありません。

Claude Codeは、主に `ANTHROPIC_API_KEY` という環境変数を見て認証を行います。

ここで多くの人がつまずくのが、「コマンドを実行したのに反映されない」という問題です。

これは、設定した変数がターミナルを閉じると消えてしまう一時的なものだったり、設定ファイルが正しく読み込まれていなかったりすることが原因です。

Mac（macOS）やLinuxを使っている場合

ターミナル（ZshやBash）を使っている場合、まずは今設定されているキーを確認してみましょう。

`printenv ANTHROPIC_API_KEY` コマンドを実行して、古いキーや何も表示されなかった場合は設定が必要です。

一時的に試すだけなら `export ANTHROPIC_API_KEY=’sk-ant-…’` と入力すれば動きますが、ターミナルを閉じると消えてしまいます。

**ずっと使えるように設定するには**、ホームディレクトリにあるシェルの設定ファイル（`.zshrc` や `.bash_profile`）を編集します。

エディタでファイルを開いて、次の行を追加または修正してください。

“`bash

export ANTHROPIC_API_KEY='ここに新しいAPIキーを貼り付け'

“`

ファイルを保存したら、**必ず** `source ~/.zshrc`（または対応するファイル名）を実行して設定を読み込み直すか、ターミナル自体を再起動してください。

これを忘れると、いくらファイルを書き換えてもClaude Codeは古いキーを使い続けてしまいます。

更新後にもう一度 `printenv ANTHROPIC_API_KEY` コマンドで新しいキーが表示されることを確認できれば、準備完了です。

Windowsを使っている場合

Windowsでは、PowerShellを使うか、システムのプロパティから設定する方法があります。

PowerShellで一時的に設定する場合は、`$Env:ANTHROPIC_API_KEY = “sk-ant-…”` を実行します。

でも、開発で継続的に使うなら、**システム環境変数として登録するのが確実**です。

検索バーで「環境変数を編集」と入力して設定画面を開き、ユーザー環境変数のところで「新規」を押すか、既存の `ANTHROPIC_API_KEY` を選んで「編集」をクリックします。

変数値に新しいAPIキーを入力して保存してください。

**ここで超重要な注意点**として、Windowsの場合、環境変数を更新した後に、すでに開いているVS Codeやターミナル、コマンドプロンプトには変更がすぐには反映されません。

**必ずアプリケーションを完全に終了させて、再起動してから**動作確認を行ってください。

この「再起動忘れ」は、Windows環境でのトラブル原因としてめちゃくちゃ多いので要注意です。

設定ファイルをチェックして認証情報をリセットしよう

環境変数を正しく設定したはずなのに、まだ「Invalid」エラーが消えない場合があります。

このしつこいエラーの原因は、Claude Codeが内部的に保持しているキャッシュや、優先順位の高い設定ファイルが邪魔をしている可能性が高いです。

Claude Codeは環境変数だけでなく、独自のログイン情報（OAuthトークンなど）も保存していて、それらが競合することで認証エラーを引き起こすことがあります。

こんなときは、**Claude Codeの認証状態を一度リセット**するのが一番効果的です。

ターミナルで次のコマンドを実行して、ログイン情報をクリアしてください。

“`bash

claude logout

“`

これで、保存されていたセッショントークンが削除されます。

その後、改めて `claude login` を実行してブラウザ認証を行うか、先ほど設定した環境変数を使ってそのまま利用を開始します。

基本的には、環境変数 `ANTHROPIC_API_KEY` が設定されていれば、Claude Codeはそれを優先して使う仕組みになっています。

それでも解決しない場合は、**設定ファイル `settings.json` の内容を確認**する必要があります。

公式ドキュメントによると、Claude Codeの設定には優先順位があって、次の順番で適用されます。

1. Managed設定（組織管理など）
2. プロジェクトローカル設定（`.claude/settings.local.json`）
3. プロジェクト設定（`.claude/settings.json`）
4. ユーザー設定（`~/.claude/settings.json`）

特に注意したいのが、**プロジェクトディレクトリ内に自動で作られた `.claude` フォルダ内のファイル**です。

過去に別のキーを設定して実験していた場合、そのローカル設定が環境変数よりも優先されている可能性があります。

プロジェクトフォルダ内の `.claude/settings.json` や `settings.local.json` を確認して、もし `apiKey` やそれに関連する記述があれば削除するか、正しい値に修正してください。

また、VS Codeの拡張機能としてClaude Codeを使っている場合、**VS Code自体の再起動**も忘れずに行いましょう。

設定ファイル、環境変数、そしてキャッシュされた認証情報。

この3つをクリアな状態にすることで、しつこい認証エラーも確実に解消できるはずです。

ここまで確認すれば、開発環境は正常に戻って、再び快適なAIコーディングができるようになります。

落ち着いて一つずつ確認していけば、必ず解決できますよ！

広告