blog

Claude Code ログイン方法・できない時の対処法|2026年版ガイド

Claude(クロード) Codeを使おうとしたら「ログインできない」「認証エラーが出る」「コマンドが通らない」――そんな状況で作業が止まってしまった経験はありませんか。弊社でもClaude Codeを実務のコーディング支援に日常的に使っており、ログイン・認証まわりのトラブルは何度か直面してきました。原因は大きく分けるとAPIキーの設定ミス・認証フローの失敗・ネットワーク/環境の問題・Anthropicのサービス側の問題の四つに絞られます。この記事では、それぞれの原因と具体的な解消手順を網羅的に解説します。順を追って確認していけば、ほとんどのケースで自力復旧できます。

目次

Claude Codeへの基本的なログイン手順(初回認証・APIキー認証)

対処法を試す前に、Claude Codeがどのように認証を行うかを把握しておくと、原因の切り分けが格段に速くなります。

Claude Codeはターミナルで動作するCLIツールです。認証方法は主に二つあります。

① Anthropic Consoleでのブラウザ認証

claudeコマンドを初回実行すると、ブラウザが開いてAnthropicのConsoleページにリダイレクトされます。Console上でログイン→権限付与→CLIに認証コードが返ってくる、というOAuthライクなフローです。

② APIキーによる直接認証

環境変数ANTHROPIC_API_KEYにAPIキーをセットするか、claude configでキーを登録する方法です。CI/CD環境やリモートサーバーではこちらが主流です。

①Anthropic Consoleでのブラウザ認証は、具体的には次の手順で進みます。

  1. claudeコマンドをターミナルで実行する
  2. ブラウザが自動的に開き、Anthropic Consoleのログイン画面にリダイレクトされる
  3. Consoleでログインし、Claude Codeへのアクセス権限を許可する
  4. ブラウザでの認証完了後、ターミナルに自動的に認証コードが返り、ログインが完了する

リモートサーバーなどブラウザが自動起動しない環境では、表示されたURLを手動でブラウザに貼り付けて認証を進める。

認証情報はホームディレクトリの~/.claude/配下に保存されます。このディレクトリや設定ファイルに問題があるだけでログインが通らなくなるケースもあります。まずどちらの認証方法を使っているかを確認した上で、以下のチェックリストに進んでください。

原因①:APIキーの設定ミス・無効化

ログインできないケースで最も多いのが、APIキーの不備です。弊社でも新しいマシンにセットアップした直後や、チームメンバーが環境を引き継いだ際にこの原因でつまずくことが何度もありました。

よくあるAPIキーのトラブルと確認手順

  • キーが期限切れ・無効化されている:Anthropic ConsoleでAPIキーの状態を確認する。削除済みや無効化されているキーは再生成が必要。
  • コピー時に余分なスペースや改行が混入している:特にシェルスクリプトや.envファイルに手動で貼り付けた場合に起きやすい。
  • 環境変数が読み込まれていない:exportしたターミナルセッションが閉じると消える。
  • 複数の設定ファイルが競合している:~/.claude/の設定と環境変数の両方にキーがあり、古い方が優先されている。

確認・修正コマンド

まず現在のキーが環境変数に正しくセットされているかを確認します。

# 環境変数の確認
echo $ANTHROPIC_API_KEY

# 先頭・末尾の余分な文字を確認(パイプでawkを使う例)
echo "$ANTHROPIC_API_KEY" | cat -A
# 末尾に^Mや$以外の文字があれば混入あり

キーを再セットする場合は以下のように行います。永続化するには~/.bashrcまたは~/.zshrcに追記してください。

# 一時的にセット(セッションが閉じると消える)
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxx"

# 永続化(.zshrcの場合)
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

APIキーはAnthropicのConsole(console.anthropic.com → API Keys)で発行・確認・再生成できます。無効なキーは即座に削除して新しいものを発行するのが最も確実な対処法です。

APIキーの権限(スコープ)も確認する

