Claude Codeの401認証エラー｜再ログインで直らない時の対処

今朝まで快適に使えていたClaude Codeが、突然ターミナルで「API Error: 401」を返し、作業がすべて止まってしまったことはありませんか？「アカウントが削除されたのか？」「課金状況に問題があるのか？」と不安になるかもしれませんが、安心してください。その多くは、保存された認証情報の期限切れや競合といった、一時的な技術的問題に過ぎません。

本記事では、Claude Codeで頻発する401エラーの根本原因を整理し、通常の再ログインから、CLI（コマンドラインインターフェース）が全く効かない「認証ループ」からの強制復旧手順までを詳しく解説します。

結論｜401は認証トークンの問題

401の意味

401エラーは、HTTPステータスコードで「Unauthorized（未承認）」を意味します。これはサーバー側が「誰であるか確認できない」と判断した状態であり、アカウントが強制停止されたり、課金が打ち切られたりしたことを意味するものではありません。英語原文で「{"type":"error","error":{"type":"authentication_error","message":"Invalid authentication credentials"}}」や「Invalid API key · Please run /login」と表示された場合も、同様に認証情報が正しく認識されていないだけです。

再ログインで解決

ほとんどの場合、一度ログアウトして再度認証プロセスを踏むだけで解決します。認証トークン（デジタル上の通行手形）が古いままになっている、あるいはブラウザとのセッションが切れたことが直接の原因です。

アカウント再作成は不要

401が出たからといって、Anthropicのアカウントを新しく作り直す必要はありません。冷静に認証情報を更新する手順を踏めば、これまで通りClaude Codeを使い始めることができます。

関連記事：【DXの最前線】Claude Codeで開発現場はどう変わる？AIエージェントチーム導入の経営判断

401の原因｜2つの認証方式

ログインとAPIキー認証

Claude Codeの認証には大きく分けて2つのルートが存在します。自分がどちらを使っているかを確認しましょう。

• ログイン認証（サブスク）: ブラウザでOAuth（認可プロトコル）認証を行い、端末にトークンを保存する方法。Claude Pro/Max契約者は主にこれを使います。
• APIキー認証: 環境変数「ANTHROPIC_API_KEY」に直接キー（sk-ant-…）を設定する方法。開発環境やサーバー構築で利用されます。

トークンの期限切れ

保存されているトークンの有効期限が切れたり、何らかの理由でサーバー側との同期がズレてしまうと、401が発生します。これは利用頻度が高いユーザーほど、長期間のセッション保持の過程で起こり得ます。

APIキーの競合

最も「罠」になりやすいのが、サブスク契約のユーザーが過去に試したAPIキーを環境変数に残しているケースです。PCがAPIキーを優先して読み込み、そのキーが古かったり無効だったりすると、ログイン認証が通らず401になります。

プロキシ・障害の影響

社内ネットワークのプロキシ（代理接続サーバー）やファイアウォール（通信遮断機能）が、認証用の通信を不正なアクセスとしてブロックしている場合があります。また、Anthropic側のシステム障害で認証サーバーが一時停止しているケースもゼロではありません。

関連記事：Claude CodeのAPIとPro認証：最適な課金設定の選び方

基本の復旧｜再ログイン手順

logoutとloginの実行

まずは、現在残っている古い認証情報を破棄するのが先決です。ターミナル上で以下のコマンドを順に実行してください。

1. /logout: 現在のセッションを明示的に終了させます。
2. /login: 再度認証フローを開始します。

ブラウザ再認証と動作確認

/loginを実行すると自動的にブラウザが立ち上がります。指示に従って認証を完了させた後、ターミナルに戻り「hello」や「whoami」などの短いコマンドを打って、正常に動作するか確認してください。

関連記事：Claude CodeによるAI駆動開発入門：導入から実務コマンド活用ガイド

落とし穴｜環境変数のAPIキー

キーが優先される現象

「ログインしたはずなのにログイン状態にならない」という場合は、環境変数の残骸を疑ってください。APIキーが設定されていると、Claude Codeは「ユーザーのログイン」よりも「APIキーによる接続」を優先的に試みます。

環境変数の確認と解除

MacやLinuxの場合、ターミナルで echo $ANTHROPIC_API_KEY を実行してみてください。ここで値が表示された場合、それが悪さをしています。

• 一時的な解除: unset ANTHROPIC_API_KEY を実行して、そのセッションでのキーを無効化します。
• 恒久的な解除: .zshrc や .bashrc など、キーを書き込んだ設定ファイルを編集し、該当行を削除して保存します。

関連記事：Claude Code設定と環境構築｜CLIとVS Codeで開発を自動化する手順

最難関｜認証ループの強制復旧

CLIが効かない状態

保存されている認証情報自体が壊れている場合、/logoutすら「401 Unauthorized」で拒否されることがあります。この状態はCLI上からは脱出不能なため、保存ファイルを直接削除する必要があります。

Macのキーチェーン削除

Macユーザーは「キーチェーンアクセス」アプリを開き、「Claude Code-credentials」という項目を探して削除してください。これで強制的に認証情報がクリアされます。

Linux・Winのファイル削除

以下のファイルを削除することで同様の強制リセットが可能です。

• Linux: ~/.claude/.credentials.json
• Windows: %USERPROFILE%\.claude\.credentials.json

削除後の再ログイン

これらのファイルを削除しても、会話履歴やプロジェクトの設定が消えることはありません。あくまで「認証トークン」のみが削除されるため、削除後に改めて claude コマンドを起動し、/login を行えば復旧します。

ブラウザ不可環境での認証

APIキーかトークンの設定

ヘッドレスサーバー（モニターのない環境）やCI/CD（継続的インテグレーション）環境ではブラウザが使えません。その場合は ANTHROPIC_API_KEY を正しく設定するか、Anthropicの仕様に従い claude setup-token コマンドで発行した長期有効トークンを使用してください。

それでも直らない場合

サーバー側の可能性

上記の手順をすべて試しても状況が改善しない場合、自分側の不具合ではなく、Anthropic側のAPIサーバーで障害が発生している可能性があります。

障害情報の確認

Anthropicの障害ステータスを確認できるページを参照し、大規模な通信障害が起きていないか確認しましょう。サーバー側の問題であれば、ユーザー側でできることはないため、復旧を待つのが最も賢明です。

まとめ

Claude Codeの401エラーは、正しく対処すれば短時間で解消できる問題です。以下のポイントを参考に、状況に応じた復旧を試みてください。

• まずは基本: /logout と /login で認証情報の更新を試す
• 環境変数をチェック: echo $ANTHROPIC_API_KEY で競合するキーが残っていないか確認する
• 認証ループからの脱出: CLIが使えない場合はキーチェーンや .credentials.json を手動削除する
• 最終手段: 自分の設定に問題がない場合は 公式ステータス を見てサーバー障害を疑う

まずは落ち着いて、環境変数のチェックから始めてみましょう。作業効率を取り戻すために、ぜひ一つずつ試してみてください。

Claude Codeの導入や基本設定についてはこちらのガイドも併せてご覧ください