
Claude Code を Mac に入れる前にそろえるもの——実際に確かめた4つのコマンド
Claude Code(ターミナルという黒い画面から使うAIエージェント)を入れたいのに、その前にgitやPythonが要ると言われて手が止まった。そういう人向けの、一番手前の話をここに書く。
この記事は「動かない」を解決する記事ではない。動かす前に何をそろえておくべきかを、実際にやった順番のまま並べただけの記事だ。
そろえるのは、Claude Code・Python 3・git(とGitHub)の3つだけ
Claude Codeは、コミットのたびに小さなスクリプトを差し込める仕組み(hooks)を持っている。テンプレとして配られているものの多くは、この仕組みの上で動く、Pythonのスクリプトで、gitのリポジトリの中に置いて使う方が良い。だから、動かす前にそろえておくものは3つだけでいい。
Claude Code本体は、読者が実際に指示を出す相手、つまりエージェントそのものだ。Python 3は、テンプレの中身がPythonで書かれているスクリプトである以上、それを実行する環境として要る。
gitは、テンプレをファイルの変更履歴ごと管理し、hooksという仕組みそのものを持っている土台になる。GitHubは、そのgitのリポジトリを手元の外に置いて、あとから同じものを別のMacに持ってきたり、人に渡したりするための場所になる。
Claude Codeを入れるだけなら、この3つの前提は要らない。だが有料記事のテンプレを実際に動かすところまで行くなら、この3つは避けて通れない。
実際にやった順番は、道具を整えてからClaude Codeを入れる形だった
実際に進めた順番はこうだった。いきなりClaude Codeから入れていない。
Xcode Command Line Tools
Homebrew
git
VS Code
Claude Code
Node.js(必要なら)
Python環境
GitHub SSH設定
先に、ソフトを配るための土台(Homebrew)と、変更履歴を管理するための土台(git)を整えてから、エディタとClaude Codeを入れている。この順で、ひとつずつ確かめながら進めた。
Xcode Command Line Tools を入れる
Appleが無料で配っている開発ツール一式で、gitやC言語のコンパイラなど、他の多くの開発ツールがこれの存在を前提にしている。新品のMacには基本的に入っていないので、ターミナルを開いたらまずこれから始める。次の1行を実行するだけでいい。
xcode-select --installインストール画面が出るので「インストール」を押せば終わる。この作業自体が、入っているかどうかを確かめる役も兼ねている。
Homebrew を入れる
HomebrewはMacの「開発者向けアプリストア」のようなもので、あとに続くgitやPythonのインストールを、1行のコマンドで済ませるための土台になる。Homebrewそのものを入れる作業は、私が残していたメモには具体的な1行が残っていなかった。ここはHomebrew公式サイトの手順をそのまま見た方が確実だ。
入ったかどうかは、次のコマンドで確かめられる。バージョンが表示されれば入っている状態だ。
brew --versiongit を入れる
Homebrewが入っていれば、gitのインストールも次の1行で終わる。入ったかどうかは、そのあと git --version で確かめる。
brew install git
git --versiongit は「入れる」と「自分用に直す」の2段階に分かれていた
Homebrewの役割は、ソフトを入れることだけだ。入れたあとに、自分の名前やメールアドレスをgitに教える作業が別に要る。この2つは別の係だと考えると分かりやすい。Homebrewはソフトを入れる係、configは入れたソフトを自分用に調整する係になる。
自分用の調整は、次の2行で行う。
git config --global user.name "Your Name"
git config --global user.email "you@example.com"この名前とメールアドレスは、以後のコミット(変更の記録)に「誰がやったか」として残る。ここに書いた例はそのまま使わず、自分の名前とメールアドレスに置き換える。
GitHubと手元のgitをつなぐ作業(SSHの接続設定)は、私が残していたメモには「GitHub SSH設定」という項目名だけが残っていて、実際に打ったコマンドまでは書いていなかった。ここはGitHub公式のSSH接続ドキュメントを見ながら進めるのが確実だ。
Python 3 が入っているかは、ターミナルに1行打てば分かる
hooksのテンプレを動かすスクリプトはPythonで書かれている。Macには元からPythonが入っている場合もあるが、テンプレが前提にしているバージョン(Python 3系)が入っているかどうかは、別に確かめた方がいい。次のコマンドでバージョン番号が表示されれば入っている。入っていなければ、Homebrewで入れてから、もう一度同じコマンドで確かめる。
python3 --version
brew install pythonClaude Code を入れて、プロジェクトのフォルダで一度動かすところまで
Claude Code本体のインストールコマンドは、私が残していたメモには残っていなかった。「CLIで claude が動く状態にする」というゴールだけが書いてあり、そこに至る入れ方自体は書かれていない。ここはClaude Code公式ドキュメントの手順を見て進める。
入れ終わったら、テンプレを使いたいプロジェクトのフォルダに移動し、ターミナルで次のコマンドを打つ。これが動けば、そのフォルダの中でClaude Codeが会話を始められる状態になっている。有料記事のhooksテンプレは、このフォルダがgitのリポジトリになっていることが前提になる。
claude迷った場所: codeコマンドが見つからない
VS Codeを入れたのに、ターミナルから code コマンドで開けないことがあった。確かめ方は次のコマンドで、バージョン番号(1.105.0のような数字の並び)が3行くらい表示されればPATH(コマンドの置き場所をターミナルに教える設定)は通っている。
code --versionそうではなく、zsh: command not found: code というメッセージが出ることもある。この場合、VS Codeを開き、キーボードで command + shift + P を押して「Shell Command」と入力し、「Shell Command: Install 'code' command in PATH」という項目を実行すれば直ることが多い。
私が実際に詰まって、材料として残っていた箇所はここだけだった。git・Python 3・Claude Code本体そのものについては、具体的な詰まりの記録が残っていない。もし同じように詰まったら、それぞれの公式ドキュメントに当たった方がいい。
最後に
ここまでの4つのコマンド、code --version・git --version・python3 --version・brew --versionが全部動けば、有料記事のhooksテンプレを動かす前提はそろっている。
Node.jsは、この記事の範囲(hooksテンプレを動かす)では要らない。Web開発を始めるタイミングが来たら、そのとき入れれば足りる。
ここまでの前提がそろった状態から、実際にAIエージェントの失敗を「二度目は自動で止める」仕組みに落とし込んだのが、次の記事だ。テンプレ一式と、状況別に選べる47件の失敗録がそのまま貼れる形で入っている。
AIエージェントの失敗を、自分の環境で「二度目は自動で止まる」ようにする仕組みの記事
【PR】オンラインプログラミングスクール【SkillHacks(スキルハックス)】
Webアプリケーション開発を動画で学べるオンラインスクールです。料金・カリキュラム・サポートの条件は公式ページで確認してください。
【PR】Amazonのオーディオブック【Audible】
通勤や家事の時間に、本やポッドキャストを耳で聴けるサービスです。無料体験の条件・料金は公式ページで確認してください。
【PR】AIエージェントの作り方を学べる本
この記事の多くはClaude Codeを使ったAIエージェント開発の中から生まれています。仕組みから学びたい方はこちらもどうぞ。
【PR】noteでの発信を学べる本
この記事もnoteで書いています。noteでの発信の仕方はこちらの本を参考にしています。
※Amazonのアソシエイトとして、当サイトは適格販売により収入を得ています(広告)