Macのzshの設定を整える手順と、bashから移るときに気をつける点

Macのターミナルを開くと、行の先頭に「%」の記号が出ている。これがzshというシェルで動いている合図です。Macのzshの設定を調べている人の多くは、Homebrewで入れたコマンドが見つからないと言われた、昔の記事に書かれた.bash_profileの設定が効かない、といった小さなつまずきをきっかけにしているはずです。

この記事では、Appleの公式サポートの説明をもとに、Macのzshの仕組みと、最初に整えておきたい設定を料理のレシピのように順番に紹介します。後半では、bashから移るときに動きが変わる点と、設定でつまずいたときの見直し方も整理します。覚えることはそれほど多くありません。とりあえず「設定ファイルは2つ」「書いたら読み込み直す」の2点だけ押さえておけば、あとは必要になったときに書き加えていけば大丈夫です。

Macのシェルがbashからzshに変わった経緯

シェルとは、ターミナルに打ち込んだ文字を読み取って、Macに命令として伝える係のことです。同じターミナルのアプリでも、裏で動くシェルが違うと、使える書き方や設定ファイルの名前が変わります。

Appleのサポートページには、次のように書かれています。

macOS 10.15以降では、Macのデフォルトのログインシェルおよびインタラクティブシェルとして、zshが使用されます。それ以前のバージョンのmacOSでも、zshをデフォルトにすることができます。 出典: support.apple.com

macOS 10.15はCatalinaという名前で2019年に公開されたバージョンです。それより前のmacOSではbashが標準でした。同じページには、zshはmacOS 10.15以降で新しく作られるすべてのユーザーアカウントの標準のシェルで、bashはmacOS 10.14以前の標準のシェルだったとも書かれています。

ここで注意したいのは、「新しく作られるアカウント」という条件です。古いMacから移行アシスタントでユーザーアカウントを引き継いだ場合や、10.14以前から同じアカウントを使い続けている場合は、今もbashのままになっていることがあります。ネットの記事どおりに設定したのに効かないというとき、そもそも自分のシェルがzshではなかった、という例は少なくありません。

なお、Macに今も入っているbashは、かなり古い版のままです。手元のMacで /bin/bash --version を実行すると、バージョン3.2.57と表示されました。一方のzshは5.9です。Linuxのサーバーで新しいbashに慣れている人ほど、Macのbashでは書いたはずの機能が動かないことに戸惑います。こうした事情もあり、Macでこれから設定を整えるなら、標準のzshに合わせておくほうが素直です。

Appleは、zshとbashの関係について「zshはBourneシェル（sh）との互換性が高く、bashとも若干の違いはあるものの、互換性があると言って差し支えありません」と説明しています。ふだん使う範囲のコマンドなら、ほとんどそのまま動きます。違いが出るのは、設定ファイルの名前と、一部の細かい書き方です。

今使っているシェルを確かめる

設定に手を付ける前に、まず今のシェルがzshかどうかを確かめます。ターミナルで次のコマンドを打ってください。

echo $SHELL

/bin/zsh と表示されれば、ログインしたときに使われるシェルはzshです。/bin/bash と出た場合はbashのままになっています。

もう1つの確かめ方として、行の先頭の記号を見る方法があります。標準の設定では、zshは「%」、bashは「$」が表示されます。ただし、記号は設定で変えられるので、確実なのはコマンドで確かめる方法です。

zshに切り替えたい場合は、Appleのサポートページに2つの方法が書かれています。1つはターミナルで chsh -s /bin/zsh と打つ方法です。もう1つは「システム設定」の「ユーザとグループ」から切り替える方法で、macOS 13以降では、ユーザーの一覧で自分の名前をcontrolキーを押しながらクリックし、「詳細オプション」を開いて「ログインシェル」を選びます。どちらの方法でも、切り替えた後に新しいターミナルのウインドウを開くと反映されます。

bashのまま使い続ける場合は、bashを起動するたびに「標準のシェルはzshになっている」という案内が表示されます。Appleのページには、この表示を消したいときは ~/.bash_profile か ~/.profile に export BASH_SILENCE_DEPRECATION_WARNING=1 を書き加えるよう案内されています。

zshの設定ファイルの役割

