نصب تک‌کلیکی Claude Code: macOS، Linux و Windows
تا تاریخ 2026-10-07، روش نصبی که Anthropic برای Claude Code بهعنوان روش توصیه‌شده علامت‌گذاری میکند نصب بومی است: در macOS، Linux یا WSL دستور curl -fsSL https://claude.ai/install.sh | bash و در Windows PowerShell دستور irm https://claude.ai/install.ps1 | iex را اجرا کنید؛ Homebrew، WinGet و npm نیز کار می‌کنند. برای اتصال به QCode، اسکریپت راه‌اندازی تک‌کلیکی QCode این کار را با یک دستور انجام میدهد: یک نقطه پایانی را بر اساس تأخیر انتخاب میکند، پیکربندی را مینویسد، در صورت نیاز Node.js و CLI را نصب میکند و اتصال را بررسی میکند. این صفحه دستورهای هر دو مسیر، نحوه تأیید نصب و خطاهای رایج نصب را فهرست میکند.
بهروزرسانی شده 2026-11-13
این ابزار را به نقطه پایانی QCode متصل کنید — یک کلید برای Claude، GPT و مدل‌های چینی.
- صورت‌حساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- به‌صورت خودخدمت: شارژ حساب و فعال‌سازی فوری
چهار نکته که ابتدا باید بدانید
نصبکننده رسمی، یکی برای هر شل
install.sh برای macOS، Linux و WSL، install.ps1 برای Windows PowerShell، و install.cmd برای Windows CMD. Anthropic این را بهعنوان روش توصیه‌شده علامت‌گذاری میکند و خودش در پس‌زمینه بهروزرسانی میشود.
موردنیاز بسته npm
مستندات رسمی می‌گویند بسته npm به Node.js 22 یا جدیدتر نیاز دارد؛ در نسخه‌های قدیمی‌تر، npm فقط هشدار EBADENGINE را چاپ میکند و نصب همچنان کامل میشود. npm همان باینری بومی نصبکننده رسمی را نصب میکند.
اسکریپت راه‌اندازی تک‌کلیکی QCode
در macOS یا Linux دستور curl -fsSL https://qcode.cc/install/claude-code.sh | bash را اجرا کنید؛ در Windows PowerShell دستور irm https://qcode.cc/install/claude-code.ps1 | iex را اجرا کنید. به sudo و حقوق مدیر نیازی نیست.
اولین بررسی پس از نصب
نصب سالم یک شماره نسخه مانند 2.1.211 (Claude Code) چاپ میکند. برای بررسی دقیق‌تر، claude doctor را اجرا کنید؛ درون یک نشست، /status تأیید میکند کدام روش احراز هویت فعال است.
کدام روش‌های نصب رسمی هستند
تا تاریخ 2026-10-07، صفحه راه‌اندازی Claude Code نصبکننده رسمی (Native Install، علامت‌گذاری‌شده بهعنوان توصیه‌شده)، Homebrew (brew install --cask claude-code)، WinGet (winget install Anthropic.ClaudeCode) و npm (npm install -g @anthropic-ai/claude-code) را فهرست میکند؛ Debian، Fedora، RHEL و Alpine نیز میتوانند از مخازن امضاشده apt، dnf و apk متعلق به Anthropic استفاده کنند. تفاوت اصلی در بهروزرسانی است: نصبکننده رسمی در پس‌زمینه بهروزرسانی میشود، اما نصب‌های Homebrew و WinGet به‌طور خودکار بهروزرسانی نمی‌شوند. Homebrew دو cask دارد: claude-code کانال stable را دنبال میکند، معمولاً حدود یک هفته عقب‌تر است و انتشارهای دارای رگرسیون عمده را رد میکند، و claude-code@latest کانال latest را دنبال میکند. نیازمندی‌های سیستم: macOS 13.0+، Windows 10 1809+ یا Windows Server 2019+، Ubuntu 20.04+، Debian 10+، Alpine Linux 3.19+، 4 GB+ RAM و پردازنده x64 یا ARM64.
نسخه‌ها و مستندات تا تاریخ 2026-10-07
تا تاریخ 2026-10-07، آخرین انتشار Claude Code در GitHub Releases نسخه v2.1.292 است که در 2026-10-06 (UTC) منتشر شده است؛ آخرین برچسب @anthropic-ai/claude-code در npm نیز 2.1.292 است و فراداده بسته آن node >=22.0.0 را فهرست میکند. صفحه‌های مستندات QCode برای اسکریپت راه‌اندازی تک‌کلیکی و راهنمای نصب، هر دو در 2026-09-25 بهعنوان به‌روزرسانی‌شده علامت‌گذاری شده‌اند؛ راهنمای نصب با توصیه اسکریپت تک‌کلیکی آغاز میشود و میگوید که این اسکریپت همه مراحل آن صفحه را با یک دستور کامل میکند. اسکریپت عمومی claude-code.sh روی qcode.cc رشته نسخه 2026.10.07.1 را در سورس خود دارد.
خط زمانی
صفحه‌های مستندات QCode برای اسکریپت راه‌اندازی تک‌کلیکی و راهنمای نصب بهروزرسانی شدند؛ تا تاریخ 2026-10-07، راهنمای نصب اسکریپت تک‌کلیکی را توصیه میکند.
Claude Code v2.1.292 در GitHub Releases (UTC) منتشر شد، آخرین انتشار تا تاریخ 2026-10-07؛ برچسب latest در npm نیز 2.1.292 است.
سورس اسکریپت عمومی claude-code.sh نسخه 2026.10.07.1 را دارد؛ دستورها، پیام‌های خطا و رفتار اسکریپت در این صفحه در این تاریخ با صفحه‌های رسمی و سورس اسکریپت بررسی شد.
تأیید‌شده در مقابل مستند‌نشده
تأیید‌شده (عیناً در مستندات)
همه موارد زیر را می‌توانید واژه‌به‌واژه در مستندات Claude Code، GitHub Releases، فراداده بسته npm یا مستندات QCode و کد منبع عمومی اسکریپت بیابید: سه فرمان نصب رسمی و توصیه Native Install؛ بهروزرسانی خودکار پس‌زمینه برای نصبکننده رسمی و نبود آن برای Homebrew و WinGet؛ نیاز بسته npm به Node.js 22 یا جدیدتر و نصب همان باینری بومی؛ هشدار Anthropic که از sudo npm install -g استفاده نکنید؛ اینکه نصب روی Windows نیازی به اجرا با Administrator ندارد؛ کاربرد claude --version، claude doctor و /status؛ فرمان‌های اسکریپت تک‌کلیک QCode، چهار گام آن (انتخاب نقطه پایانی، نوشتن پیکربندی، نصب Node.js و CLI در صورت نیاز، بررسی اتصال)، پشتیبانگیری و بازگردانی؛ و اینکه متغیرهایی که کد منبع اسکریپت مینویسد شامل ANTHROPIC_BASE_URL، ANTHROPIC_AUTH_TOKEN و CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 هستند.
مستند نشده یا در اینجا تأیید نشده است
سه موضوعی که این صفحه درباره آن‌ها نتیجه‌گیری نمی‌کند: نخست، بسته npm به Node.js 22 یا جدیدتر نیاز دارد، اما Anthropic همچنین میگوید Node.js قدیمی‌تر فقط یک هشدار EBADENGINE ایجاد میکند و نصب همچنان کامل میشود؛ اسکریپت QCode هنگام نبود Node.js یک نسخه LTS نصب میکند و این صفحه درباره رفتار روی هیچ نسخه مشخصی از Node.js گمانه‌زنی نمی‌کند. دوم، نصب روی هر سیستم‌عاملی گام‌به‌گام آزمایش نشده است؛ فرمان‌ها از مستندات رسمی و مستندات QCode که در 2026-10-07 دریافت شده‌اند پیروی می‌کنند و سیستم و نسخه خود شما اولویت دارند. سوم، 2.1.211 در مستندات رسمی فقط نمونه‌ای از قالب خروجی است، نه آخرین نسخه فعلی.
نصبکننده رسمی، npm یا اسکریپت QCode
نصبکننده رسمی در برابر npm
Anthropic، Native Install را بهعنوان گزینه توصیه‌شده علامت‌گذاری میکند و این گزینه خود را در پس‌زمینه بهروزرسانی میکند؛ برای خطاهای مجوز مخصوص npm، راهحل رسمی روی آوردن به آن است. روش npm به Node.js 22 یا جدیدتر نیاز دارد و همان باینری بومی را نصب میکند؛ با npm install -g @anthropic-ai/claude-code@latest بهروزرسانی کنید و مستندات هشدار میدهد که از npm update -g و از sudo npm install -g استفاده نکنید. Homebrew و WinGet برای کسانی مناسب‌اند که از قبل از این مدیران بسته استفاده می‌کنند، اما بهروزرسانی خودکار ندارند.
Claude Code به‌تنهایی در برابر اسکریپت QCode
نصبکننده رسمی فقط Claude Code را نصب میکند؛ در مسیر رسمی سپس با یک حساب کاربری Pro، Max، Team، Enterprise یا Console وارد می‌شوید. اسکریپت تک‌کلیک QCode اتصال را نیز راه‌اندازی میکند: نقطه پایانی را بر اساس تأخیر انتخاب میکند، ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN را مینویسد، در صورت نبود Node.js یک نسخه LTS را از طریق nvm یا winget و سپس CLI را از طریق npm نصب میکند، و در پایان یک درخواست حداقلی با کلید شما برای بررسی می‌فرستد. اگر Claude Code از قبل نصب شده است و فقط پیکربندی QCode را می‌خواهید، --no-install را اضافه کنید.
گام‌به‌گام، هر دو مسیر
مسیر رسمی: (1) یک ترمینال باز کنید و فرمان مناسب سیستم خود را اجرا کنید: در macOS، Linux یا WSL، curl -fsSL https://claude.ai/install.sh | bash؛ در Windows PowerShell، irm https://claude.ai/install.ps1 | iex؛ در Windows CMD، curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. (2) یک پنجره ترمینال جدید باز کنید و claude --version را اجرا کنید تا تأیید شود شماره نسخه چاپ میشود. (3) claude را در پوشه پروژه خود اجرا کنید. مسیر QCode: (1) یک کلید API که با cr_ شروع میشود از داشبورد QCode دریافت کنید. (2) در macOS یا Linux فرمان curl -fsSL https://qcode.cc/install/claude-code.sh | bash را اجرا کنید؛ در Windows فرمان irm https://qcode.cc/install/claude-code.ps1 | iex را در PowerShell اجرا کنید و وقتی از شما خواسته شد کلید را جای‌گذاری کنید (ورودی نمایش داده نمی‌شود). (3) یک ترمینال جدید باز کنید تا پیکربندی اعمال شود (در Windows، ویرایشگرهایی مانند VS Code را نیز یک‌بار دوباره راه‌اندازی کنید)، claude --version را اجرا کنید، سپس claude را شروع کنید و از /status برای تأیید روش احراز هویت استفاده کنید. برای پیکربندی دستی، راهنمای نصب QCode دو متغیر را تنظیم میکند: ANTHROPIC_BASE_URL=https://api.qcode.cc/api و ANTHROPIC_AUTH_TOKEN برابر کلید شما. اگر فرمان نصب با syntax error near unexpected توکن '<' یا یک 403 شکست خورد، مستندات میگوید URL نصب بهجای اسکریپت یک صفحه وب یا وضعیت خطا برگردانده است: روی macOS با Homebrew یا روی Windows با WinGet نصب کنید، یا بعد از چند دقیقه دوباره تلاش کنید.
در QCode
در QCode، Claude Code از نقطه پایانی پروتکل Anthropic استفاده میکند: ANTHROPIC_BASE_URL را روی https://api.qcode.cc/api تنظیم کنید (تا /api، بدون اسلش انتهایی) و ANTHROPIC_AUTH_TOKEN را روی یک کلید cr_ که در داشبورد ساخته‌اید قرار دهید؛ Claude Code آن را در هدر Authorization با پیشوند Bearer می‌فرستد. در macOS و Linux، متغیرهایی که اسکریپت در بلوک shell مدیریتشده مینویسد شامل CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 نیز هست که راهنمای نصب QCode آن را غیرفعال‌کردن درخواست‌های شبکه‌ای غیرضروری مانند telemetry توصیف میکند. به‌طور پیش‌فرض اسکریپت یککلیکی ANTHROPIC_MODEL را نمی‌نویسد، بنابراین Claude Code مدل پیش‌فرض داخلی خود را حفظ میکند و به‌روزرسانی‌هایش را دنبال میکند؛ برای تثبیت یک مدل، --model را بدهید، مثلاً claude-sonnet-5-5 یا claude-opus-5-5. سایر مدل‌های Claude مانند claude-sonnet-5 نیز به همین شکل قابل فراخوانی هستند. صورت‌حساب بر پایه توکن است، قیمت هر مدل در /models آمده و مدل‌های Claude لایه جداگانه‌ای برای زمینه بلند ندارند.
پرسش‌های متداول
چگونه Claude Code را روی Windows نصب کنم؟
در PowerShell دستور irm https://claude.ai/install.ps1 | iex را اجرا کنید؛ در CMD دستور curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd را اجرا کنید. نیازی نیست بهعنوان Administrator اجرا کنید و winget install Anthropic.ClaudeCode هم کار میکند. Anthropic از Windows 10 1809+ یا Windows Server 2019+ پشتیبانی میکند. Git for Windows اختیاری است: با آن، Claude Code از Git Bash استفاده میکند؛ بدون آن، Claude Code از PowerShell بهعنوان ابزار shell استفاده میکند. برای WSL، دستور نصب Linux را داخل ترمینال WSL اجرا کنید و claude را همانجا اجرا کنید. برای اتصال به QCode، دستور irm https://qcode.cc/install/claude-code.ps1 | iex را در PowerShell اجرا کنید.
بعد از نصب پیام «command not found: claude» یا «claude is not recognized» را میگیرید؟
معمولاً پوشه نصب هنوز در PATH شما نیست، بنابراین ابتدا یک پنجره ترمینال جدید باز کنید و دوباره تلاش کنید: مستندات اشاره میکند که جلسهای که از آن نصب کردید PATH قدیمی خود را نگه میدارد. نصبکننده رسمی claude را در macOS و Linux در ~/.local/bin/claude و در Windows در %USERPROFILE%\.local\bin\claude.exe قرار میدهد؛ کاربران Zsh میتوانند echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc را اجرا کنند و Bash در Linux همان خط را در ~/.bashrc میپذیرد. اگر پس از اجرای اسکریپت QCode در Windows دستور یافت نشد، مستندات QCode همان راهحل را ارائه میدهد: یک پنجره PowerShell جدید باز کنید.
پیام «irm is not recognized» یا «The توکن '&&' is not a valid statement separator» را میگیرید؟
دستور با shell شما همخوانی ندارد. مستندات میگوید پیام «irm is not recognized» یعنی در CMD هستید، پس از دستور CMD استفاده کنید یا PowerShell را باز کنید؛ پیام «The توکن '&&' is not a valid statement separator» یعنی دستور CMD را در PowerShell اجرا کردهاید. اجرای curl -fsSL ... | bash در PowerShell روی پارامتر fsSL شکست میخورد، چون curl در PowerShell نام مستعار Invoke-WebRequest است. برای اسکریپت QCode در CMD، دستور powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://qcode.cc/install/claude-code.ps1 | iex" را اجرا کنید.
PowerShell پیام «running scripts is disabled on this system» را نشان میدهد؟
سیاست اجرا، اسکریپتهای راهانداز .ps1 را که npm میسازد مسدود میکند. مستندات سه راهحل میدهد: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser را اجرا کنید و دوباره تلاش کنید؛ بهجای آن npm.cmd و claude.cmd را فراخوانی کنید؛ یا npm را رها کنید و از نصبکننده PowerShell استفاده کنید که یک باینری نصب میکند نه اسکریپت .ps1. اسکریپت یککلیکی QCode سیاست اجرا را فقط برای اجرای خودش تسهیل میکند و تنظیمات سطح کاربر و سطح ماشین شما را دست نمیزند؛ برای اینکه جلسههای بعدی PowerShell مسدود نباشند، مستندات QCode دستور Set-ExecutionPolicy -Scope CurrentUser RemoteSigned را ارائه میدهد.
نصب npm با خطای EACCES شکست میخورد. آیا از sudo استفاده کنم؟
خیر. Anthropic میگوید از sudo npm install -g استفاده نکنید، چون میتواند به مشکلات دسترسی و ریسکهای امنیتی منجر شود؛ اگر قبلاً با npm نصب کردهاید و به خطاهای دسترسی مخصوص npm برخوردهاید، مستندات توصیه میکند به نصبکننده رسمی یعنی curl -fsSL https://claude.ai/install.sh | bash روی بیاورید. اسکریپت QCode هم به sudo نیاز ندارد: اجرای آن با sudo پیکربندی را در پوشه home کاربر root مینویسد که shell خودتان هرگز آن را نمیخواند، پس آن را بدون sudo دوباره اجرا کنید.
بررسی اسکریپت QCode با 401، 404 یا تایماوت شکست خورد. حالا چه کنم؟
بر اساس کد وضعیت عمل کنید. مستندات QCode میگوید 401 یعنی کلید نامعتبر یا منقضی شده است: در داشبورد بررسی کنید که پیشوند کامل cr_ کپی شده باشد، سپس دوباره اجرا کنید؛ 404 یعنی URL نقطه پایانی اشتباه است: برای Claude Code، مقدار ANTHROPIC_BASE_URL باید شبیه https://api.qcode.cc/api باشد، بدون اسلش انتهایی؛ در صورت timeout، دوباره با پرچم --domain اجرا کنید تا نقطه پایانی دیگری انتخاب شود. اگر اسکریپت میگوید پیکربندی نوشته شد اما تأیید نشد، پیکربندی از قبل برقرار است؛ بنابراین علت را برطرف کنید و دوباره اجرا کنید. اجرای دوباره همیشه ایمن است: بلوک مدیریتشده در همان محل بهروزرسانی میشود و فایلها پیش از بازنویسی پشتیبانگیری میشوند.
منابع
روش‌های نصب، پیش‌نیازها و به‌روزرسانی‌ها: صفحات راه‌اندازی پیشرفته و شروع سریع مستندات Claude Code (code.claude.com). خطاها و رفع آن‌ها: صفحه رسمی عیب‌یابی نصب و ورود. معنی متغیرها: صفحات رسمی متغیرهای محیطی و احراز هویت. نسخه‌ها: GitHub Releases و CHANGELOG مربوط به anthropics/claude-code، و فراداده npm برای @anthropic-ai/claude-code. بخش QCode: صفحات مستندات QCode برای اسکریپت راه‌اندازی یککلیکی و راهنمای نصب (هر دو به‌روزرسانی‌شده در 2026-09-25)، به‌علاوه اسکریپت عمومی claude-code.sh در qcode.cc (فقط خوانده شده، اجرا نشده). همه در 2026-10-07 واکشی شده‌اند.
با یک فرمان نصب کنید و به QCode متصل شوید
کلید cr_ خود را آماده داشته باشید و اسکریپت راه‌اندازی یککلیکی را اجرا کنید. صورت‌حساب بر اساس توکن است؛ قیمت هر مدل در /models آمده است.
مطالب مرتبط
راه‌اندازی magpie برای Claude Code: درگاه محلی برای Claude Code و Codex (2026-11)
راه‌اندازی magpie: فرمان‌های نصب و حذف، سه روش برای افزودن ارائه‌دهنده، انتخاب مدل برای Claude Code و Codex، و سه آدرس QCode.
راهنمای پیکربندی ANTHROPIC_BASE_URL و AUTH_TOKEN
Claude Code را با دو متغیر محیطی به یک نقطه پایانی سفارشی متصل کنید.
نحوه استفاده از Claude Code در چین
مراحل پرداخت و راه‌اندازی با Alipay / WeChat.
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
فرمان‌ها و نقل‌قول‌های این صفحه در 2026-10-07 بررسی شده‌اند؛ مستندات رسمی Claude Code و مستندات QCode اولویت دارند و تغییرات ممکن است بدون اطلاع قبلی رخ دهند. فرمان‌های نصب و متن خطاها بین نسخه‌ها تغییر می‌کنند، پس بر اساس نسخه‌ای که دارید عمل کنید؛ در دسترس بودن مدل‌ها همان است که در /models فهرست شده است.