Claude CodeのAPI Error: 401は、まず/loginを試します。今回は、実際に/loginを実行しただけで復活できました。
直らない場合だけ、/logoutや古いAPIキーの確認へ進みます。この記事では、作業データを消さずに確認できる順番で復旧手順をまとめます。
最初にAnthropic側の障害を確認する
自分の設定を変える前に、Anthropic Statusを確認します。
Claude.aiやClaude Codeの認証障害が表示されているなら、端末側を触らず復旧を待ちます。複数人が同時に401になった場合も、サービス側の障害を先に疑います。
`/status`で使われている認証情報を確認する
Claude Codeを起動できるなら、次を入力します。
/statusここで、Claudeのサブスクリプション、ConsoleのAPIキー、クラウド事業者のどれが使われているか確認します。
環境変数ANTHROPIC_API_KEYがあると、ブラウザでの/loginよりAPIキーが優先されます。古いキーが残っていると、ログインに成功しても401が続きます。
`/logout`してから`/login`を実行する
今回表示されたのは、次のエラーです。
Please run /login · API Error: 401 Invalid authentication credentials表示どおり/loginを実行したところ、そのまま復活しました。まずはこの最短手順を試してください。
/loginこれで直らない場合は、保存済みの認証をいったん外して再認証します。
公式の基本手順は、保存済みの認証をいったん外して再認証することです。
/logout
/loginブラウザが自動で開かない場合は、ターミナルでcを押してログインURLをコピーします。ブラウザにコードが表示された場合は、ターミナルの入力欄へ貼り付けます。
/loginだけを繰り返すより、先に/logoutを実行するのが重要です。Anthropic公式も、同じセッションで401が戻る場合はこの順番を案内しています。
古い`ANTHROPIC_API_KEY`を一時的に外す
ProやMaxのアカウントでログインしたい人は、現在のターミナルにAPIキーが残っていないか確認します。
printenv ANTHROPIC_API_KEY値が表示されても、キー本体を画面共有や投稿へ載せないでください。現在のターミナルだけ解除するなら、次を実行します。
unset ANTHROPIC_API_KEY
claudeその後、もう一度/loginします。再起動するとキーが復活する場合は、.zshrc、.bashrc、.envなどに古い設定がないか確認します。
APIキーで使う予定なら、逆にConsole側でキーが有効か確認します。サブスクリプション認証とAPIキー認証を混ぜないことが大切です。
ブラウザから戻れないときは認証コードを貼る
WSL2、SSH、コンテナでは、ブラウザからClaude Codeへ自動で戻れないことがあります。
この場合は、ターミナルに出たURLを手元のブラウザで開きます。ログイン後に表示されたコードを、Paste code here if promptedへ貼り付けます。
これは401とは別の問題です。ローカルのコールバックへ戻れないだけなら、コード入力で認証できます。
macOSでログインが保存されないときはKeychainを確認する
毎回ログインを求められる場合、macOSのKeychainがロックされている可能性があります。Macのログインパスワードを変更したあとに、Keychainのパスワードが同期していない場合もあります。
Keychain Accessを開き、ログインKeychainが解除されているか確認します。認証情報の削除は最終手段です。先に/logoutと環境変数の確認を済ませてください。
まだ401が続くときの切り分け
次の順で確認します。
- Claude Codeを終了し、新しいターミナルで起動する
/statusで有効な認証方式を確認するANTHROPIC_API_KEYやクラウド事業者向け環境変数を確認する- Claude Codeを最新版へ更新する
- 別のネットワークで試し、会社のProxyやVPNの影響を切り分ける
- TeamやEnterpriseなら、管理者に利用権限を確認してもらう
- エラーの
request_idを添えてAnthropic Supportへ問い合わせる
401は認証エラーです。利用権限や組織停止では403や別のメッセージになる場合があります。表示されたエラー全文を伏せずに確認してください。ただし、APIキーや認証コードは共有しません。
迷ったらこの順番だけ試す
1. Anthropic Statusを確認
2. /status
3. /logout
4. ANTHROPIC_API_KEYを確認して、不要ならunset
5. Claude Codeを再起動
6. /login認証キャッシュを手作業で消す前に、この順番を試すのが安全です。多くの401は、期限切れのOAuthトークンか、古いAPIキーの優先で説明できます。
Claude Codeの設定を整理したい人は、Claude Codeのプロジェクト設定と.claudeフォルダの使い方も続けてどうぞ。
