• AIエージェント

Claude Codeのインストール方法｜Windows・Mac対応の手順と初期設定【2026年最新】

Claude Codeを試したいものの、「どの方法で入れるのが正解か分からない」「記事によって手順が違う」と迷っていませんか。導入方法は複数あり、公式が推奨する方式も途中で変わってきたため、古い情報を参照すると余計な作業が増えます。

本記事では、インストール前に確認すべきシステム要件と必要なプランから、導入方法の選び方、macOS・Linux・Windowsそれぞれの手順、動作確認とログイン、つまずいたときの切り分け、更新とアンインストール、企業導入時の統制設計までを、公式ドキュメントの情報をもとに整理します。

確認したいポイント	結論	詳細
インストールに何が必要？	対応OSと有料プランの契約が必要です	macOS 13以降、Windows 10 1809以降、主要なLinuxに対応。無料プランではClaude Codeを使えません。
どの方法で入れる？	公式のネイティブインストーラーが推奨	Homebrew・WinGet・apt等のパッケージ管理やnpmも選べます。自動更新の有無が方式によって異なります。
導入後は何を確認する？	バージョン表示と診断コマンドで確認	バージョン確認で版番号が出れば成功です。詳しい状態は診断コマンドで一括して確認できます。
企業で使う場合の注意は？	バージョン統制と権限設計を先に決める	更新チャンネルの指定や最低バージョンの固定ができます。実行を許可する範囲も事前に定めます。

この記事でわかること

• インストール前に確認すべきシステム要件と必要なプラン
• ネイティブ・パッケージ管理・npmという導入方法の選び方
• macOS・Linux・Windowsそれぞれの手順と注意点
• 動作確認とログイン、つまずいたときの切り分け方
• 更新・アンインストールと、企業導入時の統制設計

資料請求のご案内 AIコーディングツールを社内で導入する際の環境設計と権限設計、評価項目をまとめた資料をご用意しています。 検討の初期段階からご活用ください。 ▶ 資料を無料でダウンロードする

Claude Codeとは｜インストール前に押さえる前提

手順に入る前に、前提を整理します。ここではツールの性格、必要な契約、ターミナルを使わない選択肢という3点を確認します。特に契約条件を見落とすと、インストールが終わってから利用できないことに気づきます。

ターミナルで動くコーディングエージェント

Claude Codeは、Anthropicが提供するターミナル上で動作するコーディングエージェントです。ブラウザのチャット画面ではなく、コマンドを入力して起動し、指定したディレクトリ内でファイルの読み書きやコマンド実行まで行います。

「このリポジトリの構成を説明して」「失敗しているテストを直して」といった指示から、ファイルの探索、修正、テストの実行までを一連の流れとして進めます。コードを貼り付けて回答を戻す往復が不要になる点が、従来の使い方との違いです。

国内でもAI活用は広がっており、情報処理推進機構（IPA）が2026年7月に公表した調査では、AI導入による効果として「業務が効率化したり迅速化した」と回答した企業が91.6%に達しました。開発領域はその効果が出やすい分野のひとつです。

出典：独立行政法人情報処理推進機構「DX動向2026」（2026年7月16日公表）

必要なプランと契約を確認する

利用にはアカウントが必要です。公式ドキュメントでは、Pro、Max、Team、Enterprise、またはConsoleのアカウントが必要で、無料プランにはClaude Codeへのアクセスが含まれないと明記されています。

このほか、Amazon Bedrock、Google Cloud、Microsoft Foundryといった外部のAPIプロバイダー経由で利用する構成も用意されています。既に別のクラウド契約がある組織では、こちらを検討する余地があります。

また、利用できる国が定められています。導入前に対象地域に含まれているかを確認しておくと、後から使えないという事態を避けられます。

ターミナルを使わない選択肢もある

コマンド操作に不慣れな場合は、デスクトップアプリという選択肢があります。macOS、Windows、Linux向けに提供されており、ターミナルを開かずに同じ機能を利用できます。

まず使用感を確かめたい段階であれば、デスクトップアプリから入るほうが心理的な負担は小さくなります。慣れてからターミナル版に移行しても、設定は共有されます。

