Claude CodeをMacで使い始める手順と、プロジェクトごとにフォルダを分ける運用

Claude CodeをMacで使ってみたいけれど、ターミナルを開くのも久しぶりで、どこから始めればよいか分からない。インストールの記事を見ると npm や sudo が出てきて、そのまま打ってよいのか不安になる。そんな状態の人に向けて、この記事ではAnthropicの公式ドキュメントを2026年10月3日に確かめた内容をもとに、Claude CodeをMacで使い始める手順を順番に整理します。

結論から書くと、いまのMacでのおすすめは、公式が推奨している「ネイティブインストール」です。ターミナルに1行貼り付けるだけで済み、Node.jsを先に入れる必要もなく、更新も自動で行われます。そして、使い始めたら早い段階で「プロジェクトごとにフォルダを分け、フォルダごとに起動する」運用を決めておくと、後から混乱しません。この2つを中心に説明していきます。

Claude Codeとは：ターミナルで動くAIのコーディング支援

Claude Codeは、Anthropicが提供している、ターミナルで動くAIの作業支援ツールです。ターミナルとは、文字でコマンドを打ってMacを操作するアプリのことです。Claude Codeを起動したフォルダの中のファイルを読み、コードを書き換えたり、コマンドを実行したり、テストを走らせたりする作業を、会話しながら任せられます。

チャットで質問するAIとの違いは、手元のファイルに直接触れる点です。チャットのAIにコードを貼り付けて答えをもらい、それを自分でファイルに写す、という往復がなくなります。そのぶん、どのフォルダで起動したかによって、AIが読み書きできる範囲が決まります。この性質が、後で説明する「フォルダを分ける運用」の理由になります。

用途はプログラミングに限りません。文章の原稿をフォルダで管理している人が、表記ゆれの点検や、複数ファイルの一括の書き換えを任せる、といった使い方もできます。開発者でなくても、ファイルを扱う仕事をしている人なら役に立つ場面があります。

なお、公式ドキュメントには、ターミナルを使わずに Claude Code を使えるデスクトップアプリ（macOS、Windows、Linux向け）も案内されています。ターミナルにどうしても抵抗がある人は、そちらから始める選択肢もあります。この記事では、ターミナルで使う方法を中心に説明します。

始める前に確かめること：Macの条件と契約

インストールの前に、2つのことを確かめておきます。Macの条件と、Anthropicのアカウントの契約です。

公式ドキュメントのシステム要件では、macOS 13.0以上、メモリ（RAM）4GB以上、インターネットへの接続が必要とされています。シェルはBashかZshで動きます。シェルとは、ターミナルの中でコマンドを受け付けて実行するプログラムのことで、最近のMacは標準でZshが設定されています。Macのバージョンは、Appleのメニューの「このMacについて」で確かめられます。

もう1つが契約です。公式ドキュメントには、次のように書かれています。

Claude Code には、Pro、Max、Team、Enterprise、または Console アカウントが必要です。無料の claude.ai プランには Claude Code アクセスは含まれていません。 出典: code.claude.com

つまり、無料のアカウントでは Claude Code は使えません。個人で使うなら、Pro か Max のどちらかを契約することになります。Anthropicの料金ページ（2026年10月3日時点）では、Pro は年払いで月あたり18ドル（一括220ドル）、月払いなら22ドル、Max は月額110ドルからと書かれていて、価格には日本の消費税10％が含まれると表示されています。

料金ページのよくある質問の欄によると、すべてのプランには5時間ごとに区切られる使用量の上限があり、有料プランにはさらに週ごとの上限があります。Web、デスクトップ、モバイル、Claude Code の利用はすべて同じ枠から消費される、とも書かれています。チャットでたくさん使った日は、Claude Code で使える量もその分減る、ということです。

どちらを選ぶか迷ったら、まずは Pro で始めて、上限に何度も当たるようなら Max に上げる、という順番で十分です。使う量は人によって大きく違うので、最初から高いプランを選ぶ必要はありません。現在どのくらい使っているかは、料金ページの説明によると、設定の「使用状況」からいつでも確かめられます。1週間ほど普段どおりに使い、上限にどのくらい近づいたかを見てからプランを見直すと、払いすぎを防げます。

