次世代型コンテンツビジネスの無料書籍内容を見る

Claude CodeをMacに設定する方法|導入・認証・最初のファイルを確かめる

Claude CodeをMacに設定する方法|導入・認証・最初のファイルを確かめるの説明用イメージ(AI生成)

MacでClaude Codeを始めるなら、使う入口を選び、導入、アカウントの認証、ファイルの保存を別々に確かめます。ここでは公式のネイティブCLIを軸に、空の練習フォルダで1ファイルを作るところまでを整理します。Cursorを使う場合の違いも、後半で確認できます。

「入れたはずなのに動かない」。この言葉だけだと、何をやり直すべきか分かりません。アプリは入ったけれどログインしていないのか、コマンドが見つからないのか、別のフォルダを開いているのか。止まった場所を分ければ、全部を最初から入れ直さずに確認できます。

目次

Macで使う入口を一つ選び、必要条件を確認する

僕は、りんちゃさんと共同制作する導入講座で、Macでのフォルダ作成、認証、ファイルの生成を実演しています。そこで大切にしたのは、AIの返事だけで終わらせず、実際の保存先を開いて確かめることでした。

当時の教材はCursor経由です。現在は、ターミナルから使うCLI、エディタの拡張、デスクトップアプリなどの入口があります。Cursorを必ず入れなければ使えないわけではありません。以下は2026年11月4日に確認した公式資料に基づく説明です。このページの手順例を、当日の実機検証結果とは区別しています。

入口 何を開くか 最初に区別すること
ネイティブCLI Macのターミナル コマンドで起動する。この記事の手順はこれを軸にする
エディタ拡張 VS Codeや対応するCursor 拡張のチャット画面と、エディタ内ターミナルのコマンドは別
デスクトップ Claudeのデスクトップアプリ GUIで使いたい場合の公式案内へ進む

公式セットアップ資料では、macOS 13以降、4GB以上のメモリ、x64またはARM64、インターネット接続が必要とされています。「このMacについて」でOSやチップを見てから進めましょう。会社のMacなら、ソフトの導入や外部AIへ渡せる情報について、社内のルールも確認します。

使うアカウントも先に決めます。個人の有料Claudeサブスクリプション、組織から招待されたアカウント、Claude Consoleなど、認証の入口は複数あります。既存契約と利用枠を確かめ、ConsoleのAPI利用とサブスクリプションを同じ請求だと思い込まないでください。最新条件は公式の認証案内から確認できます。

入口と確認するものを分ける:CLIはターミナルでコマンド確認、エディタ拡張は正規の拡張と入力欄を確認、アカウントは契約・組織・認証先を確認、作業フォルダは実際の保存先を確認
入口と確認するものを分ける。本文の手順・判断を整理した説明図です。

ターミナルから導入し、バージョンを確認する

CLIは、文字で指示する画面から使う形式です。Macでは「Command+Space」で検索を開き、「Terminal」と入力してターミナルを開けます。公式の初心者向けガイドも、この入口から案内しています。

ネイティブインストールの公式コマンドは次です。実行前に公式ページの現在の記載と一致するかを確認してください。

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

これはインストーラーを取得して実行するコマンドです。完了したら、次でバージョンを確認します。

claude --version

確認するのは、バージョン番号が表示されるかです。 この段階では、ログインやファイルの作成が済んだことにはなりません。

command not foundなら、コマンドを見つけるための設定がまだ合っていない可能性があります。インストーラーの案内と公式のトラブルシューティングを確認します。理由が分からないまま、違うインストール方法を重ねたり、ネットで見つけた設定追記を何度も実行したりしないでください。

Node.jsを準備する古い記事もありますが、ここで選んだネイティブインストールのために、先にNode.jsを入れる手順にはしていません。別の導入方法を選ぶなら、その方法の要件を公式で読み分けます。

練習フォルダを開いてから、アカウントで認証する

Finderでデスクトップにclaude-code-practiceという空のフォルダを作ったとします。最初から、顧客資料や実際の商品原稿が詰まったフォルダで試す必要はありません。

ターミナルで、そのフォルダへ移動します。以下は、デスクトップへこの名前で作った場合の例です。

cd "$HOME/Desktop/claude-code-practice"
pwd

pwdは、今いるフォルダの場所を表示するコマンドです。表示された末尾が練習フォルダになっているか、Finderで作った場所と見比べます。フォルダを別の場所に作ったなら、移動先も変わります。

場所を確認してから、起動します。

claude

初回はブラウザのログインへ進む場合があります。画面で使うアカウントを確認し、認証を終えてターミナルへ戻ります。認証画面で別の組織や想定外の請求先を選ばないようにしましょう。公式の認証案内には、ブラウザが自動で開かない場合の操作もあります。

作業フォルダの信頼や操作の許可を聞かれたら、対象と内容を読みます。初回の目標は、この練習用フォルダに1ファイルを作ることです。目的に必要な操作かを確認して進めてください。

最初は1ファイルだけ依頼し、Finderで中身を確かめる

あなたが最初に手に入れたいのは、AIが何でもできそうだという期待より、自分の指示が手元の作業に変わる感覚でしょう。保存先、名前、中身の3つがそろえば、どこを直せばよいかも分かるようになります。最初の依頼は、短く、出力先をはっきりさせます。

