Homebrewとは・使い方｜Macインストール手順とbrewコマンド一覧

brew install の裏で何が起きているかを先に図にします。formula（パッケージの定義）を読み、ビルド済みの bottle があれば展開し、Cellar に置いてから prefix へシンボリックリンクを張ります。

flowchart TD
    A[brew install wget] --> B[formula の定義を取得]
    B --> C{bottle<br>ビルド済みがある?}
    C -->|はい| D[展開する]
    C -->|いいえ| E[ソースからビルド]
    D --> F[Cellar/wget/版 に置く]
    E --> F
    F --> G[prefix/bin へリンク]

よく調べられることの答えを先にまとめます。

確認環境：この記事を書いた環境は Ubuntu 24.04 で、Homebrew は入っておらず（which brew は何も返さない）、本記事のために新しくインストールもしていません。Mac の操作もこの環境では行えません。そのため、手順・コマンド・出力例・エラー文はすべて Homebrew の公式ドキュメント（docs.brew.sh の Installation・FAQ・Manpage（brew(1)）・Homebrew on Linux・Common Issues・Troubleshooting・Taps・Brew Bundle and Brewfile・Formula Cookbook・Support Tiers・Versions・Tips and Tricks・Analytics。内容は同じ原文が置かれている Homebrew/brew リポジトリの docs/ で読み、各ページの last_review_date も確かめました）、brew.sh（日本語ページ）、Homebrew/install リポジトリの README とインストーラー本体 install.sh、Homebrew/brew のソースコード（brew doctor の警告文・エラー文）、Homebrew/homebrew-cask の README・USAGE・error_examples で1つずつ確かめ、公式に載っている出力例だけを載せています。自分で動かして作った出力はありません。版は GitHub の Releases で 7.0.11 を確認しました（確認日 2026年10月29日）。

Homebrewとは（何ができるか・仕組み）

この節では、Homebrew が何をするツールで、どこに何を置くのかが分かります。

Homebrew は、macOS・Linux・WSL で使うコマンドラインツールやアプリケーションをインストールする、オープンソースのパッケージ管理ツールです。 公式サイト brew.sh の日本語ページは「どこでも使えるパッケージマネージャー」と名乗り、prefix（Homebrew が入っている場所）の外にはファイルを置かない、と説明しています。各パッケージは Cellar の中の専用の keg に入り、そこから prefix へシンボリックリンクが張られます。

Homebrew は Mac 専用と思われがちですが、公式ドキュメント「Homebrew on Linux」は、Linux と WSL 2 でも使え、以前は Linuxbrew と呼ばれていた、と説明しています。macOS・Linux・Windows（WSL）を同じパッケージ管理ツールで扱える点が、Linux で使う理由として挙げられています。

apt・pip・npm との役割の違い

apt の update と upgrade の違いは、関連記事「aptコマンド一覧｜updateとupgradeの違い・apt-getとの違い」で扱っています。Homebrew の update と upgrade も同じ考え方です。

HomebrewをMacにインストールする手順

この節では、公式が案内しているインストールの手順と、途中で何を聞かれるのかが分かります。

インストールは、ターミナルに公式サイトの1行を貼り付けて実行するだけです。 brew.sh は、この1行を macOS のターミナル・Linux のシェル・WSL に貼り付けるよう案内しています。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

必要な環境（公式 Installation の macOS requirements）

• Apple シリコンの CPU。64bit Intel は Tier 3（サポート外の構成）。
• macOS Sequoia（15）以降。脚注によると、Apple シリコンでは macOS 15〜27 が「best and supported」、11（Big Sur）〜14（Sonoma）は「unsupported but may work」、10.15（Catalina）以前はまったく動かない。
• ソースからビルドするときは Command Line Tools（xcode-select --install）か Xcode。
• インストールに bash（/bin/bash）。

