شروع سریع

مبانی Claude Code را در 5 دقیقه بیاموزید

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

⚡ هنوز راه‌اندازی نکرده‌اید؟ یک فرمان همه کارها را انجام می‌دهد: curl -fsSL https://qcode.cc/install/claude-code.sh | bash (Windows: irm https://qcode.cc/install/claude-code.ps1 | iex). اسکریپت راه‌اندازی یک‌کلیکی را ببینید.

هنوز کلید ندارید؟ ابتدا یک پلن انتخاب کنید و کلید خود را دریافت کنید: کلید در هر گزینه‌ای که انتخاب کنید یکسان کار می‌کند، بنابراین مراحل زیر تغییری نمی‌کنند.

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

اجرای Claude Code¶

در ترمینال به دایرکتوری پروژه خود بروید و اجرا کنید:

cd /path/to/your/project
claude

رابط تعاملی Claude Code را خواهید دید که آماده شروع گفتگوست.

تعامل‌های اصلی¶

1. درک کد¶

> What's the architecture of this project?
> Explain how src/auth/login.ts works
> Find all places that call the database

2. تولید کد¶

> Write a user registration API endpoint
> Add unit tests for the UserService class
> Create a React login form component

3. ویرایش کد موجود¶

> Refactor utils.js to improve readability
> Fix the memory leak in handleSubmit function
> Add TypeScript types to all public functions

4. اشکال‌زدایی مشکلات¶

> Why is the user redirected to 404 after login?
> Analyze this error: TypeError: Cannot read property 'id' of undefined
> Investigate why the API response is slow

5. عملیات Git¶

> Show me what files I've modified
> Commit these changes with a good commit message
> Create a PR description

ارجاع به فایل‌ها با @¶

از نماد @ برای ارجاع دقیق به فایل‌های مشخص استفاده کنید تا Claude بتواند محتوای آن‌ها را مستقیماً بخواند:

> Review @src/components/Header.tsx and optimize performance
> Compare @src/v1/api.js with @src/v2/api.js
> Analyze project dependencies based on @package.json

نکته: پس از تایپ @، Tab را فشار دهید تا مسیرهای فایل به‌صورت خودکار تکمیل شوند.

ورودی از طریق پایپ¶

خروجی سایر فرمان‌ها را برای تحلیل به Claude Code بدهید:

# Explain git changes
git diff | claude "explain these code changes"

# Analyze log errors
cat error.log | claude "analyze these errors and provide solutions"

# Review PR changes
gh pr diff 123 | claude "review this PR for code quality"

دستورهای اسلش رایج¶

در طول یک نشست از دستورهای / استفاده کنید:

میان‌برهای صفحه‌کلید¶

راه‌اندازی اولیه پیکربندی پروژه¶

در اولین استفاده، /init را اجرا کنید تا Claude پروژه شما را تحلیل کند و پیکربندی تولید کند:

> /init

این کار یک فایل CLAUDE.md ایجاد می‌کند که شامل موارد زیر است:

• نمای کلی پشته فناوری و معماری پروژه

• دستورهای رایج ساخت و آزمون

• راهنماهای سبک کد

• قواعد مخصوص پروژه

هدف CLAUDE.md: Claude Code هنگام راه‌اندازی این فایل را به‌طور خودکار می‌خواند و به هوش مصنوعی کمک می‌کند زمینه پروژه شما را بهتر درک کند.

مثال‌های کاربردی¶

مثال 1: افزودن یک قابلیت جدید¶

> I need to add a user avatar upload feature with:
  1. Support for JPG/PNG formats
  2. 2MB file size limit
  3. Auto-crop to 200x200 after upload
  4. Store in S3

مثال 2: رفع یک باگ¶

> User feedback: Page freezes after clicking "Save" button
> Please investigate the issue in @src/pages/EditProfile.tsx

مثال 3: بازبینی کد¶

> /review
> Focus on security issues and performance bottlenecks

مثال 4: کامیت هوشمند¶

> Commit these changes and write a good commit message

Claude به‌طور خودکار این کارها را انجام می‌دهد:

1. همه تغییرات را تحلیل می‌کند

2. یک پیام کامیت مناسب تولید می‌کند

3. کامیت را کامل می‌کند

نکات کارایی¶