ConsoleでAPIキーを作成する際、権限スコープが制限されている場合があります。Claude Codeを使うにはClaude APIへのフルアクセス権限が必要です。制限付きキーでは認証は通っても実行時にエラーになることがあります。

原因②:ブラウザ認証フローの失敗

初回セットアップ時やclaude loginコマンドを実行した際に、ブラウザ認証フローが途中で止まるケースがあります。

よくある失敗パターン

  • ブラウザが自動で開かない(サーバー環境・WSL・SSHセッションなど)
  • ブラウザで認証したのにCLI側が「Waiting for authentication…」のまま止まる
  • 認証コードのリダイレクトがブロックされる
  • すでに別アカウントでConsoleにログインしており、権限付与が別アカウントで行われてしまう

対処手順

1
ブラウザが開かない場合:URLを手動でコピーする
CLIがURLを出力している場合はそれをコピーして手動でブラウザに貼り付けます。出力されていない場合はclaude login --print-urlオプションが使えるか確認してください(バージョンによって異なります)。

2
ConsoleのログインアカウントをCLIで使う予定のアカウントに統一する
ブラウザでConsoleを開いてから、意図したAnthropicアカウントでログインし直す。シークレットウィンドウを使うと混線を防げます。

3
ブラウザ認証を諦めてAPIキー認証に切り替える
サーバー環境やWSLではブラウザ認証フローが構造的に難しい場合があります。ANTHROPIC_API_KEY環境変数を使うAPIキー認証に切り替えるのが最も確実です。

4
認証情報をリセットして再試行する
以前の失敗した認証情報が残っていると干渉することがあります。~/.claude/ディレクトリ内の認証関連ファイルを削除してからclaude loginをやり直します(後述)。

原因③:認証情報ファイルの破損・競合

Claude Codeの設定・認証情報は~/.claude/ディレクトリに保存されています。このファイルが破損していたり、複数の設定が競合していたりするとログインできなくなります。

設定ファイルの確認

# .claudeディレクトリの中身を確認
ls -la ~/.claude/

# 設定ファイルの内容を確認(APIキーが正しく保存されているか)
cat ~/.claude/config.json  # ファイル名はバージョンにより異なる場合あり

認証情報をリセットする手順

設定ファイルに問題がある場合は、バックアップを取った上でリセットします。

# バックアップを作成
cp -r ~/.claude/ ~/.claude_backup_$(date +%Y%m%d)/

# 認証情報をリセット(ディレクトリごと削除して再作成させる)
rm -rf ~/.claude/

# 再度ログイン
claude login
# または APIキーで直接設定
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxx"
claude  # 起動確認

弊社ではリセット前に必ずバックアップを取るようにしています。カスタム設定(モデル指定・コンテキスト設定など)も入っている場合があるためです。

原因④:ネットワーク・プロキシ・ファイアウォールの問題

企業ネットワークや特定のクラウド環境では、Anthropic APIへの通信がブロックされることがあります。エラーメッセージが「Connection refused」「Timeout」「SSL error」などネットワーク系の場合はここを確認してください。

ネットワーク疎通の確認

# AnthropicのAPIエンドポイントへの疎通確認
curl -I https://api.anthropic.com

# タイムアウトする場合はプロキシ設定を確認
echo $HTTP_PROXY
echo $HTTPS_PROXY
echo $http_proxy
echo $https_proxy

プロキシ経由で接続する

# プロキシを経由させる(会社のプロキシアドレスに変更)
export HTTPS_PROXY=http://proxy.example.com:8080
export HTTP_PROXY=http://proxy.example.com:8080
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxx"
claude

SSL証明書の検証エラーが出る場合は、社内の中間CA証明書をシステムに追加するか、IT部門に確認する必要があります。自己署名証明書のスキップは本番環境では推奨しません。

接続先ドメインのホワイトリスト登録

ファイアウォール管理者に以下のドメインへのアクセスを許可してもらう必要があります。

