claude code インストール手順と完了判定を実測ログで確認する

社内端末でPowerShellを開き、公式Quickstartと古いnpm記事を見比べている人や、ターミナルでclaudeが返らず作業前に止まっている人に向けた手順書です。Native Install、初回起動、認証前後の状態、導入済みと判断するコマンドまで同じ流れで追えます。

この記事の独自実測ログは、macOSの一時HOMEでのNative Installと、既存macOS環境でのログイン済み応答確認です。version値は検証ログの値なので、あなたの端末では同じ確認コマンドで照合してください。Windows、初回ブラウザ認証、claude doctorの成功は公式情報にもとづく範囲として読みます。

まず導入経路と検証範囲を決める

社内端末でPowerShellを開いたまま、公式Quickstart、Desktop quickstart、古いnpm前提の記事を見比べていると、最初の1行をどこに合わせるかで手が止まります。ターミナルでclaudeが返らない場面まで想定し、先にCLI、Windows、Desktopのどれを読むかと、この記事が実測で言える範囲を決めます。

判断1：CLIを主導線にする人

Quickstart - Claude Code Docsは、ターミナルからClaude Codeを起動して最初のセッションへ進む流れを示しています。開発プロジェクトのフォルダで作業し、コマンドとしてClaude Codeを使いたいなら、このCLI経路を主導線にします。

判断2：Desktopへ回した方がよい人

ターミナルより画面操作を優先したい場合や、まずGUIで感触をつかみたい場合は、Desktop quickstart - Claude Code Docsが出発点です。CLIで進めるか、画面操作から始めるかをここで切り分けると、後続のコマンドを混ぜずに進められます。

証拠1：この記事で実測済みの範囲

この記事のローカル検証は、macOS一時HOMEでNative Install、launcher symlink、claude --versionまで進んだログと、既存macOS環境でログイン済み状態と最小応答が返ったログです。Windowsで進める場合は、各章の公式リンクと自分の端末の結果を照合してください。

導入経路は、最初にこの表で仕分けます。確認方法の列を見ると、この記事の実測ログで追う範囲と、公式手順を照合する範囲が分かります。

Claude Codeの全体像を先に押さえたい場合は、Claude Codeとは何かを全体像から確認するを別タブで読んでから戻ると、CLIとDesktopの役割差がつかみやすくなります。

インストール前の前提条件を確認する

社内端末や新しい開発環境では、コマンドより前の条件で止まることがあります。OS、ターミナル、アカウント、Git、インストール経路ごとの補助ツールを先に見ておくと、エラーが出たときの原因を狭められます。

前提1：全員に必要なOSとターミナル

Advanced setup - Claude Code Docsは、OSやshellなどの前提条件を整理しています。最初にそろえる項目は、対応するOS、普段使うターミナル、作業するプロジェクトディレクトリ、ネットワーク制限の有無です。

• 対応するOSで作業しているかを照合する
• PowerShell、CMD、zsh、bashなど使うshellを決める
• Claude Codeを起動するプロジェクトディレクトリを用意する
• 会社端末ならproxyやネットワーク制限の有無を把握する

前提2：全員に必要なClaudeアカウントと利用条件

Authentication - Claude Code Docsでは、Claude.ai、Console、TeamやEnterprise、クラウドプロバイダー経由などの認証入口が整理されています。料金やseat条件は固定せず、インストール前には自分がどの入口でログインするかだけを決めます。

• 個人のClaude.aiで試す場合は、ブラウザで使うアカウントを用意する
• TeamやEnterprise契約で使う場合は、管理者からClaude Codeの利用対象になっているかを確認する
• Consoleやクラウドプロバイダー経由で使う場合は、組織側の認証経路と請求管理の担当者を確認する

前提3：WindowsでGit for Windowsを用意する

Windows nativeで進める場合は、Bash toolの利用に関係するGitの有無を見ます。必要になったら、Git for Windowsを公式の入手先として使い、インストール済みかどうかを端末側で見ます。

前提4：経路ごとに必要になるHomebrewとWinGetとnpm

Homebrew、WinGet、npm、Linux package manager、WSLは、選んだ経路によって必要性が変わります。Native Installを主経路にする場合、最初に必要なものはOS、shell、作業ディレクトリ、認証入口です。Node.jsやnpmは、npm経由や周辺ツールを選ぶ場面で必要性を見ます。

