راه‌اندازی Claude Code

CLI شرکت Anthropic روی endpoint OneProvider. راه‌اندازی یعنی دو متغیر محیطی و یک درخواست بررسی.

نصب

curl -fsSL https://claude.ai/install.sh | bash
# or:
brew install --cask claude-code

گزینهٔ 1: متغیرهای محیطی (نشست فعلی)

سریع‌ترین راه این است که متغیرها را فقط در ترمینال فعلی تنظیم کنید. در نشست‌های بعدی نمی‌مانند — اگر می‌خواهید بعد از راه‌اندازی مجدد هم بمانند، به بخش «ماندگار کردن» در انتهای صفحه نگاه کنید.

export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here

گزینهٔ 2: تنظیمات ماندگار

Claude Code تنظیمات کاربر را از settings.json می‌خواند. مدل پیش‌فرض و نام‌های مستعار خانواده‌ها در زیر از مدل‌های فعال فعلی کاتالوگ گرفته شده‌اند.

مسیر فایل: ~/.claude/settings.json

{
"env": {
"ANTHROPIC_BASE_URL": "https://api.oneprovider.dev",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
"ANTHROPIC_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
},
"model": "claude-sonnet-5-5"
}

بررسی

claude -p "say hi in one sentence"

باید ظرف یکی دو ثانیه یک پاسخ تک‌جمله‌ای ببینید. اگر 401 دیدید، کلید اشتباه است؛ 400 invalid_request_error یعنی نام مدل با فهرست رسمی مطابقت ندارد (پاسخ شناسه‌های پشتیبانی‌شده را فهرست می‌کند).

مشکلات رایج

# validate the file
jq . ~/.claude/settings.json
# auto-replace smart quotes with ASCII
sed -i.bak $'s/[\u201c\u201d]/"/g' ~/.claude/settings.json

فهرست کامل نشانه‌ها ← علت‌ها ← راه‌حل‌ها برای 400 / 401 / 403 / 404 / 429 / 503 / 504 در صفحهٔ عیب‌یابی است.

استفاده از ابزار

Claude Code از طرح‌واره (schema) بومی ابزارهای Anthropic استفاده می‌کند. API همهٔ نام‌های ابزار (Read، Write، Edit، Bash، Grep، Glob، TodoWrite و غیره) را با tool_choice: auto می‌پذیرد — همان چیزی که CLI به‌طور پیش‌فرض می‌فرستد. هدر anthropic-beta لازم نیست.

اگر هماهنگ‌کنندهٔ سفارشی شما tool_choice: {"type": "any"} یا tool_choice: {"type": "tool", "name": "X"} بگذارد، API آن‌ها را به auto به‌علاوهٔ یک یادآوری در پرامپت سیستم بازنویسی می‌کند. جدول کامل در استفاده از ابزار .

ماندگار کردن

وقتی همه‌چیز کار کرد و خواستید متغیرها بین نشست‌های ترمینال بمانند، آن‌ها را به فایل rc شل (macOS / Linux) یا به رجیستری محیط کاربر (Windows) اضافه کنید. ترمینال‌های جدید آن‌ها را خودکار برمی‌دارند.

# append to ~/.zshrc (default macOS shell)
cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL=https://api.oneprovider.dev
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF
# apply to the current session:
source ~/.zshrc

کدام مدل را انتخاب کنیم

Claude Code پروتکل Anthropic را به کار می‌برد، پس با خانوادهٔ Claude بهترین نتیجه را می‌دهد. claude-sonnet-5-5 را به‌عنوان پیش‌فرض روزمره به کار ببرید: قیمت و کیفیت متعادل برای ویرایش، تست و توضیح. برای تصمیم‌های معماری، بازسازی‌های بزرگ و باگ‌هایی که نمی‌توانید ردیابی کنید به claude-opus-5-5 بروید؛ هزینهٔ هر توکن آن بیشتر است. claude-haiku-5-5 را برای پرسش‌های سریع، پیام‌های کامیت و کارهای پس‌زمینه که سرعت از عمق مهم‌تر است به کار ببرید. داخل نشست با /model جابه‌جا شوید، یا با claude --model claude-opus-5-5 شروع کنید. تنظیمات بالا نام‌های مستعار sonnet، opus و haiku را به این شناسه‌ها نگاشت می‌کنند. شناسه‌های فعلی در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است. قیمت‌ها به‌ازای هر میلیون توکن‌اند، پس برای کلید سقف مصرف بگذارید و «مصرف» را در داشبورد زیر نظر داشته باشید.

خطاهای رایج و راه‌حل‌ها

claude: command not found بعد از نصب

اول یک ترمینال جدید باز کنید: نصب‌کننده فایل اجرایی را در ~/.local/bin می‌گذارد. اگر هنوز پیدا نمی‌شود، آن را با export PATH="$HOME/.local/bin:$PATH" در فایل rc شل اضافه کنید. با Homebrew بررسی کنید که brew install --cask claude-code بدون خطا تمام شده باشد.

400 invalid_request_error دربارهٔ مدل

شناسهٔ مدل در کاتالوگ نیست، اغلب یک نام مستعار قدیمی مثل claude-3-5-sonnet. ANTHROPIC_MODEL و سه متغیر ANTHROPIC_DEFAULT_*_MODEL را مثل settings.json بالا تنظیم کنید، یا شناسه‌های معتبر را با curl -s https://api.oneprovider.dev/v1/models -H "x-api-key: $KEY" فهرست کنید.

