AIエージェントMac環境構築
初心者向け完全セットアップ手順

この記事で分かること

「AIエージェント Mac 環境構築」で検索している人が知りたいことは、たぶんショートカットだけではありません。

何をどの順番で入れればいいのか。Homebrewとは何なのか。Node.jsやGitはなぜ必要なのか。プログラミング未経験でも進められるのか。エラーが出たらどうするのか。環境ができたら、仕事の何に使えるのか。

この記事では、その全部を扱います。

AIエージェントのMac環境構築とは？

AIエージェントのMac環境構築とは、Claude CodeやCodexのようなAIエージェントをMacで快適に動かすために、Homebrew、ターミナル、Node.js、Git、エディタといった土台ツールをまとめて整えることです。

AIエージェントは、チャット画面の中だけで動くAIではありません。Macの中のファイルを読み、コードや文章を書き換え、コマンドを実行して作業を進めます。

AIエージェントが料理人だとすると、環境構築はキッチンの準備です。コンロ（ターミナル）、食材の仕入れルート（Homebrew）、調理器具（Node.jsやGit）、盛り付けを確認する場所（エディタ）。ここが揃っていないと、腕のいい料理人が来ても何も作れません。

もう1つ大事なのが、人間側の操作速度です。

どのタブに資料があるか分からない。エラー文を探せない。ファイルの場所が分からない。ここが遅いと、AIが速くても全体は詰まります。

この記事では、土台ツールの導入と、Macを速く操作するコツの両方を扱います。

環境構築の全体像と準備するもの

入れるものと順番は、これで固定です。上から順に入れてください。

準備するものはシンプルです。Mac（Apple SiliconでもIntelでもOK）、Macのログインパスワード、安定したネット回線。時間はまとめて40分ほどで、分割してもOKです。

実測：筆者がM2 MacBook Airでこの記事の手順を通しでやり直したところ、Homebrewの導入が約7分（Command Line Toolsのダウンロード込み）、全体で約40分でした。回線速度によって前後します。

最初に送るプロンプト

環境構築は、1人で進めなくて大丈夫です。ChatGPTやClaudeに次のプロンプトを貼ると、伴走役になってくれます。

MacでAIエージェント（Claude CodeやCodex）を使うための環境構築を進めたいです。

目的:
- Claude CodeやCodexをMacで動かせる状態にする
- Homebrew、Node.js、Git、エディタ（VS Code）を正しい順番で入れる

前提:
- 使っているMac:（例: M2 MacBook Air）
- プログラミング経験: ほぼなし
- ターミナルは開いたことがある程度

お願い:
1. 手順を1ステップずつ出してください。一度に全部出さないでください
2. 各ステップの後に、成功しているか確認するコマンドを出してください
3. エラーが出たらエラー文を貼るので、原因と対処を初心者向けに教えてください
4. パスワードや秘密のキーの入力が必要な場面では、チャットに貼らないよう注意してください
5. rm -rf のような削除系の危険なコマンドは提案しないでください

この記事を読みながら進めて、詰まった所だけAIに聞く使い方でもOKです。

Mac環境構築ステップ1：ターミナルの基本操作

ターミナルは、Macに文字で指示を出す黒い画面のアプリです。AIエージェントはこの画面の中で動くので、最低限の操作だけ先に覚えます。

開き方は、Command + Space でSpotlightを開き、「ターミナル」と入力してEnter。これだけです。

最初に覚えるコマンドは7つです。

pwd
ls
cd ~/Desktop
cd ..
mkdir my-project
touch memo.md
open .

• pwd: 今いる場所を表示する
• ls: 今いる場所の中身を表示する
• cd: フォルダを移動する
• cd ..: 1つ上のフォルダに戻る
• mkdir: フォルダを作る
• touch: 空のファイルを作る
• open .: 今いるフォルダをFinderで開く

全部を暗記しなくて大丈夫です。pwd（今どこ？）、ls（何がある？）、cd（移動）の3つが体に入れば、AIエージェント作業は始められます。

AIに任せる前に、自分がどのフォルダにいるかを pwd で確認する。この癖だけは最初につけてください。

Mac環境構築ステップ2：Homebrewを導入する