この練習用フォルダに start.md を1つ作ってください。
内容は「Claude Codeを始める練習」という見出しと、
「フォルダを確認する」「作成されたファイルを開く」の2項目です。
作成前に、保存する場所とファイル名を教えてください。
同名のファイルが既にあれば書き換えず、教えてください。
既存ファイルの変更や削除は不要です。

これは練習用の依頼文です。繰り返す場合、既にstart.mdがあれば内容を確かめ、別の空の練習フォルダにするか、同じファイルを修正する練習へ切り替えます。実行前の依頼文と、実際にできた結果を分けて記録しましょう。

依頼どおりなら、開いたファイルには次の内容が入るはずです。これは照合するための期待例で、実行済みの出力ではありません。

# Claude Codeを始める練習

- フォルダを確認する
- 作成されたファイルを開く

返答が来たら、保存先とstart.mdという名前を確かめます。書き込みの確認が表示された場合は、対象が合っているかを見て許可します。実行後、Finderでもフォルダを開きましょう。

確認するもの 自分で見るところ
保存場所 作った練習フォルダにあるか
ファイル start.mdが1つ作られたか
中身 見出しと指定の2項目が入っているか
余分な変更 指定していないファイルの変更を提案されていないか

「作成しました」という返事と、手元のファイルは別です。ファイルがなければ、今見ているフォルダ、相手が示した保存先、書き込みが完了したかを順に確認します。ここまで見られれば、チャットの返事が作業へつながる感覚をつかめます。1回目はファイルを1つ作るだけです。確認したら、2回目は同じファイルの最後へ短い一文を追加するように頼んでもよいでしょう。

あなたのフォルダで、作成と修正の2つを分けて確かめると、毎回新しいファイルを増やす必要がないことにも気づけます。元の文が残り、指定した一文だけが増えたかを見ます。こうして1件ずつ確かめれば、AIの返答を眺める状態から、手元の成果物を自分で判断できる状態へ変わります。

最初のファイルまでを確かめる:導入はバージョン番号を確認、認証は使うアカウントでログイン、依頼は空フォルダへ一つ作る、照合はFinderで場所・名前・中身を見る
最初のファイルまでを確かめる。本文の手順・判断を整理した説明図です。

Cursorを使うときは、拡張の画面とターミナルを分ける

公式のエディタ拡張案内には、VS CodeとCursorへのインストール入口があります。拡張を探すときは、その公式ページから正規の拡張へ進み、発行元も確認しましょう。

拡張のチャット画面はCLIを内包していますが、エディタ内のターミナルでclaudeコマンドを使うなら、別途スタンドアロンCLIの導入が必要です。拡張を入れたのにターミナルでclaudeが見つからないときは、この違いを確認してください。

エディタ側のAIチャットとClaude Codeの入力欄も、同じものではありません。使っている画面の名前と、開いているフォルダを確かめてから、先ほどの1ファイルの練習をします。.mdは文章を書く形式であり、拡張子を付けただけでAIが自分の知識を永続的に学習するわけではありません。

止まったら、導入・認証・保存のどこかを切り分ける

この記事の記入シートをダウンロードする(CSV・記入例付き)

ExcelやGoogleスプレッドシートで開いて使えます。記入例は説明用の架空例です。ご自身の情報へ置き換えてください。

4列の確認シートには、入口、環境、導入方法、バージョン、認証先、作業フォルダ、最初の依頼、出力の確認を記録できます。説明例の状態は「未実施」です。実際に自分が確認できた結果を空欄へ残してください。止まった画面と次に確認する項目を残せば、翌日に全部をやり直す不安から抜け出せます。途中までの確認も、再開に使える記録として残ります。

止まった状態 次に確かめる場所
claudeが見つからない インストール完了の案内、PATH、公式の導入診断
起動するが使えない ログインしたアカウント、契約や利用枠、組織の設定
返事はあるがファイルがない 指定した保存先、現在のフォルダ、書き込み完了の状態
別のフォルダへ作りそう 実行前の対象を直し、許可する内容を再確認

Claude Codeとの対話を終えるときは、入力欄でexitを使えます。導入診断のclaude doctorは、対話の文章として送るのではなく、通常のターミナルで実行する公式コマンドです。エラーを誰かに相談するときは、実行した操作とエラーの箇所を伝え、認証情報、顧客情報、見せる必要のないパスは外してください。

Windowsの方は、Mac用のコマンドをそのまま使わず、公式ガイドのWindows節へ進んでください。ご自身の環境と選んだ入口をそろえることが先です。

今日の完了は、導入、認証、ファイルの確認の3つに分けて残します。あなたの手元で確かめられた所までに印を付け、次に確認する1項目を決めましょう。

次の工程へ進むための関連記事

あなたの経験を、講座と本で届けるには

今ある知識や経験を、講座や本にして必要な人へ届けたい方へ。僕の著書『マーケティング不要の次世代型コンテンツビジネス』で、何を商品にするか、AIとどう分担するか、学びたい人が集まる場所でどう届けるかをお伝えしています。

無料PDF書籍『マーケティング不要の次世代型コンテンツビジネス』の正式モックアップ
無料で受け取れる電子書籍(PDF)です。

次世代型コンテンツビジネスの無料書籍を受け取る →

案内ページのメール登録フォームから、PDFの受け取りURLをお届けします。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次