1. دقیق باشید: به‌روشنی توصیف کنید چه می‌خواهید، از جمله محدودیت‌ها

2. آن را به بخش‌های کوچک‌تر تقسیم کنید: کارهای پیچیده را به مراحل کوچک‌تر بشکنید

3. وقفه را زود بزنید: اگر خروجی آنچه می‌خواهید نیست، بلافاصله Esc را فشار دهید

4. از ارجاع‌ها استفاده کنید: از @ برای مشخص کردن فایل‌ها استفاده کنید تا هوش مصنوعی حدس نزند

5. زمینه را حفظ کنید: Claude گفتگوی قبلی را در همان نشست به یاد می‌آورد

توضیح تنظیمات کلیدی¶

برای شروع سریع فقط به چهار مورد نیاز دارید؛ بقیه را در صورت نیاز ببینید:

فهرست کامل متغیرها در متغیرهای محیطی آمده است؛ برای راه‌اندازی یک‌مرحله‌ای، اسکریپت راه‌اندازی یک‌کلیکی را ببینید.

مدیریت نشست: چند فرمان رسمی¶

تا تاریخ 2026-10-15، بر اساس مستندات Claude Code:

• /usage هزینه و مصرف نشست را نشان می‌دهد و /cost نام مستعار آن است؛
• claude --continue آخرین نشست را در پوشه جاری ادامه می‌دهد، claude --resume فهرست نشست‌ها را برای انتخاب نشان می‌دهد، و /resume درون یک نشست کار می‌کند؛
• برای مشاهده یک پلن بدون اینکه به آن اجازه دهید فایل‌ها را ویرایش کند، Shift+Tab را فشار دهید تا بین حالت‌های مجوز جابه‌جا شوید؛ وقتی نوار وضعیت ⏸ plan mode on را نشان می‌دهد، در حالت پلن هستید و تا زمانی که پلن را تأیید نکنید، چیزی ویرایش نمی‌شود.

خطاهای رایج و روش عیب‌یابی¶

اگر مطمئن نیستید کدام لایه دچار خطا است، آزمون curl را از بخش 5 نقاط پایانی و قالب‌های API اجرا کنید: 400 یا 401 یعنی مسیر قابل دسترسی است.

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

چگونه تأیید کنم که درخواست‌ها واقعاً از QCode عبور می‌کنند؟¶

کلید API خود را در probe.qcode.cc وارد کنید تا مدل و توکن‌های آخرین درخواست‌های خود را ببینید. اگر چیزی نمایش داده نشد، درخواست‌ها هرگز به QCode نرسیده‌اند؛ بنابراین متغیرهای محیطی خود را دوباره بررسی کنید.

کجا می‌توانم هزینه یک نشست را ببینم؟¶

داخل یک نشست، /usage (یا /cost) مصرف نشست جاری را نشان می‌دهد. مصرف در سطح حساب کاربری در Console QCode نمایش داده می‌شود. QCode به‌ازای هر توکن صورت‌حساب می‌کند؛ نرخ هر مدل در qcode.cc/models فهرست شده است.

آیا می‌توانم پس از بستن ترمینال، گفتگوی دیروز را ادامه دهم؟¶

بله. دستور claude --continue را در همان پوشه پروژه اجرا کنید تا آخرین نشست بازیابی شود، یا claude --resume را اجرا کنید تا از یک فهرست یکی را انتخاب کنید.

با کدام مدل شروع کنم؟¶

برای کدنویسی روزمره از claude-sonnet-5 استفاده کنید و برای کارهای دشوارتر با /model به مدل قوی‌تری سوئیچ کنید؛ برای مقایسه انتخاب مدل را ببینید.

اگر بخواهم از GPT یا مدل‌های چینی استفاده کنم چه؟¶

خود Claude Code از رابط Anthropic استفاده می‌کند، بنابراین مدل‌های چینی را می‌توان مستقیماً انتخاب کرد. برای مدل‌های GPT از Codex CLI استفاده کنید؛ مراحل راه‌اندازی در راهنمای کامل Codex آمده است.

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

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

1. نکات CLI را برای 34 نکته کاربردی بررسی کنید

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

3. یکپارچه‌سازی Codex را ببینید تا از ابزار هوش مصنوعی دیگری استفاده کنید

سازمانی ←