نصب

نصب و پیکربندی Claude Code در Windows، macOS و Linux

به‌روزرسانی 2026-11-13

به کلید API نیاز دارید؟ ثبت‌نام ←نقاط پایانی و Base URL ←

در این صفحه

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

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

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

برای دیدن گزینه‌ها، رفع اشکال و بازگردانی، اسکریپت راه‌اندازی یک‌کلیکی را ببینید.

📖 نمی‌دانید در ANTHROPIC_BASE_URL چه بگذارید یا کدام‌یک از سه دامنه دسترسی را انتخاب کنید؟ نقاط پایانی و مسیرهای API را ببینید.

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

پیش‌نیازها

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

Windows

گام 1: نصب Node.js

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

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

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

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

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

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

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

# Using Chocolatey
choco install nodejs

# Or using Scoop
scoop install nodejs

بررسی نصب

node --version
npm --version

گام 2: نصب Claude Code

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

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

بررسی نصب:

claude --version

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

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

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

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

[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 جایگزین کنید.

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

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

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

# 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؟

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

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

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

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

macOS

گام 1: نصب Node.js

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

brew update
brew install node

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

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

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

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

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

بررسی نصب

node --version
npm --version

گام 2: نصب Claude Code

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

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

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

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

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

brew install --cask claude-code

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

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

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

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

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

# 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 جایگزین کنید.

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

# 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» کلیک کنید.

Linux / WSL2

گام 1: نصب Node.js

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

# 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: استفاده از مدیر بسته سیستم

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

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

بررسی نصب

node --version
npm --version

گام 2: نصب Claude Code

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

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

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

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

claude --version

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

موقت

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

دائمی

# 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: شروع استفاده

cd /path/to/your/project
claude

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

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

# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"

پیکربندی پیشرفته (متغیرهای محیطی اختیاری)

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

ANTHROPIC_MODEL

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

# 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 را تنظیم کنید):

export MAX_THINKING_TOKENS=16000

CLAUDE_CODE_EFFORT_LEVEL

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

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

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

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

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

گام‌های بعدی

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

  1. شروع سریع را ببینید تا استفاده پایه را بیاموزید

  2. نکات CLI را بررسی کنید تا بهره‌وری را افزایش دهید

قبلی →
نقطه‌های پایانی و مسیرهای API
← بعدی
متغیرهای محیطی
متغیرهای محیطی
تنظیم ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN برای Claude Code روی QCode.cc، مشاهده تفاوت ANTHROPIC_API_KEY، به‌همراه تنظیمات هر ابزار و راستی‌آزمایی.
شروع سریع
مبانی Claude Code را در 5 دقیقه بیاموزید
راه‌اندازی CC Switch
CC Switch v4.0.28 (2026-11-08): ccswitch.io تنها وب‌سایت رسمی است. از GitHub Releases دانلود کنید، سپس QCode.cc را به Claude Code یا Codex CLI اضافه کنید.
نقطه‌های پایانی و مسیرهای API
پروتکل‌های API Anthropic و OpenAI در QCode.cc (مسیر Gemini در حال حاضر در دسترس نیست)، سه دامنه دسترسی، و نحوه پر کردن BASE_URL

با QCode شروع کنید

یک کلید API برای Claude Code، Codex و بیشتر — بر اساس توکن، قیمت هر مدل در qcode.cc/models

ایجاد حساب مشاهده پلن‌های قیمت‌گذاری ←

سازمانی ←