مرحله دوم: ساخت اتصال Claude Code در پاستا
- به صفحه اتصال ابزارهای توسعه بروید.
- Claude Code را انتخاب کنید.
- مدل مناسب و سقف هزینه روزانه را تعیین کنید.
- اتصال را بسازید و کلید و فایل تنظیم تولیدشده را همان لحظه کپی کنید.
کلید پاستا ۹۰ روز اعتبار دارد و فقط مدل انتخابی را مجاز میکند. آن را با برنامه production یا Agent دیگری مشترک نکنید؛ اتصال جدا، لغو دسترسی و گزارش هزینه را سادهتر میکند.
مرحله سوم: تنظیم ~/.claude/settings.json
پنل پاستا فایل آماده را تولید میکند. ساختار آن مانند نمونه زیر است؛ YOUR_MODEL_ID را با شناسه دقیق مدل انتخابی جایگزین کنید:
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"env": {
"ANTHROPIC_BASE_URL": "https://console.paasta.cloud/api/ai",
"ANTHROPIC_MODEL": "YOUR_MODEL_ID",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_MODEL_ID"
}
}
این آدرس عمداً بدون /v1 است؛ Claude Code مسیر Messages را به Base URL اضافه میکند. هر چهار متغیر مدل روی شناسه مجاز کلید قرار میگیرند تا انتخاب داخلی aliasها به مدل خارج از دسترسی نرود.
مرحله چهارم: تعریف ANTHROPIC_AUTH_TOKEN
Secret را داخل settings.json یا Git ننویسید. در PowerShell برای نشست فعلی:
$env:ANTHROPIC_AUTH_TOKEN="کلید-دریافتی-از-پاستا"
claude
در macOS، Linux یا WSL:
export ANTHROPIC_AUTH_TOKEN="کلید-دریافتی-از-پاستا"
claude
Claude Code این Token را بهصورت هدر Authorization برای Gateway ارسال میکند. اگر از فایل محیطی استفاده میکنید، آن را در .gitignore قرار دهید.
مرحله پنجم: اولین تست در Plan Mode
cd مسیر-پروژه
git status
claude --permission-mode plan
درخواست اولیه را کوچک و فقطخواندنی نگه دارید:
ساختار پروژه و مسیر اجرای درخواستها را توضیح بده.
سه ریسک را پیدا کن و قبل از هر ویرایش یا فرمان، برنامه پیشنهادی را نشان بده.
پس از تأیید برنامه، یک تغییر محدود بخواهید. در پایان git diff، فایلهای تغییرکرده و خروجی تست را خودتان بررسی کنید.
Permissionها و اجرای امن Claude Code
خواندن فایلها بهطور پیشفرض کماصطکاک است، اما ویرایش و فرمان Shell نیازمند تأیید میشوند. با دستور /permissions Ruleها را ببینید و دسترسیهای قبلی را بازبینی کنید.
- فرمانهای مشاهده مانند
git status و git diff را از عملیات Push و Deploy جدا کنید.
- Secretها، کلید SSH، فایل production و Dump مشتری را در دسترس Agent نگذارید.
- محتوای وب، Issue و فایل شخص ثالث را در برابر Prompt Injection غیرقابلاعتماد در نظر بگیرید.
- گزینه
--dangerously-skip-permissions را روی سیستم کاری یا Repository حساس اجرا نکنید.
چطور هزینه Claude Code را کنترل کنیم؟
یک مأموریت Agent ممکن است چند Turn و Tool Call داشته باشد. در پاستا برای هر اتصال سقف روزانه تعیین کنید، مدل را محدود نگه دارید و مصرف ورودی و خروجی را به تومان ببینید. کارهای توضیح و تغییر کوچک را با مدل اقتصادی شروع کنید و فقط برای Debug یا Refactor پیچیده اتصال جدا با مدل قویتر بسازید.
نام، موجودی و قیمت مدلها ثابت نیست؛ کاتالوگ زنده مدلها مرجع انتخاب است.
رفع خطاهای رایج
خطای 401 یا Invalid API key
ANTHROPIC_AUTH_TOKEN در همان Shell موجود نیست، یا کلید منقضی و لغو شده است. نشست تازه باز کنید یا اتصال جدید بسازید؛ Token را برای عیبیابی چاپ نکنید.
خطای 404 یا endpoint
ANTHROPIC_BASE_URL باید دقیقاً https://console.paasta.cloud/api/ai باشد. افزودن دستی /v1/messages باعث دوبارهنویسی مسیر میشود.
خطای model_not_allowed
مقدار ANTHROPIC_MODEL یا aliasهای پیشفرض با مدل مجاز کلید یکسان نیست. فایل آماده پنل را دوباره کپی کنید یا برای مدل جدید کلید جدا بسازید.
خطای 429 یا توقف بودجه
Rate Limit یا سقف روزانه پر شده است. دامنه کار و تعداد Turnها را کم کنید و فقط پس از بررسی گزارش مصرف محدودیت را افزایش دهید.
Claude Code بدون اجازه فرمان اجرا میکند
Ruleهای ذخیرهشده را با /permissions بررسی کنید و حالت اجرا را به Plan برگردانید. دسترسی عمومی Bash یا bypass را از تنظیم پروژه حذف کنید.
Claude Code با API پاستا چه مزیتی دارد؟
مسیر Gateway رسمی Claude Code برای احراز هویت مرکزی، گزارش مصرف و بودجه طراحی شده است. پاستا همین مسیر را با Anthropic Messages، Streaming و Tool Call سازگار میکند و تنظیم آماده، مدلهای قابلتعویض، پرداخت تومانی و کلید محدود تحویل میدهد.
در نتیجه برای شروع لازم نیست endpoint و Header را دستی حدس بزنید. مدل و بودجه را انتخاب میکنید، تنظیم تولیدشده را قرار میدهید و هزینه Agent را مستقل از سرویسهای دیگر میبینید. جزئیات فنی endpoint در مستندات API هوش مصنوعی پاستا آمده است.