ドメイン 用途
api.anthropic.com Claude API(メインのAPIエンドポイント)
console.anthropic.com ブラウザ認証・Console管理画面
statsig.anthropic.com 機能フラグ・設定配信(一部バージョン)

原因⑤:Claude Code自体のインストール・バージョンの問題

古いバージョンのClaude CodeはAPIの認証仕様変更に対応していないことがあります。また、インストールが中途半端な状態だと起動時にクラッシュしてログイン画面まで到達できないこともあります。

バージョン確認と更新

# バージョン確認
claude --version

# npmでインストールしている場合のアップデート
npm update -g @anthropic-ai/claude-code

# または再インストール
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code

Node.jsのバージョン互換性

Claude CodeはNode.jsで動作しています。Node.jsが古すぎるとインストールは成功しても実行時にエラーになります。Node.js 18以上を推奨します。

# Node.jsのバージョン確認
node --version

# nvmを使っている場合のアップデート例
nvm install --lts
nvm use --lts

原因⑥:Anthropic側のサービス障害・アカウント問題

自分の環境に問題がなくてもAnthropicのサービス側で障害が起きていると、ログインが通らなくなります。また、アカウントの利用制限・支払い情報の問題でAPIアクセスが停止されているケースもあります。

サービス状態の確認

Anthropicは公式のステータスページを公開しています。ログインできない場合はstatus.anthropic.comでAPIやConsoleの障害情報を確認してください。障害中の場合は復旧を待つしかありません。

アカウント・支払い状態の確認

  • Consoleにブラウザからログインして、アカウントに警告やエラーが表示されていないか確認する
  • 「API usage limit reached(利用上限超過)」が表示されていないか確認する
  • 支払い情報(クレジットカード・残高)が有効かを確認する
  • 組織アカウントを使っている場合、管理者にアカウント状態を確認してもらう

弊社でも月次の利用上限に引っかかってAPIキーが一時的に無効になったことがあります。ConsoleのUsageページで残高と使用量を定期的に確認することをお勧めします。

Claude Code・AIエージェントの業務導入をご検討の方は、自社での開発実例を公開しているクリスタルメソッドの無料相談をご利用ください。

エラーメッセージ別・原因と対処の早見表

出力されるエラーメッセージから原因を素早く特定するための一覧です。

エラーメッセージ(抜粋) 主な原因 対処
401 Unauthorized APIキーが無効・期限切れ Consoleでキーを再生成し再設定
403 Forbidden 権限不足・アカウント停止 Consoleでアカウント状態・キー権限を確認
429 Too Many Requests レート制限・利用上限超過 しばらく待つ・プランのアップグレードを検討
ECONNREFUSED / ETIMEDOUT ネットワーク・ファイアウォール問題 プロキシ設定・ホワイトリスト登録を確認
SSL certificate error 社内CA証明書・SSL検査 社内CA証明書をシステムに追加
Authentication timed out ブラウザ認証フロー失敗 ~/.claude/削除後に再認証 / APIキー認証に切替
command not found: claude インストール失敗・PATHの問題 npm install -g で再インストール・PATHを確認
500 / 503 Server Error Anthropic側のサービス障害 status.anthropic.comで状態確認・復旧を待つ

環境別のよくあるトラブルと対処法

WSL(Windows Subsystem for Linux)の場合

WSLではブラウザが自動で開かないため、ブラウザ認証フローが動作しません。WSL環境ではAPIキー認証一択です。また、WSL2とWindowsホスト間でのネットワーク解決が原因で接続失敗することもあります。

# WSL環境では環境変数でAPIキーを設定する
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxx"

# ~/.bashrcまたは~/.zshrcに追記して永続化
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

SSH接続先(リモートサーバー)の場合

リモートサーバーでも同様にブラウザ認証は使えません。APIキー認証を使い、本番サーバーには~/.bashrcより環境変数管理ツール(direnvなど)や秘密管理サービスを使うことを推奨します。

Docker コンテナの場合

