[Claude] MacでClaude Codeをインストールする

これまでClaudeについて記事を書いてきましたが、主にClaude Desktopの説明をメインにしていました。
しかし実際にプログラム開発をする場合、Claude Codeをターミナルから使用する方が開発効率が大幅に向上します。

導入自体は簡単ですが、備忘録も兼ねて導入手順を詳しく記載しておきます。

必要なもの

アカウント: Claude Pro/Maxプランまたは Anthropic Console（API）のアカウント
システム要件:
- macOS 10.15以上
- RAM 4GB以上
- インターネット接続
推奨ツール:
- Homebrew（パッケージマネージャー）
- Git（バージョン管理）

環境

macOS Ventura 13.3
Terminal.app
Homebrew 4.0.17

インストール手順

1. Claude Codeのインストール

MacではHomebrewを使うのが最も簡単です。

brew install --cask claude-code

インストールが完了したら、以下のコマンドで確認できます。

claude --version

2. 初回起動と認証

プロジェクトフォルダに移動して、Claude Codeを起動します。

cd /path/to/your/project
claude

初回起動時には、いくつかの設定画面が表示されます。
順番に見ていきましょう。

3. テーマカラーの選択

To change this later, run /config

❯ Light text
  Dark text
  Light text (colorblind-friendly)
  Dark text (colorblind-friendly)

最初に、テキストのテーマカラーを選択する画面が表示されます。

テーマの説明

Light text: 明るい背景に暗い文字（ライトモード）
Dark text: 暗い背景に明るい文字（ダークモード）
Light text (colorblind-friendly): 色覚特性に配慮したライトモード
Dark text (colorblind-friendly): 色覚特性に配慮したダークモード

ターミナルの背景色に合わせて選択してください：

ターミナルが明るい背景の場合 → Light text を選択
ターミナルが暗い背景の場合 → Dark text を選択（一般的）

色の識別が難しい場合は、colorblind-friendly オプションを選択することで、より見やすい配色になります。
後から変更したい場合は、/config コマンドで再設定できます。

4. 認証方法の選択

Claude Code can be used with your Claude subscription or billed based on API 
 usage through your Console account.                     
                                 
 Select login method:
                 
 ❯ 1. Claude account with subscription · Pro, Max, Team, or Enterprise
                                     
   2. Anthropic Console account · API usage billing
                                  
   3. 3rd-party platform · Amazon Bedrock, Microsoft Foundry, or Vertex AI

これはClaude Codeの認証方法（課金方法）の選択画面です。

選択肢の説明

1. Claude account with subscription（サブスクリプション）

claude.aiのPro・Max・Team・Enterpriseプランに加入している場合の選択肢です。月額固定料金の中でClaude Codeが使えます。すでにclaude.aiのアカウントをお持ちであればこちらを選ぶのが一番シンプルです。

2. Anthropic Console account（API従量課金）

console.anthropic.comのアカウントで、使った分だけAPI料金を支払う方式です。使用量が少ない場合はお得なこともありますが、大量に使うと費用が膨らむリスクがあります。

3. 3rd-party platform（サードパーティ経由）

Amazon BedrockやMicrosoft Foundry、Google Vertex AIなどのクラウドサービス経由でClaudeを利用する場合の選択肢です。企業での利用や既存のクラウドインフラと統合したい場合に使います。

推奨する選択肢

一般的な個人利用であれば 「1. Claude account with subscription」 が最もシンプルです。claude.aiのProまたはMaxプランに加入済みであれば、そのアカウントでそのままログインできます。

選択後、ブラウザが開いて認証画面が表示されるので、指示に従ってログインします。

5. セキュリティに関する注意事項

Security notes:                      
                                           
  Claude can make mistakes
  You should always review Claude's responses, especially when
  running code.

  Due to prompt injection risks, only use it with code you trust
  For more details see:
  https://code.claude.com/docs/en/security

 Press Enter to continue…

Claude Codeを使う上での重要な注意点が表示されます。

Claudeはミスをすることがある: 生成されたコードは必ず確認してから実行しましょう
プロンプトインジェクションのリスク: 信頼できるコードベースでのみ使用してください

Enterキーを押して続行します。

6. ターミナル設定の選択

Use Claude Code's terminal setup?    
                                           
 For the optimal coding experience, enable the recommended settings
 for your terminal: Option+Enter for newlines and visual bell 
               
 ❯ 1. Yes, use recommended settings
   2. No, maybe later with /terminal-setup                      
                       
 Enter to confirm · Esc to skip

ターミナルの推奨設定を適用するか確認されます。

推奨設定の内容

Option+Enter で改行: Enterキーだけで送信せず、複数行の入力が可能になります
Visual bell: 音ではなく画面の点滅で通知します

基本的には 「1. Yes, use recommended settings」 を選択することをおすすめします。後から /terminal-setup コマンドで変更も可能です。

7. ワークスペースの信頼確認

  Accessing workspace:

 /Users/shinyatomozumi/Develop/01.Project/01.TomozumiSystem/vTuberWebSite

 Quick safety check: Is this a project you created or one you trust? (Like
 your own code, a well-known open source project, or work from your team). If
  not, take a moment to review what's in this folder first.

 Claude Code'll be able to read, edit, and execute files here.

 Security guide

 ❯ 1. Yes, I trust this folder
   2. No, exit

作業フォルダへのアクセス許可を確認する画面です。

重要な確認事項

Claude Codeは、このフォルダ内のファイルを以下のように操作できるようになります：

読む: すべてのファイルの内容を読み取れます
編集する: ファイルの内容を変更できます
実行する: コードやスクリプトを実行できます

自分で作成したプロジェクトや信頼できるコードベースであれば、「1. Yes, I trust this folder」 を選択して問題ありません。
出所不明のコードや他人から受け取ったプロジェクトの場合は、中身を確認してから進めることをおすすめします。

基本的な使い方

起動方法

プロジェクトディレクトリに移動して起動します。

cd /path/to/your/project
claude

終了方法

Claude Codeを終了するには、以下のいずれかの方法を使用します。

/exit    # または /quit

もしくは、キーボードショートカットで終了できます：

Ctrl + C: 強制終了
Ctrl + D: 通常終了（EOF送信）

よく使うコマンド

Claude Code内では、スラッシュ（/）で始まる特殊コマンドが使えます。

/help              # ヘルプを表示
/terminal-setup    # ターミナル設定を再設定
/exit または /quit  # 終了

トラブルシューティング

インストールの確認

claude doctor

このコマンドで、インストールの状態とバージョンを確認できます。

インストールに失敗する場合

Homebrewのアップデートを試してみてください。

brew update
brew upgrade
brew reinstall --cask claude-code

認証に失敗する場合

claude.aiまたはconsole.anthropic.comにログインできることを確認
ブラウザのキャッシュをクリアして再試行
別のブラウザで認証を試みる

参考リンク

まとめ

Claude Codeを導入することで、ターミナルから直接AIの力を借りながら開発できるようになります。初回設定さえ済ませてしまえば、後は簡単に使えるので、ぜひ試してみてください。

特に以下のような作業で威力を発揮します：

コードの生成と修正
バグの特定とデバッグ
リファクタリング
ドキュメント作成
Gitコマンドの補助

効率的な開発ライフをお楽しみください！