Claude Code インストール完全ガイド¶
実現できること¶
簡単セットアップ
3ステップでClaude Codeの強力な機能をすぐに利用開始
全プラットフォーム対応
Windows、macOS、Linux環境での最適な設定方法
トラブル解決
よくある問題の事前回避と効率的な解決策
パフォーマンス最適化
OSごとの特性を活かした高速動作設定
📖 概要¶
Claude Codeは、Anthropic社が開発したターミナルベースのAIコーディング支援ツールです。このガイドでは、各プラットフォームでの正しいインストール方法と、よくある問題の解決策を包括的に解説します。
対応プラットフォーム¶
- macOS: 完全対応
- Linux: Ubuntu 20.04+、Debian 10+ 推奨
- Windows: WSL2が必要(推奨)
🔧 システム要件¶
共通要件¶
- Node.js: 18.0.0以降(LTS版推奨)
- npm: 9.0.0以降
- メモリ: 4GB以上(大規模プロジェクトは8GB推奨)
- ストレージ: 500MB以上の空き容量
API要件¶
- Anthropic APIキー: 有効なサブスクリプション
- インターネット接続: API通信用
🍎 macOS インストール¶
Step 1: Node.js のインストール¶
# Homebrew経由(推奨)
brew install node
# または公式インストーラー
# https://nodejs.org からダウンロード
# バージョン確認
node --version # v18.0.0以降
npm --version # 9.0.0以降
Step 2: Claude Code のインストール¶
# グローバルインストール
npm install -g @anthropic-ai/claude-code
# インストール確認
claude --version
Step 3: 初期設定¶
# プロジェクトディレクトリに移動
cd /path/to/your/project
# Claude Code起動
claude
macOS特有の最適化¶
# Xcodeコマンドラインツールの確認
xcode-select --install
# Homebrewの権限修正(必要に応じて)
sudo chown -R $(whoami) $(brew --prefix)/*
🐧 Linux インストール¶
Ubuntu/Debian系¶
# Node.js 18.x のインストール
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
# 依存関係のインストール
sudo apt-get update
sudo apt-get install -y build-essential curl git
# Claude Code インストール
npm install -g @anthropic-ai/claude-code
CentOS/RHEL系¶
# Node.js インストール
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo yum install -y nodejs npm
# 開発ツールのインストール
sudo yum groupinstall -y "Development Tools"
# Claude Code インストール
npm install -g @anthropic-ai/claude-code
Linux特有の最適化¶
# npm権限の設定(sudo不要にする)
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
# ファイル監視制限の増加(大規模プロジェクト用)
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
🪟 Windows インストール¶
WSL2 セットアップ(推奨)¶
# PowerShellを管理者として実行
wsl --install
# Ubuntu のインストール
wsl --install -d Ubuntu
# 再起動後、Ubuntuを起動
wsl
Windows内でのセットアップ¶
# WSL2内でのLinux手順に従う
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
# Claude Code インストール
npm install -g @anthropic-ai/claude-code
Windows特有の最適化¶
# WSL2のメモリ制限設定
# %USERPROFILE%\.wslconfig ファイルを作成
echo "[wsl2]
memory=8GB
processors=4" > /mnt/c/Users/$(whoami)/.wslconfig
# Linuxファイルシステムでの作業推奨
cd ~ # Windows の /mnt/c/ ではなくLinuxホームを使用
⚙️ API認証設定¶
Anthropic APIキーの取得¶
- Anthropic Console にアクセス
- アカウント登録・ログイン
- API Keys セクションでキーを生成
- キーを安全な場所に保存
認証方法¶
# 方法1: 環境変数(推奨)
export ANTHROPIC_API_KEY="your-api-key-here"
echo 'export ANTHROPIC_API_KEY="your-key"' >> ~/.bashrc
# 方法2: Claude起動時に設定
claude auth login
# 方法3: 設定ファイル
mkdir -p ~/.config/claude
echo "api_key: your-api-key-here" > ~/.config/claude/config.yaml
🚀 動作確認¶
基本動作テスト¶
# Claude Code起動
claude
# プロンプトで入力
"Hello, Claude! システム情報を教えて"
# ファイル操作テスト
claude "package.jsonの内容を確認して"
パフォーマンステスト¶
# 大きなプロジェクトでの動作確認
cd /path/to/large/project
claude "プロジェクト構造を分析して課題を報告"
# 応答時間測定(期待値: 2-5秒)
time claude "簡単なHello Worldスクリプトを作成"
⚠️ よくあるトラブル解決¶
インストールエラー¶
# 権限エラーの場合
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
# ネットワークエラーの場合
npm config set registry https://registry.npmjs.org/
npm cache clean --force
# Node.jsバージョンエラー
nvm install 18 # nvmを使用している場合
nvm use 18
起動エラー¶
# PATH設定確認
echo $PATH | grep npm
# 設定ファイル権限確認
ls -la ~/.config/claude/
# ログファイル確認
cat ~/.claude/logs/debug.log
API接続エラー¶
# 接続テスト
curl -H "x-api-key: your-key" https://api.anthropic.com/v1/models
# プロキシ設定(企業環境)
export HTTPS_PROXY=http://proxy.company.com:8080
export HTTP_PROXY=http://proxy.company.com:8080
💡 インストール後の推奨設定¶
プロジェクト設定¶
# CLAUDE.mdファイルの作成
cat > CLAUDE.md << 'EOF'
# プロジェクト設定
## 開発環境
- Node.js 18+
- TypeScript
- React
## コーディングルール
- ESLint/Prettier準拠
- テスト必須
- セキュリティ重視
## よく使うコマンド
- 開発: npm run dev
- テスト: npm test
- ビルド: npm run build
EOF
パフォーマンス最適化¶
# クラウドキャッシュ有効化
claude config set cache.enabled true
# 並列処理数の調整
claude config set max_concurrent_requests 3
# 応答時間の最適化
claude config set timeout 30
🔗 関連記事¶
📞 サポート¶
公式リソース¶
緊急時の対処¶
- 即座に確認: API制限状況、ネットワーク接続
- ログ確認:
~/.claude/logs/
ディレクトリ内のファイル - 一時的回避: ブラウザ版Claude(claude.ai)を使用