# نصب

> ⚡ **توصیه‌شده: راه‌اندازی یک‌کلیکی** — یک فرمان واحد همه کارهای این صفحه را انجام می‌دهد (تست سرعت نقطه پایانی، پیکربندی، نصب Node.js / Claude Code، بررسی اتصال؛ بدون sudo). برای نصب دستی به خواندن ادامه دهید.

```bash
# macOS / Linux
curl -fsSL https://qcode.cc/install/claude-code.sh | bash
```

```powershell
# Windows PowerShell
irm https://qcode.cc/install/claude-code.ps1 | iex
```

> برای دیدن گزینه‌ها، رفع اشکال و بازگردانی، [اسکریپت راه‌اندازی یک‌کلیکی](/docs/getting-started/one-click-install) را ببینید.

> 📖 نمی‌دانید در `ANTHROPIC_BASE_URL` چه بگذارید یا کدام‌یک از سه دامنه دسترسی را انتخاب کنید؟ [نقاط پایانی و مسیرهای API](./endpoints-and-api-paths) را ببینید.

با دنبال کردن این راهنما، Claude Code را به‌سادگی روی رایانه خود نصب و استفاده می‌کنید. کل فرایند تنها 5 دقیقه طول می‌کشد.

## پیش‌نیازها

Claude Code برای اجرا به Node.js نیاز دارد. لطفاً مطمئن شوید Node.js نسخه 18.0 یا بالاتر روی رایانه شما نصب است (نسخه 22 LTS توصیه می‌شود).

<div data-os="windows" markdown="1">

## Windows

### گام 1: نصب Node.js

#### گزینه A: دانلود رسمی (توصیه‌شده)