Console アカウントとは、開発者向けの管理画面で API の利用料を払う形のアカウントのことです。使った分だけ支払う形なので、月の使い方が読めない人や、会社の経費で API の請求をまとめたい人はこちらを選ぶこともあります。

インストールの手順：公式が推奨するネイティブインストール

準備ができたら、インストールに進みます。公式ドキュメントでは、Mac向けに「ネイティブインストール（推奨）」と「Homebrew」の2つの方法が並んでいます。

ネイティブインストールの手順は次のとおりです。

1. 「アプリケーション」フォルダの「ユーティリティ」から「ターミナル」を開く
2. 次の1行を貼り付けて、Enterキーを押す

curl -fsSL https://claude.ai/install.sh | bash

3. インストールが終わったら、新しいターミナルのウィンドウを開く
4. 次のコマンドで、バージョン番号が表示されるか確かめる

claude --version

バージョン番号が表示されれば、インストールは完了です。公式ドキュメントによると、ネイティブインストールでは Claude Code の本体が ~/.local/bin/claude から起動され、新しい版が出るとバックグラウンドで自動的に更新されます。~ はホームフォルダを表す記号です。

もし claude が見つからない、と表示された場合は、インストール先がまだ「PATH」に入っていないことが原因です。PATHとは、ターミナルがコマンドを探しに行く場所の一覧のことです。公式ドキュメントのトラブルシューティングに直し方が載っているので、その手順に従ってください。

インストールの状態をまとめて確かめたいときは、次のコマンドが便利です。

claude doctor

公式ドキュメントでは、このコマンドはセッションを始めずに、インストールの状態や設定ファイルの誤り、直し方の提案を読み取り専用で表示すると説明されています。うまく動かないときは、まずこれを実行してみてください。

Homebrewやnpmで入れる場合と、sudoを使わない理由

すでに Homebrew を使っている人は、次のコマンドでも入れられます。Homebrewとは、Mac用のソフトをコマンドで入れたり更新したりする仕組みのことです。

brew install --cask claude-code

公式ドキュメントによると、Homebrew には2つの種類があり、claude-code は安定版（通常は約1週間遅れで、大きな不具合を含む版を飛ばす）、claude-code@latest は最新版を追います。注意したいのは、Homebrew で入れた場合は自動で更新されないことです。brew upgrade claude-code を自分で定期的に実行する必要があります。

インターネット上の古い記事には、npm で入れる方法が多く紹介されています。npm とは、Node.js というプログラムの実行環境に付いてくる、部品を入れるための道具です。公式ドキュメントでも npm での方法は残っていますが、Node.js 22以上が必要で、推奨の方法ではありません。

ここで特に気をつけたいのが sudo です。古い記事の中には、「権限のエラーが出たら sudo npm install -g で入れる」と書いているものがあります。sudo は、管理者の権限でコマンドを実行する命令です。公式ドキュメントには、はっきりと次のように書かれています。

sudo npm install -g を使用しないでください。これはアクセス許可の問題とセキュリティリスクにつながる可能性があります。 出典: code.claude.com

管理者の権限で入れると、後の更新や設定の書き換えで権限の食い違いが起き、かえって直すのが大変になります。これから入れる人は、npm ではなくネイティブインストールを選べば、この問題を最初から避けられます。

編集部で試したときも、以前に npm で入れた環境が残っていて、新しく入れた版と古い版のどちらが起動しているのか分からなくなったことがありました。claude doctor を実行すると、どこから起動しているかが表示されたので、古い版を削除して整理できました。複数の方法で入れた覚えがある人は、まずこのコマンドで確かめてください。

更新の受け取り方を選ぶ

ネイティブインストールの Claude Code は自動で更新されますが、どのくらい早く新しい版を受け取るかは選べます。公式ドキュメントでは、更新の受け取り方（リリースチャネル）が2つ用意されていると説明されています。

・latest（既定）：新しい版が出るとすぐに受け取る
・stable：通常は約1週間前の版を使い、大きな不具合を含む版を飛ばす