zshの設定は、ホームフォルダにある決まった名前のファイルに書きます。ファイル名の先頭に「.」が付いているので、Finderでは標準では表示されません。Finderで見たいときは、command、shift、ピリオドの3つのキーを同時に押すと、隠しファイルの表示と非表示を切り替えられます。

最初に覚えるのは次の2つだけで十分です。Appleのサポートページでは、bashの設定ファイルとの対応が次のように説明されています。

・.zprofile は .bash_profile に当たり、ログインしたとき（SSHでのログインも含む）に実行される
・.zshrc は .bashrc に当たり、新しいターミナルのセッションごとに実行される

ざっくり言えば、PATH（コマンドを探しに行く場所の一覧）のように「一度決めればよいもの」は .zprofile に、エイリアス（長いコマンドに付ける短い別名）やプロンプトの見た目、補完のように「ターミナルを開くたびに効いてほしいもの」は .zshrc に書く、という分け方です。Macのターミナルのアプリは、新しいウインドウを開くたびにログインの扱いで起動するため、実際には両方が読み込まれます。迷ったら、まず .zshrc に書いておけば困ることはほとんどありません。

ファイルがまだ無い場合は、自分で作ります。ターミナルで次のように打つと、空のファイルができてテキストエディットで開きます。

touch ~/.zshrc
open -e ~/.zshrc

すでに .profile に設定を書いていた人向けに、Appleのページでは、.zprofile に次の1行を加えると、zshでも .profile を自動で読み込めると案内されています。

[[ -e ~/.profile ]] && emulate sh -c 'source ~/.profile'

最初に整えておきたい設定のレシピ

ここからは、.zshrc に書いておくと便利な設定を、レシピのように紹介します。全部を一度に入れる必要はありません。困っているところから1つずつ試してください。書き換える前には、念のため cp ~/.zshrc ~/.zshrc.bak で控えを取っておくと、元に戻したいときに安心です。

レシピ1：Homebrewのコマンドが見つかるようにする

Homebrew（Macにコマンドを追加するための道具）の公式のインストールの説明によると、Apple siliconのMacでは /opt/homebrew に入ります。この場所はもともとのPATHに含まれていないため、インストールしただけでは brew やHomebrewで入れたコマンドが「command not found」と言われます。インストールの最後に案内される次の1行を、.zprofile に書き加えます。

eval "$(/opt/homebrew/bin/brew shellenv)"

これでHomebrewの場所がPATHに加わり、ターミナルを開き直せばコマンドが見つかるようになります。

レシピ2：自分用のコマンドの置き場をPATHに加える

自分で作ったスクリプトを ~/bin のようなフォルダに保存しているなら、そこもPATHに加えます。zshでは、PATHを配列として扱う path という書き方ができます。

typeset -U path
path=(~/bin $path)

1行目の typeset -U path は、同じ場所が重複して登録されないようにする指定です。設定ファイルを何度も読み込み直すと、PATHに同じ場所が何回も並んでしまうことがありますが、この1行で防げます。

レシピ3：よく使うコマンドに短い名前を付ける

エイリアスは、長いコマンドに短い名前を付ける機能です。書き方はbashと同じです。

alias ll='ls -lhG'
alias ..='cd ..'

動画編集の仕事では、書き出したファイルの容量を確かめたり、素材のフォルダを行き来したりする操作を何度も繰り返します。よく使う操作に短い名前を付けておくだけで、1日の打鍵の量がかなり減ります。

レシピ4：履歴を多めに残し、ウインドウ間で共有する

zshの標準の設定では、コマンドの履歴が思ったほど残りません。次のように書いておくと、過去に打ったコマンドを長く呼び出せるようになります。

HISTFILE=~/.zsh_history
HISTSIZE=10000
SAVEHIST=10000
setopt share_history
setopt hist_ignore_dups

share_history は、複数のウインドウで打ったコマンドの履歴を共有する設定、hist_ignore_dups は、直前と同じコマンドを続けて履歴に残さない設定です。control キーと R キーを押すと、履歴の中から文字を打って探せます。

レシピ5：Tabキーの補完を強くする

zshの大きな魅力は、Tabキーを押したときの補完です。次の2行を書いておくと、コマンドの引数やオプションまで候補が出るようになります。

autoload -Uz compinit
compinit