Apple シリコン向けには .pkg のインストーラーも GitHub の最新リリースにあり、こちらも /opt/homebrew に入ります（公式 Installation）。自動化で対話なしに入れるときは、先頭に NONINTERACTIVE=1 を付けます（Homebrew/install の README）。

インストールの最後には「Homebrew has enabled anonymous aggregate formulae and cask analytics.」と、匿名の利用統計が有効になったことが表示されます。公式ドキュメント Analytics によると、送るのを止めるには brew analytics off を実行します。

インストール先の違い（Appleシリコン・Intel・Linux）

この節では、環境ごとに Homebrew がどこに入るのかと、Intel Mac の2026年10月時点の扱いが分かります。

インストール先（prefix）は、Apple シリコンの Mac が /opt/homebrew、Intel Mac が /usr/local、Linux・WSL が /home/linuxbrew/.linuxbrew です。 brew.sh の日本語ページと、brew(1) の --prefix の説明がこの3つを挙げています。

公式 FAQ は、Apple シリコンで /opt/homebrew を選んだ理由を「/opt/homebrew（Apple シリコン）と /usr/local（Rosetta 2）のインストールを共存させ、どちらでも bottle を使えるようにするため」と説明しています。自分の環境の prefix は brew --prefix で分かります。

Intel Mac の扱い（2026年10月29日時点）

公式のインストーラー install.sh は、2026年10月29日時点の内容では、Intel Mac で実行すると次のメッセージで止まります（abort の出力で、先頭に「Error:」は付きません）。

Homebrew on macOS is only supported on Apple Silicon processors!

公式ドキュメント Support Tiers には、次のように書かれています。

• macOS Tahoe 26 が Intel で動く最後の macOS であり、Homebrew は Intel 向けの新しい bottle のビルドを止めた。
• 2027年9月以降に、Intel の Mac で Homebrew を動かす機能そのものを取り除く予定。
• 2026年9月時点で、Intel x86_64 の macOS 11〜26 は Tier 3（サポート外）、10.15 以前は Unsupported。

すでに Intel Mac に入っている Homebrew は、/usr/local のまま使い続けられますが、brew doctor が「You are using macOS on Intel x86_64.」で始まる警告を出し、Intel Tahoe では「Existing bottles may still work, but updated formulae may build from source.」（今ある bottle は使えるが、更新された formula はソースからビルドになる）と案内します（Homebrew/brew のソースコード）。それより前の macOS では MacPorts を勧める文言になります。

Linux・WSL に入れるとき

公式「Homebrew on Linux」によると、インストールの1行は Mac と同じで、先に次のビルドツールを入れておきます（Ubuntu・Debian の場合）。

sudo apt-get install build-essential procps curl file git

Tier 1（完全にサポート）の条件は、サポート期間内の Ubuntu、glibc 2.39 以上、既定の prefix、x86_64（SSSE3 対応）か ARM64 です。glibc が 2.13〜2.38 の配布版では Homebrew 自身の glibc が自動で入ります（Tier 2）。WSL 1 では問題が知られており、WSL 2 を勧めています。

PATHの設定：brew shellenvと.zprofile（command not found: brewの直し方）

この節では、インストール後に「zsh: command not found: brew」になる理由と、PATH の正しい通し方が分かります。

Apple シリコンの /opt/homebrew/bin は macOS の既定の PATH に入っていないため、インストール直後は brew が見つかりません。 インストーラーが最後に出す「Next steps:」が、そのための設定です。install.sh の原文では、zsh の Mac では次の3行になります（「ユーザー名」の部分には実際のホームの場所が入ります）。

==> Next steps:
- Run these commands in your terminal to add Homebrew to your PATH:
    echo >> /Users/ユーザー名/.zprofile
    echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> /Users/ユーザー名/.zprofile
    eval "$(/opt/homebrew/bin/brew shellenv zsh)"
- Run brew help to get started
- Further documentation:
    https://docs.brew.sh

