Claude Code: Claude Code のインストールと使用

# Node.js バージョンの確認
node --version
# v18+ が必要

# npm バージョンの確認
npm --version
# 9+ が必要

# Node.js がない場合、nvm でインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 20
nvm use 20

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

# インストールの確認
claude --version
# 出力例: claude-code/1.0.x

# npx で直接実行（グローバルインストール不要）
npx @anthropic-ai/claude-code

# ソースからビルド
git clone https://github.com/anthropics/claude-code.git
cd claude-code
npm install
npm run build
npm link

# Alice の完全なインストールプロセス
node --version        # v20.11.0 ✓
npm --version         # 10.2.4 ✓

# Claude Code をインストール
npm install -g @anthropic-ai/claude-code

# 確認
claude --version      # claude-code/1.0.12 ✓

# 初回起動（認証がガイドされます）
claude
# → ブラウザで認証ページを開いています...
# → 認証成功！

# 方法1：環境変数（推奨）
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"

# 方法2：シェル設定ファイルに書き込み
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"' >> ~/.bashrc
source ~/.bashrc

# 方法3：.env ファイル
echo 'ANTHROPIC_API_KEY=sk-ant-api03-xxxxx' > .env

$ claude

╭─────────────────────────────────────╮
│  Welcome to Claude Code!            │
│                                     │
│  Let's get you set up.              │
╰─────────────────────────────────────╯

? How would you like to authenticate?
  ❯ Anthropic Account (browser login)
    API Key
    OAuth (Enterprise)

# Anthropic Account を選択後：
# → ブラウザが自動的に開きます
# → ログインして認可
# → "Authentication successful!"

# プロジェクトディレクトリに移動
cd ~/my-project

# Claude Code を起動
claude

# またはタスクを指定して起動
claude "Help me add a user registration feature"

$ claude
╭─ Claude Code ─────────────────────────╮
│  Project: my-project                  │
│  Model: claude-sonnet-4-20250514      │
╰───────────────────────────────────────╯

> Show me the project structure

Claude: プロジェクト構造を読み取ります...
  - src/
    - index.ts
    - routes/
    - utils/
  - package.json
  - tsconfig.json

> Modify index.ts, add a health check endpoint

Claude: ヘルスチェックエンドポイントを追加します...
  → src/index.ts を読み取り中
  → src/index.ts を修正中
  → 実行中: npm run build ✓

# 問題1：npm install の権限エラー
npm install -g @anthropic-ai/claude-code
# EACCES: permission denied
# 解決策：
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

# 問題2：Node.js バージョンが低すぎる
node --version  # v16.x
# 解決策：
nvm install 20
nvm use 20

# 問題3：ネットワークタイムアウト
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 問題4：Windows のパス問題
# Node.js のインストールパスが PATH にあることを確認
where node
where claude

# インストールから初回使用までの完全なフロー

# 1. 環境を確認
node --version && npm --version

# 2. インストール
npm install -g @anthropic-ai/claude-code

# 3. 認証
export ANTHROPIC_API_KEY="sk-ant-api03-your-key"

# 4. テストプロジェクトを作成
mkdir hello-claude && cd hello-claude
git init

# 5. 初回起動
claude "Create an Express.js Hello World project"

# Claude Code の出力：
# → プロジェクトを初期化中...
# → package.json を作成中
# → express をインストール中
# → index.js を作成中
# → .gitignore を作成中
# → 実行中: node index.js
# → ポート3000でサーバー起動 ✓