Claude Codeのインストール手順|Macで止まりやすい3か所と直し方

Claude Codeのインストールは、コマンドを1行貼るだけで終わるはずの作業です。 それでも「claude code インストール」で検索する人が多いのは、貼ったあとに command not found が出る、ログイン画面で止まる、どの入れ方を選べばよいか分からない、のどれかで手が止まっているからです。 この記事では、Macに入れる方法の違い、止まりやすい場所と直し方、入れたあとにどのフォルダで起動するかまでを、公式ドキュメントの記述を根拠に順に整理します。

Claude Codeを入れる前に確かめておくこと

最初に確かめるのは、Macの側の条件と、アカウントの側の条件の2つです。 ここを飛ばすと、インストールそのものは成功しても、起動した直後に先へ進めなくなります。

公式のセットアップページによると、Claude Codeが動くのは macOS 13.0 以上で、メモリは4GB以上、プロセッサはx64かARM64です。 Apple シリコンのMacでも、Intel のMacでも動きます。 macOSのバージョンは、アップルメニューの「このMacについて」で確かめられます。 13.0より古いと、起動時に dyld: cannot loadbuilt for Mac OS X 13.0 といったエラーが出ると公式のターミナルガイドに書かれています。

もう1つがアカウントです。 Claude Codeを使うには、Pro、Max、Team、Enterprise のいずれかのプラン、または開発者向けの Console アカウントが要ります。 公式ドキュメントには、無料の claude.ai プランには Claude Code へのアクセスが含まれていない、と明記されています。 Anthropic の料金ページでは、個人向けの Pro は米ドル表示で月払い20ドル、年払いなら月あたり 17ドル と案内されています(税別、2026年9月時点)。 インストール自体は無料でできますが、ログインの段階で有料プランが要る、という順番を先に知っておくと、途中で迷わずに済みます。

ほかに要るのはインターネット接続と、シェル(Macの既定は Zsh)だけです。 Node.js は、後で触れる npm で入れる場合を除いて要りません。 初心者向けの解説記事で「まず Node.js を入れる」と書かれているものがありますが、これは npm での入れ方が主流だった時期の手順です。

Macに入れる方法は3つある。違いは更新のされ方

Macで Claude Code を入れる方法は、公式に3つ用意されています。 どれを選んでも動く本体は同じで、違うのは「更新がどう届くか」です。

方法 コマンド 更新
ネイティブ(推奨) curl -fsSL https://claude.ai/install.sh | bash バックグラウンドで自動
Homebrew brew install --cask claude-code 手動(brew upgrade)
npm npm install -g @anthropic-ai/claude-code 手動(npm install で上書き)

公式が推奨しているのはネイティブのインストールです。 ターミナルに1行貼って Enter を押すと、インストーラーが取得されて実行され、終わると「Claude Code successfully installed!」と表示されます。 この方法で入れたものは、起動時と実行中に更新を確かめ、裏で新しい版を入れておいてくれます。

Homebrew で入れる場合は、入れ方と同じくらい、更新の手間を知っておくことが大事です。 この点は、利用者の側の解説にも短くまとまっています。

Tips: ネイティブインストール(curl)は自動更新されますが、Homebrewはbrew upgrade claude-codeによる手動更新が必要です。 出典: qiita.com

公式ドキュメントも同じ内容で、さらに Homebrew には2つの配布の系統があると説明しています。 claude-code は安定版で、新しい版より約1週間遅れて届き、大きな不具合を含む版は飛ばします。 claude-code@latest は最新版で、出たその日に届きます。 Homebrew は古い版をディスクに残すので、ときどき brew cleanup を打つよう勧められています。

npm での入れ方は今も使えますが、v2.1.198 以降は Node.js 22以上が必要です。 公式は sudo npm install -g を使わないよう注意しています。 権限の問題と安全上の危険につながるためです。 すでに Node.js を仕事で使っていて、パッケージを npm でそろえたい人向けの方法と考えると選びやすくなります。

選び方の目安は単純です。 特にこだわりがなければネイティブ、Mac の道具をすべて Homebrew で管理している人は Homebrew、という分け方で困ることはまずありません。

インストールの手順を1つずつ

ここからは、ネイティブの方法で入れる手順を、ターミナルを開くところから書きます。 ターミナルを普段使わない人でも、この順に進めれば入れ終わります。