1行目は空行を足すだけ、2行目が設定ファイルへの追記、3行目が今のターミナルへの反映です。書き込む先のファイルは、インストーラーがシェルと OS で次のように決めています。

brew shellenv は、PATH・MANPATH・INFOPATH と HOMEBREW_PREFIX・HOMEBREW_CELLAR・HOMEBREW_REPOSITORY の export 文を出力するコマンドです（brew(1)）。eval で囲んでその出力を実行することで PATH が通ります。brew(1) は、シェル名を引数で明示することを勧めており、すでに bin と sbin が PATH の先頭にあるときは何も出力しません。

command not found: brew の切り分け

1. 1本体があるか見るls /opt/homebrew/bin/brew（Intel は /usr/local/bin/brew、Linux は /home/linuxbrew/.linuxbrew/bin/brew）。無ければインストールが終わっていない
2. 2今のターミナルだけ通すeval "$(/opt/homebrew/bin/brew shellenv)" を実行して brew --version。動けば PATH の問題
3. 3設定ファイルに書くzsh の Mac なら ~/.zprofile。書いたらターミナルを開き直す
4. 4シェルを確かめるecho $SHELL。bash なら ~/.bash_profile（Mac）、Linux なら ~/.bashrc・~/.zshrc
5. 5brew doctor で確かめる「Homebrew's "bin" was not found in your PATH.」が出るなら、まだ通っていない

Mac のターミナルを開き直すのは、~/.zprofile がログイン時に読まれるファイルだからです。GUI アプリ（エディターなど）から Homebrew のコマンドが見えないときの対処として、公式 FAQ は sudo launchctl config user path "$(brew --prefix)/bin:${PATH}" を実行して再起動する方法を挙げています（すべてのユーザーに効く点に注意）。PATH の仕組み自体は、関連記事「Linux環境変数PATHの設定方法｜exportと.bashrcの使い分け早見表」と関連記事「command not foundの直し方｜PATHの確認方法と原因別の対処表」で扱っています。

brewコマンド早見表（install・uninstall・upgrade・update・list）

この節では、日常で使う brew のコマンドが一覧で分かります。

まず覚えるのは install・uninstall・update・upgrade・list・search・info・cleanup・doctor の9つです。 brew(1) の説明を基に、よく使う順に並べました。

brew installの使い方（Formula・Cask・バージョン指定）

この節では、brew install の書き方と、入れるものの種類による違いが分かります。

brew install 名前 で formula（コマンドラインのソフト）が入り、brew install --cask 名前 で cask（GUI アプリなど）が入ります。 brew(1) によると、brew install は、入っている formula の版が前のものなら upgrade し、終わったあとに自動で brew cleanup も行います（30日ごとに全体を対象）。

brew install wget            # formula
brew install git node        # 複数を一度に
brew install --cask firefox  # cask（GUI アプリ）
brew install python@3.12     # 版を指定した formula（versioned formula）
brew install --only-dependencies 名前   # 依存だけ入れる（Tips and Tricks）

Homebrew/homebrew-cask の USAGE に載っている、Firefox を入れたときの出力です。

$ brew install --cask firefox
==> Downloading https://raw.githubusercontent.com/Homebrew/homebrew-cask/ba243ff8f7984a43088e0a1721e872cdd9ae7df0/Casks/f/firefox.rb
######################################################################## 100.0%
==> Downloading https://download-installer.cdn.mozilla.net/pub/firefox/releases/128.0/mac/en-US/Firefox%20128.0.dmg
######################################################################## 100.0%
==> Installing Cask firefox
==> Moving App 'Firefox.app' to '/Applications/Firefox.app'
==> Linking Binary 'firefox.wrapper.sh' to '/opt/homebrew/bin/firefox'
🍺  firefox was successfully installed!

cask の定義を取り、配布元からアプリをダウンロードし、/Applications に移し、コマンドへのリンクを張る、という流れが読み取れます。アプリの置き場を変えるには --appdir=~/Applications、毎回使うなら環境変数 HOMEBREW_CASK_OPTS に書きます（USAGE）。