Appleのページにも、zshのコマンドライン補完について詳しく知りたいときは、ターミナルで man zsh を開くよう書かれています。

レシピ6：プロンプトを見やすくする

プロンプトとは、行の先頭に出る「ユーザー名やフォルダ名と%記号」の部分です。zshではbashとは違う記号で見た目を指定します。たとえば、今いるフォルダの名前だけを表示するなら次のように書きます。

PROMPT='%1~ %# '

%1~ は今いるフォルダの名前、%# は通常は%を表す指定です。Appleのページでは、zshは色の指定の書き方もbashより分かりやすく、複雑な制御用の記号を使わなくて済むと説明されています。

設定を書いたら読み込み直す

設定ファイルを保存しただけでは、開いているターミナルには反映されません。次のどちらかで読み込み直します。

source ~/.zshrc

または、ターミナルのウインドウを閉じて開き直します。設定が反映されないときの多くは、この読み込み直しを忘れているだけです。

Before/After：設定を整えると何が変わるか

ここで、実際に設定を整える前と後で何が変わったかを紹介します。動画編集の仕事を始めたばかりのころ、素材の変換にffmpegというコマンドを使っていました。Homebrewで入れたのに「command not found」と言われ、そのたびに長い場所をそのまま打って実行していたのです。

設定を整える前は、次のような状態でした。

・Homebrewで入れたコマンドを、毎回 /opt/homebrew/bin/ から打っていた
・書き出しのフォルダに移動するたびに、長いパスを打ち直していた
・昨日使った変換のコマンドを思い出せず、メモ帳から貼り付けていた

レシピ1、3、4を入れた後は、次のように変わりました。

・コマンドの名前だけで実行できるようになった
・よく使うフォルダへの移動がエイリアス1つで済むようになった
・control キーと R キーで、昨日の変換のコマンドをすぐに呼び出せるようになった

作業の中身は何も変わっていないのに、ターミナルを開くたびの小さなストレスが消えました。最初の1週間は「設定ファイルなんて触るのが怖い」と思っていましたが、控えを取ってから書き換えれば、失敗しても元に戻せます。完璧な設定を目指すより、困ったところから1行ずつ書き加えていくほうが続きます。

bashから移るときに気をつける点

ふだんのコマンドはzshでもそのまま動きますが、bashで書いたスクリプトや設定をそのまま持ち込むと、動きが変わる箇所があります。代表的なものを挙げます。

設定ファイルの名前が違う

一番多いつまずきです。.bash_profile や .bashrc に書いた設定は、zshでは読み込まれません。環境変数の設定のように、Appleのページで「変更を加えずに移せる」とされているものは、export MY_SETTING=1 のような書き方のまま .zprofile や .zshrc に写せば動きます。

プロンプトの書き方が違う

bashの PS1 に書いた \h や \W のような記号は、zshでは通じません。Appleのページには、bashのプロンプトの書き方をzshの書き方に置き換える例が載っています。zshでは %m（コンピュータの名前）や %1~（今いるフォルダ）のように、%で始まる記号を使います。

配列の番号が1から始まる

bashでは配列の最初の要素は0番ですが、zshでは標準で1番から数えます。bashのスクリプトで ${arr[0]} と書いていた箇所は、zshでは期待どおりに動きません。

変数の中身が空白で分かれない

bashでは、引用符で囲まずに変数を使うと、中身が空白の位置で分かれて複数の引数として扱われます。zshは標準ではこの分割をしません。空白を含むファイル名を扱うときにはzshのほうが安全ですが、bashの分割の動きを前提にしたスクリプトは、結果が変わることがあります。

一致するファイルが無いとエラーになる

*.mov のようなワイルドカード（ファイル名の一部を*などで表す書き方）に一致するファイルが1つも無いとき、bashは文字をそのまま渡しますが、zshは「no matches found」というエラーで止まります。フォルダが空のときに動かなくなる処理は、ここが原因のことが多いです。

一部の組み込みのコマンドが違う

bashの shopt はzshにはなく、zshでは setopt で設定を切り替えます。read -p のように、同じ名前でも意味が違うものもあります。

こうした違いがあるため、bash用に書かれたスクリプトは、無理にzshで動かす必要はありません。スクリプトの1行目に #!/bin/bash と書いておけば、ふだんのシェルがzshでも、そのスクリプトはbashで実行されます。毎日のターミナルの操作はzshで、昔からあるスクリプトはbashで、と分けて考えると、移行で慌てずに済みます。

