# نکات CLI

این راهنما 34 نکته کاربردی Claude Code را از عملیات پایه تا قابلیت‌های پیشرفته گردآوری می‌کند و به شما کمک می‌کند تا پتانسیل Claude Code را به حداکثر برسانید.

## عملیات پایه

### 1. تکمیل خودکار مسیرهای فایل با Tab

پس از تایپ `@`، `Tab` را فشار دهید تا مسیرهای فایل به‌طور خودکار تکمیل شوند؛ نیازی به حفظ کردن مسیرهای کامل نیست.

### 2. استفاده از @ برای ارجاع دقیق به فایل‌ها

```
> Analyze security in @src/utils/auth.ts
> Compare @v1/api.js with @v2/api.js
```

ارجاع مستقیم به فایل‌ها دقیق‌تر از توصیف مکان فایل‌ها است.

### 3. ارسال ورودی با pipe برای تحلیل

```bash
git diff | claude "explain these changes"
cat error.log | claude "analyze error causes"
npm test 2>&1 | claude "analyze test failures"
```

### 4. میانبرهای صفحه‌کلید

| میانبر | عملکرد |
|----------|----------|
| `Tab` | تکمیل خودکار مسیرهای فایل |
| `Esc` | توقف خروجی فعلی |
| `Ctrl+C` | لغو عملیات فعلی |
| `↑` / `↓` | مرور تاریخچه دستورها |
| `Shift+Tab` (سه بار از حالت خودکار، دو بار از حالت پیش‌فرض) | ورود به حالت برنامه‌ریزی |
| `Alt+Tab` / `Option+Tab` | تغییر وضعیت حالت تفکر |

### 5. استفاده از ! برای دستورهای سریع

برای اجرای مستقیم دستورهای shell، ابتدای دستور `!` را قرار دهید:

```
> !git status
> !npm run build
```

## دستورهای اسلش

### 6. دستور /help: مشاهده همه دستورها

```
> /help
```

همه دستورهای اسلش و میانبرهای موجود را نشان می‌دهد.

### 7. دستور /clear: پاک کردن گفتگو

```
> /clear
```

پیش از شروع کارهای جدید، زمینه را پاک کنید تا از تداخل گفتگوهای قبلی جلوگیری شود.

### 8. دستور /compact: فشرده‌سازی تاریخچه

```
> /compact
```

وقتی زمینه بیش از حد طولانی می‌شود از آن استفاده کنید؛ تاریخچه را برای صرفه‌جویی در توکن‌ها فشرده می‌کند و اطلاعات اصلی را حفظ می‌کند.

### 9. دستور /context: بررسی مصرف زمینه

```
> /context
```

درصد مصرف زمینه فعلی را نشان می‌دهد. در 60%، فشرده‌سازی یا شروع یک نشست جدید را در نظر بگیرید.

### 10. دستور /model: تغییر مدل‌ها

```
> /model opus
> /model sonnet
```

- **Opus 5.5**: کارهای پیچیده، طراحی معماری، مسائل دشوار (پرچمدار اصلی فعلی)

- **Sonnet 5.5**: کدنویسی روزمره، تکرارهای سریع (مقرون‌به‌صرفه)

- **Haiku 5.5**: سبک، سریع، کارهای ساده

نام‌های مستعار (`opus` / `sonnet` / `haiku`) توسط Claude Code به آخرین نسخه نگاشت می‌شوند؛ برای تثبیت یک مدل، شناسه کامل را بنویسید، برای مثال `/model claude-opus-5-5`، `/model claude-sonnet-5-5` یا `/model claude-haiku-5-5`. از `/effort` برای تنظیم شدت تفکر استفاده کنید (به [راهنمای تفکر تطبیقی](/docs/usage/adaptive-thinking) مراجعه کنید).

### 11. دستور /memory: ویرایش حافظه پروژه

```
> /memory
```

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

### 12. دستور /init: مقداردهی اولیه پیکربندی پروژه

```
> /init
```

به Claude اجازه دهید پروژه شما را تحلیل کند و یک فایل پیکربندی CLAUDE.md تولید کند.

### 13. فقط بگویید «این تغییرات را کامیت کنید»

```
> Commit these changes
```

تغییرات را به‌طور خودکار تحلیل می‌کند، پیام‌های کامیت مناسب تولید می‌کند و کامیت می‌کند.

توجه: `/commit` یک دستور توکار Claude Code نیست (در فهرست رسمی دستورهای توکار وجود ندارد). فقط زمانی کار می‌کند که شما یا یک افزونه، دستور یا مهارت سفارشی ارائه دهید. در غیر این صورت، کافی است از Claude بخواهید به زبان طبیعی کامیت کند.

### 14. دستور /review: بازبینی کد

```
> /review
```

تغییرات فعلی را برای مشکلات احتمالی بررسی می‌کند.

### 15. دستور /resume: ادامه نشست

```
> /resume
```

نشست گفتگوی قبلی را برای ادامه کارهای ناتمام از سر می‌گیرد.
## مدیریت زمینه

تا 2026-10-15، مستندات Claude Code بیان می‌کند که Opus 4.7 و نسخه‌های بعدی، Sonnet 5 و نسخه‌های بعدی و Haiku 5.5 به‌طور پیش‌فرض با پنجره زمینه 1M توکن اجرا می‌شوند، در حالی که Opus 4.6 و Sonnet 4.6 به گونه `[1m]` نیاز دارند و در غیر این صورت 200K دریافت می‌کنند. یک نشست را روی یک وظیفه متمرکز نگه دارید، از `/context` برای پایش مصرف، از `/compact` برای فشرده‌سازی تاریخچه و از `/clear` برای شروع تازه استفاده کنید.

