Claude Code インストール完全ガイド【2026年版】認証6種類・エラー対処・初回設定

インストール方法（2種類）

方法A: npm（推奨・全OS対応）

# Node.js 18以上が必要
node --version  # v18.0.0 以上であること確認

# グローバルインストール
npm install -g @anthropic-ai/claude-code

# インストール確認
claude --version
# → Claude Code 2.1.132

方法B: Homebrew（macOS）

brew install anthropic/tap/claude

# または
brew tap anthropic/tap
brew install claude

認証方法6種類の設定

# 現在の認証状態を確認
claude auth status

1. APIキー（最もシンプル）

# 方法①: 環境変数（ターミナルセッション内のみ）
export ANTHROPIC_API_KEY=sk-ant-api03-...

# 方法②: ~/.zshrc に追記して永続化
echo 'export ANTHROPIC_API_KEY=sk-ant-api03-...' >> ~/.zshrc
source ~/.zshrc

# 方法③: claude config に設定
claude config set apiKey sk-ant-api03-...

2. Claude.ai OAuth（Proプラン向け）

# ブラウザが開いて認証ページが表示される
claude auth login

# ログイン後の確認
claude auth status
# → Logged in as: you@example.com (Pro plan)

3. AWS Bedrock経由

# AWS CLI設定後
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_DEFAULT_REGION=us-east-1

# IAMロールまたはアクセスキーで認証
aws configure

claude  # BedrockのClaudeモデルを使用

4. Google Cloud Vertex AI経由

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

# GCPのデフォルト認証
gcloud auth application-default login

claude

5. カスタムAPIエンドポイント（プロキシ）

export ANTHROPIC_BASE_URL=https://your-proxy.example.com
export ANTHROPIC_API_KEY=your-proxy-key

claude

6. プロファイルによる切り替え

# 複数のプロファイルを管理
claude config set --profile work apiKey sk-ant-work-...
claude config set --profile personal apiKey sk-ant-personal-...

# プロファイルを指定して起動
claude --profile work

初回セットアップ：CLAUDE.mdを作成する

# プロジェクトのルートディレクトリで
cd ~/my-project
claude

# CLAUDE.mdを対話的に生成（/initコマンド）
> /init

または手動で作成：

<!-- CLAUDE.md -->
# プロジェクトのルール

## 技術スタック
- Python 3.11 / FastAPI / PostgreSQL
- テスト: pytest
- コードフォーマット: black + isort

## 絶対ルール
- secretsやAPIキーをコードに直接書かない
- 変更前に既存のテストが通ることを確認する
- src/core/以下は変更前にユーザーに確認する

よくあるエラーと解決策

# エラー1: command not found: claude
# → npmのパスが通っていない
export PATH="$(npm bin -g):$PATH"
# または
echo 'export PATH="$(npm bin -g):$PATH"' >> ~/.zshrc

# エラー2: AuthenticationError (401)
# → APIキーが無効または未設定
echo $ANTHROPIC_API_KEY  # 空の場合は未設定
claude config set apiKey sk-ant-...

# エラー3: PermissionDeniedError (403)
# → アカウントが停止、または権限不足
# support.anthropic.com でステータス確認

# エラー4: RateLimitError (429)
# → リクエスト制限超過
# 数秒待ってから再試行。プランのアップグレードも検討

# エラー5: EACCES permission denied (npm install -g)
# → npmのグローバルインストール権限なし
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code

動作確認

# バージョン確認
claude --version

# 非対話モードで簡単なテスト
claude --print "Hello! 日本語で返事してください"

# プロジェクトに移動して起動
cd ~/my-project
claude
> このプロジェクトの構造を説明して

あわせて読みたい

• Claude Codeセットアップ完全ガイド【macOS/Windows/WSL】詳細版
• Claude Code 403エラー（PermissionDeniedError）の原因と解決策
• Claude Code できること完全リスト【2026年版】