企業端末で認証、通信、権限の審査が先に必要な場合は、Claude Codeの法人セキュリティ要件を手元の審査項目に照らし、インストール手順へ入る前に社内の承認条件をそろえてください。

OS別のインストール手順を実行する

ここから実行に入ります。表ではコマンドの種類だけを短く照合し、実際に貼るコマンドは下のコードブロックから選びます。PowerShellとCMDは似て見えても実行文が違うため、環境名を先に確認してください。

手順1：macOSとLinuxとWSLでNative Installを実行する

macOS、Linux、WSLでは、公式のNative Installer endpointをbashで実行します。ローカル検証では、一時HOMEのmacOS環境でinstallerがClaude Code 2.1.178を配置し、launcher symlinkとversion確認まで進みました。

curl -fsSL https://claude.ai/install.sh | bash

手順2：Windows PowerShellでNative Installを実行する

WindowsでPowerShellを使う場合は、PowerShell用のinstaller endpointを使います。この記事の実測ログはmacOSなので、Windowsでは公式手順のコマンドと自分の端末の出力を照合しながら進めます。

irm https://claude.ai/install.ps1 | iex

手順3：Windows CMDを使う場合の注意点を確認する

CMDを使う場合はCMD用のinstaller endpointを使います。PowerShell用のirmとCMD用の実行文を混ぜると失敗の原因になるため、Terminal guide for new users - Claude Code Docsでshellの違いも確認します。

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd

手順4：旧npm手順を推奨手順として扱わない

SERPにはnpmやWSL2を最初から前提にした記事も混ざります。最初の経路は公式のNative Installに寄せ、npmは必要になった場面で確認する補助経路に回すと、前提条件を増やさずに進められます。

OS別の対応はこの表で見ます。コマンド全文は表に詰め込まず、貼り付け用のコードブロックから選ぶ構成にしています。

初回起動と認証を進める

インストール直後は、どのフォルダで起動したか、どのアカウントで認証するか、作業フォルダを信頼してよいかを順番に確認します。ここを飛ばすと、CLIは入ったのに使える状態か判断できないままになります。

手順1：プロジェクトディレクトリでclaudeを起動する

Claude Codeは作業対象のプロジェクトディレクトリで起動します。Quickstartの流れでも、ターミナルでプロジェクトへ移動してからclaudeを実行し、最初のセッションに入ります。

cd path/to/your-project
claude

手順2：ブラウザ認証とログイン方式を選ぶ

初回起動ではブラウザ認証へ進む流れがあります。個人利用、TeamやEnterprise、Consoleやクラウドプロバイダー経由の入口は、Authentication - Claude Code DocsとTeam / Enterpriseの公式ヘルプを公式ドキュメントで確認して選びます。

手順3：ウェルカム画面とフォルダ信頼を確認する

初回セッションでは、ウェルカム画面や作業ディレクトリの信頼確認が出る場合があります。画面の文言は変わることがあるため、ここではスクリーンショット前提にせず、作業フォルダとログイン状態を確認する方針にします。

手順4：認証前後の状態を分けて確認する

一時HOMEのクリーン検証では、インストール後のauth statusはloggedIn: falseでした。既存macOS環境では、匿名化したauth statusでloggedIn: trueとauthMethod: claude.aiを確認し、非対話の最小応答まで返りました。

導入完了をコマンドで判定する

インストール後は、PATH、version、認証状態、最小応答の順に見ます。installerが終わっても、この4つが見えない間は原因を切り分ける余地があります。

# clean HOME macOS：Native Install後のPATHとversion
$ command -v claude
[temp-home]/.local/bin/claude

$ ls -la [temp-home]/.local/bin/claude
[temp-home]/.local/bin/claude -> [temp-home]/.local/share/claude/versions/2.1.178

$ claude --version
2.1.178 (Claude Code)

# clean HOME macOS：認証前の境界
{
  "loggedIn": false,
  "authMethod": "none",
  "apiProvider": "firstParty"
}

# existing macOS：匿名化したログイン状態
$ claude auth status
{
  "loggedIn": true,
  "authMethod": "claude.ai",
  "apiProvider": "firstParty",
  "email": "[redacted]",
  "orgId": "[redacted]",
  "orgName": "[redacted]",
  "subscriptionType": "[redacted]"
}