移行の作業そのものは、次の順番で進めると取りこぼしがありません。まず、.bash_profile と .bashrc の中身を1行ずつ読み、環境変数、エイリアス、プロンプト、それ以外の処理に分けて書き出します。次に、環境変数とエイリアスをそのまま .zprofile と .zshrc に写します。プロンプトはzshの書き方に置き換え、それ以外の処理はzshで同じように動くかを1つずつ確かめます。最後に、新しいウインドウを開いて、ふだん使うコマンドが全部動くかを試します。古いbashの設定ファイルは、移行が終わってもしばらくは消さずに残しておくと、写し忘れに気づいたときに見返せます。

設定でつまずいたときの見直し方

設定を書き換えた後にうまく動かないときは、次の順で確かめてください。

まず、どのファイルに書いたかを確かめます。.bash_profile に書いていた、ファイル名の綴りが違っていた、という単純な原因がいちばん多いです。ls -a ~ でホームフォルダの隠しファイルを一覧にすると、確かめやすくなります。

次に、読み込み直したかを確かめます。source ~/.zshrc を打つか、新しいウインドウを開きます。

それでもおかしいときは、PATHの中身を見ます。echo $PATH を打つと、コマンドを探しに行く場所が「:」で区切られて表示されます。Homebrewの場所が含まれているか、同じ場所が何度も並んでいないかを確かめます。

ターミナルを開くたびに「insecure directories」という警告が出る場合は、補完の仕組みが、ほかのユーザーも書き込める場所にあるファイルを読もうとしているという意味です。compaudit を実行すると、どの場所が対象になっているかが表示されます。権限を変える操作はMacの設定に関わるため、表示された内容を確かめたうえで慎重に進めてください。

最後の手段として、取っておいた控えに戻します。cp ~/.zshrc.bak ~/.zshrc で書き換える前の状態に戻り、新しいウインドウを開けば元どおりです。書き換えるたびに控えを取る習慣さえあれば、設定ファイルは怖いものではありません。どうしても原因が分からないときは、設定ファイルの名前を一時的に変えて、何も設定していない状態のzshで動くかを確かめると、問題が設定の側にあるのかどうかを切り分けられます。

zshの起動が遅くなったと感じたとき

設定を書き加えていくと、ターミナルを開いてから文字を打てるようになるまでに、少し待たされるようになることがあります。原因の多くは、.zshrc の中で時間のかかる処理を毎回実行していることです。

よくあるのは、補完の仕組みを何度も読み込んでいる例です。ネットの記事を見ながら設定を書き加えていると、compinit の行が2か所、3か所と重複していることがあります。設定ファイルの中を検索して、同じ行が何度も出てこないかを確かめてください。

次に多いのが、いろいろな開発の道具の初期化の行を、使わなくなった後も残している例です。昔の案件で入れた道具のための数行が、毎回の起動で実行され続けています。使っていない道具の行は、行頭に # を付けて無効にし、起動の速さがどう変わるかを確かめてみてください。

どの行が遅いのかを確かめたいときは、ターミナルで time zsh -i -c exit と打つと、zshを起動して終了するまでにかかった時間が表示されます。行を1つずつ無効にしながらこの時間を比べれば、原因を絞り込めます。数秒も待たされるようなら、どこかに見直せる行があるはずです。

設定ファイルを複数のMacでそろえる

仕事用と私用、あるいはデスクトップとノートのように、複数のMacを使っている人は、zshの設定をそろえておくと迷いが減ります。どのMacでも同じエイリアスと同じプロンプトで作業できれば、手が覚えた操作がそのまま通じます。

いちばん簡単なのは、.zshrc と .zprofile を控えとして保存しておき、新しいMacにコピーする方法です。設定ファイルはただの文字のファイルなので、メールやクラウドのストレージで受け渡しても問題なく使えます。

ここで1つ気をつけたいのが、設定ファイルにパスワードやAPIキー（外部のサービスを使うための鍵の文字列）を直接書かないことです。AIの道具やクラウドのサービスを使っていると、鍵を環境変数として .zshrc に書く例をよく見かけます。そのままファイルを共有したり、インターネット上の公開の場所に保存したりすると、鍵が他人の目に触れてしまいます。鍵は別のファイルに分け、そのファイルだけは共有しない、という形にしておくと安全です。