新しい機能をすぐに試したい人は latest のままで、仕事で安定して使いたい人は stable に切り替える、という選び方ができます。切り替えは、会話の中で /config を開き、自動更新のチャネルの項目から選びます。設定ファイルに書いて切り替える方法も公式ドキュメントに載っています。

取引先の作業に使っていると、更新の直後に動きが変わって戸惑うことがあります。納期の近い案件を抱えている時期は stable にしておき、余裕のある時期に latest で新しい機能を試す、という使い分けも1つの方法です。なお、公式ドキュメントには、新しく出たモデルを使うには stable の版より新しい版が必要になる場合がある、とも書かれています。

最初の起動とログイン

インストールが済んだら、作業したいフォルダで Claude Code を起動します。ターミナルで、そのフォルダに移動してから claude と打ちます。

cd ~/Documents/my-project
claude

cd は、作業するフォルダを移動するコマンドです。Finder でフォルダをターミナルのウィンドウにドラッグすると、そのフォルダの場所が自動で入力されるので、長い場所を打ち込む必要はありません。

初めて起動すると、ブラウザが開いて Anthropic のアカウントでのログインを求められます。公式ドキュメントでは、ブラウザの案内に従ってログインする流れが説明されています。ログインが終わるとターミナルに戻り、会話を始められる状態になります。

最初に試すなら、ファイルを書き換えない質問から始めるのがおすすめです。

・このフォルダには何が入っているか説明して
・このプロジェクトの起動方法を教えて
・README.md を読んで、要点を3行で教えて

Claude Code は、ファイルを書き換えたりコマンドを実行したりする前に、許可を求めてきます。最初のうちは、何をしようとしているのかを読んでから許可する習慣をつけてください。何が起きるか分からない操作を、まとめて許可しないことが大切です。

作業が終わったら、会話の画面で /exit と打つか、Ctrl＋C を押して終了します。

なぜプロジェクトごとにフォルダを分けるのか

Claude Code を使い始めて、最初に決めておきたいのが「どのフォルダで起動するか」です。結論から書くと、案件やプロジェクトごとに1つのフォルダを作り、必ずそのフォルダの中で起動する運用をおすすめします。理由は3つあります。

1つ目は、AIが読み書きする範囲を限るためです。Claude Code は、起動したフォルダの中のファイルを扱います。ホームフォルダのような広い場所で起動すると、関係のない案件のファイルや、個人の書類まで読み取りの対象に入ってしまいます。案件ごとのフォルダで起動すれば、その案件のファイルだけを扱う状態になります。

2つ目は、案件ごとの決まりを分けるためです。次の節で説明する CLAUDE.md という指示のファイルは、フォルダごとに用意できます。A社の案件では「コメントは英語で書く」、B社の案件では「インデントはスペース4つ」といった決まりを、フォルダごとに覚えさせられます。同じフォルダで複数の案件を扱うと、この決まりが混ざります。

3つ目は、取引先の情報を混ぜないためです。業務委託で複数の会社の仕事を受けていると、守秘義務の範囲は会社ごとに違います。A社の資料を読んだ会話の流れで B社のコードを書かせる、という状況は避けるべきです。フォルダを分けて起動し直せば、会話も新しく始まります。

おすすめのフォルダの構成は、たとえば次のような形です。

~/Projects/
  client-a-website/
  client-b-app/
  personal-blog/

案件ごとのフォルダの直下に、その案件の CLAUDE.md を用意し、起動するときは必ずそのフォルダに cd してから claude を打つ。これだけで、多くの混乱を防げます。

CLAUDE.mdで、フォルダごとの決まりを覚えさせる

Claude Code の会話は、起動するたびに新しく始まります。前回の会話で伝えた決まりは、そのままでは引き継がれません。そこで使うのが CLAUDE.md というファイルです。

公式ドキュメントでは、CLAUDE.md は「Claude に永続的な指示を与えるマークダウンファイル」と説明されていて、すべてのセッションの開始時に読み込まれます。マークダウンとは、見出しや箇条書きを記号で書く、シンプルな文章の書き方のことです。

CLAUDE.md を用意できる場所は、主に次の3つです。