404 یا «The requested API endpoint does not exist»

ANTHROPIC_BASE_URL باید دقیقاً https://api.oneprovider.dev باشد: در انتها نه /v1 و نه /v1/messages. Claude Code مسیر را خودش اضافه می‌کند.

429 «Insufficient balance on this API key»

موجودی حساب کاربری یا سقف مصرف کلید تمام شده است. تلاش دوباره کمکی نمی‌کند: موجودی را شارژ کنید یا سقف را در حساب کاربری بالا ببرید، سپس درخواست را دوباره بفرستید.

پاسخ وسط کار قطع می‌شود یا اتصال ریست می‌شود

هر VPN یا پروکسی VLESS را خاموش کنید: استریم‌ها را بافر می‌کنند و HTTP/2 را خراب می‌کنند. OneProvider بر اساس کشور مسدود نمی‌کند و استریم‌ها را بافر نمی‌کند. درخواست باید حداکثر ظرف 6 دقیقه شروع به پاسخ دادن کند و مدت کل آن حداکثر 10 دقیقه است، به کدهای خطا نگاه کنید.

settings.json را عوض کردم ولی چیزی تغییر نکرد

Claude Code بلوک env را هنگام شروع می‌خواند، پس خارج شوید و claude را دوباره اجرا کنید. متغیرها را در ~/.claude/settings.json یا شل نگه دارید: .claude/settings.json داخل پروژه بعد از راه‌اندازی اولیه خوانده می‌شود و ممکن است دیر باشد.

پرسش‌های متداول

به حساب یا اشتراک Claude نیاز دارم؟

نه. کلید OneProvider کافی است. Claude Code هرگز لازم نیست به claude.ai وارد شود؛ اگر صفحهٔ ورود نشان داد، گام‌های Auth conflict بالا را دنبال کنید.

می‌توانم در Claude Code از GPT یا مدل‌های دیگر استفاده کنم؟

Claude Code درخواست‌های Anthropic Messages می‌فرستد، پس در آن شناسه‌های Claude را به کار ببرید. برای مدل‌های GPT از Codex ، Cursor یا Cline استفاده کنید.

چطور به ورود Anthropic خودم برگردم؟

متغیرهای ANTHROPIC_* که بالا تنظیم کردید را از بلوک env در settings.json و از فایل rc شل پاک کنید، یک ترمینال جدید باز کنید و /login را اجرا کنید.

هزینهٔ یک نشست را کجا می‌بینم؟

در صفحهٔ «مصرف» داشبورد کلید: هر درخواست با مدل و تعداد توکن‌هایش. سقف مصرف برای هر کلید جلوی یک عامل از کنترل خارج‌شده را می‌گیرد.

روی Windows هم کار می‌کند؟

بله. در بالای صفحه Windows را در انتخاب‌گر سیستم‌عامل انتخاب کنید: همان دو متغیر با PowerShell تنظیم می‌شوند و settings.json در پروفایل کاربر شما زیر .claude است.

افزونهٔ Claude Code برای VS Code همین است؟

فایل تنظیمات را مشترکاً به کار می‌برد. به Claude Code در VS Code نگاه کنید.

پاسخ‌های سریع

از کدام base URL استفاده کنم؟

Claude Code و SDKهای Anthropic از https://api.oneprovider.dev استفاده می‌کنند. SDKهای OpenAI و کلاینت‌های سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده می‌کنند. یک کلید پشت هر دو آدرس کار می‌کند؛ فهرست مدل‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است.

چگونه احراز هویت کنم؟

کلید خام sk-… را در x-api-key یا Authorization: Bearer بفرستید: یکی از این دو، نه هر دو. کلید را در یک متغیر محیطی نگه دارید، نه در فایلی که commit می‌شود. اطلاعات بیشتر دربارهٔ احراز هویت .

کلید را از کجا بگیرم؟

حساب کاربری خود را در ربات Telegram به نام @oneprovider_robot یا در app.oneprovider.dev باز کنید، موجودی را شارژ کنید و «صدور کلید» را بزنید. هر کلید می‌تواند سقف مصرف مخصوص خودش را داشته باشد. حساب کاربری و کلیدهای API .

کدهای 401، 404 و 429 یعنی چه؟

401: کلید ارسال نشده، اشتباه تایپ شده یا در هدر نادرست فرستاده شده است؛ کلید را کامل و بدون گیومه و فاصله جای‌گذاری کنید. 404: معمولاً base URL نادرست است، مثلاً /v1 جا افتاده یا دوبار آمده است. 429 با پیام «Insufficient balance»: موجودی حساب کاربری یا سقف مصرف کلید تمام شده است؛ به‌جای تلاش دوباره، شارژ کنید. هر 429 دیگری محدودیت نرخ است؛ تا پایان زمان Retry-After صبر کنید. جزئیات: کدهای خطا و رفع اشکال .

چرا استریم‌ها قطع یا ریست می‌شوند؟

VPN و پروکسی‌های VLESS اغلب SSE را بافر می‌کنند یا مذاکرهٔ HTTP/2 را مختل می‌کنند. OneProvider هیچ محدودیت منطقه‌ای ندارد و استریم‌ها را بافر نمی‌کند؛ پروکسی را خاموش کنید و دوباره امتحان کنید.

اگر این‌ها کافی نبود از کجا بپرسم؟

در Telegram به @Oneproviderhelpbot پیام بدهید یا در حساب کاربری وب «پشتیبانی» را باز کنید و کد وضعیت HTTP و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار می‌کند .