一方で、自動化やCIへの組み込みを想定しているならターミナル版が前提になります。用途に応じて選んでください。

システム要件と事前確認

つまずきの多くは、前提条件の確認漏れが原因です。ここでは対応OSとハードウェア、シェルとネットワーク、事前チェックの3点を整理します。10分の確認で、後の数時間を節約できます。

対応OSとハードウェア

公式ドキュメントによると、対応するOSはmacOS 13.0以降、Windows 10 1809以降またはWindows Server 2019以降、Ubuntu 20.04以降、Debian 10以降、Alpine Linux 3.19以降です。古いmacOSを使っている場合は、先にOSの更新が必要になります。

ハードウェアの要件は、4GB以上のメモリと、x64またはARM64のプロセッサとされています。ただしこれは最小要件であり、テストの実行や複数の処理を並行させる場面ではより多くのメモリを使います。

GPUは不要です。処理はクラウド側で行われるため、ローカルで推論するわけではありません。この点を誤解して高性能な機材を用意する必要はありません。

シェルとネットワーク

シェルはBash、Zsh、PowerShell、CMDに対応しています。普段使っているターミナルがこのいずれかであれば、追加の準備は不要です。

動作にはインターネット接続が必須です。社内ネットワークでプロキシや通信制限がある場合は、接続先の許可設定が必要になることがあります。情報システム部門との事前調整をおすすめします。

検索機能に使われるコンポーネントは通常同梱されていますが、Alpineなど一部のディストリビューションでは別途の準備が必要です。該当する環境では公式の案内を確認してください。

インストール前のチェックリスト

作業前に、次の4点を確認しておくと手戻りが減ります。対象OSのバージョン、契約しているプラン、端末でのソフトウェア導入が許可されているか、対象のリポジトリをローカルに置けるかの4点です。

3点目は特に企業では重要です。社内端末ではソフトウェアの導入に承認が必要なことが多く、個人判断で進めると規程違反になる場合があります。

エージェント型のAIを業務に組み込む考え方は、AIエージェントとは？仕組みと業務への組み込み方で扱っています。

インストール方法の選び方

導入方法は複数あり、それぞれ更新の扱いが異なります。ここではネイティブインストーラー、パッケージマネージャー、npmという3系統を比較します。自動更新されるかどうかが、選択の分かれ目になります。

ネイティブインストーラー（推奨）

公式が推奨しているのが、専用のインストーラーを使う方法です。バイナリを直接配置する方式で、Node.jsなどの前提環境が不要な点が利点になります。

この方式で導入した場合、新しいバージョンはバックグラウンドで自動的に更新されます。手動での更新作業が不要になるため、個人利用や少人数のチームでは扱いやすい方式です。

macOS、Linux、WSLではシェルからコマンドを1行実行するだけで完了します。WindowsではPowerShellとCMDそれぞれに対応したコマンドが用意されています。

パッケージマネージャー経由で導入する

普段からパッケージ管理の仕組みを使っている場合は、そちらに合わせる方法もあります。macOSではHomebrew、WindowsではWinGet、Linuxではapt・dnf・apkに対応した公式リポジトリが提供されています。

この方式の注意点は、自動更新が行われないことです。更新は各パッケージマネージャーの手順で手動実行する必要があります。定期的な更新を運用に組み込んでおいてください。

なおHomebrewでは、安定版を追うものと最新版を追うもので配布が分かれています。組織で標準を決める場合は、どちらを使うかも合わせて指定してください。

npmで導入する場合の注意

npmのグローバルパッケージとして導入することもできます。ただし公式ドキュメントによれば、現在のnpmパッケージはNode.js 22以降を要求します。

多くの解説記事はNode.js 18以上と記載していますが、これは以前の要件です。古い情報のまま進めると警告が出るため、実行前にNode.jsのバージョンを確認してください。

また、管理者権限を付けてグローバルインストールを行う方法は、権限の問題や安全性の観点から推奨されていません。権限エラーが出た場合は、別の対処方法を確認してください。

出典：Claude Code公式ドキュメント「Advanced setup」