場所	対象	書く内容の例
~/.claude/CLAUDE.md	自分のすべてのプロジェクト	返答は日本語で、など個人の好み
プロジェクトのフォルダの CLAUDE.md	そのプロジェクト（チームで共有できる）	ビルドやテストのコマンド、命名の決まり
プロジェクトのフォルダの CLAUDE.local.md	そのプロジェクトの自分だけ	自分だけが使うテスト用の設定など

CLAUDE.local.md は、公式ドキュメントで .gitignore に追加するよう案内されています。.gitignore とは、Git でファイルの変更を記録するときに、記録の対象から外すファイルを並べておく設定のことです。自分だけの設定を、チームと共有する記録に混ぜないためです。

最初の CLAUDE.md は、会話の中で /init と打つと自動で作れます。公式ドキュメントによると、Claude がコードを調べて、見つけたビルドのコマンドやテストの手順、プロジェクトの決まりを書いたファイルを作ってくれます。すでにファイルがある場合は、上書きせずに改善の提案をします。

書き方のコツとして、公式ドキュメントには、1つのファイルを200行以下に抑えること、「コードを適切に整える」ではなく「インデントはスペース2つ」のように確かめられる具体的な書き方にすることが挙げられています。長く書くほど守られにくくなるので、「何度も説明し直していること」だけを書くのが基本です。

読み込まれているかどうかは、会話の中で /context と打ち、表示される一覧で確かめられます。

作業を頼むときの伝え方

Claude Code は、伝え方しだいで結果が大きく変わります。使い始めの人がつまずきやすいのは、「いい感じに直して」のような、ゴールのはっきりしない頼み方です。伝え方のコツを整理しておきます。

1つ目は、完了の条件を書くことです。「ログイン画面のエラーを直して」より、「ログイン画面で正しいパスワードを入れてもエラーになる。テストを実行して、すべて通る状態にして」のほうが、どこまでやれば終わりかが伝わります。テストのある開発なら、「テストが通ること」を完了の条件にするのがいちばん確実です。

2つ目は、触ってほしくない範囲を書くことです。「設定ファイルは変更しないで」「このフォルダの外のファイルには触れないで」と最初に伝えておくと、想定外の書き換えを防げます。毎回伝えている決まりがあるなら、CLAUDE.md に書いておけば、伝え忘れがなくなります。

3つ目は、大きな作業を小さく分けることです。「サイト全体を作り直して」と一度に頼むより、「まず変更の計画を箇条書きで出して」「計画の1番目だけ実装して」と段階を分けたほうが、途中で方向がずれたときに気づけます。計画を先に出してもらい、それを読んでから実装に進む流れは、慣れないうちほど効果があります。

4つ目は、結果を自分で確かめることです。Claude Code が「直しました」と言っても、実際に画面で動くか、テストが通るかは自分の目で確かめます。AI の報告をそのまま取引先に伝えてしまうと、確かめていない内容に責任を負うことになります。

文章の仕事でも同じです。「この原稿の表記ゆれを直して」と頼むなら、「数字は半角、です・ます調、固有名詞は公式の表記に合わせる」と基準を具体的に書くと、何度も直し直す手間が減ります。

安全に使うための習慣

手元のファイルに直接触れる道具だからこそ、安全に使うための習慣を最初に身につけておきます。

まず、パスワードや API の鍵などの秘密の情報を、Claude Code に読ませるファイルや会話の中に書かないことです。プロジェクトでは、秘密の情報は .env のような専用のファイルに分けて保存し、そのファイルは Git の記録の対象から外しておくのが一般的です。会話の中で「このキーを使って」と鍵そのものを貼り付けることは避けてください。

次に、許可を求められた操作を読んでから許可することです。Claude Code は、ファイルの書き換えやコマンドの実行の前に、何をするかを表示して許可を求めます。削除を含むコマンドや、インターネットから何かを取り込むコマンドが出てきたら、内容を理解できるまで許可しないことが大切です。分からないときは「このコマンドは何をするのか説明して」と聞けば、実行する前に説明してくれます。

3つ目は、取引先の契約を確かめることです。業務委託の契約によっては、取引先のコードや資料を外部のサービスに送ることが制限されている場合があります。AI のツールを使ってよいか、どの範囲までなら使ってよいかを、作業を始める前に取引先に確認しておくと、後でもめることを防げます。Anthropic のデータの扱いについては、公式のプライバシーの説明と、アカウントの設定画面で確かめられます。