ステップ1:ターミナルを開く

Cmd + Space で Spotlight を開き、「Terminal」と打って Enter を押します。 カーソルが点滅する窓が出たら、そこがコマンドを打つ場所です。 アプリケーションフォルダの中の「ユーティリティ」から開いても同じです。

ステップ2:インストールのコマンドを貼る

次の1行をコピーし、Cmd + V で貼って Enter を押します。

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

文字が流れ、最後に完了の表示が出れば入っています。 このとき、最後のほうに Setup notes という欄が出ることがあります。 PATH の設定が足りないときの直し方がそこに書かれるので、読まずに窓を閉じないようにします。

ステップ3:入ったことを確かめる

新しいターミナルの窓を開き、次を打ちます。

claude --version

2.1.211 (Claude Code) のような番号が返れば成功です。 もう一段深く確かめたいときは claude doctor を打つと、セッションを始めずに、インストールの状態や設定ファイルの誤りを読み取り専用で一覧にしてくれます。

ステップ4:作業するフォルダで起動し、ログインする

作業したいフォルダに移ってから claude と打ちます。 初回はブラウザが開き、Claude のアカウントでのサインインを求められます。 画面の指示に従って許可すると、ターミナルに戻って会話を始められる状態になります。 終えるときは exit と打つか、空の入力欄で Ctrl + D を2回押します。

止まりやすい場所と、その直し方

インストールで手が止まる場所は、だいたい決まっています。 公式のトラブルシューティングに載っているもののうち、Macで起きやすい3つを取り上げます。

command not found: claude と出る

いちばん多いのがこれです。 インストールは終わっているのに、インストーラーが claude を置いたフォルダ(~/.local/bin)が、シェルの探す場所(PATH)に入っていない状態です。 Mac の既定のシェルである Zsh なら、公式の案内どおり次の2行で直ります。

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

そのあと新しい窓を開いて claude を打ち直します。 それでも見つからないときは、~/.local/bin/claude というファイルがあるかを確かめます。 無ければインストールが途中で止まっているので、コマンドを貼り直します。

HTML のようなものが表示される、syntax error が出る

syntax error near unexpected token '<' や、<!DOCTYPE html> のような文字が出る場合は、インストール用の URL がスクリプトではなく Web ページを返しています。 ページに「App unavailable in region」とあれば、その国では提供されていません。 そうでなければ、時間をおいてもう一度試し、続くようなら Homebrew での入れ方(brew install --cask claude-code)に切り替えるよう公式が案内しています。

2つの入れ方が混ざっている

過去に npm で入れたあと、ネイティブでも入れた、というように複数の入れ方が同居していると、古い版が起動したり、更新が効かなかったりします。 公式は、アンインストールしたのに claude が動く場合は2つ目のインストールか古いエイリアスが残っている、と説明しています。 claude doctor の出力に、どこから起動しているかが出るので、使っていないほうを消します。 消し方は入れ方ごとに違い、Homebrew なら brew uninstall --cask claude-code、npm なら npm uninstall -g @anthropic-ai/claude-code です。

ターミナルを使いたくない人向けの入れ方

ここまで読んで、ターミナルそのものに抵抗がある人もいるはずです。 その場合は、デスクトップアプリから Claude Code を使う方法があります。

公式のデスクトップアプリには Claude Code が含まれていて、Node.js も CLI も別に入れる必要はありません。 Mac 向けは Intel と Apple シリコンの両方で動くユニバーサル版です。 アプリの上部にある「Code」タブを開き、「Select folder」で作業するフォルダを選べば、ターミナルを開かずにファイルを読ませたり直させたりできます。

ただし、デスクトップアプリで使えない機能もあります。 公式の比較表では、スクリプトから呼び出す --print のような非対話の使い方は、デスクトップでは利用できないとされています。 また、ターミナルから claude と打って使いたいなら、アプリとは別に CLI を入れる必要があります。 最初はアプリで慣れ、決まった作業を繰り返したくなった段階で CLI を足す、という順番でも遅くはありません。 両者は同じ設定ファイルと CLAUDE.md を読むので、途中で移っても積み上げたものは無駄になりません。

インストールが終わったあとに決めること

インストールと同じくらい、入れたあとの最初の数日で差が出るのが「どのフォルダで起動するか」です。