版を指定して入れる（@付きの formula）

homebrew/core には python@3.12 や postgresql@16 のように、版を名前に含む formula（versioned formula）があります（公式 Versions）。公式は、自分の都合で版を固定する目的に versioned formula を使うのではなく、まず homebrew/core にある versioned formula を使い、それが無ければ brew pin や brew version-install（前の版を自分の tap に取り出して入れるコマンド）を使うよう案内しています。

どの入れ方にするかの判断表

Python の版の切り替えは、関連記事「pyenvとは｜インストール・使い方・仕組みとエラーの直し方」、Node.js は関連記事「Node.js バージョン管理｜nvm・fnm・mise・Volta比較と実測」で扱っています。

brew updateとbrew upgradeの違い（outdated・pin）

この節では、update と upgrade の役割の違いと、更新したくないものの止め方が分かります。

brew update は「Homebrew 本体と formula・cask の定義を最新にする」、brew upgrade は「入れたソフトを新しい版にする」です。 公式 FAQ「How do I update my local packages?」は、この順番で案内しています。

brew update              # 定義を更新する
brew outdated            # 新しい版がある入れたものを一覧
brew upgrade             # 全部を新しい版にする
brew upgrade wget        # 1つだけ新しい版にする

brew upgrade wget と書いても、ほかのものまで一緒に上がることがあります。公式 FAQ は「formula の版の組み合わせを自由に混ぜることはサポートしておらず、依存するもの・されるものは全部最新に揃える必要がある。python や openssl のような重要なものが上がるときは特に多くが上がる」と説明しています。

更新したくないものは pin

特定の formula や cask を upgrade の対象から外すには brew pin 名前、戻すには brew unpin 名前 です。公式 Versions は、pin している間はセキュリティ更新も止まること、pin した formula を必要とする他の formula の install・upgrade が止まることがあること、pin した cask はアプリ自身の更新機能で勝手に上がることがあること、を欠点として挙げています。自動の update そのものを止めたいときは export HOMEBREW_NO_AUTO_UPDATE=1 を設定します。

自分で更新するアプリと --greedy

自分で更新する機能を持つアプリ（cask に auto_updates true が書かれたもの）は、brew outdated・brew upgrade で基本的に飛ばされます。公式 FAQ によると、入っているアプリの版と cask の版を比べて、入っているほうが前の版と分かるときだけ upgrade に含め、比べられないときは飛ばします。--greedy を付けると、こうした cask も含めて上げます。

brew list・search・info・depsで確かめる

この節では、入っているもの・探し方・詳細の見方が、公式に載っている出力で分かります。

何が入っているかは brew list、探すのは brew search、詳しく見るのは brew info です。 Homebrew/homebrew-cask の USAGE に載っている出力を引用します（brew info の Languages の行は省いています）。

$ brew search --cask firefox
==> Casks
firefox                      firefox@cn                   firefox@esr
firefox@beta                 firefox@developer-edition    firefox@nightly
Use `brew desc` to list packages with a short description.

$ brew list --cask
firefox       google-chrome     opera

$ brew list --cask firefox
==> App
/Applications/Firefox.app (112 files, 360MB)

$ brew info firefox
==> firefox: 128.0 (auto_updates)
https://www.mozilla.org/firefox/
Not installed
From: https://github.com/Homebrew/homebrew-cask/blob/HEAD/Casks/f/firefox.rb
==> Name
Mozilla Firefox
==> Description
Web browser
==> Artifacts
Firefox.app (App)
/opt/homebrew/Caskroom/firefox/128.0/firefox.wrapper.sh -> firefox (Binary)

brew info の「Not installed」は入っていないこと、「(auto_updates)」はアプリが自分で更新すること、「Artifacts」は何がどこに置かれるかを示しています。formula の brew info では、依存・入っている版・keg-only の理由と PATH の通し方（Caveats）が見られます。