Homebrewは、Macにアプリや開発用ツールを入れるための管理ツールです。環境構築の土台はここです。

この後に入れるNode.js、Git、VS Code、iTerm2は、全部Homebrew経由で1行のコマンドで入れられます。「Macのツール用App Store」くらいのイメージでOKです。

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

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

brew --version

Mac環境構築ステップ3：Node.jsとnpmを導入する

Node.jsは、JavaScriptというプログラム言語をMac上で動かすための土台ソフトです。npmは、Node.js用のツールを追加するための管理コマンドで、Node.jsと一緒に入ります。

なぜ必要かというと、Claude CodeもCodexも、npm経由でインストールする方法が公式に用意されているからです。AIエージェント本体の受け皿だと思ってください。

Homebrewが入っていれば、1行です。

brew install node

終わったら確認します。

node -v
npm -v

v22.x.x のようなバージョンが2つとも表示されればOKです。数字は時期によって変わるので、表示されること自体が確認ポイントです。

Mac環境構築ステップ4：Gitを初期設定する

Gitは、ファイルの変更履歴を記録するツールです。AIエージェントを使うなら、実はこれが一番大事な保険になります。

AIエージェントはファイルを書き換えます。Gitで履歴を残しておけば、AIが変な変更をしても元に戻せます。逆に、Gitなしで書き換えを任せるのは、セーブなしでゲームを進めるのと同じです。

MacにはGitが最初から入っていることも多いですが、Homebrewで新しめのものを入れておくと管理がラクです。

brew install git

次に、名前とメールアドレスを登録します。変更履歴に「誰が変更したか」を記録するための設定です。

git config --global user.name "自分の名前"
git config --global user.email "自分のメールアドレス"

確認します。

git config --global --list

user.nameとuser.emailが表示されればOKです。

GitHub（コードをインターネット上に保存するサービス）との連携は、慣れてからで大丈夫です。まずはローカルで履歴が残る状態を作ることが目的です。

Mac環境構築ステップ5：エディタ（VS Code）を入れる

エディタは、コードや文章のファイルを見やすく編集するアプリです。AIエージェントが書き換えたファイルを、人間の目で確認する場所になります。

定番はVS Code（Visual Studio Code）です。無料で、ファイルの中身確認、微修正、変更差分の確認まで全部できます。

brew install --cask visual-studio-code

インストール後は、Command + Space で「Visual Studio Code」と検索して起動できます。

ターミナルから code . と打つだけで今のフォルダを開けるようにしておくと便利です。VS Codeを起動して Command + Shift + P を押し、「shell command」と入力して「Install 'code' command in PATH」を選んでください。

最初は「AIの変更をここで見る」だけの使い方で十分です。拡張機能やテーマの調整は後回しでOKです。

Mac環境構築ステップ6：Claude CodeとCodexを入れる

土台ができたので、AIエージェント本体を入れます。

Claude CodeはAnthropicのAIエージェント、CodexはOpenAIのAIエージェントです。最初はどちらか1つで大丈夫です。Claudeに課金しているならClaude Code、ChatGPTに課金しているならCodexから始めると、追加契約なしで試しやすいです。

Claude Codeは、Homebrewで入れられます。

brew install --cask claude-code

Codexは、npmで入れられます。

npm install -g @openai/codex

インストールできたら、作業フォルダへ移動して起動します。

cd ~/Desktop/my-project
claude

Codexならこうです。

cd ~/Desktop/my-project
codex

ログインの流れ、料金プランの選び方、初回テスト、細かいエラー対処は、それぞれの専用記事にまとめています。ここから先はそちらを見ながら進めてください。

あわせて読むClaude Codeインストール完全ガイド｜初心者向けClaude Codeのインストールからログイン、料金、エラー対処まで確認できます。

あわせて読むCodex CLIインストール完全ガイド｜初心者向け手順ChatGPT課金ユーザーがCodexを使い始める手順とエラー対処を確認できます。

Mac環境構築ステップ7：作業フォルダを整理する

環境が整ったら、AIエージェントに任せる作業フォルダを決めます。ここを整理しておくと、AIの精度も安全性も上がります。