# existing macOS：最小応答
$ claude -p 'Return exactly: INSTALL_CHECK_OK' --safe-mode --disable-slash-commands --tools '' --max-budget-usd 0.20 --output-format text
INSTALL_CHECK_OK

# doctor：この実測では成功ログなし
$ claude doctor
# no stdout after more than 40 seconds; stopped from evidence workflow

判定1：claudeへのPATHが通っている

一時HOMEの検証では、~/.local/binをPATHに入れるとcommand -v claudeが実行ファイルの場所を返しました。installerはPATH未反映時にsetup noteを出したため、この症状はローカル観測ありとして扱えます。

判定2：claude versionが返る

ローカル検証では、クリーン一時HOMEと既存macOS環境のどちらでもclaude --versionが2.1.178 (Claude Code)を返しました。version値は検証ログの値として読み、自分の端末では同じコマンドの出力を確認します。

判定3：ログイン状態を確認できる

認証後の確認では、メールアドレスや組織IDを出さずに、loggedInとauthMethodだけを見ます。既存macOS環境では、Claude.ai経由でログイン済みと分かる状態まで匿名化して記録しました。

判定4：最小応答が返る

既存macOS環境では、非対話でReturn exactly: INSTALL_CHECK_OKを投げ、期待した文字列が返ることを確認しました。このチェックの目的は、CLIが応答できる状態かを見ることです。実務プロンプトの性能評価には使いません。

補助判定：claude doctorは公式確認に留める

claude doctorは追加確認の候補ですが、このローカル実行では40秒以上、画面に出力が返らず、成功ログを取得できませんでした。完了判定では、先にPATH、version、認証状態、最小応答を照合してください。

判定表は、失敗した項目から次章の切り分けへ進むために使います。各行は、現在地を知るための照合点です。

command -v claude
claude --version
claude auth status
claude -p 'Return exactly: INSTALL_CHECK_OK' --safe-mode --disable-slash-commands --tools '' --max-budget-usd 0.20 --output-format text

失敗しやすい点を症状から切り分ける

失敗時は、手順を最初からやり直す前に症状を分けます。コマンドが見つからないのか、shellを取り違えたのか、GitやWSLの前提なのか、認証やネットワークなのかで見る場所が変わります。

失敗1：claudeコマンドが見つからない

ローカル観測で確認できた代表症状は、「Native installation exists but ~/.local/bin is not in your PATH」というsetup noteです。まずPATHにClaude Codeのlauncherが入っているかを確認します。

失敗2：PowerShellとCMDのコマンドを取り違える

PowerShellはirm ... | iex、CMDはinstall.cmdを取得して実行する形です。Windowsのshell違いは、Terminal guide for new users - Claude Code Docsで確認し、同じ画面に貼るコマンドを混ぜないようにします。

失敗3：WindowsでGitやBashやWSLの選び分けに詰まる

Windows nativeでGitやBash toolの前提に詰まる場合は、Git for Windowsの有無を確認します。Linux前提の開発環境をそのまま使うならWSLへ寄せる選択もあります。成功可否は、公式手順と手元の画面出力を照合して判断します。

失敗4：認証や契約条件で止まる

ブラウザ認証やプラン条件で止まる場合は、Authentication - Claude Code DocsとTeam / Enterpriseの公式ヘルプを開き、選んだ入口が個人Claude.ai、Team / Enterprise、Console、クラウドプロバイダー経由のどれかを見直します。料金、seat条件、usage limitは版や契約で変わるため、最新の公式ページで照合します。

失敗5：権限やネットワークで止まる

企業端末ではproxy、ネットワーク、権限管理、データ利用条件が関係する場合があります。通信や権限で止まるときは、Data usage - Claude Code DocsとSecurity - Claude Code Docsを開き、社内の制限と照らし合わせます。

症状表は、最初に見る場所を決めるための入口です。扱い列を見て、実測済みの症状か公式手順で照合する症状かを分けて進めます。

より細かい原因別の復旧手順は、Claude Codeのエラーと動かない時の対処を確認するで扱う予定です。この記事では、初回導入で見る入口に絞ります。

更新とやり直しの範囲を最小限で押さえる