1. مرورگر خود را باز کنید و به [https://nodejs.org/](https://nodejs.org/) بروید

2. روی دانلود نسخه «LTS» کلیک کنید (نسخه پشتیبانی بلندمدت توصیه‌شده)

3. روی فایل `.msi` دانلودشده دوبار کلیک کنید

4. ویزارد نصب را با تنظیمات پیش‌فرض دنبال کنید

#### گزینه B: استفاده از مدیر بسته

اگر Chocolatey یا Scoop نصب دارید:

```powershell
# Using Chocolatey
choco install nodejs

# Or using Scoop
scoop install nodejs
```

#### بررسی نصب

```powershell
node --version
npm --version
```

### گام 2: نصب Claude Code

PowerShell یا CMD را باز کنید:

```powershell
npm install -g @anthropic-ai/claude-code
```

بررسی نصب:

```powershell
claude --version
```

### گام 3: تنظیم متغیرهای محیطی

#### موقت (نشست کنونی)

```powershell
$env:ANTHROPIC_BASE_URL = "https://api.qcode.cc/api"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key"
```

#### دائمی (توصیه‌شده)

```powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.qcode.cc/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-api-key", [System.EnvironmentVariableTarget]::User)
```

> `your-api-key` را با کلید واقعی خود از [داشبورد QCode.cc](https://qcode.cc/dashboard) جایگزین کنید.

#### بررسی تنظیمات

```powershell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
```

### گام 4: شروع استفاده

```powershell
# Go to your project directory
cd C:\path\to\your\project

# Start Claude Code
claude
```

### پرسش‌های متداول Windows

**خطای دسترسی؟**

- PowerShell را با دسترسی Administrator اجرا کنید

- یا npm را به پوشه کاربری خود اشاره دهید: `npm config set prefix %APPDATA%\npm`

**خطای سیاست اجرای PowerShell؟**

```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

**متغیرهای محیطی اعمال نمی‌شوند؟**

- پس از تنظیم دائمی، PowerShell یا CMD را دوباره راه‌اندازی کنید

- یا از Windows خارج شوید و دوباره وارد شوید

</div>

<div data-os="macos" markdown="1">
## macOS

### گام 1: نصب Node.js

#### گزینه A: استفاده از Homebrew (پیشنهادی)

```bash
brew update
brew install node
```

#### گزینه B: دانلود رسمی

1. به [https://nodejs.org/](https://nodejs.org/) مراجعه کنید.

2. نسخه LTS برای macOS را دانلود کنید.

3. فایل `.pkg` دانلودشده را باز کنید.

4. دستورالعمل‌های نصب را دنبال کنید.

#### بررسی نصب

```bash
node --version
npm --version
```

### گام 2: نصب Claude Code

#### گزینه A: استفاده از npm

```bash
npm install -g @anthropic-ai/claude-code
```

اگر با مشکلات مجوز مواجه شدید:

```bash
sudo npm install -g @anthropic-ai/claude-code
```

#### گزینه B: استفاده از Homebrew

```bash
brew install --cask claude-code
```

### گام 3: تنظیم متغیرهای محیطی

#### موقت (جلسه فعلی)

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"
```

#### دائمی (پیشنهادی)

فایل پیکربندی پوسته خود را ویرایش کنید:

```bash
# For zsh (macOS default)
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc

# For bash
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bash_profile
source ~/.bash_profile
```

> `your-api-key` را با کلید واقعی خود از [داشبورد QCode.cc](https://qcode.cc/dashboard) جایگزین کنید.

### گام 4: شروع استفاده

```bash
# Go to your project directory
cd /path/to/your/project

# Start Claude Code
claude
```

### پرسش‌های متداول macOS

**خطای مجوز؟**

- نصب با sudo: `sudo npm install -g @anthropic-ai/claude-code`

- یا npm را روی پوشه کاربری خود تنظیم کنید: `npm config set prefix ~/.npm-global`

**آیا macOS باینری را مسدود می‌کند؟**

- «System Settings» → «Privacy & Security» را باز کنید.

- روی «Open Anyway» یا «Allow» کلیک کنید.

</div>

<div data-os="linux" markdown="1">

## Linux / WSL2

### گام 1: نصب Node.js

#### گزینه A: استفاده از NodeSource (پیشنهادی)

```bash
# Add the NodeSource repository
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# Install Node.js
sudo apt-get install -y nodejs
```

#### گزینه B: استفاده از مدیر بسته سیستم

```bash
# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm
```

#### بررسی نصب

```bash
node --version
npm --version
```

### گام 2: نصب Claude Code

```bash
npm install -g @anthropic-ai/claude-code
```

اگر با مشکل مجوز مواجه شدید:

```bash
sudo npm install -g @anthropic-ai/claude-code
```

نصب را بررسی کنید:

```bash
claude --version
```

### گام 3: تنظیم متغیرهای محیطی

#### موقت

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"
```

#### دائمی

```bash
# For bash (default)
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bashrc
source ~/.bashrc

# For zsh
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc
```

### گام 4: شروع استفاده

```bash
cd /path/to/your/project
claude
```

### پرسش‌های متداول Linux

**کمبود وابستگی‌های ساخت؟**

```bash
# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"
```

</div>
## پیکربندی پیشرفته (متغیرهای محیطی اختیاری)

علاوه بر دو متغیر الزامی، می‌توانید با این متغیرهای اختیاری سفارشی‌سازی بیشتری انجام دهید:

### ANTHROPIC_MODEL

مدل پیش‌فرض را مشخص کنید. توصیه می‌کنیم Sonnet 5 را به‌صورت صریح تنظیم کنید. اگر تنظیم نشود، Claude Code از پیش‌فرض داخلی خود برای همان نسخه CLI استفاده می‌کند — به نام پیش‌فرض تاریخی این صفحه تکیه نکنید. شناسه‌های 4.x مانند `claude-sonnet-4-6` و `claude-opus-4-8` همچنان قابل خرید هستند.

```bash
# Daily recommendation (Sonnet 5)
export ANTHROPIC_MODEL=claude-sonnet-5

# Heavy work (Opus 5, higher cost)
export ANTHROPIC_MODEL=claude-opus-5
```

### MAX_THINKING_TOKENS

حداکثر توکن‌های فرایند تفکر مدل را کنترل کنید (برای غیرفعال‌سازی مقدار 0 را تنظیم کنید):

```bash
export MAX_THINKING_TOKENS=16000
```

### CLAUDE_CODE_EFFORT_LEVEL

سطح تلاش Claude را تنظیم کنید:

```bash
# Options: low / medium / high
export CLAUDE_CODE_EFFORT_LEVEL=high
```

### CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

درخواست‌های شبکه‌ای غیرضروری (مثلاً تلمتری) را غیرفعال کنید:

```bash
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

## گام‌های بعدی

تبریک می‌گوییم! Claude Code را با موفقیت نصب کردید. در ادامه:

1. [شروع سریع](/docs/getting-started/quick-start) را ببینید تا استفاده پایه را بیاموزید

2. [نکات CLI](/docs/usage/cli-tips) را بررسی کنید تا بهره‌وری را افزایش دهید