Macで環境変数を設定する方法:確認、削除、永続化まで(zsh)
Maria Otworowska
最初にお断りしておくと、私たちはfideliusというMacアプリを開発しています。iCloudキーチェーンの上に作ったアプリで、独自の保管庫や同期の仕組みは持っていません。APIキーをシェルやプロジェクトのファイルに置かなくて済むようにするためのアプリです。記事の最後で紹介しますが、それまでの内容はfideliusがなくてもそのまま使えます。
今のターミナルだけで設定する
$ export EDITOR=nano$ echo "$EDITOR"
この変数はウィンドウを閉じるまで有効で、そのウィンドウから起動するコマンドすべてに渡ります。1つのコマンドにだけ渡したいときは、変数をコマンドの前に付けます。
$ EDITOR=nano git commit環境変数を確認する
$ printenv EDITOR$ env
printenv に変数名を付けると、その値だけが表示されます。env では設定済みの環境変数がすべて表示されます。何も出てこなければ、その変数は環境変数になっていません(export を付けずに設定した変数もここには出てきません)。
環境変数を削除する
$ unset EDITORunset で消えるのは今のウィンドウの値だけです。~/.zshrc に書いた場合は、その行も消してください。行が残っていると、次に開いたウィンドウでまた設定されてしまいます。
~/.zshrcに書いて永続化する
ファイルの末尾に行を追加してから、source ~/.zshrc で今のウィンドウに再読み込みします。
$ echo 'export EDITOR=nano' >> ~/.zshrc$ source ~/.zshrc
シングルクォートで囲んでおけば、行は書いたとおりに保存されます。$ が展開されるのは追記した時点ではなく、zshがファイルを読み込むときです。エディタで直接編集するなら nano ~/.zshrc を実行します。ファイルがなければ新規作成されます。
ドットで始まるファイルはFinderでは非表示になっていますが、Command + Shift + .(ピリオド)で表示できます。テキストエディットで編集するときは、先に「編集」>「自動置換」>「スマート引用符」をオフにしてください。オンのままだと引用符が “ ” に置き換わり、その行が正しく動きません。
どのファイルに書くか
| ファイル | 読むシェル | 向いている用途 |
|---|---|---|
| ~/.zshenv | スクリプトを含むすべてのzsh | ほとんど不要。書くなら最小限に |
| ~/.zprofile | ログインシェル(ターミナルが開くシェル) | Homebrewなどの PATH の設定 |
| ~/.zshrc | すべての対話シェル | ほとんどの環境変数、エイリアス、プロンプト |
zshは表の上から順にこれらのファイルを読み込みます。同じ変数を複数のファイルに書くと、最後に読まれる ~/.zshrc の値が有効になります。bashを使っているなら ~/.bash_profile に書きます。
PATHにフォルダを追加する
追加するフォルダを先頭に置き、その後ろに今の PATH をつなげます。
$ echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zprofile:$PATH を書き忘れると、フォルダの一覧がまるごと置き換わってしまいます。そうなると、ファイルを直すまで ls や git などのコマンドが見つからなくなります。
Dockから開いたアプリに反映されない理由
Dock、Finder、Spotlightから開いたアプリはシェルを経由しないので、~/.zshrc の設定は届きません。ターミナルでは使える変数がデスクトップアプリでは空になるのは、これが理由です。
launchctl setenv EDITOR nano を実行すると、それ以降に開いたアプリに変数が渡ります。効果が続くのはログアウトか再起動までです。ずっと使いたい場合は、ログイン項目やLaunchAgentからこのコマンドを実行させます。古い記事に出てくる ~/.MacOSX/environment.plist は、今のmacOSではもう読み込まれません。
APIキーは~/.zshrcに書かない
セットアップ手順では、APIキーを export OPENAI_API_KEY=... のように ~/.zshrc に書くよう案内されることがよくあります。動きはしますが、次のような問題があります。
- キーが平文のままホームフォルダのファイルに残ります。そのファイルがdotfilesのリポジトリやバックアップに紛れ込むこともよくあります。
- ターミナルから起動するすべてのコマンドに渡ります。AIコーディングエージェントや、エージェントが実行するコマンドも例外ではありません。エージェントが env を1回実行するだけで、値がそのまま会話に出てしまいます。
- すべてのキーがまとめて設定されるので、2つのプロジェクトで同じ変数名のまま別々のキーを使い分けることができません。
より安全なのは、キーをシェルのファイルに置かず、コマンドを起動するときに必要なキーだけを渡すやり方です。Macならキーチェーンがキーの置き場所になり、標準の security コマンドで操作できます。まずキーを1回だけ保存します。-w を最後に付けると値の入力を求められるので、キーがシェルの履歴に残りません。
$ security add-generic-password -a "$USER" -s openai-api-key -wあとは、コマンドを起動するときに、そのコマンドにだけキーを渡します。
$ OPENAI_API_KEY="$(security find-generic-password -s openai-api-key -w)" python app.pyfideliusでできること
fideliusは、APIキーをプロジェクトごとにキーチェーンに保存します。accio myapp npm run dev のように実行すると、そのプロジェクトのキーが環境変数として1つのコマンドにだけ渡り、ターミナルのほかの部分には渡りません。ワンクリックで、Claude Code、Codex、Gemini CLIに accio を使うよう指示を追加できます。エージェントはその指示に従う限り、キーの値ではなく変数名で作業します。