برای راهبردهای تفصیلی مدیریت زمینه (شامل مدیریت سرریز نشست‌های طولانی) → [مدیریت زمینه](/docs/usage/context-management)

## حالت Plan

### 19. ورود به حالت Plan

`Shift+Tab` را فشار دهید تا به حالت Plan بروید (سه بار از حالت خودکار پیش‌فرض، دو بار از `default`). Claude بدون تغییر کد پژوهش می‌کند و برنامه می‌سازد.

### 20. برنامه‌ریزی پیش از اجرا

برای وظایف پیچیده، ابتدا از Claude بخواهید برنامه‌ای ایجاد کند:

```
> Analyze this feature requirement and create an implementation plan, don't write code yet
```

پیش از اجرا برنامه را تأیید کنید تا دوباره‌کاری کاهش یابد.

### 21. اجرای گام‌به‌گام وظایف پیچیده

وظایف بزرگ را به گام‌های کوچک‌تر تقسیم کنید:

```
> Step 1: Analyze the existing auth system
> Step 2: Design the new JWT approach
> Step 3: Implement core functionality
> Step 4: Add tests
```

## زیرعامل‌ها

### 22. استفاده از عامل Explore برای جست‌وجوی سریع

عامل Explore در جست‌وجوهای سریع در پایگاه کد تخصص دارد:

```
> Use the Explore agent to find all payment handling code
```

### 23. استفاده از عامل Plan برای طراحی

عامل Plan در برنامه‌ریزی پیاده‌سازی تخصص دارد:

```
> Use the Plan agent to design the user permission system
```

### 24. عامل‌های پس‌زمینه برای وظایف موازی

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

## پیکربندی CLAUDE.md

`CLAUDE.md` یک فایل پیکربندی در سطح پروژه است که Claude هنگام راه‌اندازی به‌طور خودکار آن را می‌خواند. از `/init` برای تولید آن استفاده کنید یا آن را به‌صورت دستی بسازید. استانداردهای کد، دستورهای رایج و معماری پروژه را تعریف کنید تا در هر نشست خودتان را تکرار نکنید.

راهنمای کامل پیکربندی همراه با مثال‌ها → [پیکربندی CLAUDE.md](/docs/usage/claude-md)

## گردش کار Git

### 28. پیام‌های کامیت هوشمند

```
> Commit these changes
```

Claude همه تغییرات را تحلیل می‌کند و پیام‌های کامیت مناسب تولید می‌کند.

### 29. ایجاد توضیحات PR

```
> Create a PR description for the current branch
```

به‌طور خودکار توضیحات PR را همراه با خلاصه تغییرات و برنامه آزمون تولید می‌کند.

### 30. تحلیل تغییرات PR

```bash
gh pr diff 123 | claude "review this PR"
```

## تست و اشکال‌زدایی

### 31. از Claude بخواهید تست بنویسد

```
> Write unit tests for @src/services/UserService.ts
```

بگذارید Claude تست بنویسد تا درستی کد خودش را بررسی کند.

### 32. تحلیل شکست‌های تست

```bash
npm test 2>&1 | claude "analyze failures and fix"
```

### 33. اشکال‌زدایی خطاها

```
> Analyze this error: [paste error message]
> Debug the issue in @src/pages/Login.tsx
```

## نکات پیشرفته

### 34. استفاده از اسکرین‌شات‌ها/تصاویر

Claude Code از درک تصویر پشتیبانی می‌کند:

```
> Look at this screenshot @screenshot.png and analyze UI issues
```

## مقایسه کارایی

| سناریو | روش سنتی | Claude Code |
|----------|-------------|-------------|
| یافتن کد | grep + مرور دستی | `@file` یا عامل Explore |
| نوشتن تست | دستی + اشکال‌زدایی | `/review` + تولید خودکار |
| کامیت Git | فکر کردن به پیام + نوشتن | بگویید «این تغییرات را کامیت کنید» |
| مرور کد | مرور خط‌به‌خط | تحلیل هوشمند `/review` |
| درک کد | خواندن مستندات + خواندن کد | فقط از Claude بپرسید |

## خلاصه بهترین شیوه‌ها

1. **مشخص باشید**: نیازمندی‌ها را همراه با محدودیت‌ها به‌روشنی توصیف کنید

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

3. **گام‌به‌گام**: وظایف پیچیده را به گام‌های کوچک‌تر تقسیم کنید

4. **زودهنگام وقفه دهید**: اگر خروجی نادرست است، فوراً `Esc` را فشار دهید

5. **متمرکز بمانید**: یک نشست برای یک وظیفه

6. **به‌طور منظم فشرده کنید**: وقتی زمینه طولانی می‌شود از `/compact` استفاده کنید

7. **ابتدا برنامه‌ریزی کنید**: پیش از وظایف پیچیده برنامه بسازید

8. **بگذارید AI تست کند**: از Claude بخواهید برای بررسی کدش تست بنویسد

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

- برای فرایندهای توسعه کارآمد، [نکات گردش کار](/docs/usage/workflow-tips) را بیاموزید

- برای مدیریت نشست‌های طولانی و سرریز توکن، [مدیریت زمینه](/docs/usage/context-management) را بررسی کنید

- برای سفارشی‌سازی رفتار Claude در پروژه خود، [پیکربندی CLAUDE.md](/docs/usage/claude-md) را تنظیم کنید

- برای استفاده از ابزار هوش مصنوعی دیگر، [یکپارچه‌سازی Codex](/docs/ide/codex) را بررسی کنید