カテゴリ

インストール・ログイン

5 項目

Claude Codeのインストール・ログインとは|このカテゴリで分かること

Claude Code を使い始めるときの最初の関門が、インストールとログインです。公式のセットアップには、macOS、Linux、WSL、Windows の PowerShell、Windows の CMD ごとに、ネイティブインストールのコマンドが示されています。このカテゴリでは、Claude Code のインストールとログインでよく起きるつまずきを、表示される文言から探せるように整理します。

対象は、インストールが終わったのに claude が見つからない人、ログインがうまくいかない人、更新や診断の方法を知りたい人です。ゴールは、エラーの文言から原因を特定し、公式の手順で自力で直せることです。会社のネットワークなど、環境に依存する問題も、確認の観点を示します。

はじめにおすすめの3本

迷ったら、まずこの3本から読んでください。残りの記事は、このページ下の項目一覧から選べます。

  1. 「command not found: claude」エラー|PATHの確認と直し方
    インストール直後に最も多い「見つからない」エラーの、PATH の直し方です。
  2. Claude CodeをWindowsにインストールする方法|PowerShellとCMD
    Windows での導入手順と、PowerShell と CMD の取り違えの直し方です。
  3. Claude Codeにログインできない問題|403・ループの直し方
    ログインできない、ループする、403 が出るときの、原因別の対処です。

押さえておきたいポイント(リサーチ)

公式ドキュメントで確認できた事実です。

論点 確認できた内容
動作環境 macOS 13.0 以降、Windows 10 の 1809 以降、Ubuntu 20.04 以降など。メモリ 4GB 以上
インストール先 macOS・Linux は ~/.local/bin/claude、Windows は %USERPROFILE%\.local\bin\claude.exe
確認方法 新しい端末で claude --version を実行し、版番号が出れば成功
再認証 /logout でログアウトし、Claude Code を閉じて、claude で再度認証する
環境変数 ANTHROPIC_API_KEY が残っていると、サブスクリプションより優先される
診断 claude doctor(端末)と /doctor(セッション内)で、インストールと設定を診断できる

手順や版は更新されます。最新は公式で確認してください。

よくある疑問

Q. インストールが成功したか、どう確認しますか。
A. 新しい端末で claude --version を実行します。版番号が出れば成功です。出ない場合は、「command not found: claude」エラー|PATHの確認と直し方 を参照してください。

Q. PowerShell と CMD のコマンドは、どちらを使えばよいですか。
A. プロンプトが「PS C:\」なら PowerShell、「C:\」なら CMD です。使い分けは Claude CodeをWindowsにインストールする方法|PowerShellとCMD にあります。

Q. ログインのたびに失敗します。
A. まず /logout からやり直します。原因別の表は Claude Codeにログインできない問題|403・ループの直し方 にあります。

Q. 更新は手動で行う必要がありますか。
A. ネイティブ版は自動更新されます。Homebrew や WinGet は手動です。詳しくは Claude Codeのアップデート方法|claude updateと自動更新の仕組み を参照してください。

Q. 原因が分からないとき、最初に何をすればよいですか。
A. 診断コマンドの実行です。使い方は claude doctorと/doctor|診断コマンドの使い方と結果の読み方 にまとめています。

編集部の見解

インストールとログインの問題は、文言から原因がほぼ決まるため、落ち着いて表示を読めば、多くは短時間で直ると考えます。つまずきやすいのは、焦って再インストールを繰り返し、複数のインストールが混在してしまうことです。直らないときは、いったん現状を確認し、1つにそろえることを勧めます。

ログインについては、環境変数に残った古い API キーが、見落とされやすい原因だと考えます。心当たりがなくても、一度確認する価値があります。会社の組織で権限の問題が出る場合は、自分で直そうとせず、管理者に症状の文言をそのまま伝えるのが近道だと考えます。

なお、本ページは情報提供を目的としたもので、会社の環境での作業は、IT 担当者の方針に従ってください。

出典(一次情報)

インストール・ログインの項目一覧