名前を間違えると、Homebrew/brew のソースコードにある次の形のエラーになります（Did you mean の候補は似た名前があるときだけ）。

Error: No available formula or cask with the name "名前". Did you mean 候補?

brew uninstall・cleanup・autoremoveで片付ける

この節では、入れたものの消し方と、ディスクを空ける方法が分かります。

消すのは brew uninstall 名前、前の版やキャッシュを消すのは brew cleanup、依存としてだけ入って要らなくなったものを消すのは brew autoremove です。

brew uninstall wget               # formula を消す
brew uninstall --cask firefox     # cask を消す（/Applications のアプリも消える）
brew uninstall --zap --cask 名前  # 設定ファイルなど関連ファイルも消す
brew uninstall --force 名前       # 入っている全部の版を消す
brew cleanup -n                   # 何を消すか見るだけ
brew cleanup                      # 前の版と、120日より前のダウンロードを消す
brew cleanup --prune=all          # キャッシュを全部消す
brew autoremove --dry-run         # 要らなくなった依存を一覧

• brew(1) によると、--zap は「ほかのアプリと共有しているファイルを消すことがある」ため、何が消えるかを brew info --cask 名前 の zap の欄で見てから使います。
• brew cleanup が消すダウンロードを消す基準の日数の既定は120日で、HOMEBREW_CLEANUP_MAX_AGE_DAYS で変えられます。-s（--scrub）は最新版のダウンロードも消します。
• 公式 FAQ によると、brew upgrade は前の版を自動で消し、30日ごとに全体の cleanup も行います。前の版を残したいときは export HOMEBREW_NO_INSTALL_CLEANUP=1 を設定します。
• 消した formula を一時的に PATH から外すだけなら brew unlink 名前、戻すのは brew link 名前 です（Tips and Tricks）。

Formula・Cask・Tap・Bottleの違い（用語）

この節では、Homebrew のドキュメントに出てくる用語が、公式の定義で分かります。

formula は「ソースからビルドするパッケージの定義」、cask は「配布元がビルドして署名したバイナリを入れるパッケージの定義」、tap は「formula・cask・外部コマンドが入ったディレクトリ（多くは Git リポジトリ）」です。 brew(1) の TERMINOLOGY と Formula Cookbook の用語表を基にまとめます。

Formula Cookbook によると、Homebrew 4.0.0 以降、formula の定義は homebrew/core リポジトリを手元に clone するのではなく、formulae.brew.sh から JSON として取得されます。そのため brew tap を実行しても homebrew/core は一覧に出ないのが普通です。

bottle が使われない条件

公式 FAQ によると、bottle（ビルド済み）があれば既定でそれが使われますが、--build-from-source を付けたとき、使っている OS の版向けの bottle が無いとき、prefix が既定と違って bottle を置き換えられないとき、formula のオプションを付けたとき、はソースからビルドになります。インストールに時間がかかるのはこのときです。

brew tap で第三者のリポジトリを足す

公式 Taps によると、brew tap user/repo は https://github.com/user/homebrew-repo を clone します（GitHub 以外は URL を2つ目の引数に書く）。公式ドキュメント Taps に載っている一覧の出力です。

$ brew tap
petere/postgresql

公式は「tap の中のコードは自分のユーザー権限で動く」として、公式以外の tap を使う前に Tap Trust のドキュメントを読むよう求めています。tap を足しただけでは tap 全体を信頼したことにはならず、brew install user/repo/名前 のように完全な名前で入れると、その1つだけを信頼する形になります。同じ名前の formula が homebrew/core にもあるときも、完全な名前で区別します。外すのは brew untap user/repo です。

Brewfileとbrew bundle（環境をまるごと再現する）

この節では、入れたものを1つのファイルに書き出し、別の Mac や新しい Mac で同じ環境を作る方法が分かります。