4つ目は、定期的に更新されているかを確かめることです。ネイティブインストールなら自動で更新されますが、Homebrew で入れた場合は自分で更新する必要があります。安全に関わる修正も更新に含まれるので、claude doctor で状態を見る習慣をつけておくと安心です。

複数の案件を並行するときの運用

フリーランスや副業で、複数の案件を同時に進めている人も多いはずです。Claude Code で複数の案件を扱うときの運用を整理しておきます。

まず、ターミナルのウィンドウやタブを案件ごとに分けます。A社の案件はこのタブ、B社の案件はこのタブ、と決めて、それぞれのフォルダで claude を起動します。同じタブの中でフォルダを移動して使い回すより、取り違えが起きにくくなります。

次に、ターミナルのタブに名前を付けます。Mac 標準のターミナルでも、タブのタイトルを変更できます。案件の名前を付けておくと、どのタブで何が動いているかが一目で分かります。

3つ目は、長い作業を任せている間の確認です。Claude Code は、テストを走らせて直す、といった作業を数分から数十分かけて進めることがあります。その間に別の案件の作業をしていると、許可を求められていることに気づかず、作業が止まったままになりがちです。こまめにタブを見て回るか、終わったら知らせてくれる仕組みを用意しておくと安心です。

4つ目は、案件が終わったときの片付けです。納品が済んだら、その案件のフォルダは別の場所に移して、普段の作業の場所から外します。CLAUDE.md も一緒に移るので、後で同じ取引先から追加の依頼が来たときに、そのまま再開できます。

よくあるつまずきと対処

Claude Code を Mac で使い始めたときに、よく出会うつまずきを整理しておきます。

1つ目は、claude と打っても「command not found」と出るケースです。インストールの直後なら、新しいターミナルのウィンドウを開き直すと直ることがほとんどです。それでも出る場合は、前の節で触れた PATH の問題なので、公式ドキュメントのトラブルシューティングの手順を確かめてください。

2つ目は、ログインしたのに使えないケースです。無料のアカウントでログインしている可能性があります。前の節で触れたとおり、Claude Code には Pro 以上の契約か Console アカウントが必要です。契約しているアカウントとは別のメールアドレスでログインしていないかも確かめてください。

3つ目は、使っているうちに上限に達して止まるケースです。5時間ごとの上限と週ごとの上限があり、チャットと Claude Code は同じ枠を使います。料金ページによると、上限に達したら、リセットを待つか、上位のプランに移るか、有料プランなら使用クレジットを有効にして続けられます。大きな作業は、上限がリセットされた直後に始めると止まりにくくなります。

4つ目は、AIに想定外のファイルを書き換えられたケースです。Git で変更を記録していれば、元に戻せます。Claude Code を使うプロジェクトでは、作業を始める前に Git の記録を取っておく習慣をつけてください。Git をまだ使っていないなら、Claude Code に「このフォルダを Git で管理できるようにして」と頼むところから始められます。

5つ目は、日本語の入力で文字が確定前に送信されてしまうケースです。ターミナルでは、日本語の変換中に Enter キーを押すと、変換の確定と送信が重なることがあります。長い指示を書くときは、別のテキストエディタで文章を作ってから貼り付けると、思わぬ送信を防げます。

フォルダとターミナルを1つの画面で扱う選択肢

ここまでの運用を続けていると、「案件のフォルダを Finder で開き、別のウィンドウでターミナルを開き、両方を行き来する」作業が増えていきます。フォルダを切り替えるたびに cd を打ち直すのも手間です。こうした「Finder とターミナルの行き来」を減らしたい場合の候補の1つとして、Mac 用のファイル管理アプリ「Atriens」があります。

公式サイトによると、Atriens は AI エージェントと使うための Mac のファイル管理アプリで、フォルダごとにターミナルを1つ持ち、フォルダを切り替えるとターミナルも一緒に切り替わるので cd を打つ必要がない、と説明されています。動いている・応答を待っている・終わったという状態をタブの色と印で見分けられ、作業が終わったときや確認を求められたときは macOS の通知で知らせます。サイドバーでは、ディスクの別々の場所にあるフォルダを1つの案件の下に並べられ、ファイル自体は移動しないと書かれています。