Homebrewの場所のように、Macの種類によって違う設定もあります。古いMacと新しいMacで同じ設定ファイルを使う場合は、そのMacに実際にあるかどうかを確かめてから読み込む書き方にしておくと、片方でエラーが出る事態を避けられます。

仕事のMacでターミナルを使うときの注意

在宅で仕事を受けていると、取引先から預かったファイルや、取引先のサービスの管理画面に関わる操作をターミナルで行う場面も出てきます。そのときに気をつけたいのが、履歴に残る内容です。

レシピ4で履歴を多めに残す設定にすると、過去に打ったコマンドがすべて ~/.zsh_history というファイルに記録されます。便利な反面、コマンドの中にパスワードや鍵の文字列をそのまま書いて実行すると、それも履歴に残ります。画面を共有して打ち合わせをしているときに履歴を呼び出し、取引先の鍵が映ってしまう、という事故も起こりえます。

対策は、鍵やパスワードをコマンドに直接書かないことです。どうしても一時的に打つ必要があるときは、zshの設定で setopt hist_ignore_space を有効にしておくと、先頭に空白を入れて打ったコマンドは履歴に残らなくなります。もう1つの方法は、作業が終わった後に履歴のファイルを開き、該当の行を消すことです。

また、取引先との契約で、預かったデータを扱う端末や保存の方法が決められていることがあります。ターミナルでファイルをコピーしたり、外部のサービスに送ったりする前に、契約の条件に反していないかを確かめておくと安心です。道具の設定を整えることと同じくらい、預かったものを丁寧に扱う姿勢が、在宅の仕事では信頼につながります。

拡張の仕組みを入れる前に考えること

zshには、テーマやプラグインをまとめて入れられる拡張の仕組みがいくつも公開されています。見た目が一気に華やかになり、便利な機能もそろうので、最初に入れたくなる気持ちはよく分かります。

ただ、最初から大きな拡張の仕組みを入れると、どの設定が何をしているのかが分からないまま使うことになります。動きがおかしくなったときに、自分の設定が原因なのか、拡張の仕組みが原因なのかを切り分けられません。起動が遅くなる原因になることもあります。

おすすめの順番は、この記事のレシピで基本を整え、それでも足りないと感じた機能だけを後から加えることです。何を加えたのかを自分で説明できる状態にしておけば、Macを買い替えたときにも同じ環境をすぐに作り直せます。

ターミナルとファイル管理を行き来する手間

zshの設定が整うと、ターミナルで済ませられる作業がどんどん増えます。一方で、ファイルの中身を確かめるのはFinderやプレビュー、コマンドを打つのはターミナル、と2つのアプリを行き来する場面も増えていきます。Finderで開いているフォルダと同じ場所でコマンドを打ちたいのに、ターミナルで cd を打ってパスを打ち直す、という手間は、多くの人が日常的に感じているはずです。

最近は、AIのエージェント（ターミナルの中で自動で作業を進めるAIの道具）をターミナルで動かし、できたファイルをFinderで確かめる、という使い方も広がっています。エージェントが動いている間、どのウインドウで何が終わったのかを見張るのは意外に骨が折れます。

フォルダとターミナルを1つの画面で扱いたいときの候補

フォルダの管理とターミナルを1つの画面で扱いたい場合の候補の1つとして、Mac用のファイル管理アプリのAtriensがあります。

公式サイトの記載によると、サイドバーでフォルダを管理し、フォルダごとに1つのターミナルが結び付いている仕組みです。フォルダを切り替えるとターミナルも一緒に切り替わるため、cd を打つ必要がありません。ターミナルの状態（動いている、応答を待っている、終わった）がタブの色と印で分かり、作業が終わったときや確認を求められたときはmacOSの通知で知らせてくれます。外付けのディスクやほかの場所にあるフォルダを、ファイルを動かさずにサイドバーの1つの案件の下に並べられる点も特徴です。