無料相談のご案内 どの導入方式が自社の端末管理やセキュリティ方針に合うかは、環境によって変わります。 現状をお聞かせいただければ、進め方を一緒に整理します。 ▶ 無料相談を申し込む

手順①｜macOS・Linuxへの導入

ここからは実際の作業です。ネイティブインストーラー、Homebrew、Linuxのパッケージマネージャーという3つの方法を順に見ていきます。いずれもコマンドを実行するだけで、作業自体は数分で終わります。

ネイティブインストーラーで導入する

ターミナルを開き、公式が案内しているインストールコマンドを実行します。バイナリが自動でダウンロードされ、ホームディレクトリ配下に配置されます。

配置先はユーザー領域のため、管理者権限は不要です。導入後は、プロジェクトのフォルダに移動して起動コマンドを実行すると、対話画面が立ち上がります。

無人での導入が必要な環境向けに、対話を伴わない実行方法も用意されています。共通の開発環境を用意する場合はこちらを検討してください。

Homebrewで導入する

macOSでHomebrewを使っている場合は、caskとして導入できます。普段のアプリ管理と同じ手順で扱えるため、端末の構成管理をそろえたい場合に向いています。

この方式では自動更新が行われないため、定期的にアップグレードのコマンドを実行する必要があります。設定によっては、更新を自動で実行させることも可能です。

古いバージョンがディスクに残り続けるため、時折クリーンアップを実行して容量を回収しておくとよいでしょう。

Linuxのパッケージマネージャーで導入する

Debian系、Fedora系、Alpine向けに、署名付きの公式リポジトリが公開されています。リポジトリを登録すれば、通常のシステム更新の流れで管理できます。

各リポジトリには安定版と最新版のチャンネルが用意されています。安定版は概ね1週間ほど前のバージョンが配信され、大きな不具合を含むリリースは飛ばされる設計です。

登録時には署名鍵を取得します。取得した鍵の指紋が公式に記載された値と一致するかを必ず確認してください。ここを省略すると、なりすましのリスクが残ります。

手順②｜Windowsへの導入

Windowsは選択肢が多く、迷いやすい環境です。ここではネイティブとWSLの選び方、PowerShellとCMDの違い、Git for Windowsの役割を整理します。どちらの環境を選ぶかで、使える機能が変わります。

ネイティブWindowsとWSLの選び方

Windows上で直接動かす方法と、WSL内で動かす方法があります。判断の基準は、プロジェクトがどこに置かれているかと、サンドボックス機能が必要かどうかです。

公式ドキュメントによると、コマンド実行を隔離するサンドボックス機能はWSL 2でのみ対応しています。ネイティブWindowsとWSL 1では対応していません。安全性を重視する場合はWSL 2が前提になります。

一方、Windows向けのツールチェーンを使うプロジェクトであれば、ネイティブでの導入が扱いやすくなります。用途に応じて選んでください。

PowerShellとCMDの違いに注意する

Windowsではインストールコマンドが2種類あり、使っている画面によって実行するコマンドが変わります。プロンプトの表示を見れば、どちらを使っているか判別できます。

行頭にPSの表記があればPowerShell、なければCMDです。片方のコマンドをもう片方で実行すると、構文に関するエラーやコマンドが認識されないというエラーが出ます。

エラーメッセージから逆に判断することもできます。区切り文字に関するエラーが出た場合はPowerShell側、コマンドが認識されないという表示が出た場合はCMD側にいる、と切り分けられます。

Git for Windowsの役割

ネイティブWindowsで使う場合、Git for Windowsの導入が推奨されています。これがあるとBashのツールが使えるようになり、Linux系のコマンドをそのまま実行できます。

導入していない場合は、代わりにPowerShellを使ってコマンドが実行されます。動作しないわけではありませんが、コマンドの書き方が変わる点に注意してください。

なお、WSLを使う構成であればGit for Windowsは不要です。WSL側の環境がそのまま使われるためです。

資料請求のご案内 開発チームへの展開手順と、効果測定の項目をまとめた資料をお配りしています。 社内での比較検討にお役立てください。 ▶ 資料請求はこちら

動作確認とログイン

