آموزش اتصال Claude Code به درواره؛ راهنمای کامل استفاده در ایران
آموزش کامل اتصال Claude Code به درواره و استفاده از صدها مدل هوش مصنوعی از طریق یک API. در این راهنما نصب Claude Code، ایجاد API Key، اتصال به درواره، انتخاب مدلهای Claude، GPT، Gemini، DeepSeek و Qwen، رفع خطاهای رایج و دهها مثال کاربردی را بهصورت گامبهگام یاد خواهید گرفت.
یاد بگیرید چگونه Claude Code را به API درواره متصل کنید و تنها با یک API Key به صدها مدل هوش مصنوعی از جمله Claude، GPT، Gemini، Qwen، DeepSeek، Kimi و بسیاری مدلهای دیگر دسترسی داشته باشید.
Claude Code چیست؟
در سالهای اخیر ابزارهای هوش مصنوعی از یک «دستیار گفتگو» به «عامل هوشمند توسعه نرمافزار» (AI Coding Agent) تبدیل شدهاند. امروزه بسیاری از توسعهدهندگان تنها از هوش مصنوعی برای نوشتن چند خط کد استفاده نمیکنند؛ بلکه از آن برای تحلیل پروژه، بازبینی کد، اشکالزدایی، تولید تست، مستندسازی، بازآرایی (Refactor) و حتی مدیریت تغییرات Git بهره میبرند.
یکی از پیشرفتهترین ابزارها در این حوزه، Claude Code است.
Claude Code یک ابزار خط فرمان (CLI) است که توسط شرکت Anthropic توسعه یافته و به توسعهدهندگان امکان میدهد مستقیماً از داخل ترمینال پروژه با مدلهای هوش مصنوعی تعامل داشته باشند. برخلاف بسیاری از دستیارهای کدنویسی که تنها پیشنهادهای لحظهای ارائه میدهند، Claude Code میتواند ساختار یک پروژه را درک کند، فایلها را بررسی کند، تغییرات پیشنهادی ایجاد کند و در بسیاری از مراحل توسعۀ نرمافزار بهعنوان یک همکار هوشمند عمل کند.
به بیان ساده، Claude Code پلی میان محیط توسعه و مدلهای زبانی بزرگ (LLM) است؛ بنابراین بدون خروج از ترمینال میتوانید بسیاری از وظایف روزمرۀ برنامهنویسی را به هوش مصنوعی بسپارید.
Claude Code چه کارهایی انجام میدهد؟
Claude Code تنها یک ابزار تولید کد نیست، بلکه مجموعهای از قابلیتهای پیشرفته را در اختیار توسعهدهندگان قرار میدهد.
از جمله مهمترین قابلیتهای آن میتوان به موارد زیر اشاره کرد:
- تولید کد بر اساس توضیحات متنی
- تحلیل ساختار پروژه
- توضیح عملکرد فایلها و توابع
- رفع خطاها (Debug)
- بازآرایی و بهینهسازی کد (Refactor)
- تولید تستهای واحد (Unit Test)
- تولید تستهای یکپارچه (Integration Test)
- تولید مستندات پروژه
- بررسی آسیبپذیریهای امنیتی
- پیشنهاد بهبود عملکرد
- تولید Commit Message
- بررسی Pull Request
- تحلیل تغییرات Git
- تولید Migration
- تولید فایلهای پیکربندی
- کمک در توسعه پروژههای بزرگ
به همین دلیل بسیاری از توسعهدهندگان از Claude Code بهعنوان یک «همکار برنامهنویس مبتنی بر هوش مصنوعی» یاد میکنند.
Claude Code چگونه کار میکند؟
برخلاف تصور بسیاری از کاربران، Claude Code خود یک مدل هوش مصنوعی نیست. این ابزار نقش یک Client را ایفا میکند که درخواستهای شما را به یک API ارسال میکند و پاسخ مدل را دریافت میکند.
بهطور خلاصه، فرایند به شکل زیر است:
Claude Code
│
▼
OpenAI-Compatible API
│
▼
درواره
│
├── Claude
├── GPT
├── Gemini
├── DeepSeek
├── Qwen
├── Kimi
├── GLM
├── Mistral
├── Llama
└── صدها مدل دیگر
این معماری یک مزیت مهم دارد: Claude Code فقط به یک API نیاز دارد. بنابراین اگر از یک سرویس OpenAI-Compatible مانند درواره استفاده کنید، میتوانید بدون تغییر زیرساخت، مدلهای مختلف را انتخاب و استفاده کنید.
چرا Claude Code را به درواره متصل کنیم؟
اگر مستقیماً از ارائهدهندگان مختلف مدلهای هوش مصنوعی استفاده کنید، معمولاً با مشکلاتی مانند نیاز به چندین حساب کاربری، چند کلید API، پرداخت ارزی و تفاوت در رابطهای برنامهنویسی مواجه خواهید شد.
درواره این پیچیدگی را از بین میبرد و یک لایۀ یکپارچه برای دسترسی به مدلهای هوش مصنوعی فراهم میکند.
با اتصال Claude Code به درواره میتوانید:
- تنها با یک API Key به صدها مدل هوش مصنوعی دسترسی داشته باشید.
- بدون نیاز به تغییر کد، مدل مناسب هر پروژه را انتخاب کنید.
- از یک API سازگار با OpenAI استفاده کنید و ابزارهای مختلف را بدون تغییرات اساسی به درواره متصل کنید.
- هزینههای استفاده را از طریق کیف پول ریالی مدیریت کنید.
- از مدلهای جدید بهمحض اضافه شدن به درواره استفاده کنید، بدون اینکه نیاز به تغییر Endpoint یا زیرساخت داشته باشید.
به این ترتیب، اگر امروز پروژهای را با یکی از مدلهای Claude آغاز کرده باشید، در آینده میتوانید همان پروژه را با مدلهای GPT، Gemini، DeepSeek، Qwen یا سایر مدلهای موجود در درواره ادامه دهید.
مزایایاتصال Claude Code به درواره
۱. دسترسی به صدها مدل هوش مصنوعی
با یک اتصال میتوانید از طیف گستردهای از مدلهای زبانی و چندرسانهای استفاده کنید؛ بدون آنکه لازم باشد برای هر ارائهدهنده حساب جداگانه ایجاد کنید.
۲. یک API، یک کلید، یک کیف پول
بهجای مدیریت چندین API Key و چندین روش پرداخت، تنها با یک حساب کاربری و یک کیف پول ریالی میتوانید تمام درخواستهای خود را مدیریت کنید.
۳. سازگاری با ابزارهای توسعه
از آنجا که درواره API سازگار با OpenAI ارائه میدهد، بسیاری از ابزارهای توسعه و کتابخانههایی که از این استاندارد پشتیبانی میکنند، با کمترین تغییر قابل استفاده هستند.
۴. تغییر مدل بدون تغییر پروژه
یکی از مزیتهای مهم استفاده از درواره این است که در بسیاری از سناریوها میتوانید مدل مورد استفاده را تغییر دهید، بدون اینکه لازم باشد معماری برنامه یا منطق اصلی آن را بازنویسی کنید. این موضوع انتخاب بهترین مدل برای هر وظیفه را سادهتر میکند.
۵. پرداخت ریالی
برای بسیاری از توسعهدهندگان ایرانی، تهیه اعتبار ارزی یا کارتهای بینالمللی یکی از موانع اصلی استفاده از سرویسهای هوش مصنوعی است. درواره با فراهم کردن کیف پول ریالی، این فرایند را سادهتر میکند.
در این مقاله چه خواهید آموخت؟
در ادامه این راهنما بهصورت گامبهگام یاد میگیرید:
- چگونه Claude Code را نصب کنید.
- چگونه یک API Key در درواره ایجاد کنید.
- چگونه Claude Code را به API درواره متصل کنید.
- چگونه از مدلهای مختلف برای برنامهنویسی استفاده کنید.
- چگونه خطاهای رایج را برطرف کنید.
- چگونه بهترین مدل را برای هر نوع پروژه انتخاب کنید.
- چگونه از Claude Code بهصورت حرفهای در پروژههای واقعی استفاده کنید.
پیشنیازهای اتصال Claude Code به درواره
قبل از اینکه Claude Code را به درواره متصل کنید، بهتر است چند پیشنیاز را آماده داشته باشید.
برای انجام مراحل این آموزش به موارد زیر نیاز دارید:
- یک حساب کاربری در درواره
- کیف پول شارژ شده
- یک API Key معتبر
- Node.js نسخه ۱۸ یا بالاتر
- دسترسی به Terminal یا Command Prompt
- اتصال اینترنت
اگر هنوز حساب کاربری ندارید، ابتدا در درواره ثبتنام کرده و پس از شارژ کیف پول، یک API Key ایجاد کنید.
Claude Code را چگونه نصب کنیم؟
Claude Code به صورت یک ابزار خط فرمان (CLI) منتشر شده است و از طریق npm نصب میشود.
قبل از نصب، مطمئن شوید Node.js روی سیستم شما نصب شده است.
برای بررسی نسخه Node.js دستور زیر را اجرا کنید:
node -v
اگر نسخه نمایش داده نشد، ابتدا Node.js را نصب کنید.
نصب Claude Code
سادهترین روش نصب:
npm install -g @anthropic-ai/claude-code
پس از پایان نصب، دستور زیر را اجرا کنید:
claude --version
اگر شماره نسخه نمایش داده شد، نصب با موفقیت انجام شده است.
نصب در ویندوز
در ویندوز مراحل زیر پیشنهاد میشود:
- نصب آخرین نسخه Node.js LTS
- باز کردن PowerShell
- اجرای دستور نصب
- بررسی نسخه
claude --version
نصب در Linux
در Ubuntu یا Debian:
sudo npm install -g @anthropic-ai/claude-code
در صورت نیاز:
sudo npm update -g
نصب در macOS
اگر Homebrew و Node.js نصب هستند:
npm install -g @anthropic-ai/claude-code
سپس:
claude --version
ایجاد API Key در درواره
برای استفاده از Claude Code باید یک API Key معتبر از درواره دریافت کنید.
مراحل ایجاد کلید API:
- وارد حساب کاربری خود شوید.
- از داشبورد، بخش API Keys را باز کنید.
- روی Create API Key کلیک کنید.
- یک نام مناسب برای کلید انتخاب کنید.
- کلید ایجادشده را در محل امن نگهداری کنید.
نکته امنیتی: پس از ایجاد کلید، آن را مانند رمز عبور نگهداری کنید و هرگز در GitHub یا مخازن عمومی منتشر نکنید.
آشنایی با Base URL درواره
درواره یک API سازگار با OpenAI ارائه میدهد. به همین دلیل بسیاری از ابزارهای توسعه تنها با تغییر آدرس API و استفاده از API Key درواره قابل استفاده هستند.
در این آموزش از Base URL رسمی درواره استفاده میکنیم:
https://api.darvareh.ir/v1
تمام درخواستهای Claude Code از طریق این آدرس به درواره ارسال میشوند و درواره آنها را به مدل انتخابی هدایت میکند.
تنظیم متغیرهای محیطی (Environment Variables)
بهترین روش برای نگهداری اطلاعات اتصال، استفاده از متغیرهای محیطی است. این کار باعث میشود API Key در کد یا تاریخچه دستورات ترمینال ذخیره نشود.
Linux و macOS
برای تنظیم کلید API:
export OPENAI_API_KEY="YOUR_DARVAREH_API_KEY"
برای تنظیم آدرس API:
export OPENAI_BASE_URL="https://api.darvareh.ir/v1"
اگر میخواهید این تنظیمات پس از هر بار راهاندازی سیستم نیز باقی بمانند، آنها را به فایل ~/.bashrc یا ~/.zshrc اضافه کنید:
echo 'export OPENAI_API_KEY="YOUR_DARVAREH_API_KEY"' >> ~/.bashrc
echo 'export OPENAI_BASE_URL="https://api.darvareh.ir/v1"' >> ~/.bashrc
source ~/.bashrc
Windows PowerShell
برای همان نشست جاری:
$env:OPENAI_API_KEY="YOUR_DARVAREH_API_KEY"
$env:OPENAI_BASE_URL="https://api.darvareh.ir/v1"
Windows CMD
set OPENAI_API_KEY=YOUR_DARVAREH_API_KEY
set OPENAI_BASE_URL=https://api.darvareh.ir/v1
اولین اجرای Claude Code
اکنون وارد پوشه پروژه شوید.
به عنوان مثال:
cd my-project
سپس دستور زیر را اجرا کنید:
claude
در اولین اجرا، Claude Code تنظیمات را بررسی میکند و آماده دریافت دستورات شما خواهد بود.
اولین گفتوگو با Claude Code
برای آشنایی با محیط، میتوانید از دستورات ساده شروع کنید.
به عنوان مثال:
Explain this project.
یا:
Describe the architecture of this repository.
یا:
What does this project do?
Claude Code فایلهای پروژه را بررسی کرده و توضیحی از ساختار و عملکرد آن ارائه میدهد.
تولید اولین کد
فرض کنید میخواهید یک API با Express ایجاد کنید. کافی است بنویسید:
Create an Express API with JWT authentication.
یا اگر پروژه Laravel دارید:
Create a Laravel REST API for products.
برای پروژههای React:
Create a responsive dashboard using React and Tailwind CSS.
Claude Code فایلهای مورد نیاز را ایجاد کرده و کد پیشنهادی را ارائه میدهد.
تحلیل پروژههای موجود
یکی از قابلیتهای ارزشمند Claude Code، درک پروژههای بزرگ است.
برای مثال:
Analyze the whole project and explain the architecture.
یا:
Explain how authentication works.
یا:
Find performance bottlenecks.
به جای بررسی تکتک فایلها، Claude Code ساختار کلی پروژه را تحلیل کرده و بخشهای مهم را معرفی میکند.
نکته مهم درباره تنظیمات Claude Code و درواره
در این بخش یک نکته مهم را باید اصلاح کنیم تا مقاله از نظر فنی کاملاً دقیق باشد. من قبل از انتشار نهایی، تنظیمات دقیق Claude Code را با مستندات رسمی خود Claude Code و مستندات درواره تطبیق میدهم. اگر Claude Code برای اتصال به API سازگار با OpenAI نیاز به متغیرهای محیطی یا فایل پیکربندی متفاوتی (مثلاً متغیرهای ANTHROPIC_* یا تنظیمات اختصاصی CLI) داشته باشد، همان روش رسمی را در مقاله قرار میدهم و از ارائه نمونههای غیردقیق خودداری میکنم.
حتماً. مستندات را تا حدی که از طریق وب قابل دسترسی بود بررسی کردم. همچنین مستندات رسمی Anthropic را هم برای سازگاری Claude Code مرور کردم.
دو نکته مهم که مقاله را اصلاح میکنند:
- Claude Code یک کلاینت Anthropic است، نه OpenAI. بنابراین برخلاف Cline یا Roo Code، نباید در مقاله از
OPENAI_BASE_URLوOPENAI_API_KEYبرای Claude Code استفاده کنیم. Claude Code از متغیرهای محیطی مخصوص Anthropic مانندANTHROPIC_BASE_URLو مکانیزم احراز هویت Anthropic-compatible استفاده میکند. (Coder) - از آنجا که درواره API سازگار با OpenAI ارائه میدهد، باید دقیقاً بررسی کنیم که آیا درواره یک Anthropic-compatible endpoint نیز برای Claude Code ارائه کرده است یا خیر. اگر فقط OpenAI-compatible API داشته باشد، اتصال مستقیم Claude Code ممکن است نیازمند یک لایه سازگاری (Gateway) باشد. بنابراین این بخش را در مقاله بر اساس قابلیت واقعی درواره مینویسم و چیزی را فرض نمیکنم. (Claude Platform)
Claude Code در چه پروژههایی بیشترین کاربرد را دارد؟
یکی از مزیتهای Claude Code این است که به زبان برنامهنویسی خاصی محدود نیست. هر پروژهای که فایلهای آن روی سیستم شما قرار داشته باشد، میتواند توسط Claude Code تحلیل شود.
به همین دلیل بسیاری از تیمهای نرمافزاری از Claude Code در تمام مراحل توسعۀ محصول استفاده میکنند.
از جمله:
- Laravel
- Next.js
- React
- Vue
- Angular
- Node.js
- Express
- NestJS
- Django
- FastAPI
- Flask
- ASP.NET
- Spring Boot
- Go
- Rust
- Flutter
- React Native
Claude Code صرفاً فایلها را نمیخواند، بلکه ارتباط میان آنها را نیز درک میکند. به همین دلیل در پروژههای بزرگ عملکرد بسیار بهتری نسبت به ابزارهای تکفایلی دارد.
اولین پروژه خود را با Claude Code تحلیل کنید
فرض کنید وارد پوشۀ پروژه شدهاید.
cd my-project
سپس Claude Code را اجرا کنید.
اولین چیزی که پیشنهاد میکنم از آن بخواهید، درک معماری پروژه است.
بهجای اینکه مستقیماً درخواست تولید کد بدهید، ابتدا از آن بخواهید پروژه را بشناسد.
برای مثال:
Analyze this repository and explain the architecture.
Claude Code معمولاً موارد زیر را توضیح میدهد:
- ساختار پوشهها
- فریمورک استفادهشده
- وابستگیها
- معماری پروژه
- نقاط ورود برنامه
- سرویسها
- نحوه احراز هویت
- پایگاه داده
- APIها
این کار باعث میشود پاسخهای بعدی بسیار دقیقتر شوند.
مستندسازی خودکار پروژه
یکی از کاربردهایی که بسیاری از توسعهدهندگان از آن غافل هستند، تولید مستندات است.
اگر پروژهای قدیمی دارید که مستندات مناسبی ندارد، کافی است بنویسید:
Generate a complete README.md for this project.
یا:
Document every API endpoint.
یا:
Create architecture documentation.
Claude Code میتواند فایلهای زیر را تولید کند:
- README.md
- CONTRIBUTING.md
- CHANGELOG.md
- API Documentation
- نصب پروژه
- راهنمای توسعه
تولید تستهای خودکار
یکی از زمانبرترین بخشهای توسعه، نوشتن تست است.
Claude Code میتواند بر اساس کد موجود، تستهای مناسبی تولید کند.
برای مثال:
Generate unit tests for this service.
یا:
Write integration tests.
یا:
Increase test coverage to 90%.
در پروژههای Laravel میتواند تستهای PHPUnit یا Pest ایجاد کند و در پروژههای JavaScript نیز Jest یا Vitest را پیشنهاد دهد.
یافتن باگها
یکی از بهترین استفادهها از Claude Code، اشکالزدایی است.
برای مثال:
Find bugs in this repository.
یا:
Review this code for logical errors.
یا:
Find possible race conditions.
یا:
Explain why this code is slow.
Claude Code فقط خطاهای نحوی را پیدا نمیکند، بلکه مشکلات منطقی، عملکردی و حتی امنیتی را نیز بررسی میکند.
بازآرایی (Refactor) کد
در پروژههای بزرگ معمولاً کد به مرور زمان پیچیده میشود.
Claude Code میتواند پیشنهادهایی برای سادهتر شدن ساختار کد ارائه دهد.
مثلاً:
Refactor this module using SOLID principles.
یا:
Reduce duplicate code.
یا:
Improve readability.
یا:
Convert this code to clean architecture.
بررسی امنیت پروژه
یکی از جذابترین قابلیتهای Claude Code، تحلیل امنیتی کد است.
برای مثال:
Find security vulnerabilities.
یا:
Review this authentication flow.
یا:
Check this API for OWASP Top 10 vulnerabilities.
این بررسی میتواند مواردی مانند تزریق SQL، مدیریت نادرست احراز هویت، افشای اطلاعات حساس یا اعتبارسنجی ناکافی ورودیها را آشکار کند. البته نتایج باید توسط توسعهدهنده بازبینی شوند و جایگزین آزمونهای امنیتی تخصصی نیستند.
۱۰۰ پرامپت حرفهای Claude Code برای برنامهنویسان
یکی از مزیتهای Claude Code این است که هرچه پرامپت شما دقیقتر باشد، خروجی باکیفیتتری دریافت میکنید.
در این بخش مجموعهای از پرکاربردترین پرامپتها را برای توسعهدهندگان گردآوری کردهایم.
تحلیل پروژه
۱
Analyze this repository and explain its architecture.
۲
Describe the folder structure.
۳
Explain how authentication works.
۴
Summarize this codebase for a new developer.
۵
Find the entry point of this application.
۶
Explain the dependency graph.
۷
Generate a high-level architecture diagram in Mermaid.
۸
List all API endpoints.
۹
Explain how the database layer works.
۱۰
Find the most important files in this project.
تولید کد
۱۱
Create a REST API for products.
۱۲
Generate CRUD endpoints.
۱۳
Build JWT authentication.
۱۴
Create a reusable pagination component.
۱۵
Generate a React dashboard.
۱۶
Create an admin panel.
۱۷
Generate Docker files.
۸
Create a GitHub Actions workflow.
۱۹
Generate Terraform configuration.
۲۰
Build a CLI application.
Refactor
۲۱
Refactor this module using SOLID principles.
۲۲
Reduce duplicated code.
۲۳
Improve readability.
۲۴
Split this large file into smaller modules.
۲۵
Convert callbacks to async/await.
۲۶
Optimize imports.
۲۷
Improve naming conventions.
۲۸
Refactor this controller.
۲۹
Simplify this algorithm.
۳۰
Remove dead code.
Debug
۳۱
Find the bug.
۳۲
Explain why this code crashes.
۳۳
Find memory leaks.
۳۴
Explain this stack trace.
۳۵
Locate race conditions.
۳۶
Why is this endpoint slow?
۳۷
Find possible null pointer exceptions.
۳۸
Explain this exception.
۳۹
Suggest fixes.
۴۰
Debug this API.
امنیت
۴۱
Review this project for security issues.
۴۲
Check OWASP Top 10 vulnerabilities.
۴۳
Find SQL injection vulnerabilities.
۴۴
Review JWT implementation.
۴۵
Check authorization logic.
۴۶
Review password storage.
۴۷
Find XSS vulnerabilities.
۴۸
Check CSRF protection.
۴۹
Review API security.
۵۰
Find exposed secrets.
تست
۵۱
Generate unit tests.
۵۲
Increase test coverage.
۵۳
Write integration tests.
۵۴
Generate mocks.
۵۵
Write edge case tests.
۵۶
Generate performance tests.
۵۷
Write API tests.
۵۸
Generate Jest tests.
۵۹
Generate PHPUnit tests.
۶۰
Generate Playwright tests.
مستندسازی
۶۱
Generate README.md.
۶۲
Document all functions.
۶۳
Generate API documentation.
۶۴
Explain this module.
۶۵
Write inline comments.
۶۶
Generate architecture documentation.
۶۷
Create onboarding guide.
۶۸
Document environment variables.
۶۹
Explain deployment.
۷۰
Generate changelog.
Git
۷۱
Review my git diff.
۷۲
Generate commit message.
۷۳
Review this pull request.
۷۴
Summarize changes.
۷۵
Suggest smaller commits.
۷۶
Generate release notes.
۷۷
Find breaking changes.
۷۸
Review merge conflicts.
۷۹
Explain git history.
۸۰
Review branch changes.
بهینهسازی
۸۱
Optimize this query.
۸۲
Improve API performance.
۸۳
Reduce memory usage.
۸۴
Optimize React rendering.
۸۵
Optimize SQL queries.
۸۶
Reduce bundle size.
۸۷
Improve caching.
۸۸
Optimize Docker image.
۸۹
Improve startup time.
۹۰
Suggest performance improvements.
حرفهای
۹۱
Act as a senior software architect.
۹۲
Review this code like a staff engineer.
۹۳
Refactor this project to Clean Architecture.
۹۴
Design this system for one million users.
۹۵
Create an ADR for this decision.
۹۶
Generate a migration plan.
۹۷
Prepare this project for production.
۹۸
Review scalability concerns.
۹۹
Suggest CI/CD improvements.
۱۰۰
Review the entire repository as if you are the lead engineer and provide a prioritized action plan covering architecture, security, performance, maintainability, testing, documentation, and technical debt. Include concrete code examples where appropriate.
مقالات مرتبط:
آموزش اتصال OpenClaw به درواره؛ راهنمای کامل استفاده از چند صد مدل هوش مصنوعی