# برگه تقلب Claude Code

> دستورها تابع `claude --version` محلی شما و [انتشارهای رسمی](https://github.com/anthropics/claude-code/releases) هستند. این صفحه را برای مراجعه سریع نشانک کنید.

---

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

### کنترل‌های عمومی

| میان‌بر | عملکرد |
|--------|------|
| `Ctrl+C` | لغو ورودی / قطع تولید |
| `Ctrl+D` | خروج از جلسه |
| `Ctrl+L` | پاک‌کردن صفحه |
| `Ctrl+O` | تغییر وضعیت خروجی پرجزئیات (نمایش فرایند تفکر) |
| `Ctrl+R` | جست‌وجوی معکوس در تاریخچه |
| `Ctrl+G` | باز کردن prompt در ویرایشگر |
| `Ctrl+B` | اجرای وظیفه فعلی در پس‌زمینه |
| `Ctrl+T` | تغییر وضعیت فهرست وظایف |
| `Ctrl+V` | چسباندن تصویر |
| `Ctrl+F` | پایان دادن به Agentsهای پس‌زمینه (دو بار فشار دهید) |
| `Esc` `Esc` | واگرد / بازگشت |

### تغییر حالت

| میان‌بر | عملکرد |
|--------|------|
| `Shift+Tab` | چرخش بین حالت‌های مجوز (خودکار → عادی → پذیرش خودکار → برنامه) |
| `Alt+P` | تغییر مدل |
| `Alt+T` | تغییر وضعیت حالت تفکر |

### نکات ورودی

| میان‌بر | عملکرد |
|--------|------|
| `\` + `Enter` | خط جدید (میان‌بر) |
| `Ctrl+J` | خط جدید (توالی کنترل) |

### نمادهای پیشوند

| پیشوند | عملکرد |
|------|------|
| `/` | دستورهای اسلش |
| `!` | اجرای مستقیم bash |
| `@` | ارجاع به فایل + تکمیل خودکار |

### انتخابگر جلسه

| میان‌بر | عملکرد |
|--------|------|
| `↑` `↓` | پیمایش |
| `←` `→` | گسترش / جمع کردن |
| `P` | پیش‌نمایش |
| `R` | تغییر نام |
| `/` | جست‌وجو |
| `A` | همه پروژه‌ها |
| `B` | شاخه فعلی |

---

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

### مدیریت جلسه

| دستور | عملکرد |
|------|------|
| `/clear` | پاک کردن گفت‌وگو |
| `/compact [focus]` | فشرده‌سازی زمینه (به‌صورت اختیاری تمرکز را مشخص کنید) |
| `/resume` | ازسرگیری / تغییر جلسه |
| `/rename [name]` | نام‌گذاری جلسه فعلی |
| `/branch [name]` | انشعاب‌گرفتن از گفت‌وگو (نام مستعار `/fork`) |
| `/cost` | آمار مصرف توکن |
| `/context` | نمایش بصری مصرف زمینه (شبکه‌ای) |
| `/diff` | نمایشگر تعاملی تفاوت‌ها |
| `/copy` | کپی آخرین پاسخ |
| `/export` | خروجی گرفتن از گفت‌وگو |

### پیکربندی

| دستور | عملکرد |
|------|------|
| `/config` | باز کردن تنظیمات |
| `/model [model]` | تغییر مدل (`←` `→` برای تنظیم سطح تلاش) |
| `/fast [on\|off]` | تغییر وضعیت حالت سریع |
| `/vim` | تغییر وضعیت حالت vim |
| `/theme` | تغییر پوسته رنگ |
| `/permissions` | مشاهده / به‌روزرسانی مجوزها |
| `/effort [level]` | تنظیم سطح تلاش (low / med / high / max / auto) |
| `/color [color]` | تنظیم رنگ نوار prompt |
| `/keybindings` | میان‌برهای سفارشی صفحه‌کلید |
| `/terminal-setup` | پیکربندی میان‌برهای ترمینال |

### ابزارها

| دستور | عملکرد |
|------|------|
| `/init` | ساخت CLAUDE.md |
| `/memory` | ویرایش فایل‌های CLAUDE.md |
| `/mcp` | مدیریت سرورهای MCP |
| `/hooks` | مدیریت قلاب‌ها |
| `/skills` | فهرست مهارت‌های موجود |
| `/agents` | مدیریت عامل‌ها |
| `/chrome` | یکپارچه‌سازی با Chrome |
| `/reload-plugins` | بارگذاری مجدد افزونه‌ها بدون توقف |
| `/add-dir <path>` | افزودن پوشه کاری |

### ویژگی‌های ویژه

| دستور | عملکرد |
|------|------|
| `/btw <question>` | پرسش جانبی (بدون زمینه، بدون تأثیر بر گفت‌وگوی اصلی) |
| `/plan [desc]` | حالت برنامه (+ شروع خودکار تحلیل) |
| `/loop [interval]` | زمان‌بندی وظیفه تکرارشونده (مثلاً `/loop 5m check deploy`) |
| `/voice` | حالت صوتی فشار برای صحبت (20 زبان) |
| `/doctor` | تشخیص نصب |
| `/pr-comments [PR]` | دریافت نظرهای PR در GitHub |
| `/stats` | روند پیوسته مصرف و ترجیح‌ها |
| `/insights` | گزارش تحلیلی جلسه |
| `/desktop` | ادامه در برنامه Desktop |
| `/remote-control` | اتصال به claude.ai/code (نام مستعار `/rc`) |
| `/usage` | وضعیت سهمیه و نرخ پلن |
| `/schedule` | وظایف زمان‌بندی‌شده ابری |
| `/security-review` | تحلیل امنیتی تغییرات |
| `/help` | نمایش راهنما + همه دستورها |
| `/feedback` | ارسال بازخورد (نام مستعار `/bug`) |
| `/release-notes` | مشاهده فهرست کامل تغییرات |

---
## دستورها و پرچم‌های CLI

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

| دستور | کارکرد |
|------|------|
| `claude` | شروع تعاملی |
| `claude "question"` | شروع با prompt اولیه |
| `claude -p "query"` | حالت بدون رابط (غیرتعاملی) |
| `claude -c` | ادامه آخرین گفتگو |
| `claude -r "name"` | ازسرگیری نشست بر اساس نام |
| `claude update` | به‌روزرسانی به آخرین نسخه |

### پرچم‌های کلیدی

| پرچم | کارکرد |
|------|------|
| `--model` | تعیین مدل |
| `-w` | حالت درخت کاری Git |
| `-n` / `--name` | نام نشست |
| `--add-dir` | افزودن پوشه اضافی |
| `--agent` | استفاده از عامل مشخص‌شده |
| `--allowedTools` | پیش‌تأیید ابزارهای مشخص‌شده |
| `--output-format` | قالب خروجی (json / stream-json) |
| `--json-schema` | خروجی JSON ساخت‌یافته |
| `--max-turns` | محدود کردن نوبت‌های تعامل |
| `--max-budget-usd` | سقف هزینه (USD) |
| `--console` | احراز هویت از طریق Anthropic Console |
| `--verbose` | خروجی با جزئیات |
| `--bare` | حداقلی بدون رابط (بدون قلاب‌ها/LSP/افزونه‌ها) |
| `--channels` | انتقال مجوز / ارسال MCP |
| `--remote` | نشست وب |
| `--effort` | تعیین میزان تلاش (low / med / high / max) |
| `--permission-mode` | حالت مجوز (default / acceptEdits / plan / auto / dontAsk / bypassPermissions) |
| `--dangerously-skip-permissions` | رد کردن همه اعلان‌های مجوز |
| `--chrome` | یکپارچه‌سازی با Chrome |

---

## سرورهای MCP

### افزودن سرور

| پرچم | انتقال |
|------|---------|
| `--transport http` | HTTP راه‌دور (توصیه‌شده) |
| `--transport stdio` | فرایند محلی |
| `--transport sse` | SSE راه‌دور |

### محدوده

| محدوده | فایل پیکربندی | توضیح |
|--------|---------|------|
| محلی | `.claude.json` | یک پروژه |
| پروژه | `.mcp.json` | اشتراکی (کامیت در VCS) |
| کاربر | `~/.claude.json` | سراسری |

### دستورهای مدیریت

| دستور | کارکرد |
|------|------|
| `/mcp` | رابط مدیریت تعاملی |
| `claude mcp list` | فهرست همه سرورها |
| `claude mcp serve` | در دسترس قرار دادن خود Claude Code به‌عنوان سرور MCP |

> **Elicitation**: سرورهای MCP می‌توانند در میانه کار از کاربر ورودی درخواست کنند.

---

## حافظه و سیستم فایل

### مکان‌های CLAUDE.md

| مکان | محدوده |
|------|---------|
| `./CLAUDE.md` | سطح پروژه (اشتراکی برای تیم) |
| `~/.claude/CLAUDE.md` | سطح کاربر (همه پروژه‌ها) |
| `/etc/claude-code/` | مدیریت‌شده (در سطح سازمان) |

### قوانین و واردکردن‌ها

| مسیر / نحو | توضیح |
|------------|------|
| `.claude/rules/*.md` | فایل‌های قواعد پروژه |
| `~/.claude/rules/*.md` | فایل‌های قواعد کاربر |
| `paths:` frontmatter | قواعد مخصوص مسیر (فقط برای مسیرهای مطابق) |
| `@path/to/file` | واردکردن محتوای فایل در CLAUDE.md |

### حافظه خودکار

```
~/.claude/projects/<proj>/memory/
├── MEMORY.md          ← Memory index
└── topic_xxx.md       ← Topic-based memory files
```

فایل‌های حافظه به‌صورت خودکار در پنجره زمینه بارگذاری می‌شوند و پس از /compact حفظ می‌شوند.

---
## گردش کار و نکته‌ها

### حالت Plan

| اقدام | توضیح |
|------|------|
| `Shift+Tab` | چرخه: auto → Normal → Auto-accept → Plan |
| `--permission-mode plan` | شروع در حالت Plan |

### تفکر و تلاش

| اقدام | توضیح |
|------|------|
| `Alt+T` | تغییر حالت تفکر |
| `"ultrathink"` | حداکثر تلاش برای این نوبت |
| `Ctrl+O` | مشاهده فرایند تفکر (خروجی مبسوط) |
| `/effort` | تعیین سطح: low · med · high · max |

### Worktreeهای Git

| اقدام | توضیح |
|------|------|
| `--worktree name` | ایجاد فضای کاری شاخه جداگانه برای هر ویژگی |
| `isolation: worktree` | عامل در worktree جداگانه اجرا می‌شود |
| `sparsePaths` | checkout پراکنده فقط دایرکتوری‌های لازم |
| `/batch` | ایجاد خودکار چندین worktree برای تغییرات موازی |

### حالت صدا

| اقدام | توضیح |
|------|------|
| `/voice` | فعال‌سازی push-to-talk |
| `Space` (hold) | نگه دارید تا ضبط شود، رها کنید تا ارسال شود |
| 20 زبان | EN / ES / FR / DE / ZH / JA / KO ... |

### مدیریت زمینه

| اقدام | توضیح |
|------|------|
| `/context` | مشاهده مصرف + نکته‌های بهینه‌سازی |
| `/compact [focus]` | فشرده‌سازی با تمرکز |
| فشرده‌سازی خودکار | در حدود 95% ظرفیت به‌طور خودکار فعال می‌شود |
| زمینه 1M | Opus 4.8 (در Max/Team/Enterprise در دسترس است) |
| CLAUDE.md | پس از فشرده‌سازی حفظ می‌شود |

### نکته‌های پیشرفته جلسه

| اقدام | توضیح |
|------|------|
| `claude -c` | ادامه آخرین گفتگو |
| `claude -r "name"` | ادامه بر اساس نام |
| `/btw question` | پرسش جانبی، بدون تأثیر بر زمینه اصلی |

### حالت SDK / Headless

| اقدام | توضیح |
|------|------|
| `claude -p "query"` | اجرای غیرتعاملی |
| `--output-format json` | خروجی ساختاریافته |
| `--max-budget-usd 5` | سقف هزینه |
| `cat file \| claude -p` | ورودی از طریق pipe |

### زمان‌بندی و از راه دور

| اقدام | توضیح |
|------|------|
| `/loop 5m msg` | وظیفه تکرارشونده |
| `/rc` | کنترل از راه دور |
| `--remote` | جلسه وب در claude.ai |

---

## مهارت‌ها و عامل‌ها

### مهارت‌های داخلی

| مهارت | کارکرد |
|-------|------|
| `/simplify` | بازبینی کد (3 عامل موازی) |
| `/batch` | تغییرات موازی در مقیاس بزرگ (5-30 worktree) |
| `/debug [desc]` | اشکال‌زدایی از روی لاگ‌ها |
| `/loop [interval]` | وظایف زمان‌بندی‌شده دوره‌ای |
| `/claude-api` | بارگذاری مستندات مرجع API + SDK |

### مکان‌های مهارت سفارشی

| مکان | دامنه |
|------|---------|
| `.claude/skills/<name>/` | مهارت‌های پروژه |
| `~/.claude/skills/<name>/` | مهارت‌های شخصی |

### فیلدهای frontmatter مهارت

| فیلد | توضیح |
|------|------|
| `description` | توضیح فعال‌سازی خودکار |
| `allowed-tools` | ابزارهایی که promptهای مجوز را دور می‌زنند |
| `model` | بازنویسی مدل برای این مهارت |
| `effort` | بازنویسی سطح تلاش |
| `context: fork` | اجرا در عامل فرعی |
| `$ARGUMENTS` | جای‌نگهدار ورودی کاربر |
| `${CLAUDE_SKILL_DIR}` | مسیر دایرکتوری مهارت |
| `` !`cmd` `` | تزریق پویای زمینه (اجرای cmd، جاسازی نتیجه) |

### عامل‌های داخلی

| عامل | توضیح |
|-------|------|
| **Explore** | جستجوی سریع فقط‌خواندنی (از Haiku استفاده می‌کند) |
| **Plan** | پژوهش برای حالت Plan |
| **General** | مجموعه ابزار کامل، وظایف پیچیده |
| **Bash** | ترمینال با زمینه مستقل |

### فیلدهای frontmatter عامل

| فیلد | توضیح |
|------|------|
| `permissionMode` | default / acceptEdits / plan / dontAsk / bypass |
| `isolation: worktree` | اجرا در یک worktree git |
| `memory: user\|project` | حافظه پایدار |
| `background: true` | وظیفه پس‌زمینه |
| `maxTurns` | محدودکردن نوبت‌های عامل |
| `SendMessage` | ادامه عامل‌های متوقف‌شده |

---
## پیکربندی و متغیرهای محیطی

### فایل‌های پیکربندی

| فایل | توضیح |
|------|------|
| `~/.claude/settings.json` | تنظیمات کاربر |
| `.claude/settings.json` | تنظیمات اشتراکی پروژه |
| `.claude/settings.local.json` | تنظیمات فقط محلی |
| `~/.claude.json` | OAuth، MCP، وضعیت |
| `.mcp.json` | سرورهای MCP پروژه |

### تنظیمات کلیدی

| تنظیم | توضیح |
|------|------|
| `modelOverrides` | نگاشت انتخاب‌گر مدل به شناسه‌های مدل سفارشی |
| `autoMemoryDirectory` | دایرکتوری حافظه سفارشی |
| `worktree.sparsePaths` | دایرکتوری‌های واکشی پراکنده |

### متغیرهای محیطی کلیدی

| متغیر | توضیح |
|------|------|
| `ANTHROPIC_AUTH_TOKEN` | کلید API |
| `ANTHROPIC_MODEL` | مدل پیش‌فرض |
| `ANTHROPIC_BASE_URL` | نقطه پایانی API (QCode.cc: `https://api.qcode.cc/api`) |
| `CLAUDE_CODE_EFFORT_LEVEL` | سطح تلاش پیش‌فرض (low / med / high) |
| `MAX_THINKING_TOKENS` | حد توکن‌های تفکر (0 = غیرفعال) |
| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | حد توکن خروجی (پیش‌فرض 32K) |
| `ANTHROPIC_CUSTOM_MODEL_OPTION` | ورودی سفارشی فهرست کشویی /model |
| `CLAUDE_CODE_PLUGIN_SEED_DIR` | دایرکتوری‌های اولیه افزونه (جداشده با دونقطه) |
| `CLAUDECODE` | تشخیص حضور در پوسته Claude Code (=1) |
| `IS_DEMO` | حالت نمایشی (پنهان‌کردن ایمیل/سازمان) |
| `CLAUDE_CODE_DISABLE_CRON` | غیرفعال‌سازی وظایف cron |

---

## حالت مجوز

| حالت | توضیح | پرچم |
|------|------|---------|
| `auto` | یک طبقه‌بند، اقدام‌هایی را که به تأیید نیاز دارند بررسی می‌کند و اقدام‌های خطرناک را مسدود می‌کند (پیش‌فرض نشست‌های تعاملی از 2.1.283) | `--permission-mode auto` |
| `default` | برای هر اقدام نیازمند تأیید، درخواست تأیید می‌شود (با برچسب «Manual» در رابط کاربری) | `--permission-mode default` |
| `acceptEdits` | پذیرش خودکار ویرایش‌های فایل | `--permission-mode acceptEdits` |
| `plan` | فقط‌خواندنی، بدون تغییر | `--permission-mode plan` |
| `dontAsk` | رد همه به‌جز موارد صریحاً مجاز | `--permission-mode dontAsk` |
| `bypassPermissions` | نادیده‌گرفتن همه بررسی‌های مجوز | `--permission-mode bypassPermissions` |

> پرچم CLI `--dangerously-skip-permissions` معادل `bypassPermissions` است. فقط در محیط‌های ایزوله استفاده کنید.
> در CI و اسکریپت‌ها، حالت را صریحاً تنظیم کنید؛ توصیه می‌کنیم از `--permission-mode dontAsk` همراه با `--allowedTools` استفاده کنید. بدون آن، `claude -p` از طریق QCode در حالت auto شروع می‌شود.

---

## راه‌اندازی سریع QCode.cc

```bash
# One-line setup
export ANTHROPIC_BASE_URL=https://api.qcode.cc/api
export ANTHROPIC_AUTH_TOKEN=cr_your_key
```

> همان کلید `cr_` هم برای Claude Code و هم برای [Codex](/docs/getting-started/codex-quick-start) کار می‌کند و سهمیه پلن را به اشتراک می‌گذارد.

---

## مستندات مرتبط

- [آموزش کامل Claude Code](/docs/getting-started/claude-code-tutorial) — از صفر تا تسلط
- [راهنمای پیکربندی CLAUDE.md](/docs/usage/claude-md) — راهنمای پیکربندی پروژه
- [سیستم هوک‌ها](/docs/advanced/hooks) — هوک‌های خودکارسازی
- [خودکارسازی و CI/CD](/docs/advanced/headless) — حالت بدون رابط در عمل
- [آموزش کامل Codex](/docs/ide/codex) — راهنمای Codex CLI
- [Codex در برابر Claude Code](/docs/getting-started/codex-vs-claude-code) — مقایسه دو ابزار
- [پلن‌ها و قیمت‌گذاری](https://qcode.cc/pricing) — پلن‌های QCode.cc