料金は、Mac 単体で使う機能（サイドバー、ターミナル、プレビュー、Git など）が期間の制限なく無料です。iPhone や iPad から自宅の Mac に繋いで使う機能は有料で、月額780円、年額6,800円、買い切り14,800円（いずれも税込）から選べます。対応は macOS 14 以降で、アカウントの登録は不要とされています。AI の利用料は Atriens では取らず、手元の Claude Code などの契約をそのまま使う形です。

案件ごとのフォルダで Claude Code を動かす運用が定着してきたら、無料の範囲で1つの案件を登録し、行き来が減るかを確かめてみてください。

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

AIを道具として使える人の仕事の広がり

最後に、Claude Code のような AI の道具を使いこなすことが、仕事の広がりとどうつながるのかを整理しておきます。

AI に作業を任せられるようになると、1人で扱える仕事の量と幅が変わります。これまで外注していた小さなスクリプトの作成や、資料の一括の整形を、自分で片付けられるようになるからです。一方で、AI に何をどこまで任せるか、結果をどう確かめるかを判断する力は、人の側に残ります。

AI の導入や活用を企業に提案する仕事は、AIコンサル・業務活用支援のお仕事で中身を確かめられます。AI を使った集客や、安全な運用の設計に関わる仕事はAI・マーケティング・セキュリティのお仕事にまとまっています。開発そのものを受ける人はアプリケーション開発のお仕事が参考になり、収入の目安はソフトウェア作成者の年収・単価相場で公的な統計をもとにした数字を確認できます。

フリーランス・在宅ワークの市場を20年運営してきた立場から言えば、新しい道具が出てきたときに長く続く人は、道具の性能より先に「取引先の情報をどう守るか」を考えています。案件ごとにフォルダを分けて AI を動かす運用は、その姿勢をそのまま形にしたものです。仲介の手数料が乗らない直接取引では、発注する側は同じ予算でより多くを頼め、受ける側は手取りが厚くなります。その信頼関係を続けるうえで、情報の扱いの丁寧さは何よりの土台になります。

まずはネイティブインストールで Claude Code を入れ、1つの案件のフォルダで起動し、CLAUDE.md を作るところまで進めてみてください。そこまでできれば、あとは使いながら自分の運用を育てていけます。

よくある質問

Q. Claude Codeは無料で使えますか？

公式ドキュメントでは、Claude Code には Pro、Max、Team、Enterprise、または Console アカウントが必要で、無料の claude.ai プランには含まれていないと書かれています。2026年10月3日時点の料金ページでは、Pro は年払いで月あたり18ドル、月払いで22ドル、Max は月額110ドルからです。使う量が読めない場合は、まず Pro から始めるのが無難です。

Q. MacにClaude Codeを入れるとき、npmとネイティブインストールのどちらがよいですか？

公式が推奨しているのはネイティブインストールです。ターミナルに1行貼り付けるだけで入り、Node.js を先に入れる必要がなく、更新も自動で行われます。npm での方法は Node.js 22以上が必要で、権限のエラーが出たときに sudo を使うと、かえって問題を大きくします。公式ドキュメントも sudo npm install -g を使わないよう案内しています。

Q. CLAUDE.mdはどこに作ればよいですか？

すべてのプロジェクトに共通する個人の好みはホームフォルダの .claude フォルダの中、プロジェクトの決まりはそのプロジェクトのフォルダの直下に作ります。自分だけの設定は CLAUDE.local.md に書き、Git の記録の対象から外します。最初のファイルは会話の中で /init と打つと自動で作れます。

Q. 複数の案件でClaude Codeを使うときの注意点はありますか？

案件ごとにフォルダを分け、必ずそのフォルダの中で起動してください。起動したフォルダが AI の読み書きの範囲になるので、広い場所で起動すると別の案件や個人の書類まで対象に入ります。ターミナルのタブも案件ごとに分けて名前を付けると、取り違えを防げます。作業の前に Git で記録を取っておくと、想定外の書き換えも元に戻せます。