導入が終わったら、正しく入ったかを確認します。バージョン表示、診断コマンド、認証という3つの手順で進めます。ここでつまずく場合、原因はほぼパスか権限のどちらかです。

バージョンを確認する

最初に、バージョンを表示するコマンドを実行します。版番号が表示されれば、正しく導入できています。

コマンドが見つからないという表示が出る場合は、実行ファイルへのパスが通っていない可能性があります。ターミナルを開き直すだけで解決することも多いため、まず再起動を試してください。

特定のバージョンを指定して導入することもできます。組織で使うバージョンをそろえたい場合に有効な方法です。

診断コマンドで状態を確認する

より詳しく確認したい場合は、診断用のコマンドが用意されています。セッションを開始せずに、導入状態と設定ファイルの検証結果、警告と推奨される対処をまとめて表示できます。

設定ファイルに誤りがある場合や、複数の導入が競合している場合もここで検出されます。原因が分からないときは、まずこのコマンドを実行するのが早道です。

更新が正しく行われているかもここで確認できます。自動更新が効いていない場合の切り分けにも使えます。

ログインして利用を開始する

起動コマンドを実行すると、初回はログインを求められます。ブラウザが開き、アカウントで認証する流れです。

APIキーを環境変数として設定している場合は、ブラウザを開く代わりにそのキーを使うかどうかの確認が一度表示されます。共有環境やCIで使う場合はこちらの方式になります。

認証が完了したら、対象のプロジェクトフォルダで起動し、読み取り中心の指示から試してください。指示の設計については生成AIの精度を上げるプロンプト設計の基本も参考になります。

インストール時のつまずきと対処

相談が集中するのは3つの箇所です。コマンドが見つからない、権限のエラー、導入の重複という順に、切り分け方を整理します。多くはツールの不具合ではなく、環境側の条件によるものです。

コマンドが見つからない

最も多いのがこの症状です。実行ファイルの配置先にパスが通っていないか、ターミナルが古い状態を保持していることが原因になります。

対処としては、ターミナルを開き直す、シェルの設定ファイルを読み込み直す、という順で試します。それでも解決しない場合は、配置先のディレクトリが環境変数に含まれているかを確認してください。

社内端末では、セキュリティソフトや実行ポリシーによってブロックされている可能性もあります。この場合は情報システム部門への確認が必要です。

権限に関するエラーが出る

npmで導入する際に発生しやすいのが権限のエラーです。管理者権限を付けて実行する方法は、公式ドキュメントでも推奨されていません。

グローバルの導入先ディレクトリに書き込み権限がない場合、自動更新も動作しません。この場合は起動時に通知が表示され、診断コマンドで対処方法が示されます。

根本的な解決としては、ネイティブインストーラーへの切り替えが確実です。前提環境に依存しないため、権限まわりの問題が起きにくくなります。

複数の導入が競合している

アンインストールしたはずなのに起動してしまう場合、別の方法で入れたものが残っています。過去にnpmで入れたものと、後からネイティブで入れたものが共存しているケースが典型です。

古いインストーラーが残したシェルの別名設定が原因のこともあります。どこから実行されているかを確認し、不要なものを削除してください。

こうした環境差は、開発チーム全体で標準の導入方法を決めておけば防げます。業務効率化の観点はAIを活用した業務効率化の進め方とツール選定のポイントでも整理しています。

更新とアンインストール

導入後の管理も押さえておきます。自動更新の仕組み、手動での更新、削除の手順という3点です。方式によって更新の扱いが異なるため、自分がどの方法で入れたかを把握しておいてください。

自動更新とリリースチャンネル

ネイティブインストーラーで導入した場合、起動時と稼働中に更新が確認され、背後でダウンロードと適用が行われます。適用されるのは次回の起動時からです。

更新の系統は2つあり、新機能をすぐ受け取る設定と、概ね1週間ほど前の安定したバージョンを使う設定を選べます。安定性を重視する環境では後者を指定してください。

自動更新を止めたい場合は、設定ファイルで無効化できます。組織で配布するバージョンを固定したい場合に使われる設定です。

手動で更新する

