この記事の目次
「ログインできない」原因はどう切り分ければいいか
Claude Codeにログインできない原因は「アカウント種別」「認証方式」「通信・実行環境」の3系統のどれかに当てはまることが多い。エラーメッセージの文言だけで検索するより、この3系統のどこに該当するかを先に見極めたほうが、遠回りせずに対処へたどり着ける。
まず前提を一つ確認しておきたい。この記事が対象にしているのは「インストールは終わったのに、ログイン試行時にうまくいかない」というケースだ。irmコマンドが認識されないなど、インストールスクリプトの実行段階で止まっている場合は範囲が異なるため、Claude Codeのインストール手順を解説した記事を先に確認してほしい。
症状から系統を逆引きする早見表を用意した。自分の症状に近いものを探し、該当する節に進んでほしい。
| 症状の例 | 原因系統 | 確認する節 |
|---|---|---|
| どのアカウントで入ればいいか分からない | ①アカウント種別 | そもそもどのアカウントでログインすべきか |
| 認証コードが無効と表示される | ②認証方式 | ブラウザでの認証（OAuth）が失敗するのはなぜか |
| ログインできても403やロールエラーが出る | ①アカウント種別／②認証方式 | 403 Forbiddenや権限エラーが出るのは何が原因か |
| macOSで毎回ログインを求められる | ③実行環境 | macOSで認証情報が保存できない・毎回ログインを求められるのはなぜか |
| Windowsでブラウザが開かない・止まる | ③実行環境 | Windowsでログインがうまくいかない時、何を確認すべきか |
以降の各節は、この3系統のどれに属するかを冒頭で明記しながら進める。エラーの分類そのものをもっと広く知りたい場合は、Claude Codeのエラー全般をまとめた記事も参考になる。
そもそもどのアカウントでログインすべきか
ログイン画面で迷う理由の多くは、Claude（Web・デスクトップアプリ）とClaude Code（ターミナルで動くCLI）を同じものとして扱ってしまっていることにある。この2つはアカウント自体は共通でも、ログインの入り口も保存される認証情報の場所も別物と考えたほうが混乱が少ない。
さらにClaude Codeの中でも、サブスクリプション認証（Claude.aiのプランでログインする方式）とAPIキー認証（Anthropic Consoleで発行したキーを使う方式）の2通りがある。両方が設定されていると、環境変数ANTHROPIC_API_KEYが優先されてサブスクリプション側のログインが無視されるケースがあるため、意図しない認証方式が使われていないか確認する価値がある。
| 比較対象 | 主な用途 | ログインに使うアカウント | 認証情報の主な保存場所 |
|---|---|---|---|
| Claude（Web・デスクトップ） | ブラウザやアプリでの会話 | Claude.aiアカウント | ブラウザのセッション |
| Claude Code（サブスクリプション認証） | ターミナルでのコーディング支援 | Claude.aiアカウント | OS標準の認証情報ストア（macOSならKeychainなど） |
| Claude Code（APIキー認証） | 従量課金でのAPI利用 | Anthropic Consoleアカウント | 環境変数ANTHROPIC_API_KEY |
アカウント種別の見分け方はここまでで、APIキーの発行・管理そのものを詳しく知りたい場合はAPIキーの使い方を解説した記事、Claude本体とClaude Codeの違いを整理したい場合はClaude Codeとは何かを解説した記事を合わせて読むと理解が深まる。
ブラウザでの認証（OAuth）が失敗するのはなぜか
「Invalid code」と表示される、ブラウザにリダイレクトされない、認証コードを貼り付けても弾かれるといった症状は、OAuth（ブラウザ経由でユーザーの許可を得てログインを完了させる仕組み）の手順のどこかでつまずいているサインだ。
Claude Codeのログインは、ターミナルからブラウザを起動し、ユーザーがブラウザ上で許可を出すと、認可コードがターミナル側に戻ってくる流れになっている。この橋渡しがどこかで途切れると、コードが無効と表示されたり、そもそもブラウザが開かなかったりする。
WSL2やSSH接続、Dockerなどのコンテナ環境では、ターミナルからブラウザを直接起動できずリダイレクトが届きにくい場合があると公式情報で確認できる。ただし内部の挙動が環境ごとにどう違うかは断定できる範囲を超えるため、この記事では踏み込まない。対処としては、表示されたURLを手動でブラウザに貼り付けて開く、発行された認可コードを手入力で貼り付けるといった、公式手順に沿った回避策を試すのが確実だ。手順の詳細は公式のインストール時トラブルシューティングでも確認できる。
ブラウザとターミナルを行き来する操作自体につまずく場合は、ターミナルの基本操作を解説した記事を先に読んでおくと迷いにくい。
403 Forbiddenや権限エラーが出るのは何が原因か
ログイン自体は通っているのに403やロール関連のエラーが出る場合、原因は認証の失敗ではなく「権限が足りていない」ことにある。
個人利用であれば、選んでいるプランがClaude Codeの利用対象に含まれているかをまず確認したい。組織（チーム）アカウントで使っている場合は、個人の権限の問題ではなく、管理者側でのロール割り当てが漏れていることが原因になっていることもある。この場合、本人が設定を変えても解決しないため、組織の管理画面での確認が必要になる。
macOSで認証情報が保存できない・毎回ログインを求められるのはなぜか
macOSで一度ログインしたのに次回起動時にまたログインを求められる場合、認証情報を保存するKeychain(macOSに標準搭載されている、パスワードや認証情報を暗号化して保管する仕組み)まわりでの保存が失敗している可能性がある。
Keychainのロックや破損が起きる具体的な条件は公式情報だけでは断定できないため、この記事では原因を決めつけず、確認できる手順にとどめる。まずは「Keychain Access.app」を開き、Claude Code関連の項目が存在するか、アクセス権限に問題がないかを見てみるとよい。それでも改善しない場合は、/logoutでいったんログアウトしてから再ログインする方法が、環境をクリーンな状態に戻す基本の対処になる。
/logoutmacOS固有の詳細な設定手順については、公式ドキュメントも合わせて確認してほしい。
Windowsでログインがうまくいかない時、何を確認すべきか
Windowsでclaudeコマンドを実行してもログインが進まない、ブラウザが開かないといった症状は、ログイン試行そのものではなく、インストール段階に原因が潜んでいることもある。インストールが完了している前提で、それでもログインが止まる場合は、社内プロキシや証明書の設定がOAuthのリダイレクトを妨げているケースが公式情報で挙げられている。ネットワーク管理者に確認できる立場であれば、プロキシ経由でブラウザの外部通信が許可されているか、社内証明書のインストールが必要な構成になっていないかを確認すると手がかりが得られる。
Windows環境でのセットアップ全般を見直したい場合はWindowsでの利用方法を解説した記事も役立つ。
ログイン後、自分の認証状態を確認するにはどうすればいいか
無事にログインできたら、/statusコマンドで現在どの認証方式が使われているかを確認しておくと、後から同じ問題を防ぎやすくなる。
/statusはターミナル内で実行するコマンドで、サブスクリプション認証とAPIキー認証のどちらが有効になっているかを表示してくれる。想定していたのと違う方式で認証されていた場合、そもそもどのアカウントでログインすべきかで触れた環境変数ANTHROPIC_API_KEYが意図せず優先されていないかを見直すとよい。
/status
claude doctorclaude doctorは設定や接続状態をまとめて自己診断してくれるコマンドで、ログインは通ったが挙動に不安が残る時の確認に向いている。診断結果をエラーログの保存場所と読み方を解説した記事と突き合わせて読むと、原因の切り分けがさらに進めやすい。ここまでの内容を振り返ると、今回の問題が①アカウント種別、②認証方式、③通信・実行環境のどこに属していたかを自分の言葉で説明できる状態になっているはずだ。CLIの操作全体を一通り確認しておきたい場合は、CLIの使い方を解説した記事にも目を通しておくとよい。
会社やチームでの利用では、ログインの管理はどう変わるか
組織でClaude Codeを導入している場合、個人のOAuthログインとは別に、SSOやAmazon Bedrock・Google Vertex AI経由の認証が使われることがある。この場合、ログインの可否は個人の設定ではなく組織側の構成に左右される。
社内でSSOが有効になっている環境では、個人アカウントでの通常ログインがそもそも想定されていないこともある。管理者に確認すべき事項が個人利用とは異なるため、詳細は専用の記事に委ねたい。Bedrock経由の利用はBedrock連携の記事、Vertex AI経由の利用はVertex AI連携の記事で扱っている。
OAuth・Keychain・環境変数といった専門用語は何を意味するか
ここまでに出てきた用語を短く整理しておく。
- OAuth: ブラウザ上でユーザーが許可操作をすることで、パスワードを直接渡さずにログインを完了させる仕組み。
- Keychain: macOSに標準搭載されている、パスワードや認証情報を暗号化して保管する仕組み。
- 環境変数: コマンドを実行する際に、その場で参照される設定値のこと。
ANTHROPIC_API_KEYのように、ターミナルの設定として保存しておける。
まとめ
ログインできない原因は、①アカウント種別、②認証方式、③通信・実行環境のいずれかに整理でき、症状から系統を逆引きすれば対処までの距離は短くなる。
今日の問題が解決しても、Claude Codeを使い続けるうちに別の場面で同じようなつまずきに出会うことはある。そのたびに検索するのではなく、仕組みごと理解して自分で切り分けられるようになりたい人向けに、月額1,980円から参加できる学習コミュニティ「AI駆動ラボ」を案内しておく。自分の手で使えるようになるために学べる場だ。