コンテナ内でClaude Codeを使う場合は、環境変数としてAPIキーを渡します。docker run-eオプションか--env-fileを使い、Dockerfileにキーを直書きしないよう注意してください。

# docker runで環境変数を渡す例
docker run -e ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxx" your-image

# --env-fileを使う場合(.envファイルはGitignoreに追加すること)
docker run --env-file .env your-image

GitHub Actions / CI環境の場合

GitHub ActionsではSecretsにAPIキーを登録し、ワークフローのYAMLで環境変数として参照します。

# .github/workflows/example.yml の抜粋
env:
  ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

問題が解決しない場合のチェックリスト

上記を全て試しても解決しない場合は、以下を順番に確認してください。

  1. Claude Codeを最新バージョンに更新したかnpm update -g @anthropic-ai/claude-code
  2. Node.jsがv18以上であるかnode --version
  3. ~/.claude/を削除して認証をゼロからやり直したか
  4. 別のAPIキーを新規発行して試したか(既存のキーの問題を排除)
  5. 別のネットワーク(モバイル回線・テザリングなど)で試したか(企業ネットワークの問題を排除)
  6. status.anthropic.comで障害が出ていないか確認したか
  7. Consoleにログインしてアカウントに警告が出ていないか確認したか
  8. Anthropicのサポートに問い合わせたか(Console内のサポートフォームから送信可能)

実務での切り分け順序 ― 影響の小さい順に試す(一次情報)

当メディアの監修者・河合継はClaude Codeを3.5の時代から1年以上、日次で実務利用してきた。その中でログイン・認証のトラブルにも何度も遭遇したが、原因の切り分けには「試す順番」がある。闇雲に再インストールから入ると時間を浪費しやすいため、実務では次の順序で当たると大半が短時間で解決した。

  1. まずAnthropic側の障害を疑う(自分の環境を触る前に)。status.anthropic.com を最初に見るだけで、こちらの設定をいじって状況を悪化させる事故を防げる。「昨日まで動いていたのに急に」という時ほど、自分の環境ではなくサービス側に原因があることが多い。
  2. 次に再認証(/login のやり直し)。一時的な認証切れの多くは、設定ファイルを消す前に再ログインするだけで戻る。最も副作用が小さい復旧手段なので二番目に置いている。
  3. それでも駄目なら認証情報のリセット(~/.claude/ の削除)。古いトークンや破損した認証ファイルが残っているケースは、ここで初めて消す。再ログインで戻らなかった時だけの手段だ。
  4. 最後にインストール・バージョン側(更新/再インストール)。環境要因を疑うのはこの段階で十分で、最初から手を出す必要はほぼ無かった。

「サービス障害 → 再認証 → 認証リセット → 再インストール」という、影響の小さい順に試す流れを習慣にしておくと、復旧までの時間が安定して短くなる。原因リスト(前述の①〜⑥)を上から総当たりするより、この順序で切り分けるほうが実務では速い。

ターミナル環境でのClaude Code認証フローのイメージ
ターミナル環境でのClaude Code認証フローのイメージ

「サブスク(Pro/Max)ログイン」と「APIキー認証」の取り違えを見分ける

「ログインできない」と感じるケースの中には、実は認証方式そのものを取り違えているものが少なくありません。Claude Codeにはログインの入り口が二系統あり、どちらを使っているかを取り違えると、正しく認証しているのに「アクセス権がない」「利用できない」と表示されて行き詰まります。ここは他の原因(キーの不備・ネットワークなど)とは切り分けの観点が異なるため、単独で確認しておく価値があります。

一つ目はClaudeのサブスクリプション(Pro/Max)でのログインで、ブラウザでClaudeアカウントにサインインして利用枠を使う方式です。二つ目はAPIキー認証(従量課金)で、ANTHROPIC_API_KEYやConsole上の請求先アカウントにひも付く方式です。両者はログインするアカウントも課金の出どころも別物になり得ます。よくあるつまずきが、ブラウザ側はサブスクのアカウントで入っているのに、ターミナルには古いAPIキーが環境変数として残っていて、そちらが優先されてしまうパターンです。