背後での更新を待たずに反映したい場合は、更新用のコマンドを実行します。更新があれば新旧のバージョンが表示され、最新であればその旨が表示されます。

パッケージマネージャーで導入した場合は、それぞれのアップグレードコマンドを使います。Homebrewは配布の種類によってコマンドが変わるため、どちらを入れたかを確認してください。

なお、更新の通知が出ても、パッケージマネージャー側にまだ配信されていない場合があります。失敗したときは時間を置いて再度試してください。

アンインストールの手順

削除は、導入した方法に応じた手順で行います。ネイティブで入れた場合は実行ファイルとバージョン管理用のディレクトリを削除し、パッケージ管理で入れた場合はそれぞれの削除コマンドを使います。

設定やセッション履歴を完全に消す場合は、ユーザー領域の設定ディレクトリも削除します。ただしこの操作で、許可設定や連携の設定もすべて失われる点に注意してください。

エディタの拡張機能やデスクトップアプリが残っていると、設定ディレクトリは再作成されます。完全に削除したい場合は、それらも先に削除しておきます。全社展開の設計はAI導入を成功させる進め方と社内推進体制の作り方で解説しています。

無料相談のご案内 バージョン統制や権限設計を含む全社展開の設計、既存の開発フローへの組み込みについてもご相談を承っています。 ▶ 無料で相談する

企業で導入する場合の設計

個人利用と組織利用では、考えるべき点が変わります。バージョンの統制、バイナリの真正性、権限設計という3点を整理します。開発資産に触れるツールである以上、統制の設計は避けて通れません。

バージョンを統制する

組織で使う場合、全員が同じバージョンで動いている状態が望ましくなります。更新チャンネルの指定に加え、下限となるバージョンを設定して意図しない巻き戻りを防げます。

管理者向けの設定を使えば、利用者側やプロジェクト側の設定で上書きできない形で組織全体に適用できます。統制が求められる環境ではこちらを前提に設計してください。

起動そのものを特定のバージョン範囲に限定する設定も用意されています。検証済みのバージョンだけを使わせたい場合に有効です。

バイナリの真正性を確認する

配布物の正しさを検証する仕組みも提供されています。リリースごとに各プラットフォームのチェックサムをまとめたファイルが公開され、その署名を検証できます。

macOSではAnthropic名義の署名とAppleの公証、WindowsではAnthropic名義の署名が付与されています。Linuxのバイナリ単体には個別の署名がないため、署名済みのファイルで検証するか、パッケージ管理経由で導入します。

調達や情報セキュリティの観点で説明が必要な場合、こうした検証手段があること自体が説明材料になります。導入申請の際にまとめておくとよいでしょう。

権限とサンドボックスを設計する

ファイルの書き換えやコマンドの実行を伴うため、どこまで許可するかを先に決めます。読み取りのみから始め、安全性を確認できた作業だけ範囲を広げる進め方が無難です。

Windows環境では、サンドボックス機能を使うためにWSL 2が前提になります。隔離した実行が要件に含まれる場合は、この点を踏まえて環境を選択してください。

あわせて、扱ってよい情報の範囲も定めます。社内ルールの整備は生成AI利用時の情報漏えい対策と社内ルールの作り方にまとめています。

まとめ｜方式の選択と前提確認で導入はつまずかない

Claude Codeの導入は、対応OSと契約プランを確認したうえで方式を選べば、数分で完了します。無料プランでは利用できない点と、npmで入れる場合はNode.js 22以降が必要になる点は、特に見落とされやすい前提です。

方式の違いは主に更新の扱いに表れます。ネイティブインストーラーは自動で更新され、パッケージマネージャー経由は手動更新が前提です。個人か組織か、統制がどの程度必要かで選択してください。

そして組織で使う場合は、バージョンの統制、配布物の検証、権限の設計を導入と同時に整えます。手順そのものは短いため、時間をかけるべきなのは前提条件の確認と運用設計のほうです。

無料相談のご案内 AI開発ツールの選定から環境構築、社内ルールの整備、開発体制への定着までを一貫して支援しています。 まずは現状の課題をお聞かせください。 ▶ 無料相談フォームはこちら