راهنمای کاربر Claude Code
آموزش کامل ابزار CLI Claude Code، از نصب تا تسلط. با برنامه‌نویسی به‌کمک هوش مصنوعی شروع کنید و بهره‌وری توسعه خود را افزایش دهید.
شروع سریع
سه گام برای شروع استفاده از Claude Code
دریافت کلید API
در کنسول QCode یک کلید API بسازید (با cr_ شروع می‌شود)؛ Claude Code از آن برای فراخوانی مدل‌ها استفاده می‌کند
نصب ابزار CLI
ابزار خط فرمان Claude Code را دانلود و نصب کنید
شروع کدنویسی
متغیرهای محیطی را پیکربندی کنید و سفر کدنویسی به‌کمک هوش مصنوعی خود را آغاز کنید
راهنمای تفصیلی کاربر
نصب و راه‌اندازی
Claude Code CLI را به‌سرعت نصب و پیکربندی کنید
نمونه نصب
# نصب Claude Code با npm
npm install -g @anthropic-ai/claude-code
# پیکربندی نقطه پایانی API (با استفاده از پروکسی QCode)
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
# پیکربندی کلید API
export ANTHROPIC_AUTH_TOKEN="cr_your-key"
# اجرای Claude Code
claude
استفاده پایه
بر قابلیت‌های اصلی Claude Code مسلط شوید
نمونه دستورهای پایه
# اجرای Claude Code در پوشه پروژه
cd your-project && claude
# پرسش مستقیم
claude "explain what this function does"
# ادامه نشست قبلی
claude --continue
قابلیت‌های پیشرفته
از قابلیت‌های قدرتمند Claude Code به‌طور کامل استفاده کنید
عیب‌یابی
رفع مشکلات رایج استفاده
قابلیت‌های پیشرفته Claude Code
بر جدیدترین قابلیت‌ها مسلط شوید تا بهره‌وری توسعه را افزایش دهید
Claude Fable 5.1
Anthropic آن را به‌عنوان هوش نسل بعدی برای استدلال‌های پیچیده و کارهای عاملی بلندمدت معرفی می‌کند، با پنجره زمینه 1M
عامل‌های پس‌زمینه
نشست‌های پس‌زمینه را با claude agents اعزام کنید: آن‌ها بدون اتصال ترمینال به اجرا ادامه می‌دهند. مستندات رسمی می‌گویند هر نشست به‌صورت مستقل از سهمیه اشتراک استفاده می‌کند؛ یعنی سهمیه اشتراک claude.ai؛ نمای عامل هنوز پیش‌نمایش پژوهشی است
خودکارسازی Hooks
فرمان‌ها را به‌صورت خودکار روی رویدادها اجرا کنید: PreToolUse و PostToolUse هر فراخوانی ابزار در حلقه عامل را پوشش می‌دهند
زیرعامل‌های موازی
وظایف را به زیرعامل‌ها بسپارید: هرکدام در پنجره زمینه خود اجرا می‌شود، فقط یک خلاصه برمی‌گرداند و درخواست‌هایش در همان محدودیت‌های مصرف حساب می‌شوند
نکته‌ها و بهترین روش‌ها
نکته‌های بهره‌وری
استفاده از فایل CLAUDE.md
یک CLAUDE.md در ریشه پروژه بنویسید تا قراردادهای پروژه را ثبت کند؛ اگر مخزن از AGENTS.md استفاده می‌کند، Claude به‌جای آن همان را می‌خواند؛ این فایل‌ها در آغاز هر نشست خوانده می‌شوند
بهره‌گیری از هوک‌ها
رویدادهای هوک را پیکربندی کنید: SessionStart و SessionEnd یک‌بار در هر نشست فعال می‌شوند، UserPromptSubmit و Stop یک‌بار در هر نوبت، و PreToolUse و PostToolUse در هر فراخوانی ابزار در حلقه عامل
استفاده از عامل‌های پس‌زمینه
نمای عامل را با claude agents باز کنید تا نشست‌های پس‌زمینه را اعزام کنید: هرکدام بدون اتصال ترمینال به اجرا ادامه می‌دهند و به‌صورت مستقل از سهمیه اشتراک استفاده می‌کنند؛ مستندات رسمی این سهمیه را سهمیه اشتراک claude.ai توصیف می‌کنند
عیب‌یابی
کلید API نامعتبر
بررسی کنید که متغیر محیطی و کلید با هم مطابقت داشته باشند: کلید cr_ مربوط به QCode در ANTHROPIC_AUTH_TOKEN قرار می‌گیرد، که Claude Code آن را به‌عنوان توکن Bearer ارسال می‌کند
اتمام مهلت اتصال
اتصال شبکه خود را بررسی کنید و مطمئن شوید ANTHROPIC_BASE_URL برابر https://api.qcode.cc/api است؛ از سرزمین اصلی چین، https://asia.qcode.cc/api گزینه جایگزین پیشنهادی است
کیفیت پایین کد
نیازمندی‌های دقیق‌تری ارائه دهید، از CLAUDE.md برای تعریف مشخصات پروژه استفاده کنید
QCode همچنین از OpenAI Codex / GPT-5.6 پشتیبانی می‌کند
سهمیه QCode شما در Claude Code و OpenAI Codex CLI کار می‌کند — یک موجودی مشترک، صفر هزینه تکراری.
شروع استفاده از Claude Code
در QCode.cc ثبت‌نام کنید و سرویس API Claude Code را فعال کنید. صورت‌حساب بر اساس توکن محاسبه می‌شود؛ نرخ هر مدل در /models فهرست شده است. می‌خواهید Claude Code را برای مدت‌های طولانی روی سرور اجرا کنید یا محیطی ثابت در اختیار تیم خود بگذارید؟ هر سرور ابری QCode یک IPv4 عمومی اختصاصی و دسترسی کامل root دارد؛ برای نصب Claude Code روی ماشین، فرمان curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --lang en را اجرا کنید. فراخوانی‌های مدل همچنان از طریق نقطه پایانی QCode و با کلید QCode شما انجام می‌شوند، و سرویس‌های هوش مصنوعی و سرورهای ابری یک موجودی مشترک دارند. برای قیمت‌های شروع، مقایسه خطوط را در qcode.cc/en/cloud ببینید.