brew bundle dump で今の環境を Brewfile に書き出し、brew bundle でその内容を入れます。 公式「Homebrew Bundle, brew bundle and Brewfile」は、実行する brew コマンドを並べるのではなく「到達したい状態を書く」宣言的な仕組みだと説明しています。

tap "apple/apple"
brew "git"
brew "postgresql@16", restart_service: true
cask "firefox"
cask "visual-studio-code"
mas "Refined GitHub", id: 1519867270
vscode "editorconfig.editorconfig"

formula・cask・tap のほかに、Mac App Store のアプリ（mas）、VS Code の拡張、Go・Cargo・npm・uv のパッケージ、Linux の Flatpak、WSL の WinGet まで書けます（brew(1)）。公式ドキュメントに載っている実行結果です。

$ brew bundle
Installing ruby
`brew bundle` complete! 1 Brewfile dependency now installed.

$ brew bundle check
The Brewfile's dependencies are satisfied.

$ brew bundle cleanup --global --force
Uninstalling gcc... (1,914 files, 459.8MB)
Uninstalled 1 formula

公式は、プロジェクトのリポジトリに package.json や requirements.txt と同じ感覚で Brewfile を置き、開発環境の依存を1コマンドで揃える使い方と、Mac の乗り換えで brew bundle dump → 新しい Mac で brew bundle install と復元する使い方を案内しています。Common Issues も、Homebrew を入れ直す前に brew bundle dump で記録を取り、Brewfile を prefix の外に置いておくよう書いています。

brew servicesで常駐サービスを動かす

この節では、PostgreSQL や MySQL のように常駐するソフトを Homebrew で起動・停止する方法が分かります。

brew services start 名前 で、そのサービスを今すぐ起動し、ログイン時にも起動するよう登録します。 brew(1) によると、Mac では launchctl、Linux では systemctl を使い、sudo を付けると /Library/LaunchDaemons（起動時）、付けないと ~/Library/LaunchAgents（ログイン時）に登録されます。

サービスに環境変数を渡すには ~/.homebrew/services/名前.env に KEY=value の形で書き、次の brew services restart から反映されます（brew(1)）。Brewfile では brew "postgresql@16", restart_service: true のように書くと、入れたあとにサービスの起動まで行えます。

brew doctorの警告とよくあるエラーの直し方

この節では、brew doctor が出す警告の意味と、インストール・Cask でよく出るエラーの原文と直し方が分かります。

困ったときの公式の手順は「brew update を2回 → brew doctor → 警告を全部読む → 直す → もう一度実行」です（公式 Troubleshooting）。 問題が無ければ、brew doctor は次の1行を返します（Homebrew/brew のソースコード）。

Your system is ready to brew.

brew(1) は、doctor の警告は「issue を出すときにメンテナーが調べる手がかり」であり、使っているものが問題なく動いているなら気にせず無視してよい、とも書いています。ソースコードで確かめた、よく出る警告です。

Command Line Tools の警告で、ソフトウェア・アップデートに更新が出ないときに brew doctor が案内する手順です（Homebrew/brew のソースコード）。

sudo rm -rf /Library/Developer/CommandLineTools
sudo xcode-select --install

インストール・Cask でよく出るエラー

macOS をアップグレードしたあと

公式 Common Issues によると、macOS のアップグレードで Command Line Tools や入れた formula が使うライブラリが無効になることがあります。手順は「macOS の更新を全部入れる → brew doctor が指摘したら Command Line Tools を入れ直す → brew update → brew upgrade」です。大きな版の更新のあとは、pkgconf などがソースから作り直されることがあります。無いライブラリへのシンボリックリンクを手で作るのは、不完全な更新を隠すため、やらないよう書かれています。

Homebrew 自体のアンインストール

Homebrew/install の README にある公式の uninstall スクリプトを実行します。Intel から Apple シリコンへ移って /usr/local の Homebrew を消すような、場所を指定して消すときは、スクリプトをダウンロードして --path を付けます。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