料金は、Mac単体で使う機能（サイドバー、ターミナル、プレビュー、Gitなど）が無料で、期限もありません。有料にすると、iPhoneとiPadからMacのターミナルを見て操作できるようになります。有料の料金は税込で月額780円、年額6,800円、買い切り14,800円の3つから選べると案内されています。動作の条件はmacOS 14以降で、アカウントの登録は要りません。

zshの設定は、Atriensの中のターミナルでもそのまま使えます。ターミナルのアプリだけで困っていないなら、新しいアプリを入れる必要はありません。フォルダとターミナルの行き来が多いと感じたときに、無料の範囲で試してみるのが現実的です。

Atriensは、@SOHOを運営する株式会社ライフスケープが開発・提供しています。

ターミナルを使いこなす力と在宅の仕事

最後に、zshの設定を整える力が在宅の仕事でどう生きるかを整理します。ターミナルに慣れておくと、ファイルの一括の名前の変更や、大量の素材の変換、定期的なバックアップのような作業を、手作業ではなく仕組みで片付けられるようになります。動画編集や画像の制作のように扱うファイルが多い仕事では、この差が納期の余裕に直結します。

ターミナルやAIの道具を使った業務の効率化を、他の会社に向けて手伝う仕事も増えています。こうした仕事の内容はAIコンサル・業務活用支援のお仕事で紹介されています。シェルのスクリプトから一歩進んで、アプリやWebサービスを作る仕事に関心があるなら、アプリケーション開発のお仕事で求められる技術や準備を確認できます。開発の仕事の報酬の水準は、ソフトウェア作成者の年収・単価相場が目安になります。

AIを使ったマーケティングやセキュリティの分野でも、ターミナルでの作業に慣れている人は重宝されます。仕事の広がりはAI・マーケティング・セキュリティのお仕事にまとめられています。また、技術の手順を分かりやすく書ける人は、マニュアルや解説記事の執筆の仕事も受けられます。文章の仕事の報酬は著述家，記者，編集者の年収・単価相場で確かめられます。在宅で働く環境を整える費用については、国の制度を使える場合もあり、テレワーク 助成金 2026で対象や条件が整理されています。

フリーランス・在宅ワーク市場を20年見てきた運営者の視点から言えば、長く続く人ほど、自分の作業環境を少しずつ整えることに時間を使っています。ターミナルの設定はその代表です。1つひとつは数秒の短縮でも、毎日積み重なると、その分だけ納品の質や相手とのやり取りに時間を回せるようになります。中間の手数料が乗らない直接の取引であれば、依頼者は同じ予算でより多くを任せられ、受け手の手取りも厚くなります。道具を整える習慣は、こうした関係を長く続けるための土台にもなります。

よくある質問

Q. Macのシェルがzshかbashかはどうやって確かめますか？

ターミナルで echo $SHELL と打ち、/bin/zsh と表示されればzsh、/bin/bash と表示されればbashです。macOS 10.15以降で新しく作ったアカウントは標準でzshですが、古いMacからアカウントを引き継いだ場合はbashのままのことがあります。切り替えは chsh -s /bin/zsh か、システム設定のユーザとグループから行えます。

Q. .zprofileと.zshrcはどちらに設定を書けばよいですか？

Appleの説明では、.zprofileは.bash_profileに当たりログイン時に、.zshrcは.bashrcに当たり新しいターミナルのセッションごとに実行されます。PATHのように一度決めればよいものは.zprofile、エイリアスやプロンプト、補完の設定は.zshrcに書くのが一般的です。迷ったら.zshrcに書いても困ることはほとんどありません。

Q. bashで書いたスクリプトはzshでそのまま動きますか？

多くのコマンドはそのまま動きますが、配列の番号が1から始まる、変数の中身が空白で分かれない、一致するファイルが無いとエラーになるといった違いがあります。bash用のスクリプトは、1行目に #!/bin/bash と書いておけば、ふだんのシェルがzshでもbashで実行されます。無理に書き換える必要はありません。

Q. zshの設定を間違えてターミナルがおかしくなったらどうすればよいですか？

書き換える前に cp ~/.zshrc ~/.zshrc.bak のように控えを取っておけば、その控えを元の名前に戻すだけで元どおりになります。控えが無い場合は、.zshrcの中で最近書き加えた行を行頭に # を付けて無効にし、新しいウインドウを開いて確かめると、原因の行を絞り込めます。