おすすめは、デスクトップかホームフォルダ直下に親フォルダを1つ作り、その下にプロジェクトごとのフォルダを置く形です。

mkdir -p ~/Desktop/ai-work/blog
mkdir -p ~/Desktop/ai-work/sns
mkdir -p ~/Desktop/ai-work/lp

ルールは3つです。

• AIに触らせるフォルダと、触らせないフォルダを分ける
• 1プロジェクト1フォルダにする。デスクトップ直下にファイルをばらまかない
• 秘密のキーが入ったファイル（.envなど）は置き場所を決めて、GitHubに上げない

AIエージェントは、起動したフォルダの中を読んで作業します。関係ないファイルだらけの場所で起動すると、余計なものまで読んでしまいます。フォルダ整理は、AIへの指示の一部です。

秘密のキーを安全に管理したい人は、1Passwordを使う方法を別記事にまとめています。

あわせて読む1Password CLI設定｜Mac/WSL完全手順秘密のキーをファイル直書きせず、安全にAI開発で使う方法を確認できます。

iTerm2でターミナルを使いやすくする

ここからは仕上げです。Mac標準のターミナルでも作業はできますが、AIエージェントを毎日使うならiTerm2を入れておくと快適です。

iTerm2は、Mac向けの高機能なターミナルアプリです。画面分割（複数ペイン）、検索、配色調整、プロファイル設定など、長時間のAI作業に向いています。

これもHomebrewで1行です。

brew install --cask iterm2

使い方は標準ターミナルと同じです。おすすめは Command + D の画面分割で、左でClaude CodeやCodexを動かし、右で確認コマンドを打つ使い方ができます。

最初は難しい設定をしなくて大丈夫です。慣れてきたら、文字サイズ、配色、起動時のフォルダを調整してください。

外出先からスマホでAIエージェントを操作したい人は、tmuxと組み合わせる方法を別記事にまとめています。

あわせて読むClaudeCodeをスマホ操作｜Moshiとtmux入門手順スマホからMac上のAIエージェントを操作する環境を確認できます。

最初に覚えるMacショートカット

土台が入ったら、人間側の操作も速くします。全部覚える必要はありません。毎日使うものから体に入れます。