# 場所を指定して消す（Intel の /usr/local を消す例・README）
curl -fsSLO https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh
/bin/bash uninstall.sh --path /usr/local

Common Issues は、Migration Assistant や Apple シリコン上の x86_64 のターミナルで /usr/local と /opt/homebrew の両方が有効になることがあるとして、arch・command -v brew・brew --prefix で今どちらを使っているかを確かめ、消す前に arch -x86_64 /usr/local/bin/brew bundle dump --file=~/intel-Brewfile で前の環境を記録するよう案内しています。

• 1インストール後に brew --version が動く動かないなら「Next steps」の PATH 設定
• 2brew doctor が「Your system is ready to brew.」警告があれば原文を読んで表で引く
• 3brew --prefix が自分の環境の既定の場所Apple シリコンなら /opt/homebrew
• 4brew bundle dump で Brewfile を取っておく入れ直し・乗り換えのときの保険
• 5sudo brew を使っていない初回のインストール以外に sudo は要らない

Docker Desktop のように cask で入れることの多いアプリのインストールと有料の条件は、関連記事「Docker Desktopとは｜インストール・使い方・有料の条件とエラー対処」で扱っています。

よくある質問

Q. Homebrew とは何ですか？ A. macOS・Linux・WSL でコマンドラインツールやアプリをインストール・更新・削除するパッケージ管理ツールです。公式サイトは「どこでも使えるパッケージマネージャー」と説明しています。パッケージは prefix（Apple シリコンなら /opt/homebrew）の中だけに入り、初回のインストール以降は sudo を使いません。

Q. Mac に Homebrew をインストールするには？ A. ターミナルで brew.sh の1行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" を実行し、パスワードを入れて Enter で進め、最後に出る「Next steps」の3行を実行します。Apple シリコンと macOS 15 以降が条件です。

Q. Intel Mac にはもう入れられませんか？ A. 2026年10月29日時点の公式インストーラーは、Intel Mac では「Homebrew on macOS is only supported on Apple Silicon processors!」で止まります。すでに入っている /usr/local の Homebrew は Tier 3（サポート外）として動き、公式は2027年9月以降に Intel での動作を取り除く予定と書いています。

Q. インストールしたのに「command not found: brew」になります。 A. PATH が通っていません。eval "$(/opt/homebrew/bin/brew shellenv)" を実行して動くことを確かめ、同じ行を ~/.zprofile（zsh の Mac）に追記してターミナルを開き直します。

Q. .zprofile と .zshrc のどちらに書きますか？ A. 公式のインストーラーは、Mac の zsh では ~/.zprofile、Linux の zsh では ~/.zshrc に書きます。brew(1) も Mac では ~/.zprofile・~/.bash_profile、Linux では ~/.zshrc・~/.bashrc を例に挙げています。

Q. brew update と brew upgrade の違いは？ A. update は Homebrew 本体とパッケージの定義を最新にするだけで、入れたソフトは変わりません。upgrade は入れたソフトを新しい版にします。brew update → brew outdated → brew upgrade の順です。

Q. brew install と brew install --cask の違いは？ A. 付けないと formula（コマンドラインのソフト。ソースからビルドする定義で、多くは bottle というビルド済みが使われる）、--cask を付けると cask（配布元がビルドした GUI アプリ・フォントなど）が入ります。

Q. brew upgrade で頼んでいないものまで上がるのはなぜですか？ A. 公式 FAQ によると、Homebrew は formula の版の組み合わせを自由に混ぜることをサポートしておらず、依存するもの・されるものを全部最新に揃えるためです。特定のものだけ止めたいなら brew pin 名前 を使います。

Q. sudo brew install と書いてもよいですか？ A. 公式は使わないよう求めています。上流のビルドスクリプトにシステム全体の権限を与えないためで、初回のインストール以外に sudo は要りません。sudo で動かすとファイルの所有者が root になり、以後の brew が失敗する原因になります。

