نکات CLI

34 نکته کاربردی برای CLI Claude Code جهت افزایش بهره‌وری توسعه شما

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

این راهنما 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 برای تحلیل¶

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

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

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 برای تنظیم شدت تفکر استفاده کنید (به راهنمای تفکر تطبیقی مراجعه کنید).

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 برای شروع تازه استفاده کنید.

برای راهبردهای تفصیلی مدیریت زمینه (شامل مدیریت سرریز نشست‌های طولانی) → مدیریت زمینه

حالت 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

گردش کار Git¶

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

> Commit these changes

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

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

> Create a PR description for the current branch

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

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

gh pr diff 123 | claude "review this PR"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• برای فرایندهای توسعه کارآمد، نکات گردش کار را بیاموزید

• برای مدیریت نشست‌های طولانی و سرریز توکن، مدیریت زمینه را بررسی کنید

• برای سفارشی‌سازی رفتار Claude در پروژه خود، پیکربندی CLAUDE.md را تنظیم کنید

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

سازمانی ←