前提条件
以下のソフトウェアが事前にインストールされている必要があります。
| ソフトウェア | バージョン | 確認コマンド |
|---|---|---|
| Node.js | 20以上 | node --version |
| Git | 最新版 | git --version |
Node.jsのインストール
Homebrewを使う方法が最も簡単です。
# Homebrewがまだの場合はインストール
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Node.jsをインストール
brew install node
# 確認
node --version
# v20.x.x 以上が表示されればOK
Homebrewを使わない場合は、Node.js公式サイトからLTS版のインストーラーをダウンロードしてください。
Gitのインストール
macOSにはXcode Command Line Toolsに含まれるGitがあります。
# Xcode Command Line Toolsをインストール
xcode-select --install
# 確認
git --version
インストール手順
ターミナルを開いて、以下のコマンドを実行します。
npm install -g @anthropic-ai/claude-code
権限エラーが出る場合
EACCES エラーが表示される場合は、npmのグローバルディレクトリの権限を変更します。
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
~/.zshrc（または ~/.bashrc）に以下を追加します。
export PATH=~/.npm-global/bin:$PATH
変更を反映して再度インストールします。
source ~/.zshrc
npm install -g @anthropic-ai/claude-code
インストールの確認
claude --version
バージョン番号が表示されればインストール成功です。
初回起動・認証
1. Claude Codeを起動
作業したいフォルダに移動して、claude コマンドを実行します。
cd ~/Projects/my-project
claude
2. Anthropicアカウントでログイン
初回起動時にブラウザが自動で開き、Anthropicアカウントでのログインを求められます。
- ブラウザでAnthropicアカウントにログイン
- Claude Codeへのアクセスを許可
- ターミナルに戻ると認証完了
3. 認証の確認
認証が成功すると、Claude Codeの対話画面が表示されます。
基本的な使い方
対話モード
claude コマンドで対話モードが起動します。自然言語で指示を出せます。
> ファイルの一覧を表示して
> このプロジェクトの構成を教えて
> バグを修正して
ファイルを指定して起動
特定のファイルやフォルダを引数として渡せます。
claude "このファイルのバグを修正して" --file src/app.js
よく使うコマンド
| コマンド | 説明 |
|---|---|
| claude | 対話モードで起動 |
| claude "指示" | ワンショットで指示を実行 |
| claude --help | ヘルプを表示 |
| claude --version | バージョンを表示 |
| /help | 対話モード内でヘルプを表示 |
| /clear | 対話履歴をクリア |
| Ctrl+C | 実行中の処理をキャンセル |
| Esc を2回 | Claude Codeを終了 |
トラブルシューティング
claude コマンドが見つからない
PATHにnpmのグローバルインストール先が含まれていない可能性があります。
npm config get prefix
表示されたパスの配下の bin ディレクトリがPATHに含まれているか確認してください。
認証に失敗する
- ブラウザのポップアップブロックを確認してください
- 別のブラウザで試してください
claude logoutで一度ログアウトしてから再度claudeを実行してください
Apple Siliconで問題が起きる場合
M1/M2/M3チップのMacで問題が発生する場合、Rosetta 2がインストールされているか確認してください。
softwareupdate --install-rosetta