メインコンテンツへスキップ
見出し画像

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から入れていない。

    1. Xcode Command Line Tools

    2. Homebrew

    3. git

    4. VS Code

    5. Claude Code

    6. Node.js(必要なら)

    7. Python環境

    8. 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 --version

    git を入れる

    Homebrewが入っていれば、gitのインストールも次の1行で終わる。入ったかどうかは、そのあと git --version で確かめる。

    brew install git
    git --version

    SkillHacksの詳細はこちら

    git は「入れる」と「自分用に直す」の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 python

    Audibleの詳細・無料体験はこちら

    Claude 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アプリケーション開発を動画で学べるオンラインスクールです。料金・カリキュラム・サポートの条件は公式ページで確認してください。

    SkillHacksの詳細はこちら

    【PR】Amazonのオーディオブック【Audible】

    通勤や家事の時間に、本やポッドキャストを耳で聴けるサービスです。無料体験の条件・料金は公式ページで確認してください。

    Audibleの詳細・無料体験はこちら

    【PR】AIエージェントの作り方を学べる本

    この記事の多くはClaude Codeを使ったAIエージェント開発の中から生まれています。仕組みから学びたい方はこちらもどうぞ。

    【PR】noteでの発信を学べる本

    この記事もnoteで書いています。noteでの発信の仕方はこちらの本を参考にしています。

    ※Amazonのアソシエイトとして、当サイトは適格販売により収入を得ています(広告)

     
     
    会社員が、本業はそのままで副業とお金を増やす手順だけを書きます。AIに副業を回させる一式、何歳で辞められるかが30秒で出る無料の道具、積立の考え方。YouTube・Instagramでは、チワとポメが昭和〜平成と世界の事件を語る動画もAIで回しています。固定記事から読めます。

    あなたへのおすすめ