Claude Code چیست؟ آموزش نصب، دسترسی و اتصال به API
Claude Code عامل برنامه‌نویسی Anthropic برای کار روی پروژه است. نصب، مسیرهای دسترسی و تفاوت آن با مدل Claude را بشناسید و راه استفاده از جایگزین‌های سازگار با API وان ای آی را یاد بگیرید.
Claude Code چیست؟ ابزار عاملمحور برنامه‌نویسی شرکت Anthropic است که میتواند کد پروژه را بخواند، فایل‌ها را ویرایش کند و فرمان‌ها و تست‌ها را اجرا کند؛ یعنی کار را از پیشنهاد کد به اقدام روی پروژه می‌رساند. طبق معرفی رسمی Claude Code، این ابزار در ترمینال و محیط‌های توسعه در دسترس است. برای اتصال مستقیم به یک درگاه سفارشی به Anthropic Messages API نیاز دارد و با API وان ای آی کار نمی‌کند؛ مسیر استفاده از مدل‌های Claude در 1ai، ابزارهای سازگاری مثل Cline و OpenCode است.
Anthropic کلود کد را در فوریهٔ ۲۰۲۵، اسفند ۱۴۰۳، ابتدا به‌صورت پیش‌نمایش پژوهشی معرفی کرد؛ این تاریخ مربوط به آغاز محصول است، نه یک نسخهٔ تازه در آبان ۱۴۰۵. اعلام اولیهٔ Anthropic همین تمایز را روشن می‌کند. اطلاعات متغیر این راهنما با مراجعه به صفحات رسمی برای نگارش در ۳۱ اکتبر ۲۰۲۶، ۹ آبان ۱۴۰۵، بررسی شده‌اند؛ پیش از خرید، شرایط همان روز را دوباره ببینید.
Claude Code چیست و چه فرقی با مدل Claude دارد؟
برای فهم اینکه Claude Code چیست، سه چیز را جدا کنید: مدل، ابزار و سرویس دسترسی. مدل پاسخ را تولید می‌کند؛ ابزار فایل‌ها و فرمان‌ها را به فرایند کار اضافه می‌کند؛ سرویس دسترسی هم تعیین می‌کند درخواست از کدام API عبور کند و هزینه کجا ثبت شود. یکسان بودن نام مدل، به معنای یکسان بودن ابزار یا امکان اتصال آن نیست.
تغییر اصلی نسبت به شیوهٔ معمول پرسش‌وپاسخ دربارهٔ کد، در جدول زیر آمده است. این مقایسه دربارهٔ روش کار است؛ ادعای مقایسهٔ دو نسخهٔ شماره‌دار یا امتیاز عملکرد نیست.
| بخش کار | پرسش‌وپاسخ متنی دربارهٔ کد | کار عاملمحور در Claude Code |
|---|---|---|
| شناخت مسئله | شما قطعهٔ مرتبط را توضیح می‌دهید | ابزار میتواند فایل‌های مرتبط را بررسی کند |
| اعمال تغییر | پاسخ را دستی به پروژه منتقل می‌کنید | ابزار میتواند فایل پروژه را تغییر دهد |
| بررسی نتیجه | خودتان تست را اجرا می‌کنید | ابزار میتواند فرمان تست را اجرا و خروجی را بررسی کند |
| تحویل کار | یک پاسخ یا قطعه‌کد می‌گیرید | امکان انجام زنجیره‌ای از اقدامات روی پروژه وجود دارد |
مبنای ستون آخر، شرح رسمی چرخهٔ کار Claude Code است: جمع‌آوری زمینه، اقدام و بررسی نتیجه. این توانایی، تضمین درست بودن خروجی نیست. مسئولیت تشخیص اینکه تغییر با نیاز محصول هم‌خوان است، همچنان به بازبینی شما وابسته است.
در وان ای آی (1ai) می‌توانید از مدل‌های Claude برای توضیح کد، تحلیل خطا و پیشنهاد راه‌حل استفاده کنید. صفحهٔ دسترسی به مدل‌های Claude دربارهٔ همین مدل‌هاست؛ داشتن این دسترسی، اشتراک یا دسترسی به نرمافزار Claude Code ایجاد نمی‌کند.
کلود کد برای چه کسانی کاربرد دارد؟
اگر پروژه‌ای دارید و می‌توانید تغییرات آن را بررسی کنید، یک کار محدود برای شروع انتخاب کنید: پیدا کردن علت خطا، افزودن یک تست یا توضیح مسیر اجرای یک درخواست. برای توسعه‌دهندهٔ باتجربه، معیار انتخاب باید زمان رسیدن به تغییر قابل‌اعتماد باشد؛ برای دانشجو، فهمیدن دلیل تغییر هم بخشی از نتیجه است.
اگر هنوز تفاوت فایل منبع، ترمینال و تست را نمی‌دانید، ابتدا مسئله را در یک گفت‌وگوی متنی بررسی کنید. مثلاً بپرسید این خطا چه معنایی دارد، کدام ورودی آن را ایجاد می‌کند و چگونه می‌توان آن را بازتولید کرد. سپس سراغ ابزاری بروید که اجازهٔ ویرایش پروژه دارد.
برای انتخاب روش مناسب، راهنمای بهترین هوش مصنوعی برای برنامه‌نویسی را کنار نیاز واقعی خود بگذارید. پروژهٔ آموزشی، رفع خطای یک فروشگاه فعال و بازآرایی سامانهٔ شرکتی، به سطح یکسانی از اختیار، هزینه و بازبینی نیاز ندارند.
نصب Claude Code چطور انجام می‌شود؟
برای نصب Claude Code ابتدا سیستم‌عامل، دسترسی رسمی و پوشهٔ پروژه را مشخص کنید. مراحل زیر مسیر ترمینال را توضیح می‌دهند؛ فرمان‌ها از راهنمای رسمی نصب گرفته شده‌اند. این‌ها دستور آموزشی هستند و اجرای آن‌ها روی رایانهٔ شما بخشی از این مقاله نیست.
۱. پروژه‌ای مناسب برای شروع آماده کنید
یک پروژهٔ تمرینی یا نسخه‌ای قابل‌بازیابی از کار خود انتخاب کنید. قبل از شروع، تغییرات ذخیره‌نشده را مشخص کنید تا بعداً بدانید کدام فایل واقعاً توسط ابزار تغییر کرده است. نخستین آزمایش را به اطلاعات مشتری، کلید سرویس‌ها یا پایگاه دادهٔ اصلی وابسته نکنید.
از همان ابتدا یک هدف قابل‌اندازه‌گیری بنویسید: «خطای ورودی خالی را بازتولید کن و فقط همان مسیر را اصلاح کن». درخواست «کل برنامه را بهتر کن» برای اولین جلسه، مرز تغییرات و معیار پایان را مبهم می‌کند.
۲. فرمان نصب مناسب را اجرا کنید
در macOS، Linux یا محیط WSL، روش نصب بومی پیشنهادی مستندات این است:
curl -fsSL https://claude.ai/install.sh | bashدر Windows PowerShell از فرمان مخصوص همان محیط استفاده کنید:
irm https://claude.ai/install.ps1 | iexاین دو فرمان را با هم اجرا نکنید؛ هرکدام برای محیط مشخصی است. چون نصب‌کننده از اینترنت دریافت و اجرا می‌شود، آدرس را با مستندات رسمی تطبیق دهید و سیاست نصب نرمافزار محل کارتان را رعایت کنید.
۳. نصب را بررسی و جلسه را شروع کنید
مطابق راهنمای شروع سریع Claude Code، نسخه را بررسی کنید، وارد پوشهٔ پروژه شوید و ابزار را اجرا کنید:
claude --version
cd /path/to/your/project
claudeمسیر نمونه را با مسیر واقعی پروژه عوض کنید. در اولین استفاده، مراحل ورود را دنبال کنید؛ حساب اشتراکی واجد شرایط یا حساب Console از مسیرهای معرفیشده در همین راهنما هستند. نصب شدن فرمان، به‌تنهایی به معنای فعال بودن دسترسی مدل نیست.
۴. اولین درخواست را فقط به شناخت پروژه اختصاص دهید
آموزش Claude Code را با درخواست خواندن و توضیح دادن شروع کنید. قبل از درخواست تغییر، ببینید ابزار مسئله و محدودهٔ پروژه را چگونه فهمیده است:
ابتدا ساختار این پروژه و مسیر اجرای درخواست ورود کاربر را توضیح بده.
فعلاً هیچ فایلی را تغییر نده و هیچ بسته‌ای نصب نکن.
فایل‌های مرتبط، فرض‌های نامطمئن و تست‌های موجود را نام ببر.
بعد یک برنامهٔ کوتاه برای بررسی خطای ورود پیشنهاد بده.اگر پاسخ به فایل یا فرض اشتباه تکیه داشت، همان‌جا اصلاحش کنید. اصلاح برداشت اولیه معمولاً از بازبینی مجموعه‌ای از تغییرات بی‌ربط ساده‌تر است.
پلنها و روش‌های دسترسی Claude Code کدام‌اند؟
دو مسیر را از هم تفکیک کنید: استفاده در چارچوب اشتراک Claude و مصرف از مسیر API یا زیرساخت سازمانی. در صفحات رسمی بررسی‌شده، پلن‌های فردی Pro، Max و Ultra و مسیرهای Team و Enterprise برای دسترسی مطرح شده‌اند. نوع حساب و احراز هویت را مستندات رسمی دسترسی توضیح میدهد؛ نام پلنها و شرایط آن‌ها ممکن است تغییر کند.
| مسیر | قبل از انتخاب چه چیزی را بررسی کنید؟ |
|---|---|
| اشتراک فردی واجد شرایط | وجود Claude Code در پلن، سقف مصرف و شرایط تمدید |
| Team یا Enterprise | دعوت حساب، مجوز مدیر و سیاست استفادهٔ سازمان |
| Claude Console و API | اعتبار، شیوهٔ محاسبهٔ مصرف و محل ثبت هزینه |
| زیرساخت ابری پشتیبانی‌شده | حساب سازمانی، تنظیمات ارائه‌دهنده و مسئول پرداخت |
برای تصمیم خرید، قیمت لحظه‌ای را از صفحهٔ رسمی بگیرید. عدد یک مقالهٔ قدیمی، هزینهٔ نهایی با مالیات یا شرایط حساب شما را مشخص نمی‌کند. ابتدا یک کار نمونه، مدت استفاده و بودجهٔ قابل‌قبول تعریف کنید؛ سپس ببینید مسیر انتخابی با آن سازگار است یا نه.
آیا Claude Code رایگان است؟
جست‌وجوی «Claude Code رایگان» نباید به این برداشت منجر شود که نصب ابزار، مصرف نامحدود مدل را هم رایگان می‌کند. در جدول رسمی پلن‌های Claude، Claude Code در امکانات پلن‌های پولی آمده است؛ وجود پلن Free برای Claude را معادل دسترسی رایگان دائمی به این ابزار نگیرید. هر پیشنهاد آزمایشی را نیز فقط با شرایط رسمی همان پیشنهاد ارزیابی کنید.
در مصرف API، اندازهٔ زمینه، مدل انتخابی و الگوی استفاده روی هزینه اثر می‌گذارند؛ راهنمای رسمی مدیریت هزینه این عوامل را توضیح میدهد. پیشنهاد عملی ما این است که برای آزمایش، کارهای کوتاه با خروجی روشن تعریف کنید و هزینهٔ رسیدن به نتیجهٔ تأییدشده را بسنجید.
آیا استفاده از Claude Code در ایران امکان‌پذیر است؟
در فهرست رسمی محل‌های دسترسی Claude که برای این مقاله بررسی شد، ایران ذکر نشده است. بنابراین نباید نصب موفق نرمافزار را تضمین دسترسی رسمی از ایران دانست؛ حساب واجد شرایط و امکان پرداخت مسیر انتخابی هم اهمیت دارند. مرجع این موضوع فهرست رسمی مناطق دسترسی Claude است.
برای تصمیم عملی، سه پرسش را جدا پاسخ دهید: آیا ابزار نصب می‌شود؟ آیا استفاده از حساب در محل شما پشتیبانی می‌شود؟ آیا هزینه از مسیر مجاز قابل‌پرداخت است؟ این راهنما روشی برای دور زدن محدودیت منطقه‌ای یا شرایط حساب پیشنهاد نمی‌کند.
اگر نیازتان توضیح کد، نوشتن تست پیشنهادی یا تحلیل خطاست، برنامه‌نویسی با هوش مصنوعی در 1ai مسیر دیگری است. ورود با شمارهٔ موبایل ایرانی و رمز یک‌بارمصرف انجام می‌شود و برای استفاده از فضای فارسی آن به حساب خارجی، کارت خارجی یا VPN نیاز ندارید. اتصال ابزار توسعه نیز مسیر جداگانهٔ API را دارد.
چرا Claude Code با API وان ای آی کار نمی‌کند؟
پاسخ فنی به «Claude Code چیست» بدون توضیح قالب اتصال کامل نیست: Claude Code برای اتصال مستقیم به درگاه سفارشی از قالب Anthropic Messages استفاده می‌کند، نه OpenAI Chat Completions. راهنمای رسمی سازگاری درگاه‌ها مسیر /v1/messages را برای این حالت مشخص می‌کند؛ مسیرهای ابری پشتیبانی‌شده هم تنظیمات اختصاصی دارند.
API وان ای آی در نشانی https://1ai.ir/v1، سازگار با OpenAI است و برای چت از chat/completions استفاده می‌کند. این API، Anthropic Messages API را ارائه نمی‌کند؛ بنابراین Claude Code با API وان ای آی کار نمی‌کند. تغییر آدرس در ANTHROPIC_BASE_URL، قالب درخواست و پاسخ را تبدیل نمی‌کند.
| چیزی که انتخاب می‌کنید | نقش آن در اتصال |
|---|---|
| مدل Claude | مدل پاسخ‌دهنده به درخواست |
| قالب API | ساختار پیام، فراخوانی ابزار و پاسخ |
| Base URL | نشانی سرویس دریافت‌کنندهٔ درخواست |
| کلید API | اعتبارنامهٔ همان سرویس |
این جدول یک قاعدهٔ تشخیص خطا میدهد: اول سازگاری قالب را بررسی کنید، بعد کلید و نام مدل را. کلید درست هم نمی‌تواند ناسازگاری دو API را رفع کند. امکان استفاده از مدل Claude در یک سرویس، وعدهٔ پشتیبانی از همهٔ نرم‌افزارهای دارای نام Claude نیست.
کدام جایگزین‌های Claude Code با 1ai کار می‌کنند؟
برای استفاده از مدل‌های Claude از طریق https://1ai.ir/v1، ابزار را در حالت OpenAI-compatible تنظیم کنید. چهار گزینهٔ زیر این نوع اتصال را در مستندات رسمی خود توضیح داده‌اند. آن‌ها جایگزین مسیر کار هستند؛ انتظار یکسان بودن همهٔ امکانات و رفتارشان را نداشته باشید.
| ابزار | تنظیم اصلی برای اتصال به 1ai | مستند رسمی |
|---|---|---|
| Cline | انتخاب OpenAI Compatible، سپس Base URL، کلید و Model ID | تنظیمات Cline |
| OpenCode | تعریف ارائه‌دهندهٔ سفارشی سازگار با OpenAI و baseURL | ارائه‌دهندگان OpenCode |
| Aider | تنظیم OPENAI_API_BASE و کلید، با پیشوند openai/ برای مدل | اتصال Aider |
| Continue | انتخاب provider: openai و تنظیم apiBase | تنظیمات Continue |
چطور Cline را به مدل‌های Claude در 1ai وصل کنیم؟
۱. در 1ai یک کلید API بسازید و سقف ماهانهٔ مناسبی برای همان کلید قرار دهید.
۲. در تنظیمات Cline، ارائه‌دهنده را OpenAI Compatible انتخاب کنید.
۳. Base URL را دقیقاً https://1ai.ir/v1 بگذارید و کلید اختصاصی خود را وارد کنید.
۴. شناسهٔ مدل Claude را از فهرست مدل‌های در دسترس حساب خود بردارید و در Model ID قرار دهید.
۵. ابتدا یک درخواست کوتاه برای توضیح یک تابع بفرستید؛ سپس ویرایش و فراخوانی ابزار را روی پروژهٔ آزمایشی بررسی کنید.
این مراحل، کاربرد تنظیمات رسمی Cline برای مشخصات API وان ای آی است. راهنمای اتصال Cline به 1ai را برای ادامه ببینید. انتخاب گزینهٔ Anthropic به‌جای OpenAI Compatible، برای این اتصال مناسب نیست.
برای OpenCode، Aider و Continue چه تنظیمی لازم است؟
در OpenCode، ارائه‌دهندهٔ سفارشی را با اتصال Chat Completions سازگار با OpenAI تعریف کنید و options.baseURL را نشانی وان ای آی بگذارید؛ راهنمای OpenCode در 1ai مسیر داخلی این اتصال است. در Aider نشانی پایه و کلید تنظیم می‌شوند و پیشوند openai/ به شناسهٔ مدل اضافه می‌شود. در Continue، apiBase همان نشانی و provider برابر openai خواهد بود؛ نام این گزینه، قالب اتصال را مشخص می‌کند و لزوماً به معنای انتخاب مدل ساخت OpenAI نیست.
شناسهٔ مدل را حدس نزنید و کلید واقعی را در مخزن کد قرار ندهید. اگر پاسخ متنی می‌رسد ولی ویرایش یا ابزارها درست عمل نمی‌کنند، تنظیمات مدل و پشتیبانی فراخوانی ابزار را جدا بررسی کنید. برقرار بودن اتصال، هنوز تأیید کیفیت نتیجهٔ برنامه‌نویسی نیست.
آموزش Claude Code فارسی را با چه پرامپتی شروع کنیم؟
اگر منظورتان از «Claude Code فارسی» راهنمای فارسی و درخواست فارسی است، معیار موفقیت را روشن بنویسید و پاسخ را ارزیابی کنید؛ این عبارت را وعدهٔ رابط رسمی فارسی تلقی نکنید. نمونه‌های زیر پیشنهاد ما برای صورت‌بندی کار هستند، نه تضمین خروجی ابزار.
نمونهٔ رفع خطا با محدودهٔ مشخص
خطا: ارسال فرم با نام خالی باعث خطای سرور می‌شود.
انتظار: پیام اعتبارسنجی قابل‌فهم نمایش داده شود.
ابتدا مسیر خطا را پیدا کن و روش بازتولید را توضیح بده.
فقط فایل‌های ضروری همین مشکل را تغییر بده.
برای ورودی خالی و ورودی معتبر تست مرتبط را اجرا کن.
در پایان بگو چه چیزی بررسی شد و چه چیزی بررسی نشد.نمونهٔ بازبینی قبل از تغییر
این تغییر پیشنهادی را از نظر منطق، مجوز دسترسی و حالت‌های مرزی بررسی کن.
فعلاً فایل‌ها را ویرایش نکن.
برای هر ایراد، ورودی مشکل‌ساز و نتیجهٔ مورد انتظار را بنویس.
اگر اطلاعات کافی نداری، فرض خودت را مشخص کن.بعد از دریافت نتیجه، فقط به خلاصهٔ ابزار اکتفا نکنید. تغییر واقعی فایل‌ها، خروجی تست و رفتار قابل‌مشاهده را کنار هم ببینید. در رویکرد وایب کدینگ هم نوشتن درخواست روشن، جای تشخیص درست بودن محصول را نمی‌گیرد.
سوالات متداول
Claude Code چیست و چه تفاوتی با چت Claude دارد؟
Claude Code ابزار عاملمحور برای اقدام روی پروژه است؛ مدل Claude بخش تولید پاسخ را انجام میدهد. مطابق مستندات رسمی معرفیشده در ابتدای مقاله، ابزار میتواند خواندن فایل، ویرایش و اجرای فرمان را به جریان کار اضافه کند.
آیا نصب Claude Code به معنی دسترسی رایگان است؟
خیر؛ نصب نرمافزار و هزینهٔ مصرف مدل دو موضوع جدا هستند. پلن واجد شرایط، اعتبار API یا دسترسی سازمانی را مطابق منابع رسمی بخش پلنها بررسی کنید و پیشنهاد موقت را دسترسی دائمی فرض نکنید.
آیا کلید API وان ای آی در Claude Code کار می‌کند؟
خیر؛ Claude Code برای اتصال سفارشی به Anthropic Messages API نیاز دارد و API وان ای آی از قالب OpenAI-compatible استفاده می‌کند. قرار دادن کلید 1ai یا تغییر Base URL این تفاوت را رفع نمی‌کند.
چطور با API وان ای آی از مدل‌های Claude برای کدنویسی استفاده کنیم؟
Cline، OpenCode، Aider یا Continue را مطابق جدول و منابع رسمی بالا در حالت سازگار با OpenAI تنظیم کنید. نشانی پایه https://1ai.ir/v1، کلید 1ai و شناسهٔ مدل در دسترس حساب را وارد کنید.
آیا برای شروع باید به ابزار اجازهٔ تغییر همهٔ فایل‌ها را بدهیم؟
پیشنهاد ما شروع با خواندن پروژه و یک تغییر محدود است. پیش از افزایش اختیار، کیفیت تغییر، خروجی تست‌ها و امکان بازیابی پروژه را بررسی کنید.
برای شروع در 1ai، یک سؤال واقعی برنامه‌نویسی انتخاب کنید و ابتدا پاسخ را در چت بسنجید. سپس در صورت نیاز، یکی از ابزارهای سازگار را متصل کنید؛ اعتبار یکپارچه برای مصرف خدمات است و شرایط اشتراک و اعتبار را می‌توانید در صفحهٔ تعرفه‌ها ببینید.
