Claude Code: تثبيت Claude Code واستخدامه

# Check Node.js version
node --version
# Need v18+

# Check npm version
npm --version
# Need 9+

# If no Node.js, install with nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 20
nvm use 20

# Global install Claude Code
npm install -g @anthropic-ai/claude-code

# Verify installation
claude --version
# Output similar to: claude-code/1.0.x

# Run directly with npx (no global install needed)
npx @anthropic-ai/claude-code

# Build from source
git clone https://github.com/anthropics/claude-code.git
cd claude-code
npm install
npm run build
npm link

# Alice's complete installation process
node --version        # v20.11.0 ✓
npm --version         # 10.2.4 ✓

# Install Claude Code
npm install -g @anthropic-ai/claude-code

# Verify
claude --version      # claude-code/1.0.12 ✓

# First run (will guide authentication)
claude
# → Opening browser for authentication...
# → Authentication successful!

# Method 1: Environment variable (recommended)
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"

# Method 2: Write to shell config file
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"' >> ~/.bashrc
source ~/.bashrc

# Method 3: .env file
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)

# After selecting Anthropic Account:
# → Browser opens automatically
# → Login and authorize
# → "Authentication successful!"

# Navigate to your project directory
cd ~/my-project

# Launch Claude Code
claude

# Or launch with a task directly
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: Let me read the project structure...
  - src/
    - index.ts
    - routes/
    - utils/
  - package.json
  - tsconfig.json

> Modify index.ts, add a health check endpoint

Claude: I'll add a health check endpoint...
  → Reading src/index.ts
  → Modifying src/index.ts
  → Running: npm run build ✓

# Problem 1: npm install permission error
npm install -g @anthropic-ai/claude-code
# EACCES: permission denied
# Solution:
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

# Problem 2: Node.js version too low
node --version  # v16.x
# Solution:
nvm install 20
nvm use 20

# Problem 3: Network timeout
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# Problem 4: Windows path issues
# Ensure Node.js install path is in PATH
where node
where claude

# Complete installation to first use flow

# 1. Confirm environment
node --version && npm --version

# 2. Install
npm install -g @anthropic-ai/claude-code

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

# 4. Create test project
mkdir hello-claude && cd hello-claude
git init

# 5. First run
claude "Create an Express.js Hello World project"

# Claude Code output:
# → Initializing project...
# → Creating package.json
# → Installing express
# → Creating index.js
# → Creating .gitignore
# → Running: node index.js
# → Server started on port 3000 ✓