取り違えを見分けるチェックポイントは次の通りです。まず環境変数にAPIキーが残っていないかを確認します(echo $ANTHROPIC_API_KEY)。サブスクで使いたいのにキーが表示される場合は、そのキーが優先されている可能性があります。次にブラウザで今ログインしているアカウントと、CLIで使いたいアカウントが一致しているかを確認します。サブスクの契約アカウントと、Consoleの請求先アカウントが別メールになっているケースは実際によくあります。最後に、「どちらの方式で使うか」を先に決めてから片方に統一することです。サブスクで使うなら環境変数のキーを一時的に外す、APIキーで使うならブラウザ側の状態は無視する、と方針を固定するだけで、認証系のトラブルは大きく減ります。個人の日常利用はサブスク、CI/CDやサーバーはAPIキーと、用途で入り口を分けて考えると混線しにくくなります。

まとめ

Claude Codeのログインができない原因は、①APIキーの不備、②ブラウザ認証フローの失敗、③認証情報ファイルの破損、④ネットワーク・ファイアウォールの問題、⑤インストール・バージョンの問題、⑥Anthropic側の障害・アカウント問題の六つに大別されます。

弊社の実務経験からいうと、最も多いのは①のAPIキー設定ミスと、③の認証情報ファイルの古い設定が残っているケースです。まずエラーメッセージを確認して早見表と照らし合わせ、該当する原因の対処法を試すのが最短の解決ルートです。WSL・SSH・Dockerなどブラウザが使えない環境では最初からAPIキー認証で設定する方針にしておくと、こうしたトラブルを未然に防げます。環境ごとに認証方式を統一し、APIキーはシークレット管理ツールで安全に管理する習慣を付けておくと、チームでの運用もスムーズになります。

関連記事

監修

河合 継(クリスタルメソッド株式会社 代表取締役)

AI・ディープラーニングに関する特許16件の発明者。過去、国立がん研究センターとの共同研究や、テレビ番組でのAI解説実績を持つAI研究者として、AIの研究開発を主導している。
運営会社について編集方針

Claude Code・AIエージェントの業務活用をご検討の方へ

クリスタルメソッドは、Claude Codeを実務投入している開発会社として、AIエージェント・社員AIの導入と開発効率化を支援しています。自社サイトの表示速度をAI社員(Claude Code)で12.89秒→2.03秒に短縮した実例も事例記事として公開しています。「自社の開発・業務にAIをどう組み込むか」といったご相談を承っています。

AIブログ購読

 
クリスタルメソッドがお届けする
AIブログの更新通知を受け取る

Study about AI

AIについて学ぶ

  • 教育 AI 活用 事例から学ぶ企業研修のDXとAnthropic無償提供が示すプロンプトの重要性

    教育 AI 活用 事例から学ぶ企業研修のDXとAnthropic無償提供が示すプロンプトの重要性

    ## 1. Anthropicによる教育者向けClaude無償提供ニュースの要点 2026年1月、AIスタートアップのAnthropicは、国際NGO「Teac...

  • AI人事評価のリスクと違法性の境界線とは?Meta社リストラ訴訟から学ぶ防衛策

    AI人事評価のリスクと違法性の境界線とは?Meta社リストラ訴訟から学ぶ防衛策

    近年、企業の意思決定プロセスにおいてAI(人工知能)の活用が急速に進んでいます。特に人事評価や採用、人員整理といった領域でのAI導入は、業務効率化や客観性の担保...

  • AIエージェントの相互運用性と規制がもたらす経営インパクト—米上院法案から紐解く日本企業の針路

    AIエージェントの相互運用性と規制がもたらす経営インパクト—米上院法案から紐解く日本企業の針路

    自律的にタスクを遂行するAIエージェントの台頭に伴い、異なるシステムやプラットフォーム間でこれらを安全に連携させる「相互運用性」と、それを支える「規制」のあり方...

View more