インストールが終わったら、更新や再インストールの入口だけ押さえます。初回導入の記事でversion管理やアンインストールを長く扱うと、今やるべき確認から外れてしまいます。

運用1：Native InstallとHomebrewとWinGetの更新差分を見る

Advanced setup - Claude Code Docsには、更新、version management、アンインストールの入口があります。Native、Homebrew、WinGet、npmでは更新方法が変わるため、再インストールや更新の前に公式手順で現在のコマンドを確認します。

運用2：アンインストールと再インストールは公式手順へ戻る

やり直しが必要な場合は、自己判断で関連ファイルを消す前に公式のsetup手順へ戻ります。設定や認証情報に触れる作業は環境差が大きいため、この記事では削除手順を固定表から外します。

運用3：DesktopやIDEに切り替える条件を確認する

CLIでの作業が目的に合わない場合は、DesktopやIDE integrationへ切り替える判断もあります。VS Code中心で進めたい場合は、Use Claude Code in VS Code - Claude Code Docsを確認先にします。

GUIを主導線にする場合は、Claude Codeデスクトップ版の使い方を確認するへ進むと、この記事のCLI手順から目的を切り替えやすくなります。

FAQ

最後に、インストール直前に迷いやすい疑問を短く整理します。macOSの実測ログで言える範囲と、公式ドキュメントで判断する範囲を混ぜずに読める形にします。

FAQ1：Claude CodeのインストールにNode.jsは必要か

Native Installを主経路にする場合、Node.jsやnpmを全員の前提には置きません。npm経路を選ぶ人だけ、Node.jsとnpmをその経路の準備項目として見ます。

FAQ2：WindowsはPowerShellとCMDのどちらで始めるべきか

Windowsでは、まずPowerShellの手順を見ます。社内手順や端末制約でCMD指定がある場合に、CMD用コマンドへ切り替えます。この記事のWindows部分は公式ドキュメントの確認範囲です。

FAQ3：claude doctorまで成功しないと導入完了ではないか

claude doctorは補助判定に置きます。今回の実測ログにはdoctor成功がないため、導入完了はPATH、version、認証状態、最小応答の4つで読者が照合できる形にします。

FAQ4：無料プランや料金はどこまで確認すべきか

料金、seat条件、usage limitは変わるため、記事内では固定表にしません。認証で止まったときは、Claude pricingとTeam / Enterpriseの公式ヘルプで、自分のログイン入口と利用対象を確認します。

FAQ5：CLIが不安な場合はDesktopから始めてよいか

CLIに不安がある場合、Desktopから始める選択もあります。この記事の主目的はCLIのNative Installなので、GUI優先の人はDesktop quickstartに沿って進めると手順が混ざりにくくなります。

インストール後の初期設定へ進む

PATH、version、認証状態、最小応答まで見えたら、次はClaude Codeにプロジェクトの前提を渡す段階です。ここから先は活用術を広げるより、最初に壊さないための設定を短く整えます。

次の打ち手1：slash commandとhelpを確認する

CLI reference - Claude Code Docsで、helpや基本コマンドの入口を確認します。初回は機能を覚えるより、困ったときにhelpへ戻れる状態を作る方が重要です。

claude --help
claude
/help

次の打ち手2：CLAUDE.mdでプロジェクトの前提を渡す

作業ルール、触ってよい範囲、禁止したい操作、テスト方法はCLAUDE.mdに寄せていきます。具体的な書き方は、Claude CodeのCLAUDE.md設定方法を確認するで分けて説明します。

次の打ち手3：権限設定と安全な使い方を整える

権限や安全な使い方は、インストール直後から確認する候補です。Security - Claude Code Docsを確認先にしつつ、この記事では権限管理の詳細へ広げず、次の設定作業へ渡します。

次の打ち手4：おすすめ初期設定のチェックリストへ進む

インストール後に最初に確認するのは、help、CLAUDE.md、権限、作業フォルダの4項目です。手元で動く状態を確認したら、Claude Codeの初期設定おすすめチェックリストへ進むと合わせて、設定を小さく積み上げてください。

• helpで困ったときの入口を確認する
• CLAUDE.mdにプロジェクトの前提を書く
• 権限や通信の確認先を用意する
• 作業フォルダで最小応答をもう一度確認する