Claude Code は、起動したフォルダを作業の範囲として扱います。 ホームフォルダで起動すると、読ませたい資料がどこにあるかを毎回説明することになり、案件のフォルダで起動すると、その中のファイルをすぐに読んでくれます。 公式のクイックスタートでも、まずよく知っている小さなプロジェクトから始めるよう勧めています。

ここで多くの人が、ファイルを探す窓(Finder)とコマンドを打つ窓(ターミナル)を行き来する手間に気づきます。 Finder でフォルダを開き、場所をコピーし、ターミナルで cd を打つ。 この往復が1日に何十回も起きると、インストールでは見えなかった手間が目立ってきます。

手当ては2つあります。 1つは、よく使う案件のフォルダを決め、そこで起動する習慣を先に作ることです。 もう1つは、フォルダとターミナルが1つの窓に入っているファイル管理アプリを使うことです。 フォルダを選ぶとその場所のターミナルが隣に開く道具なら、cd を打つ手順そのものがなくなります。 どんな作業がまとまるかは、できることのページに、サイドバー・ターミナル・プレビューの組み合わせとして一覧になっています。

作業の置き場所を整えるという考え方

最後に、インストールの先にある使い方の話を、公開している情報を材料に整理します。

Claude Code の作業は、指示してから終わるまで数分から数十分かかることがあります。 その間、ターミナルの前に座っている必要はありません。 公式にも、手元の Mac で動いているセッションにスマートフォンやブラウザからつなぐ仕組みが用意されています。 つまり、インストールした時点で、作業は「机の前だけのもの」ではなくなっています。

そうなると大事になるのは、どのフォルダで何が動いているかが一目で分かることです。 フォルダごとにターミナルを持ち、動いている・返事を待っている・終わった、を見分けられる道具は、この点で役に立ちます。 出先の iPhone や iPad から Mac の作業を見る方法については、iPhone・iPadから続きをで、つながり方と暗号化の扱いが説明されています。

道具を選ぶときは、手元のファイルをどこかへ預けずに済むか、毎月の費用が使うほど増えないか、の2点を確かめると失敗が減ります。 ファイル管理の道具ごとの違いは他のファイル管理との比較に、費用の考え方は料金にまとまっています。 Mac の中だけで使う範囲は無料と案内されているので、インストールを終えたこの段階で、フォルダの置き方と一緒に試してみる余地があります。 購入前によく聞かれる点はよくある質問で確かめられます。

インストールで止まる場所は、PATH、配布元の応答、入れ方の重複の3つにほぼ集約されます。 それを越えたら、次に決めるのは「どのフォルダで起動するか」です。 ここを先に決めておくと、入れたばかりの道具が、毎日の作業の中で使える道具に変わります。

よくある質問

Claude Codeは無料プランのままでもインストールできますか?

インストール自体は無料のアカウントでも可能で、コマンドを貼れば Mac に入ります。ただし公式ドキュメントでは、無料の claude.ai プランには Claude Code へのアクセスが含まれないとされています。実際に使うには Pro、Max、Team、Enterprise のいずれかか、開発者向けの Console アカウントでのログインが必要です。

ネイティブとHomebrewとnpm、どれで入れるのがよいですか?

特にこだわりがなければ、公式が推奨するネイティブのインストールが扱いやすい方法です。自動で更新されるため、入れたあとの手間がほとんどありません。Mac の道具をすべて Homebrew で管理している場合は Homebrew も選べますが、更新は brew upgrade で手動になります。npm は Node.js 22以上が必要です。

インストールしたのにcommand not foundと表示されるのはなぜですか?

claude が置かれた ~/.local/bin が、シェルの探す場所である PATH に入っていないためです。Zsh なら ~/.zshrc に PATH を足す1行を書き、source で読み込み直してから新しい窓で試すと直ります。インストールの最後に表示される Setup notes に、同じ直し方が出ていることもあります。

Claude Codeをアンインストールするにはどうすればよいですか?

入れ方ごとに消し方が違います。Homebrew なら brew uninstall --cask claude-code、npm なら npm uninstall -g @anthropic-ai/claude-code を打ちます。ネイティブで入れた場合は、本体と版の置き場所を削除する手順が公式ドキュメントに載っています。消したあとも claude が動くなら、別の入れ方が残っていないか確かめてください。

記事一覧へ戻る