# Claude Code چیست و چطور با ChatQT کار می‌کند؟

## English summary

**Claude Code چیست و چطور با ChatQT کار می‌کند؟**



URL: https://chatqt.com/blog/claude-code-guide.html

---

راهنمای کامل Claude CLI / Claude Code: نصب، اتصال به ChatQT با کلید API از کنسول، و چه زمانی به‌جای CLI از اپ وب برای استدلال (reasoning) استفاده کنیم.

## Claude Code / Claude CLI چیست؟

**Claude Code** (یا همان Claude CLI) ابزار رسمی شرکت Anthropic است که مدل Claude را مستقیم داخل ترمینال در اختیار شما می‌گذارد. به‌جای کپی‌پیست بین مرورگر و ادیتور، Claude در همان پوشهٔ پروژه با شما کار می‌کند:

- خواندن و ویرایش فایل‌های پروژه
- اجرای دستور در شل و دیدن خروجی
- نوشتن کامیت، ساخت Pull Request و بازخوانی diff
- اجرای تست‌ها و دیباگ خطاها

این یعنی Claude Code برای **کدنویسی، ریفکتور، اتومیشن و کارهای تکراری پروژه** ساخته شده — نه برای یک گفتگوی ساده.

## چطور کار می‌کند؟

در پشت صحنه، Claude Code همان API استاندارد Anthropic را صدا می‌زند. سه چیز برای راه‌اندازی لازم دارد:

1. **کلید API** برای احراز هویت (`ANTHROPIC_AUTH_TOKEN`).
2. **آدرس endpoint** که درخواست‌ها به آن ارسال می‌شود (`ANTHROPIC_BASE_URL`).
3. **شناسهٔ مدل** که می‌خواهید استفاده کنید (`ANTHROPIC_MODEL`).

سپس Claude در یک **حلقهٔ tool-use** کار می‌کند: مدل تصمیم می‌گیرد چه فایلی بخواند یا چه دستوری اجرا کند، CLI آن ابزار را اجرا می‌کند، خروجی را برمی‌گرداند، و این چرخه تا پاسخ نهایی ادامه پیدا می‌کند.

## چرا با ChatQT؟

در ایران دسترسی مستقیم به سرویس Anthropic معمولاً ممکن نیست؛ هم محدودیت IP وجود دارد و هم پرداخت با کارت بین‌المللی دردسر دارد. ChatQT یک **endpoint سازگار با Anthropic** ارائه می‌دهد روی `api.chatqt.com/api`:

- بدون VPN — درخواست‌ها از سمت ChatQT به Anthropic می‌رسد
- **پرداخت ریالی** و شارژ اعتبار به‌صورت PAYG
- پشتیبانی فارسی و فعال‌سازی فوری

یعنی همان Claude Code رسمی را روی ترمینال خودتان دارید، فقط `BASE_URL` و `AUTH_TOKEN` را عوض می‌کنید.

## شروع سریع

ابتدا از [کنسول توسعه‌دهندگان ChatQT](https://console.chatqt.com) یک کلید API بسازید. سپس فایل `~/.claude/settings.json` را بسازید یا ویرایش کنید:

```prompt
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_CHATQT_KEY",
    "ANTHROPIC_BASE_URL": "https://api.chatqt.com/api"
  }
}
```

حالا کافی است در پوشهٔ پروژه دستور `claude` را اجرا کنید. برای جزئیات بیشتر (انتخاب شناسهٔ دقیق مدل، رفع خطاها، تنظیم proxy) صفحهٔ [راهنمای کامل Claude CLI با ChatQT](../claude-cli.html) را ببینید.

## چه زمانی به‌جای CLI از اپ وب استفاده کنیم؟

Claude Code برای کدنویسی فوق‌العاده است، اما همه‌چیز کدنویسی نیست. اگر می‌خواهید از **حالت استدلال** Claude (یعنی **Extended Thinking** یا همان reasoning) استفاده کنید — مثل تحلیل عمیق یک مسئله، حل ریاضی چندمرحله‌ای، استدلال منطقی، یا بررسی یک سند طولانی — بهترین تجربه در **اپ وب ChatQT** است:

- در [اپ وب ChatQT](https://app.chatqt.com) مدل‌های استدلال‌محور Claude (مثل Claude Opus) با یک کلیک قابل انتخاب‌اند.
- زنجیرهٔ تفکر مدل به‌صورت زنده نمایش داده می‌شود.
- می‌توانید بین مدل‌های مختلف (Claude، GPT، Gemini، Grok و QT) جابه‌جا شوید و پاسخ‌ها را مقایسه کنید.
- نیازی به تنظیم فایل کانفیگ یا متغیر محیطی نیست.

به‌طور خلاصه:

- **کدنویسی، ریفکتور، اتومیشن، اسکریپت‌نویسی** → Claude CLI با کلید [کنسول ChatQT](https://console.chatqt.com)
- **استدلال، تحلیل، نوشتن، مقایسهٔ مدل‌ها** → [اپ وب ChatQT](https://app.chatqt.com)

## جمع‌بندی

Claude Code یک ابزار حرفه‌ای برای توسعه‌دهنده‌هاست و با ChatQT می‌توانید بدون VPN و با پرداخت ریالی از آن استفاده کنید. کلید API را از [کنسول توسعه‌دهندگان](https://console.chatqt.com) بگیرید و اگر کارتان بیشتر از جنس **استدلال و تحلیل** است تا کدنویسی، یک‌راست به [اپ وب ChatQT](https://app.chatqt.com) بروید.

برای دیدن جزئیات فنی به صفحهٔ [API](../api.html)، برای خرید اعتبار به [خرید Claude](../buy-claude.html) و برای چت سریع به [چت با هوش مصنوعی](../chat.html) سر بزنید.

URL: https://chatqt.com/blog/claude-code-guide.html