MacでSalesforce CLIが動かない時の直し方（PATH／sf・sfdx）

結論

MacでSalesforce CLIが動かない時は、まず『CLIが入ってるか』『PATHが通ってるか』『sf/sfdxのどちらで動いてるか』を順に潰します。
これだけで、VSCodeとターミナルの挙動ズレを含めて、だいたい直ります。

症状

• インストールしたのに sfdx / sf が command not found になる
• VSCodeではコマンドが出るのに、ターミナルだと見つからない
• sf と sfdx のどっちを使うべきか分からない（環境で混ざる）

手順（確認→切り分け→対処）

1. まず「コマンドが存在するか」を確認する（ここで8割決まる）
   • which sf
   • which sfdx
   • sf --version
   • sfdx --version
2. which がパスを返すなら、CLI自体は見つかっている（次へ）
3. command not found なら、PATH未読み込みが濃厚（.zshrc を整える）
4. .zshrc の有無を確認して開く（なければ作る）
   • cd ~
   • ls -a
   • nano ~/.zshrc
5. PATHを追記して反映する（例：Homebrew系の定番）
   • export PATH="/opt/homebrew/bin:$PATH"
   • export PATH="/usr/local/bin:$PATH"
   • source ~/.zshrc
   • which sf
   • sf --version
6. sf と sfdx が混ざる場合は「どっちが生きてるか」を先に確定し、使う側に寄せる
   • 新しく書く手順や自分メモは sf 寄せ
   • 既存手順が sfdx 前提なら、当面は sfdx を動かす側に寄せる
7. 最小の動作確認として「認証できるか」まで確認する
   • sf org login web
   • sf org list

ハマりどころ

• VSCodeとターミナルの差は、だいたい「PATHの読み込み差」（.zshrc 未反映が多い）
• sf / sfdx は環境で混ざるので、最初に which で“生存確認”しないと迷う

補足

シェルがzshかだけ確認したい場合は echo $SHELL を見ると早いです（設定ファイルがズレてると直りません）。