Q. brew doctor の警告は全部直すべきですか？ A. brew(1) は、警告は issue を出すときの手がかりであり、使っているものが問題なく動いているなら無視してよい、と書いています。何かが失敗しているときは、警告のうち関係するものを直してからやり直します。

Q. Homebrew をアンインストールするには？ A. Homebrew/install の README にある uninstall.sh を実行します。場所を指定して消すときは、スクリプトをダウンロードして /bin/bash uninstall.sh --path /usr/local のように --path を付けます。

Q. 新しい Mac に同じ環境を作るには？ A. 前の Mac で brew bundle dump を実行して Brewfile を作り、新しい Mac に Homebrew を入れてから、その Brewfile のある場所で brew bundle を実行します。formula・cask・tap・Mac App Store のアプリ・VS Code の拡張まで1つのファイルで書けます。

まとめ

• Homebrew は macOS・Linux・WSL のパッケージ管理ツールで、brew install 名前 で入れ、brew update → brew upgrade で更新する。初回以外に sudo は使わない。
• インストール先は Apple シリコンが /opt/homebrew、Intel が /usr/local、Linux が /home/linuxbrew/.linuxbrew。Apple シリコンと Linux は brew shellenv で PATH を通す必要があり、「command not found: brew」はこれが原因。
• 2026年10月29日時点の公式インストーラーは Intel Mac で止まり、Intel は Tier 3。2027年9月以降に Intel での動作が取り除かれる予定（公式 Support Tiers）。
• formula はソースからビルドする定義（多くは bottle で入る）、cask は配布元のビルド済み（GUI アプリ）、tap は第三者のリポジトリ。brew cleanup・brew autoremove で片付け、brew bundle dump の Brewfile で環境を再現する。
• 困ったら brew update を2回 → brew doctor → 警告を全部読む。以前の issue のコマンドをそのまま実行しない。

参考・出典

確認日はいずれも 2026年10月29日です。docs.brew.sh の各ページは、同じ原文が置かれている Homebrew/brew リポジトリの docs/ でも確かめました。

• Homebrew「The Missing Package Manager for macOS (or Linux)」（日本語ページ）：https://brew.sh/ja/
• Homebrew「Installation」：https://docs.brew.sh/Installation
• Homebrew「Homebrew on Linux」：https://docs.brew.sh/Homebrew-on-Linux
• Homebrew「FAQ」：https://docs.brew.sh/FAQ
• Homebrew「brew(1) – The Package Manager for Everywhere」（Manpage）：https://docs.brew.sh/Manpage
• Homebrew「Support Tiers」：https://docs.brew.sh/Support-Tiers
• Homebrew「Troubleshooting」：https://docs.brew.sh/Troubleshooting
• Homebrew「Common Issues」：https://docs.brew.sh/Common-Issues
• Homebrew「Taps (Third-Party Repositories)」：https://docs.brew.sh/Taps
• Homebrew「Homebrew Bundle, brew bundle and Brewfile」：https://docs.brew.sh/Brew-Bundle-and-Brewfile
• Homebrew「Formula Cookbook」（Homebrew terminology）：https://docs.brew.sh/Formula-Cookbook
• Homebrew「Formulae Versions」：https://docs.brew.sh/Versions
• Homebrew「Tips and Tricks」：https://docs.brew.sh/Tips-and-Tricks
• Homebrew「Anonymous Analytics」：https://docs.brew.sh/Analytics
• Homebrew/install「Homebrew (un)installer」README と install.sh：https://github.com/Homebrew/install
• Homebrew/brew のソースコード「Library/Homebrew/diagnostic.rb」「cmd/doctor.rb」「exceptions.rb」：https://github.com/Homebrew/brew
• Homebrew/homebrew-cask「README」「USAGE.md」「doc/reporting_bugs/error_examples.md」：https://github.com/Homebrew/homebrew-cask
• Homebrew/brew「Releases」（7.0.11）：https://github.com/Homebrew/brew/releases/latest

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。