Command + Space      Spotlight検索
Command + Tab        アプリ切り替え
Command + `          同じアプリ内のウィンドウ切り替え
Command + C          コピー
Command + V          貼り付け
Command + X          切り取り
Command + A          全選択
Command + Z          戻す
Command + Shift + Z  やり直し
Command + F          ページや文書内を検索
Command + S          保存
Command + W          ウィンドウやタブを閉じる
Command + Q          アプリ終了

特に大事なのは、Command + Space、Command + Tab、Command + F です。

Command + Spaceでアプリをすぐ起動する。Command + Tabでアプリを切り替える。Command + Fでページ内やファイル内の単語を探す。この3つだけでも、AIの出力を確認して次の指示を出す速度がかなり変わります。

Chromeで作業効率を上げる

AIエージェント作業では、Chromeのタブ操作も重要です。公式ドキュメントを調べる、AIの成果物を表示して確認する、といった場面で毎日使います。

Command + L          アドレスバーへ移動
Command + T          新しいタブを開く
Command + W          今のタブを閉じる
Command + Shift + T  閉じたタブを開き直す
Command + Option + 左右  タブ移動
Command + F          ページ内検索
Command + R          再読み込み
Command + Shift + R  強制再読み込み

AIで調査するときは、Command + Lで検索、Command + Fでページ内検索、Command + Shift + Tで閉じたタブを戻す。この3つの使用頻度が高いです。

たとえば長い公式ドキュメントからエラーの原因を探すとき、上から読むより、Command + Fでエラー文の単語を直接探した方が速いです。

Typelessで音声入力を強くする

AIエージェントへの指示は、長くなりがちです。「このファイルを読んで、初心者向けにブログ化して、コマンドはコピーできる形にして、最後にFAQも入れて」と毎回キーボードで打つのは面倒です。

そこでTypelessのようなAI音声入力を使います。Typelessは、話した内容を整った文章に変換するAI音声入力ツールです。だらだら話しても、プロンプトとして使いやすい形に整えやすいのが強みです。

たとえば、口でこう話します。

今からAIエージェントにLPの修正を頼みたい。
対象は初心者向けのサービスページ。
ファーストビューのコピーを強くして、CTAを分かりやすくして、スマホ表示も確認して。
ただし既存のデザインは大きく崩さないで。
変更後に確認コマンドも出して。

これをTypelessで整えて、Claude CodeやCodexへ貼る。これだけで、指示作成の負担がかなり減ります。必須ツールではないので、環境が落ち着いてからの導入で大丈夫です。

よくあるエラーと対処法

Homebrewのインストールが途中で止まる

症状: 公式コマンドを実行したあと、画面が長時間止まって見える。またはCommand Line Tools関連のエラーで終了する。

原因: Command Line Tools（Appleの開発用部品）のダウンロードに時間がかかっている。パスワード入力待ちで止まっている（入力しても文字は表示されません）。回線が不安定で、ダウンロードが途中で失敗した。

確認すること: 画面に Password: と出ていないか。出ていたらMacのログインパスワードを打ってEnter。最後に表示されている行がエラー文なのか、進行中の表示なのか。

対処: 進行中なら待つ。Command Line Toolsは数分から10分以上かかることがあります。エラーで終わっていたら、ターミナルを開き直して公式コマンドをもう一度実行する。それでも失敗する場合は、先に xcode-select --install でCommand Line Toolsだけ入れてから、Homebrewを入れ直す。

brew: command not found が出る

症状: Homebrewのインストールは終わったように見えるのに、brew --version を打つと zsh: command not found: brew と出る。

原因: PATH（コマンドの置き場所をターミナルに教える設定）が通っていない。Apple SiliconのMacで、インストール後に案内される「Next steps」のコマンドを実行していない。

確認すること: ls /opt/homebrew/bin/brew を実行して、ファイル自体は存在するか。インストールの最後に「Next steps」の案内が出ていなかったか。

対処: 次の2行を実行してPATHを通し、ターミナルを一度閉じて開き直してから、brew --version で確認します。

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

node や npm が command not found になる

症状: node -v や npm -v を打つと command not found と出る。

原因: brew install node が終わっていない、または失敗している。Homebrew自体のPATHが通っていない。

確認すること: brew --version は通るか。通らないなら1つ前のエラー対処へ。brew list の一覧に node があるか。

対処: brew install node をもう一度実行する。終わったらターミナルを開き直し、node -v と npm -v でバージョンが出るか確認する。

npm install -g で権限エラー（EACCES）が出る

症状: npm install -g の実行中に EACCES や permission denied と出て失敗する。

原因: npmのグローバルフォルダに書き込み権限がない。過去に sudo でnpmを使った影響で、フォルダの持ち主情報が壊れている。

確認すること: Node.jsをHomebrewで入れたか。この記事の手順なら通常は起きにくいです。エラー文の中に、どのフォルダ名が出ているか。

対処: sudo で無理やり通すのは非推奨です。後でもっと面倒になります。Homebrew経由でNode.jsを入れ直す（brew reinstall node）。それでも出る場合は、エラー文全文をAIに貼って、フォルダ権限の直し方を確認する。

筆者も昔、sudo で無理やり通した結果npmの権限が壊れて、結局Node.jsを丸ごと入れ直しました。急がば回れで、入れ直しが一番早いです。

claude や codex と打っても起動しない

症状: インストールしたはずなのに、claude や codex が command not found になる。

原因: インストールが実は失敗している。npmのグローバルインストール先にPATHが通っていない。インストール後にターミナルを開き直していない。

確認すること: which claude や which codex で場所が表示されるか。ターミナルを開き直したか。

対処: ターミナルを開き直して、もう一度実行する。出ない場合は入れ直す。Claude Codeは brew install --cask claude-code、Codexは npm install -g @openai/codex。それでも動かない場合は、Claude Codeのインストール記事やCodexのインストール記事のエラー対処を確認する。

Gitの保存で名前を聞かれて止まる

症状: AIエージェントに変更の保存（コミット）を頼んだら、Please tell me who you are のようなメッセージで止まる。

原因: Gitに名前とメールアドレスが登録されていない。

確認すること: git config --global --list に user.name と user.email があるか。

対処: git config --global user.name "自分の名前" と git config --global user.email "自分のメールアドレス" を実行してから、もう一度AIに続きを頼む。

ターミナルで今どこにいるか分からなくなる

症状: cd を繰り返すうちに、今どのフォルダにいるか分からなくなった。AIに指示を出すのが怖くなる。

原因: 移動の結果を確認しないまま、コマンドを打ち続けている。

確認すること: pwd を打って、表示されたパスが作業フォルダかどうか。

対処: pwd で現在地を確認する。迷子になったら cd ~/Desktop/ai-work のように作業フォルダへ直接移動し直す。AIエージェントを起動する前に pwd を打つ癖をつける。

AIに聞くためのプロンプト集

MacでAIエージェント用の環境構築を始めます。

使っているMac:
プログラミング経験:
今入っているか分かっているツール:
やりたい作業:（例: ブログ作成、SNS運用、LP修正）

Homebrew、Node.js、Git、エディタをどの順番で入れるべきか、初心者向けに確認する順番を教えてください。

MacにHomebrewを入れている途中で止まりました。

実行したコマンド:
画面に表示されている最後の数行:
使っているMac:（例: M2 MacBook Air）
待った時間:

今の状態が「待てば進む」のか「失敗している」のか判断して、次にやることを1つずつ教えてください。

Macのターミナルで command not found が出ます。

打ったコマンド:
表示されたエラー:
そのツールを入れるために実行したコマンド:
ターミナルを開き直したか:

原因の候補と、確認する順番を初心者向けに教えてください。PATHの直し方が必要なら、コピペできる形で出してください。

AIエージェント用の作業フォルダを整理したいです。

今のデスクトップやフォルダの状態:
やっている仕事:（例: SNS運用、ブログ、動画制作）
AIに任せたい作業:

プロジェクトごとのフォルダ構成案と、AIに触らせないほうがよいファイルの例を教えてください。フォルダを作るコマンドもまとめて出してください。

Macの環境構築がどこまで終わっているか確認したいです。

目的: Claude CodeやCodexを動かせる状態にする

brew --version、node -v、npm -v、git config --global --list の結果を貼ります。

（ここに結果を貼る）

足りないものと、次に実行するコマンドを順番に教えてください。

MacのAIエージェント環境構築が一通り終わりました。

入れたもの: Homebrew、Node.js、Git、VS Code、（Claude Code / Codex）
やりたい作業:

安全に使い始めるためのチェックリストを作ってください。特に、Gitでの履歴の残し方、秘密のキーの扱い、AIに最初に頼むと安全な小さい作業を3つ入れてください。

Mac環境構築後の実務活用14選

環境構築はゴールではなく入口です。この土台ができると、開発以外の仕事もAIエージェントに任せられるようになります。

AI駆動倶楽部の考え方は「AIで作る / AIでバズる / AIで運営する」。ひとりでもAIチームを作って、開発・SNS・事務・リサーチ・運営を回していく世界観です。運営はhashshnet（はしもとかずや）です。

hashshでは、この記事と同じ構成のMac環境（iTerm2 + Homebrew + Node.js + Git + VS Code）の上で、ブログ記事のHTML化、LPの修正、SNS投稿の下書き作成を毎日回しています。この記事自体も、その環境でAIエージェントに下書きとHTML化を手伝わせて作っています。

SNSの自動投稿は、アカウント停止リスクの責任を取れないため推奨しません。下書き生成、予約前チェック、運用設計までをAIの担当範囲にして、公開ボタンは人間が押す運用にしてください。

まとめ Mac環境構築は1回やれば終わり

AIエージェントのMac環境構築は、順番さえ守れば難しくありません。

派手な設定より、毎日使う土台と操作を整える方が効果があります。環境構築は基本的に1回やれば終わりです。ここを越えると、AIエージェントに任せられる仕事の幅が一気に広がります。

よくある質問

更新履歴

• 2026-07-02: Homebrew、Node.js、Git、VS Codeの導入手順、作業フォルダ整理、エラー対処7件、AIプロンプト集6本、実務活用14選、FAQ7問へ大幅増補。タイトルを変更
• 2026-05-21: 公開